This is the runner for ActiveData recipes, it provides a command line interface and flask web app. ActiveData is a large data warehouse containing billions of records related to Mozilla's CI, version control, bug tracking and much more. An ActiveData "recipe" is a Python snippet that runs one or more queries against ActiveData, then performs some post-processing before returning the results.

Other than a handful of built-in recipes, this repo doesn't contain any actual recipes itself. Those live in project specific repositories that will typically depend on some version of this library. The recommended way to run a recipe is to follow the README of the desired recipe project rather than starting here.

Here are some of the known repositories containing ActiveData recipes:

• active-data-recipes - Misc recipes that are mostly untriaged. Good for finding examples to copy from.

Although installing adr directly is not recommended, it is still supported:

$ pip install adr

You will need Python 3.6 or higher.

The adr binary will search for recipes that live under $CWD, so usually just changing directories to the repository containing recipes is the best way to ensure adr can discover them.

For a list of available recipes:

$ adr --list

To run a given recipe:

$ adr <recipe> <options>

For recipe specific options see:

$ adr <recipe> -- --help

To contribute to adr first install poetry, then run:

$ git clone https://github.com/mozilla/adr
$ cd adr
$ poetry install

Now you can use poetry run to perform various development commands:

# run adr
$ poetry run adr <recipe>

# run webapp
$ poetry run adr-app

# run tests
$ poetry run tox

Alternatively activate the poetry shell ahead of time:

$ poetry shell

# run adr
$ adr <recipe>

# run app
$ adr-app

# run tests
$ tox