mozilla / active-data-recipes

A repository of various activedata queries and recipes
Mozilla Public License 2.0
9 stars 24 forks source link

Archived due to ActiveData being decommissioned

Build Status PyPI version

ActiveData Recipes

This is a repository of various ActiveData recipes. A recipe is a small snippet that runs one or more ActiveData queries and returns the output. Queries can sometimes be modified by command line arguments and output can sometimes be post-processed.

Each recipe should try to answer a single question.

Installation

First install poetry, then run:

$ git clone https://github.com/mozilla/active-data-recipes
$ cd active-data-recipes
$ poetry install

You will need Python 3.6 or higher.

Usage

The poetry install command will create a virtualenv with all of the required dependencies installed. You can use poetry run <cmd> to run a single command within the virtualenv context. Or you can use poetry shell to spawn a new shell with the virtualenv activated. The commands below assume you have run the latter.

Run:

$ adr <recipe> <options>

For a list of recipes:

$ adr list

For recipe specific options see:

$ adr <recipe> -- --help

To serve the web app locally:

$ adr-app

Recipes

See the recipe documentation for more information on which recipes are available and how to run them.

Development

To contribute to active-data-recipes first follow the installation steps above. You can run tests with:

$ poetry run tox

Or:

$ poetry shell
$ tox