nwon_django_toolbox 0.2.0

Some Django Wizardry

NWON-Django-Toolbox

This package provides some Django additions that can be used across several projects.

The project has a bunch of dependencies that we use in most of our projects. These are:

• Django (Obviously 🧠)
• Pydantic
• django-polymorphic
• django-rest
• drf-yasg

Package is meant for internal use at NWON as breaking changes may occur on version changes. This may change at some point but not for now 😇.

Development Setup

We recommend developing using poetry.

This are the steps to setup the project with a local virtual environment:

1. Tell poetry to create dependencies in a .venv folder withing the project: poetry config virtualenvs.in-project true
2. Create a virtual environment using the local python version: poetry env use $(cat .python-version)
3. Install dependencies: poetry install

Prepare Package

Before publishing the package we need to:

1. Clean dist folder
2. Bump up the version of the package
3. Build the package

Luckily we provide a script for doing all of this python scripts/prepare.py patch. Alternatively you can run the script in a poetry context poetry run prepare patch. The argument at the end defines whether you want a patch, minor or major version bump.

The final zipped data ends up in the dist folder.

Publish Package

Test package publication

1. Add test PyPi repository: poetry config repositories.testpypi https://test.pypi.org/legacy/
2. Publish the package to the test repository: poetry publish -r testpypi
3. Test package: pip install --index-url https://test.pypi.org/simple/ nwon_baseline

If everything works fine publish the package via poetry publish.