Metadata-Version: 2.1
Name: proofdock-chaos-middleware-django
Version: 0.1.0
Summary: A chaos engineering middleware for Python Django applications.
Home-page: https://github.com/proofdock/chaos-middleware-python/tree/master/src/contrib-django
Author: Proofdock Authors
Author-email: support@proofdock.io
License: Apache-2.0
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.5.*
Description-Content-Type: text/markdown
Requires-Dist: django
Requires-Dist: proofdock-chaos-middleware-python

# Chaos Middleware Django integration

![CI](https://github.com/proofdock/chaos-middleware-python/workflows/CI/badge.svg?branch=master)
[![Python versions](https://img.shields.io/pypi/pyversions/proofdock-chaos-middleware-django.svg)](https://www.python.org/)

## Install

This package requires Python 3.5+

```
$ pip install -U proofdock-chaos-middleware-django
```

## Usage

The chaos middleware takes the following **input variables**:

| Variable | Description |
| ---      | ---         |
| `CHAOS_MIDDLEWARE_APPLICATION_NAME` | The service application's name |
| `CHAOS_MIDDLEWARE_APPLICATION_ENV` | The service application's deployed environment |
| `CHAOS_MIDDLEWARE_PROOFDOCK_API_TOKEN` | The API token to connect to Proofdock's Chaos API |

The **configuration** exemplified as **code**:

```python
# file: settings.py
MIDDLEWARE = [
    '..'
    'pdchaos.middleware.contrib.django.django_middleware.DjangoMiddleware',
    '..'
]

# other settings ...

CHAOS_MIDDLEWARE = {
    'CHAOS_MIDDLEWARE_APPLICATION_NAME': 'example-application-name',
    'CHAOS_MIDDLEWARE_APPLICATION_ENV': 'example-environment',
    'CHAOS_MIDDLEWARE_PROOFDOCK_API_TOKEN': 'eyJ0eXAi...05'
}
```

## References

- [Chaos Middleware documentation][proofdock_middleware_docs]
- [Chaos Middleware repository][proofdock_middleware_repo]
- [Support][proofdock_support]
- [Proofdock website][proofdock]

[proofdock]: https://proofdock.io/
[proofdock_middleware_docs]: https://docs.proofdock.io/chaos/middleware/about/
[proofdock_support]: https://github.com/proofdock/chaos-support/
[proofdock_middleware_repo]: https://github.com/proofdock/chaos-middleware-python


