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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
Contributing to pycodestyle
===========================
When contributing to pycodestyle, please observe our `Code of Conduct`_.
Step 1: Forking pycodestyle for editing
---------------------------------------
Fork the pycodestyle repository on GitHub. This will add
pycodestyle to your GitHub account. You will push your changes to your
fork and then make pull requests into the official pycodestyle repository.
GitHub has an excellent `guide`_ that has screenshots on how to do this.
Next, clone your fork of the pycodestyle repository to your system for
editing::
$ git clone https://www.github.com/<your_username>/pycodestyle
Now you have a copy of the pycodestyle codebase that is almost ready for
edits. Next we will setup `virtualenv`_ which will help create an isolated
environment to manage dependencies.
Step 2: Use virtualenv when developing
--------------------------------------
`virtualenv`_ is a tool to create isolated python environments.
First, install virtualenv with::
$ pip install virtualenv
Next, ``cd`` to the pycodestyle repository that you cloned earlier and
create, then activate a virtualenv::
$ cd pycodestyle
$ virtualenv venv-pycodestyle
$ source venv-pycodestyle/bin/activate
Note that ``venv*/`` is ignored via ``.gitignore``.
Now you can install the pycodestyle requirements::
$ pip install -r dev-requirements.txt
To deactivate the virtualenv you can type::
$ deactivate
For more information see `virtualenv`_'s documentation.
Step 3: Run tests
-----------------
Before creating a pull request you should run the tests to make sure that the
changes that have been made haven't caused any regressions in functionality.
To run the tests, the core developer team and GitHub Actions use `tox`_::
$ pip install -r dev-requirements.txt
$ tox
All the tests should pass for all available interpreters, with the summary of::
congratulations :)
At this point you can create a pull request back to the official pycodestyle
repository for review! For more information on how to make a pull request,
GitHub has an excellent `guide`_.
The current tests are written in 2 styles:
* pytest tests
* functional test using a custom framework
Running tests
~~~~~~~~~~~~~
The tests are written using ``pytest``, the existing tests
include unit, integration and functional tests.
To run the tests::
$ pytest tests
Running functional
~~~~~~~~~~~~~~~~~~
$ pip install -e .
$ # Run all tests.
$ pytest tests/test_data.py
$ # Run a subset of the tests.
$ pytest tests/tests_data.py -k testing/data/E30.py
.. _virtualenv: http://docs.python-guide.org/en/latest/dev/virtualenvs/
.. _guide: https://guides.github.com/activities/forking/
.. _tox: https://tox.readthedocs.io/en/latest/
.. _Code of Conduct: http://meta.pycqa.org/en/latest/code-of-conduct.html
|
