If you would like to contribute to pythonrobot-twitch-bot, then your contributions are definitely
welcome and will be very appreciated. Below is some guidance to help contribute to this
project.
The first thing you need to do is fork this project and then clone that project to your local machine. I recommend either developing on Ubuntu or WSL 2.0 if using Windows.
Once you have cloned the project, navigate to that directory with:
cd pythonrobot-twitch-bot
To get your development environment ready and install any required dependencies run:
tools/setup/prep-dev-environment
and
tools/setup-git-repo
and
source pythonrobot-twitch-bot-venv/bin/activate
The tools/setup-git-repo command will setup some commit hooks to run our linters on any changed files before
the commit and then run the linters on your commit message to ensure it meets our
commit message guidelines. You can read our guidelines here.
The linters that will be ran when you try and commit, will only run on changed files. To run these manually on the entire project you can run:
tools/lint
We use a rebase-oriented workflow. We do not use merge
commits. This means you should use git fetch followed by git rebase
rather than git pull (or you can use git pull --rebase). Also, to prevent
pull requests from becoming out of date with the main line of development,
you should rebase your feature branch prior to submitting a pull request, and
as needed thereafter. If you're unfamiliar with how to rebase a pull request,
read this excellent guide.