Contributing to HTTPie

Bug reports and code and documentation patches are welcome. You can help this project also by using the development version of HTTPie and by reporting any bugs you might encounter.

1. Reporting bugs

It's important that you provide the full command argument list as well as the output of the failing command. Use the --debug flag and copy&paste both the command and its output to your bug report, e.g.:

$ http --debug [COMPLETE ARGUMENT LIST THAT TRIGGERS THE ERROR]
[COMPLETE OUTPUT]

2. Contributing Code and Docs

Before working on a new feature or a bug, please browse existing issues to see whether it has been previously discussed. If the change in question is a bigger one, it's always good to discuss before your starting working on it.

Creating Development Environment

Go to https://github.com/jakubroztocil/httpie and fork the project repository.

git clone https://github.com/<YOU>/httpie

cd httpie

git checkout -b my_topical_branch

# (Recommended: create a new virtualenv)

# Install dev. requirements and also HTTPie (in editable mode
# so that the `http' command will point to your working copy):
make

Making Changes

Please make sure your changes conform to Style Guide for Python Code (PEP8).

Testing

Before opening a pull requests, please make sure the test suite passes in all of the supported Python environments. You should also add tests for any new features and bug fixes.

HTTPie uses pytest and Tox for testing.

Running all tests:

# Run all tests on the current Python interpreter
make test

# Run all tests on the current Python with coverage
make test-cover

# Run all tests in all of the supported and available Pythons via Tox
make test-tox

# Run all tests for code as well as packaging, etc.
make test-all

Running specific tests:

# Run specific tests on the current Python
py.test tests/test_uploads.py
py.test tests/test_uploads.py::TestMultipartFormDataFileUpload
py.test tests/test_uploads.py::TestMultipartFormDataFileUpload::test_upload_ok

# Run specific tests on the on all Pythons via Tox
tox -- tests/test_uploads.py --verbose
tox -- tests/test_uploads.py::TestMultipartFormDataFileUpload --verbose
tox -- tests/test_uploads.py::TestMultipartFormDataFileUpload::test_upload_ok --verbose

See Makefile for additional development utilities. Don't forget to add yourself to AUTHORS!