Skip to content

Latest commit

 

History

History
85 lines (46 loc) · 1.38 KB

CONTRIBUTING.rst

File metadata and controls

85 lines (46 loc) · 1.38 KB

Getting Started

Prerequisites

  • Git
  • Python

Get the code

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

$ git clone [email protected]:BriefyHQ/briefy.alexandria.git

Local Install

Access the directory containing briefy.alexandria codebase:

$ cd briefy.alexandria

Create a virtual environment:

$ python3 -m venv .

Install package & dependencies

For development:

$ ./bin/pip install -r requirements/dev.txt

For staging / production:

$ ./bin/pip install -r requirements.txt

Running tests

Run all tests:

$ make tests

Check style:

$ make lint

To run just a subset of the tests:

$ ./bin/py.test tests/foo

Reporting Bugs

Report bugs at https://github.com/BriefyHQ/briefy.alexandria/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:

$ ./bin/pip install -r requirements/dev.txt

Generate the HTML documentation:

$ make docs_server

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