Contributing
The issue tracker is to be used for bug reports, enhancements, or general questions
If you wish to contribute to the pygrmp codebase, feel free to fork the repository and submit a pull request. We use flake8, isort, pylint, and black to enforce a consistent coding style; having these set up in your editor of choice is a great boon to your development process.
Want to jump in?
- Help us fix bugs: This is a good place to start if you're new to the project. Help is always appreciated!
- Write code: Ready to write some python with us? These issues are waiting for you!
- Write documentation: Some additionnal documentation could be added to some features. Feel free to help us help others use the library better!
- Discuss: There are still some open ended questions in this project. Join in on the discussion!
Setup
To get ready to work on the codebase, please do the following:
- Fork and clone the repository
- Create your own branch, ensure that you are branching from
master
- This is generally done in console with
git checkout -b branchNameHere
- This is generally done in console with
- Create a virtual environment for your development
- Code to your heart's content!
- Submit a merge request to the develop branch
- You should see a button on the main Pygrpm page
Additional notes
In order to test your changes you may want to create a separate directory to import and test
your modified pygrpm library. A simple way to install your changes from a local directory
(thus avoiding having to deal with constant remote installs) is to run the following from your
virtual environment
* pip install -e /path/to/your/pygrpm/
See docs
Any changes saved in your pygrpm folder will be immediately reflected in your imported version
Deployment
Deployment is made by the gitlab runner via tags.