Skip to content

Latest commit

 

History

History
83 lines (49 loc) · 1.54 KB

CONTRIBUTING.rst

File metadata and controls

83 lines (49 loc) · 1.54 KB

Getting Started

Prerequisites

  • Git
  • Python 3.5

Get the code

Having you privileges to access the codebase on GitHub, execute the following command on a shell prompt:

$ git clone git@github.com:BriefyHQ/briefy.choreographer.git

Local Install

Access the directory containing briefy.choreographer codebase:

$ cd briefy.choreographer

Create a virtual environment and activate it:

$ python3 -m venv env
$ source env/bin/activate

Install package & dependencies

For development:

(env)$ pip install -r requirements/dev.txt

For staging / production:

(env)$ pip install -r requirements.txt

Running tests

To run all tests, first, it is needed to setup a mock server for AWS SQS:

(env)$ make run_dockers

Run all tests:

(env)$ make test

Check style:

(env)$ make lint

To run just a subset of the tests:

(env)$ py.test tests/queue

Reporting Bugs

Report bugs at https://github.com/BriefyHQ/briefy.choreographer/issues.

If you are reporting a bug, please include:

  • Your operating system name and version.
  • Any details about your local setup that might be helpful in troubleshooting.
  • Detailed steps to reproduce the bug.

Generating the documentation

Install this package and its dependencies:

(env)$ pip install -r requirements/dev.txt

Generate the HTML documentation:

(env)$ make docs_server

Open the your browser at http://localhost:8000