1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
# Contributing
If you want to participate in this project, please follow this guidline.
Fork and clone this repository:
```bash
git clone git@github.com:your-username/osmapi.git
```
Install the dependencies using `pip`:
```bash
pip install -r requirements.txt
pip install -r test-requirements.txt
```
Make sure the tests pass:
```bash
nosetests --verbose
```
You can even run the tests on different versions of Python with `tox`:
```bash
tox
```
To ensure a good quality of the code use `flake8` to check the code style:
```bash
flake8 --install-hook
```
## Create a pull request
1. Choose the `develop` branch as a target for new/changed functionality, `master` should only be targeted for urgent bugfixes.
2. While it's not strictly required, it's highly recommended to create a new branch on your fork for each pull request.
3. Push to your fork and [submit a pull request][pr].
4. Check if the [build ran successfully][ci] and try to improve your code if not.
At this point you're waiting for my review.
I might suggest some changes or improvements or alternatives.
Some things that will increase the chance that your pull request is accepted:
* Write tests.
* Follow the Python style guide ([PEP-8][pep8]).
* Write a [good commit message][commit].
[pr]: https://github.com/metaodi/osmapi/compare/
[ci]: https://travis-ci.org/metaodi/osmapi
[pep8]: https://www.python.org/dev/peps/pep-0008/
[commit]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
|
