Before you begin:
- Ensure you are using Python 3.5+
- Check out the existing issues
Contributions are made to this repo via Issues and Pull Requests (PRs). Make sure to search for existing Issues and PRs before creating your own.
- Fork this project
- Clone the repository to your machine
- Create a separate branch to get started, e.g. for feature
feat/branch-name-here
or fixfix/fix-name-goes-here
- Make sure to create a new virtual environment and activate it:
python3 -m venv venv
source activate venv/bin/activate
- Install dependencies: Run from Git
- Start the program with debug mode:
./bin/gpodder -v
- Make the changes, commit in a branch and push the branch to your fork and then submit a Pull Request.
To ensure code quality, we recommend you to run the linter before pushing the changes to your repo. In order to do so ensure the necessary packages are installed by executing:
pip3 install pytest-cov minimock pycodestyle isort requests pytest pytest-httpserver
Execute the linter in the root directory (Linux only): make lint unittest
. On Windows execute: pycodestyle share src/gpodder tools bin/* *.py