Skip to main content

Allow calling registered custom functions (system tools, script functions, etc.) via admin UI or manage.py command.

Project description

django-adminutilities

https://img.shields.io/pypi/v/django-adminutilities.svg

Allow calling registered custom functions (system tools, script functions, etc.) via admin UI or manage.py command.

The inspiration for this library comes from https://github.com/timonweb/django-clearcache.

Installation

  1. Install the package via pip:

    pip install django-adminutilities
  2. Add adminutilities to your INSTALLED_APPS setting like this:

    INSTALLED_APPS = [
         ...
         'adminutilities',
    ]
  3. Add adminutilities.middleware.GetAllAdminToolFunctionsMiddleware to your MIDDLEWARE setting like this:

    MIDDLEWARE = [
         ...
         'adminutilities.middleware.GetAllAdminToolFunctionsMiddleware',
    ]
  4. Add adminutilities to your urls.py:

    urlpatterns = [
         ...
         path('admin/', admin.site.urls),
         path('admin/adminutilities/', include('adminutilities.urls')),
    ]

Usage

  1. Create a new file admin_tools.py in your app folder, and define your custom functions, for example:

    from adminutilities.decorators import admin_tool
    
    @admin_tool
    def my_custom_function():
         return 'Hello, world!'
  2. Go to /admin/adminutilities/ and you will see the registered functions. If you click the function, it will execute the function and show the result.

  3. You can also call the function via manage.py command, need to provide the full path of the function (app_name.function_name), for example:

    python manage.py adminutilities main.my_custom_function

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2024-03-17)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-adminutilities-0.1.4.tar.gz (13.7 kB view hashes)

Uploaded Source

Built Distribution

django_adminutilities-0.1.4-py2.py3-none-any.whl (9.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page