Metadata-Version: 2.4
Name: clock-box
Version: 0.1.0
Summary: Request recording and replay debugging middleware for Django
Author: ashi
Classifier: Framework :: Django
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Django>=3.2
Dynamic: license-file

# BlackBox

BLACKBOX is a Django middleware that records failing HTTP requests
and allows replay and regression debugging.
in a controlled db safe env.
configurable by user.

## Features

- Automatic request recording
- Replay engine
- Response diff detection
- Regression detection

## Installation

pip install blackbox

##through git

pip install git+https://github.com/AuxSHii/blackbox-middleware.git

## Usage

Add to INSTALLED_APPS:

    "blackbox"

Add middleware:

    "blackbox.middleware.BlackBoxMiddleware"

#confugure in project seettings

BLACKBOX={
   "ENABLED": True,               #master switch
   "RECORD_STATUS_CODES": [500],  # only record 500 i.e. server crashes
   "IGNORE_PATHS": ["/admin"],    # ignore admin panel = noise
   "MAX_REPLAY_PER_REQUEST": 3,      #keep only latest n replays i.e.5 here configured
   "DUPLICATE_IDENTICAL": True,       #deleeting spam replays
   "REPLAY_TTL_DAYS":14,
}
