maykin-common 0.2.0

Re-usable utilities for Maykin Django projects, centrally maintained instead of in default-project.

1 Shared Django utilities

Version:

0.2.0

Re-usable utilities for Maykin Django projects.

Maykin’s Django projects all share a common base: default-project to provide a consistent and recognizable structure accross projects. This library bundles some shared utilities that are common in (most) projects but are too small/specific to warrant a separate library.

maykin-common acts as a vehicle to quickly propagate changes and useful helpers to a large number of projects that would otherwise all have to be updated manually and one-by-one, a labour-intensive task.

What’s up with the name?

A similar utility for the client side exists: https://github.com/maykinmedia/client-common so we wanted to mimick this naming pattern. The NPM package has namespacing: @maykinmedia/client-common, but this doesn’t exist on PyPI, while using django-common as a PyPI package name might just be a bit arrogant.

So, the repository maykinmedia/django-common perfectly covers the contents and purpose of the package, while the PyPI package keeps the imports short and focused: maykin_common, while leaving room for potential future non-Django packages.

Contents

• 1 Shared Django utilities

• 2 Installation and usage

• 3 Local development

2 Installation and usage

See the documentation: https://maykin-django-common.readthedocs.io/en/latest/

3 Local development

To install and develop the library locally, use:

pip install -e .[tests,docs,release,pdf,mfa,axes]

When running management commands via django-admin, make sure to add the root directory to the python path (or use python -m django <command>):

export PYTHONPATH=. DJANGO_SETTINGS_MODULE=testapp.settings
django-admin check
# or other commands like:
# django-admin makemessages -l nl

Run the tests with:

tox

Note that if you run pytest directly, some tests are expected to fail when you have all optional dependency groups installed.