|
1 | 1 | # Contributing
|
2 | 2 |
|
3 |
| -## Test Coverage |
4 |
| - |
5 |
| -To contribute to Consulate, please make sure that any new features or changes |
6 |
| -to existing functionality **include test coverage**. |
7 |
| - |
8 |
| -*Pull requests that add or change code without coverage have a much lower chance |
9 |
| -of being accepted.* |
10 |
| - |
11 |
| -## Prerequisites |
12 |
| - |
13 |
| -Consulate test suite has a couple of requirements: |
14 |
| - |
15 |
| - * Dependencies from [requires/testing.txt](requires/testing.txt) are installed |
16 |
| - * Local Docker and [docker-compose](https://docs.docker.com/compose/) |
17 |
| - |
18 |
| -## Installing Dependencies |
19 |
| - |
20 |
| -You may want to develop in a virtual environment. This is usually done inside the source |
21 |
| -repository, and `.gitignore` is configured to ignore a virtual environment in `env`. |
22 |
| - |
23 |
| -```bash |
24 |
| -python3 -m venv env |
25 |
| -source env/bin/activate |
26 |
| -``` |
27 |
| - |
28 |
| -To install the dependencies needed to run Consulate tests, use |
29 |
| - |
30 |
| -```bash |
31 |
| -pip install -r requires/testing.txt |
32 |
| -``` |
33 |
| - |
34 |
| -## Starting the test dependency |
35 |
| - |
36 |
| -Prior to running tests, ensure that Consul is running via Docker using: |
37 |
| - |
38 |
| -```bash |
39 |
| -./bootstrap |
40 |
| -``` |
41 |
| - |
42 |
| -This script uses [docker-compose](https://docs.docker.com/compose/) to launch a Consul server container that is |
43 |
| -pre-configured for the tests. In addition, it configures `build/test-environment` that is loaded |
44 |
| -by the tests with configuration information for connecting to Consul. |
45 |
| - |
46 |
| -## Running Tests |
47 |
| - |
48 |
| -To run all test suites, run: |
49 |
| - |
50 |
| - nosetests |
51 |
| - |
52 |
| -## Code Formatting |
53 |
| - |
54 |
| -Please format your code using [yapf](http://pypi.python.org/pypi/yapf) |
55 |
| -with ``pep8`` style prior to issuing your pull request. In addition, run |
56 |
| -``flake8`` to look for any style errors prior to submitting your PR. |
57 |
| - |
58 |
| -Both are included when the test requirements are installed. If you are fixing |
59 |
| -formatting for existing code, please separate code-reformatting commits from |
60 |
| -functionality changes. |
| 3 | +See this [webpage](https://python-microservices.github.io/contributing/) |
0 commit comments