- Submit Pull Requests against the master branch.
- Provide a good description of what you're doing and why.
- Provide tests that cover your changes and try to run the tests locally first.
$ git clone email@example.com:pypa/pip.git $ cd pip # ... $ git diff $ git add <modified> ... $ git status $ git commit
You may reference relevant issues in commit messages (like #1259) to make GitHub link issues and commits together, and with phrase like "fixes #1259" you can even close relevant issues automatically. Now push the changes to your fork:
$ git push firstname.lastname@example.org:yourname/pip.git
Open Pull Requests page at https://github.com/yourname/pip/pulls and click "New pull request". That's it.
Usually, a link to your specific travis build appears in pull requests, but if not, you can find it on our travis pull requests page
The only way to trigger Travis to run again for a pull request, is to submit another change to the pull branch.
We also have Jenkins CI that runs regularly for certain python versions on windows and centos.
OS Requirements: subversion, bazaar, git, and mercurial.
Python Requirements: tox or pytest, virtualenv, scripttest, and mock
Ways to run the tests locally:
$ tox -e py33 # The preferred way to run the tests, can use pyNN to # run for a particular version or leave off the -e to # run for all versions. $ python setup.py test # Using the setuptools test plugin $ py.test # Using py.test directly $ tox # Using tox against pip's tox.ini
If you are missing one of the VCS tools, you can tell
py.test to skip it:
$ py.test -k 'not bzr' $ py.test -k 'not svn'
The pip project welcomes help in the following ways:
- Making Pull Requests for code, tests, or docs.
- Commenting on open issues and pull requests.
- Helping to answer questions on the mailing list.
If you want to become an official maintainer, start by helping out.
Later, when you think you're ready, get in touch with one of the maintainers, and they will initiate a vote.
- On the current pip
masterbranch, generate a new
invoke generate.authorsand commit the results.
- On the current pip
masterbranch, make a new commit which bumps the version in
pip/__init__.pyto the release version and adjust the
CHANGES.txtfile to reflect the current date.
- Create a signed tag of the
masterbranch of the form
X.Y.Zusing the command
git tag -s X.Y.Z.
- Checkout the tag using
git checkout X.Y.Zand create the distribution files using
python setup.py sdist bdist_wheel.
- Upload the distribution files to PyPI using twine
twine upload -s dist/*). The upload should include GPG signatures of the distribution files.
- Push all of the changes.
- Regenerate the
get-pip.pyscript by running
invoke generate.installerin the get-pip repository, and committing the results.
Creating a Bugfix Release¶
Sometimes we need to release a bugfix release of the form
X.Y.Z+1. In order
to create one of these the changes should already be merged into the
- Create a new
release/X.Y.Z+1branch off of the
X.Y.Ztag using the command
git checkout -b release/X.Y.Z+1 X.Y.Z.
- Cherry pick the fixed commits off of the
masterbranch, fixing any conflicts and moving any changelog entries from the development version's changelog section to the
- Push the
release/X.Y.Z+1branch to github and submit a PR for it against the
masterbranch and wait for the tests to run.
- Once tests run, merge the
release/X.Y.Z+1branch into master, and follow the above release process starting with step 4.