Metadata-Version: 2.4
Name: django-watchman
Version: 1.5.0
Summary: django-watchman exposes a status endpoint for your backing services
Project-URL: Homepage, https://github.com/mwarkentin/django-watchman
Project-URL: Documentation, https://django-watchman.readthedocs.io
Project-URL: Repository, https://github.com/mwarkentin/django-watchman
Project-URL: Changelog, https://github.com/mwarkentin/django-watchman/blob/main/CHANGELOG.md
Author-email: Michael Warkentin <mwarkentin@gmail.com>
License-Expression: BSD-3-Clause
License-File: AUTHORS.md
License-File: LICENSE
Keywords: django,health-check,status,watchman
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
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
Requires-Python: >=3.10
Requires-Dist: django>=4.2
Description-Content-Type: text/markdown

# django-watchman

[![PyPI version](http://img.shields.io/pypi/v/django-watchman.svg)](http://badge.fury.io/py/django-watchman)
[![Coverage](http://img.shields.io/coveralls/mwarkentin/django-watchman.svg)](https://coveralls.io/r/mwarkentin/django-watchman?branch=main)

django-watchman exposes a status endpoint for your backing services like
databases, caches, etc.

![Ozymandias](https://mwarkentin-snaps.s3.amazonaws.com/Watchmen_The_One_Thing_Nobody_Says_about_Adrian_Veidt_aka_Ozymandias_2022-03-23_08-36-18.png)

## Documentation

The full documentation is at [django-watchman.readthedocs.io](https://django-watchman.readthedocs.io).

## Testimonials

> We're in love with django-watchman. External monitoring is a vital part of our service offering. Using django-watchman we can introspect the infrastructure of an application via a secure URL. It's very well written and easy to extend. We've recommended it to many of our clients already.

-- Hany Fahim, CEO, [VM Farms](https://vmfarms.com/).

## Quickstart

1. Install `django-watchman`:

    ```bash
    pip install django-watchman
    ```

    Or with [uv](https://docs.astral.sh/uv/):

    ```bash
    uv add django-watchman
    ```

2. Add `watchman` to your `INSTALLED_APPS` setting:

    ```python
    INSTALLED_APPS = (
        ...
        'watchman',
    )
    ```

3. Include the watchman URLconf in your project `urls.py`:

    ```python
    re_path(r'^watchman/', include('watchman.urls')),
    ```

4. Start the development server and visit `http://127.0.0.1:8000/watchman/` to
   get a JSON response of your backing service statuses:

    ```json
    {
        "databases": [
            {
                "default": {
                    "ok": true
                }
            }
        ],
        "caches": [
            {
                "default": {
                    "ok": true
                }
            }
        ],
        "storage": {"ok": true}
    }
    ```

## License

BSD-3-Clause
