django-pycorpkit 1.0.0

Reusable functionality

About

A reusable DRF library that provides reusable components.

Installation

pip install django-pycorpkit

Quick start

1. Add “django-pycorpkit” to your INSTALLED_APPS setting:

   INSTALLED_APPS = [
       ...
       "pycorpkit.common",
       "pycorpkit.accountx",
       "pycorpkit.org_structure",
   ]

2. Include the django_sample_lib URLconf in your project urls.py:

   path('api/', include('pycorpkit.urls')),

3. Run migrations:

   python manage.py migrate

4. Add exception handler and default backend filter:

   REST_FRAMEWORK = {
       "EXCEPTION_HANDLER": "pycorpkit.common.utils.exception_handler.custom_exception_handler",
       "DEFAULT_PERMISSION_CLASSES": [
           "pycorpkit.accountx.permissions.enforce.EnforceDRFViewPermission",
       ],
       "DEFAULT_FILTER_BACKENDS": (
           "pycorpkit.common.filters.base.OrganisationFilterBackend",
       ),
   }

5. Add variables:

   PERMISSIONS_PATH = "testapp.perms"
   PERMISSIONS_GROUPS_PATH = "testapp.perms.apps.perm_groups"
   APP_NAME = "PyCorpKit"
   AUTH_USER_MODEL = "accountx.User"
   SIMPLE_JWT = {
       "ACCESS_TOKEN_LIFETIME": timedelta(seconds=3600),
       "REFRESH_TOKEN_LIFETIME": timedelta(days=7),
   }
   DEFAULT_FROM_EMAIL = "[e-mail]"

Development

To set up the development environment:

1. Clone the repository

2. Create a virtual environment and activate it

3. Install development dependencies:

   pip install -e ".[dev]"

4. Run tests:

   python -m pytest tests
   # OR
   pytest tests/

Install test dependencies

pip install -e ".[test]"

Making migrations

python testapp/manage.py makemigrations
python testapp/manage.py makemigrations <app_name> --empty

Migrate

python testapp/manage.py migrate