Skip to content

ambient-innovation/django-removals

Repository files navigation

PyPI release Downloads Coverage Linting Coding Style Documentation Status

Welcome to the django-removals - a maintainer's best friend for finding removed features in your Django project

Features

This package will throw Django system checks warnings for all known removals from Django v1.0 to today.

Here's an example:

Example system check

The checks will either be triggered when using the Django development server

python manage.py runserver

or when you call the checks manually

python manage.py check --deploy

It focuses on Django settings but might also add more checks in the future.

Installation

  • Install the package via pip:

    pip install django-removals

    or via pipenv:

    pipenv install django-removals

  • Add module to INSTALLED_APPS within the main django settings.py:

    INSTALLED_APPS = (
        # ...
        "django_removals",
    )

Since this package adds only Django system checks, which don't run on production, you could add it only when being in (local) debug mode.

if DEBUG_MODE:
    INSTALLED_APPS += ("django_removals",)

Publish to ReadTheDocs.io

  • Fetch the latest changes in GitHub mirror and push them
  • Trigger new build at ReadTheDocs.io (follow instructions in admin panel at RTD) if the GitHub webhook is not yet set up.

Publish to PyPi

  • Update documentation about new/changed functionality

  • Update the Changelog

  • Increment version in main __init__.py

  • Create pull request / merge to main

  • This project uses the flit package to publish to PyPI. Thus, publishing should be as easy as running:

    flit publish
    

    To publish to TestPyPI use the following to ensure that you have set up your .pypirc as shown here and use the following command:

    flit publish --repository testpypi
    

Maintenance

Please note that this package supports the ambient-package-update. So you don't have to worry about the maintenance of this package. This updater is rendering all important configuration and setup files. It works similar to well-known updaters like pyupgrade or django-upgrade.

To run an update, refer to the documentation page of the "ambient-package-update".

About

Package to check for known Django removals and deprecations

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published