sanic/docs/contributing.md

# How to contribute to Sanic

Thank you for your interest!

## Setting up the dev environment

It is ideal to create a virtual environment whenever you want to work on
a python project. **Note:** This is not a necessity to work on sanic.

Create a a new virtual environment if you dont have one, using:

`python3 -m venv <any name>`

Enable it using:

`. <any name>/bin/activate`

Get the source of sanic:

`git clone https://github.com/channelcat/sanic`

`cd sanic`

Install sanic :

`python setup.py install`

Install the dev dependencies:

`pip install -r requirements-dev.txt`

Create a new branch for your bugfix or feature:

`git checkout -b <branch name>`

Now you can start working on sanic.

## Tests

Install pytest and flake8:

`pip install pytest`

`pip install flake8`

Run the tests:

 `pytest tests`

 Ensure your code is properly linted using flake8:

 `flake8 sanic/`

 ## Pull request

 Once all tests have passed send out a PR.

## Warning
One of the main goals of Sanic is speed.  Code that lowers the performance of Sanic without significant gains in usability, security, or features may not be merged.