Metadata-Version: 2.4
Name: django-admin-list-charts
Version: 0.2.0
Summary: Super simple bar charts for django admin list views visualizing the number of objects based on date_hierarchy using Chart.js.
Home-page: https://github.com/foorilla/django-admin-list-charts
Author: foorilla LLC
Author-email: pat@foorilla.com
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Classifier: Framework :: Django :: 6.0
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12,<3.15
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Django<7,>=5
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# django-admin-list-charts
Super simple bar charts for django admin list views visualizing the number of objects based on date_hierarchy using Chart.js.

This package serves as a ready-made drop-in solution with Chart.js included.
This way you can super-charge your django admin with date-based bar charts in less than a minute :)

## Examples

![Example 1: Django admin list charts on with bright theme](https://github.com/foorilla/django-admin-list-charts/raw/main/django-admin-list-charts_example_1_bright_screen.png)

![Example 1: Django admin list charts on with dark theme](https://github.com/foorilla/django-admin-list-charts/raw/main/django-admin-list-charts_example_2_dark_screen.png)

## Requirements

* `Python>=3.12,<3.15`
* `Django>=5,<7`

## Compatibility update

This release updates package metadata for modern supported runtimes and is intended for Django 5.x-6.x projects running on Python 3.12-3.14.

## Installation

1. Install Django admin list charts from PyPI by using `pip`:

	`pip install django-admin-list-charts`

2. Add `'admin_list_charts'` entry to Django `INSTALLED_APPS` setting.

3. Sprinkle some `ListChartMixin` over every admin class where you want to display charts in the admin list view. For example:

```	
    ...
    from admin_list_charts.admin import ListChartMixin
    
    @admin.register(Foo)
    class FooAdmin(ListChartMixin, admin.ModelAdmin):
	    date_hierarchy = 'created'
	    ...
```

4. Done!

## Acknowledgements

This rather pragmatic solution was heavily inspired by the work of Dani Hodovic (see [https://findwork.dev/blog/adding-charts-to-django-admin/](https://findwork.dev/blog/adding-charts-to-django-admin/)).
