django-features

A collection of fearures used in our Django-based web applications

Installation

pip install ftw-django-features

Usage

Add desired app to INSTALLED_APPS in your Django project.

Available apps:

django_features.system_message
django_features.custom_fields

Configuration

If you want to use django_features, your base configuration class should inherit from django_features.settings.BaseConfiguration.

from django_features.settings import BaseConfiguration


class Base(BaseConfiguration):
    ...

Custom Fields

To use all features of the django_features.custom_fields app, the following steps are required:

Add the django_features.custom_fields.routers.custom_field_router to your ROOT_URLCONF. For example:

path("api/", include(custom_field_router.urls)),

Create your own custom field and value models

You need to create a custom field model and a custom value model.
Your custom field model should inherit from django_features.custom_fields.models.field.AbstractBaseCustomField.
Your custom value model should inherit from django_features.custom_fields.models.value.AbstractBaseCustomValue.

Configuration

You can configure the models used by the django_features.custom_fields app by setting the CUSTOM_FIELD_MODEL or CUSTOM_FIELD_VALUE_MODEL setting.
The swapped models should inherit from django_features.custom_fields.models.field.AbstractBaseCustomField or django_features.custom_fields.models.value.AbstractBaseCustomValue.

Models with custom values

Your models with custom values should inherit from django_features.custom_fields.models.CustomFieldBaseModel.
Your models should have a relation to the custom value model. For example:
- custom_values = models.ManyToManyField(blank=True, to=CustomValue, verbose_name=_("Benutzerdefinierte Werte"))

Querysets

Your querysets for the models with custom values should inherit from django_features.custom_fields.models.CustomFieldModelBaseManager.

Serializers

Your serializers for the models with custom values should inherit from django_features.custom_fields.serializers.CustomFieldBaseModelSerializer.

System Message

If you want to use django_features.system_message, your base configuration class should inherit from django_features.system_message.settings.SystemMessageConfigurationMixin.

Then call the super property:

@property
def CONSTANCE_CONFIG(self) -> dict:
    config = super().CONSTANCE_CONFIG
    return {**config, ...}

@property
def CONSTANCE_CONFIG_FIELDSETS(self) -> dict:
    config = super().CONSTANCE_CONFIG_FIELDSETS
    return {
        **config,
        ...
    }

Add the django_features.system_message.routers.system_message_router to your ROOT_URLCONF. For example:

path("api/", include(system_message_router.urls)),

Development

Installing dependencies, assuming you have poetry installed:

poetry install

Release

This package uses towncrier to manage the changelog, and to introduce new changes, a file with a concise title and a brief explanation of what the change accomplishes should be created in the changes directory, with a suffix indicating whether the change is a feature, bugfix, or other.

To make a release and publish it to PyPI, the following command can be executed:

./bin/release

This script utilizes zest.releaser and towncrier to create the release, build the wheel, and publish it to PyPI.

Before running the release command, it is necessary to configure poetry with an access token for PyPI by executing the following command and inserting the token stored in 1password:

poetry config pypi-token.pypi <token>

The version attribute in the pyproject.toml file should be updated to the new version before running the release command, because this version will be published to PyPI.

Release files for ftw-django-features 2026.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ftw-django-features 2026.4.0
File	Size	Uploaded
ftw_django_features-2026.4.0.tar.gz	24.7 kB	Aug 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ftw-django-features 2026.4.0
File	Interpreter	ABI	Platform	Reset
ftw_django_features-2026.4.0-py3-none-any.whl 42.4 kB Aug 17, 2026	Python 3	none	any	Details

Total release size: 67.1 kB

Release files / ftw_django_features-2026.4.0.tar.gz

Download URL	ftw_django_features-2026.4.0.tar.gz
Size	24.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`4ff9f42e40ba14bfc65edef2412035dcb39bc3aef6c870d7a47c988d78ad8c10`
BLAKE2b-256 checksum How to use checksums	`a707d74996df353b51a2717528af1d73b29fca654d01e69a64c0d18ac86f3cf3`
Upload date	Aug 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.4.0 CPython/3.13.13 Darwin/24.6.0`

Release files / ftw_django_features-2026.4.0-py3-none-any.whl

Download URL	ftw_django_features-2026.4.0-py3-none-any.whl
Size	42.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c5eee8052a02ab784b09d5775652b3de8d57e2de8277a2ffeca6ddd1c3b62a4a`
BLAKE2b-256 checksum How to use checksums	`44a996be709fe36b689940183f71973f55b3856c6c39279a82731f246aca50b3`
Upload date	Aug 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.4.0 CPython/3.13.13 Darwin/24.6.0`