Skip to main content

A compilation of the applications we often use in addition to Django Rest Framework

Project description

PixelForest DRF

PyPI version Python versions Django versions

This repository host the code of the PixelForest DRF package. This package will host most of the reusable applications/code we use on a project basis as the PixelForest Dev Team.

Note This package is under public licensing because we figured it might be useful for other as it is.

Current subpackages

  • utils: A subpackage with useful tools for Django applications. Not an application itself (but used as one for testing), no need to add it to your installed apps
  • countries: A django application to handle some location data, based on 3 levels: Country, SubRegion and Region
  • companies: A django application to handle companies structure, based on 4 levels: CompanyGroup, Company, Subsidiary and Service
  • users: A django application to handle users
  • rest: A collection of basic apis for the applications subpackages

Getting started

Requirements

The following requirements will need to be installed and configured

Installation

You can install the package using pip:

pip install pixelforest_drf

Add the wanted application(s) to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...,
    'rest_framework',  # necessary to use pixelforest_drf.rest
    'phonenumber_field',  # necessary to use pixelforest_drf.users
    'pixelforest_drf.companies',
    'pixelforest_drf.countries',
    'pixelforest_drf.users',
    ...,
)

If you use the pixelforest_drf.users subpackage, define the user in your settings:

AUTH_USER_MODEL = "users.PFUser"

Run the included migrations:

python3 manage.py migrate

Rest Endpoints

Add the wanted URL patterns:

from pixelforest_drf.rest import api_urls

urlpatterns = [
    ...,
    path('', include(api_urls)),
    ...,
]

Or, if you are not using all subpackages, you can nitpick:

from pixelforest_drf.rest.countries import api_urls as countries_urls
from pixelforest_drf.rest.companies import api_urls as companies_urls
from pixelforest_drf.rest.users import api_urls as users_urls

urlpatterns = [
    ...,
    path('', include(countries_urls)),
    path('', include(companies_urls)),
    path('', include(users_urls)),
    ...,
]

Contributing

Guidelines

Please contact the PixelForest Dev Team for any bug report or feature request.

Credit

Contributors

Jean-Xavier Raynaud - email - Product Owner / System Architect / Developer

Milo Parigi - email - Scrum Master / Developer

Victor Duvernois - email - Developer

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pixelforest-drf, version 0.2.3
Filename, size File type Python version Upload date Hashes
Filename, size pixelforest_drf-0.2.3-py3-none-any.whl (852.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pixelforest_drf-0.2.3.tar.gz (846.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page