django-saladbar 0.1.0__tar.gz

django_saladbar-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brian Artschwager
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_saladbar-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+recursive-include src/saladbar/templates *
+recursive-include src/saladbar/static *

django_saladbar-0.1.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: django-saladbar
+Version: 0.1.0
+Summary: A Celery task monitoring dashboard for Django
+Author: Brian Artschwager
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/bartschwager/django-saladbar
+Project-URL: Repository, https://github.com/bartschwager/django-saladbar
+Project-URL: Changelog, https://github.com/bartschwager/django-saladbar/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/bartschwager/django-saladbar/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Celery
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=4.2
+Requires-Dist: celery>=5.0
+Requires-Dist: redis>=4.0
+Requires-Dist: django-celery-beat>=2.5
+Requires-Dist: django-celery-results>=2.5
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# django-saladbar
+
+A Celery task monitoring dashboard for Django. Drop-in UI for monitoring workers, periodic tasks, queue depth, error grouping, and more.
+
+## Requirements
+
+- Python 3.10+
+- Django 4.2+
+- Celery 5.0+ with Redis broker
+- django-celery-beat
+- django-celery-results
+
+## Installation
+
+```bash
+pip install django-saladbar
+```
+
+Add to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "django_celery_results",
+    "django_celery_beat",
+    "saladbar",
+]
+```
+
+Include the URL conf:
+
+```python
+from django.urls import include, path
+
+urlpatterns = [
+    # ...
+    path("saladbar/", include("saladbar.urls")),
+]
+```
+
+Run migrations:
+
+```bash
+python manage.py migrate
+```
+
+## Configuration
+
+All settings are optional. Add to your Django `settings.py`:
+
+```python
+# Template that saladbar pages extend.
+# Must provide blocks: title, css, content, script-footer.
+# Default: "saladbar/base.html" (ships with the package — includes Bootstrap 5 + FontAwesome)
+SALADBAR_BASE_TEMPLATE = "myapp/base.html"
+
+# Dotted path to your Celery app instance.
+# Default: auto-discovered via celery.current_app
+SALADBAR_CELERY_APP = "myproject.celery.app"
+
+# Queue names to check for depth on the dashboard.
+# Default: ("celery", "default", "bulk")
+SALADBAR_QUEUE_NAMES = ("celery", "default", "high-priority")
+```
+
+## Permissions
+
+Saladbar defines two permissions:
+
+- `saladbar.can_view_saladbar` — required to access the dashboard and all read-only pages
+- `saladbar.can_manage_saladbar` — required to run tasks, revoke tasks, and purge queues
+
+Assign these to users or groups via the Django admin.
+
+> **Security note:** Saladbar exposes Celery task metadata — task names, arguments, results, tracebacks, worker info, and Redis broker stats — to users with `can_view_saladbar`. Users with `can_manage_saladbar` can execute, revoke, and purge tasks. **Grant these permissions carefully.**
+
+## Features
+
+- Real-time worker status and pool utilization
+- 24h/7d task volume charts
+- Periodic task health tracking (on-schedule / missed / never-run)
+- 24-hour schedule timeline visualization
+- Queue depth and throughput monitoring
+- Redis broker info (memory, clients, hit rate, evictions)
+- In-flight task monitoring with long-running detection
+- Error grouping by exception type
+- Top tasks by volume with trend indicators
+- Slowest tasks by average runtime
+- Per-queue statistics
+- Stale task detection
+- Task execution history with runtime trend charts
+- Manual task execution and revocation
+- Queue purge
+- Auto-refresh with countdown timer
+
+## Development
+
+```bash
+git clone https://github.com/bartschwager/django-saladbar.git
+cd django-saladbar
+pip install -e ".[dev]"
+```
+
+## License
+
+MIT

django_saladbar-0.1.0/README.md

@@ -0,0 +1,106 @@
+# django-saladbar
+
+A Celery task monitoring dashboard for Django. Drop-in UI for monitoring workers, periodic tasks, queue depth, error grouping, and more.
+
+## Requirements
+
+- Python 3.10+
+- Django 4.2+
+- Celery 5.0+ with Redis broker
+- django-celery-beat
+- django-celery-results
+
+## Installation
+
+```bash
+pip install django-saladbar
+```
+
+Add to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "django_celery_results",
+    "django_celery_beat",
+    "saladbar",
+]
+```
+
+Include the URL conf:
+
+```python
+from django.urls import include, path
+
+urlpatterns = [
+    # ...
+    path("saladbar/", include("saladbar.urls")),
+]
+```
+
+Run migrations:
+
+```bash
+python manage.py migrate
+```
+
+## Configuration
+
+All settings are optional. Add to your Django `settings.py`:
+
+```python
+# Template that saladbar pages extend.
+# Must provide blocks: title, css, content, script-footer.
+# Default: "saladbar/base.html" (ships with the package — includes Bootstrap 5 + FontAwesome)
+SALADBAR_BASE_TEMPLATE = "myapp/base.html"
+
+# Dotted path to your Celery app instance.
+# Default: auto-discovered via celery.current_app
+SALADBAR_CELERY_APP = "myproject.celery.app"
+
+# Queue names to check for depth on the dashboard.
+# Default: ("celery", "default", "bulk")
+SALADBAR_QUEUE_NAMES = ("celery", "default", "high-priority")
+```
+
+## Permissions
+
+Saladbar defines two permissions:
+
+- `saladbar.can_view_saladbar` — required to access the dashboard and all read-only pages
+- `saladbar.can_manage_saladbar` — required to run tasks, revoke tasks, and purge queues
+
+Assign these to users or groups via the Django admin.
+
+> **Security note:** Saladbar exposes Celery task metadata — task names, arguments, results, tracebacks, worker info, and Redis broker stats — to users with `can_view_saladbar`. Users with `can_manage_saladbar` can execute, revoke, and purge tasks. **Grant these permissions carefully.**
+
+## Features
+
+- Real-time worker status and pool utilization
+- 24h/7d task volume charts
+- Periodic task health tracking (on-schedule / missed / never-run)
+- 24-hour schedule timeline visualization
+- Queue depth and throughput monitoring
+- Redis broker info (memory, clients, hit rate, evictions)
+- In-flight task monitoring with long-running detection
+- Error grouping by exception type
+- Top tasks by volume with trend indicators
+- Slowest tasks by average runtime
+- Per-queue statistics
+- Stale task detection
+- Task execution history with runtime trend charts
+- Manual task execution and revocation
+- Queue purge
+- Auto-refresh with countdown timer
+
+## Development
+
+```bash
+git clone https://github.com/bartschwager/django-saladbar.git
+cd django-saladbar
+pip install -e ".[dev]"
+```
+
+## License
+
+MIT

