PyScaffold was started by Blue Yonder developers to help automating and standardizing the process of project setups. Nowadays it is a pure community project and you are very welcome to join in our effort if you would like to contribute.
If you experience bugs or in general issues with PyScaffold, please file an issue report on our issue tracker.
Submit an issue¶
Before you work on any non-trivial code contribution it’s best to first create an issue report to start a discussion on the subject. This often provides additional considerations and avoids unnecessary work.
Create an environment¶
Before you start coding we recommend to install Miniconda which allows
to setup a dedicated development environment named
conda create -n pyscaffold python=3 six virtualenv pytest pytest-cov
Then activate the environment
source activate pyscaffold
Clone the repository¶
Create a Gitub account if you do not already have one.
Fork the project repository: click on the Fork button near the top of the page. This creates a copy of the code under your account on the GitHub server.
Clone this copy to your local disk:
git clone email@example.com:YourLogin/pyscaffold.git
python setup.py egg_info --egg-base .after a fresh checkout. This will generate some critically needed files. Typically after that, you should run
python setup.py developto be able run
Create a branch to hold your changes:
git checkout -b my-feature
and start making changes. Never work on the master branch!
Start your work on this branch. When you’re done editing, do:
git add modified_files git commit
to record your changes in Git, then push them to GitHub with:
git push -u origin my-feature
Please check that your changes don’t break any unit tests with:
python setup.py test
or even a more thorough test with
toxafter having installed tox with
pip install tox. Don’t forget to also add unit tests in case your contribution adds an additional feature and is not just a bugfix.
Use flake8 to check your code style.
Add yourself to the list of contributors in
Go to the web page of your PyScaffold fork, and click “Create pull request” to send your changes to the maintainers for review. Find more detailed information creating a PR.