Skip to main content

django-updater

https://djangoupdater.com/static/images/logo.png
https://badge.fury.io/py/django-updater.png https://travis-ci.org/jayfk/django-updater.svg?branch=master

Displays a warning message in the admin when the used Django version is insecure or outdated and provides a management command (or celery task) that checks for updates periodically.

Documentation

The full documentation is at https://django-updater.readthedocs.org.

Quickstart

Install django-updater:

pip install django-updater

Then, add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    "updater",
)

If you want to enable it in the admin area, make sure to put updater before django.contrib.admin:

INSTALLED_APPS = (
    ...
    "updater",
    "django.contrib.admin",
)

Usage

If you have django-updater enabled in the admin area, it will display a info/warning message when there are updates available automatically.

In order to check for updates in an automated fashion, django-updater has to be called periodically. There are two ways to accomplish that:

  • Running a periodic Celery task

  • Create a cronjob

Celery

If you are using Celery and have a celery beat daemon running, enable Celery support in your settings with:

from datetime import timedelta

CELERYBEAT_SCHEDULE = {
    'run-django-updater': {
        'task': 'updater.tasks.run_check',
        'schedule': timedelta(days=1),
    },
}

And you are good to go!

Cronjob

You can use a cronjob to check for updates once a day.

To set up a cronjob, run:

crontab -e

And then add:

30 2 * * * python /path/to/your/apps/manage.py check_for_updates

If you are using a virtual environment, you might need to point to the python executable your virtual environment is using:

30 2 * * * /path/to/virtual/environment/bin/python /path/to/your/apps/manage.py check_for_updates

Screenshots

https://djangoupdater.com/static/images/security_mail.png
https://djangoupdater.com/static/images/update_mail.png

History

0.3.3 (2015-10-23)

  • Added a lot of tests

  • Simplified management commands

  • Some small refactorings

0.4.0 (2015-10-25)

  • Now compatible with Django 1.4 - 1.9

0.3.2 (2015-10-13)

  • Fixed an error with squashed migrations

0.3.1 (2015-10-13)

  • Squashed migrations

0.3.0 (2015-09-24)

  • Added registration view

0.2.2 (2015-09-24)

  • Refactored models

  • Added admin page

  • Reworked registration process

0.2.1 (2015-09-14)

  • Added callback token

0.2.0 (2015-09-09)

  • Major refactoring

0.1.8 (2015-09-08)

  • Fixed small typo

0.1.7 (2015-09-08)

  • Added notification service

  • Added inline documentation

  • Small refactorings

0.1.6 (2015-09-07)

  • Added online service registration

  • Fixed minor issues

0.1.5 (2015-08-19)

  • Fixed minor issues

0.1.4 (2015-08-19)

  • Fixed packaging issue

0.1.3 (2015-08-19)

  • Temporarily fixing piprot issue with pytz

0.1.2 (2015-08-19)

  • Added package requirements

0.1.1 (2015-08-19)

  • Switched to pip.get_installed_distributions to get a package list

  • minor documentation tweaks

0.1.0 (2015-08-19)

  • First release on PyPI.

Metadata

Release files for django-updater 0.5.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 django-updater 0.5.0
File Size Uploaded Provenance Actions
django-updater-0.5.0.tar.gz 11.3 kB Without provenance Details for django-updater-0.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for django-updater 0.5.0
File Interpreter ABI Platform Actions
django_updater-0.5.0-py2.py3-none-any.whl Python 3, Python 2 none any Details for django_updater-0.5.0-py2.py3-none-any.whl

Total release size: 40.1 kB

Release files / django-updater-0.5.0.tar.gz

Download URL django-updater-0.5.0.tar.gz
Size 11.3 kB
Tags Source
SHA-256 checksum
How to use checksums
69a80c07142c095cecb8dec72e30b3c9a7dc84a22b41968912b40159ed8bff23
BLAKE2b-256 checksum
How to use checksums
40234ee576e948d308df9fe9de82420b548782289d93b780dee31e927aef813b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / django_updater-0.5.0-py2.py3-none-any.whl

Download URL django_updater-0.5.0-py2.py3-none-any.whl
Size 28.7 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
39ccc2a07bd7ec0f1a754d84bc9fa284ed05ab188b1ba9236d386be8b2627142
BLAKE2b-256 checksum
How to use checksums
da81fc31abc836ce2a94d8415178d2518a2760583102265ceae92c94d0f012d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for django-updater 0.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page