django_saladbar-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "django-saladbar"
+version = "0.1.0"
+description = "A Celery task monitoring dashboard for Django"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Brian Artschwager" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Framework :: Django",
+    "Framework :: Django :: 4.2",
+    "Framework :: Django :: 5.0",
+    "Framework :: Django :: 5.1",
+    "Framework :: Django :: 5.2",
+    "Framework :: Celery",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: System :: Monitoring",
+]
+dependencies = [
+    "Django>=4.2",
+    "celery>=5.0",
+    "redis>=4.0",
+    "django-celery-beat>=2.5",
+    "django-celery-results>=2.5",
+]
+
+[project.optional-dependencies]
+dev = [
+    "build",
+    "twine",
+]
+
+[project.urls]
+Homepage = "https://github.com/bartschwager/django-saladbar"
+Repository = "https://github.com/bartschwager/django-saladbar"
+Changelog = "https://github.com/bartschwager/django-saladbar/blob/main/CHANGELOG.md"
+Issues = "https://github.com/bartschwager/django-saladbar/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

django_saladbar-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

django_saladbar-0.1.0/src/django_saladbar.egg-info/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: django-saladbar
+Version: 0.1.0
+Summary: A Celery task monitoring dashboard for Django
+Author: Brian Artschwager
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/bartschwager/django-saladbar
+Project-URL: Repository, https://github.com/bartschwager/django-saladbar
+Project-URL: Changelog, https://github.com/bartschwager/django-saladbar/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/bartschwager/django-saladbar/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Celery
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=4.2
+Requires-Dist: celery>=5.0
+Requires-Dist: redis>=4.0
+Requires-Dist: django-celery-beat>=2.5
+Requires-Dist: django-celery-results>=2.5
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# django-saladbar
+
+A Celery task monitoring dashboard for Django. Drop-in UI for monitoring workers, periodic tasks, queue depth, error grouping, and more.
+
+## Requirements
+
+- Python 3.10+
+- Django 4.2+
+- Celery 5.0+ with Redis broker
+- django-celery-beat
+- django-celery-results
+
+## Installation
+
+```bash
+pip install django-saladbar
+```
+
+Add to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "django_celery_results",
+    "django_celery_beat",
+    "saladbar",
+]
+```
+
+Include the URL conf:
+
+```python
+from django.urls import include, path
+
+urlpatterns = [
+    # ...
+    path("saladbar/", include("saladbar.urls")),
+]
+```
+
+Run migrations:
+
+```bash
+python manage.py migrate
+```
+
+## Configuration
+
+All settings are optional. Add to your Django `settings.py`:
+
+```python
+# Template that saladbar pages extend.
+# Must provide blocks: title, css, content, script-footer.
+# Default: "saladbar/base.html" (ships with the package — includes Bootstrap 5 + FontAwesome)
+SALADBAR_BASE_TEMPLATE = "myapp/base.html"
+
+# Dotted path to your Celery app instance.
+# Default: auto-discovered via celery.current_app
+SALADBAR_CELERY_APP = "myproject.celery.app"
+
+# Queue names to check for depth on the dashboard.
+# Default: ("celery", "default", "bulk")
+SALADBAR_QUEUE_NAMES = ("celery", "default", "high-priority")
+```
+
+## Permissions
+
+Saladbar defines two permissions:
+
+- `saladbar.can_view_saladbar` — required to access the dashboard and all read-only pages
+- `saladbar.can_manage_saladbar` — required to run tasks, revoke tasks, and purge queues
+
+Assign these to users or groups via the Django admin.
+
+> **Security note:** Saladbar exposes Celery task metadata — task names, arguments, results, tracebacks, worker info, and Redis broker stats — to users with `can_view_saladbar`. Users with `can_manage_saladbar` can execute, revoke, and purge tasks. **Grant these permissions carefully.**
+
+## Features
+
+- Real-time worker status and pool utilization
+- 24h/7d task volume charts
+- Periodic task health tracking (on-schedule / missed / never-run)
+- 24-hour schedule timeline visualization
+- Queue depth and throughput monitoring
+- Redis broker info (memory, clients, hit rate, evictions)
+- In-flight task monitoring with long-running detection
+- Error grouping by exception type
+- Top tasks by volume with trend indicators
+- Slowest tasks by average runtime
+- Per-queue statistics
+- Stale task detection
+- Task execution history with runtime trend charts
+- Manual task execution and revocation
+- Queue purge
+- Auto-refresh with countdown timer
+
+## Development
+
+```bash
+git clone https://github.com/bartschwager/django-saladbar.git
+cd django-saladbar
+pip install -e ".[dev]"
+```
+
+## License
+
+MIT

django_saladbar-0.1.0/src/django_saladbar.egg-info/SOURCES.txt

@@ -0,0 +1,31 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+src/django_saladbar.egg-info/PKG-INFO
+src/django_saladbar.egg-info/SOURCES.txt
+src/django_saladbar.egg-info/dependency_links.txt
+src/django_saladbar.egg-info/requires.txt
+src/django_saladbar.egg-info/top_level.txt
+src/saladbar/__init__.py
+src/saladbar/admin.py
+src/saladbar/apps.py
+src/saladbar/conf.py
+src/saladbar/models.py
+src/saladbar/py.typed
+src/saladbar/urls.py
+src/saladbar/views.py
+src/saladbar/migrations/0001_initial.py
+src/saladbar/migrations/__init__.py
+src/saladbar/static/saladbar/js/chart.min.js
+src/saladbar/templates/saladbar/base.html
+src/saladbar/templates/saladbar/dashboard.html
+src/saladbar/templates/saladbar/result_detail.html
+src/saladbar/templates/saladbar/result_list.html
+src/saladbar/templates/saladbar/task_detail.html
+src/saladbar/templates/saladbar/task_list.html
+src/saladbar/templatetags/__init__.py
+src/saladbar/templatetags/saladbar_tags.py
+tests/test_conf.py
+tests/test_helpers.py
+tests/test_views.py

django_saladbar-0.1.0/src/django_saladbar.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

django_saladbar-0.1.0/src/django_saladbar.egg-info/requires.txt

@@ -0,0 +1,9 @@
+Django>=4.2
+celery>=5.0
+redis>=4.0
+django-celery-beat>=2.5
+django-celery-results>=2.5
+
+[dev]
+build
+twine

django_saladbar-0.1.0/src/django_saladbar.egg-info/top_level.txt

@@ -0,0 +1 @@
+saladbar

django_saladbar-0.1.0/src/saladbar/__init__.py

@@ -0,0 +1 @@
+default_app_config = "saladbar.apps.SaladbarConfig"

django_saladbar-0.1.0/src/saladbar/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin  # noqa: F401

django_saladbar-0.1.0/src/saladbar/apps.py

@@ -0,0 +1,7 @@
+from django.apps import AppConfig
+
+
+class SaladbarConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "saladbar"
+    verbose_name = "Salad Bar"

django_saladbar-0.1.0/src/saladbar/conf.py

@@ -0,0 +1,43 @@
+"""
+Saladbar configuration with sensible defaults.
+
+Users can override these in their Django settings module:
+
+    SALADBAR_BASE_TEMPLATE = "myapp/base.html"
+    SALADBAR_CELERY_APP = "myproject.celery.app"
+"""
+
+from django.conf import settings
+
+# Template that all saladbar pages extend. Must provide blocks:
+#   title, css, content, script-footer
+DEFAULT_BASE_TEMPLATE = "saladbar/base.html"
+
+# Dotted path to the Celery app instance, e.g. "myproject.celery.app".
+# When None, saladbar discovers it automatically via celery._state.
+DEFAULT_CELERY_APP = None
+
+# Queue names to check for depth on the dashboard.
+DEFAULT_QUEUE_NAMES = ("celery", "default", "bulk")
+
+
+def get_base_template():
+    return getattr(settings, "SALADBAR_BASE_TEMPLATE", DEFAULT_BASE_TEMPLATE)
+
+
+def get_celery_app():
+    app_path = getattr(settings, "SALADBAR_CELERY_APP", DEFAULT_CELERY_APP)
+    if app_path:
+        from importlib import import_module
+
+        module_path, attr = app_path.rsplit(".", 1)
+        return getattr(import_module(module_path), attr)
+
+    # Auto-discover: grab the current default Celery app
+    from celery import current_app
+
+    return current_app
+
+
+def get_queue_names():
+    return getattr(settings, "SALADBAR_QUEUE_NAMES", DEFAULT_QUEUE_NAMES)

django_saladbar-0.1.0/src/saladbar/migrations/0001_initial.py

@@ -0,0 +1,35 @@
+# Generated by Django 5.2.11 on 2026-04-01 19:43
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="SaladBarPermissions",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+            ],
+            options={
+                "permissions": [
+                    ("can_view_saladbar", "Can view Salad Bar dashboard"),
+                    ("can_manage_saladbar", "Can manage tasks and purge queues"),
+                ],
+                "managed": False,
+                "default_permissions": (),
+            },
+        ),
+    ]

django_saladbar-0.1.0/src/saladbar/models.py

@@ -0,0 +1,13 @@
+from django.db import models
+
+
+class SaladBarPermissions(models.Model):
+    """Unmanaged model solely for defining saladbar permissions."""
+
+    class Meta:
+        managed = False
+        default_permissions = ()
+        permissions = [
+            ("can_view_saladbar", "Can view Salad Bar dashboard"),
+            ("can_manage_saladbar", "Can manage tasks and purge queues"),
+        ]