Contributor’s Guide
Steps for Submitting Code
Contributions are very much welcomed and appreciated. Every little bit of help counts, so do not hesitate!
Check for open issues, or open a new issue to start some discussion around a feature idea or bug. There is a contributor friendly tag for issues that should be ideal for people who are not familiar with the codebase yet.
Fork the repository on GitHub to start making your changes.
Configure development environment.
make develop
Write some tests that show the bug is fixed or that the feature works as expected.
Ensure your code passes the code quality checks by running
$ make lint
Check all of the unit tests pass by running
$ make test
Check the type checks pass by running
$ make types
Send a pull request and bug the maintainer until it gets merged and published 🙂
Bug Reports
Bug reports should be made to the issue tracker. Please include enough information to reproduce the issue you are having. A minimal, reproducible example would be very helpful.
Feature Requests
Feature requests should be made to the issue tracker.
Other
Create a New Release
Update the version number in
questionary/version.py
andpyproject.toml
.Add a new section for the release to Changelog.
Commit these changes.
git tag
the commit with the release version number.
GitHub Actions will build and push the updated library to PyPi.
Create a Command Line Recording
Install the following tools:
$ brew install asciinema $ npm install --global asciicast2gif
Start the recording with
asciinema
:$ asciinema rec
Do the thing you want to record.
Convert to gif using
asciicast2gif
:$ asciicast2gif -h 7 -w 120 -s 2 <recording> output.gif