Skip to content

Latest commit

 

History

History
84 lines (56 loc) · 3.03 KB

CONTRIBUTING.md

File metadata and controls

84 lines (56 loc) · 3.03 KB

Contributing

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given. This project could always use more documentation, whether as part of the README, in docstrings, or even on the web in blog posts articles, and such.

Submmit an [issue] if you found a bug or have a great idea for a new feature!

Development

Follow these steps for local development:

  1. Bet you've read the Zen Of Python.

  2. Clone your register_apps locally:

     git clone [email protected]:papaemmelab/register_apps.git
    
  3. Create a branch for local development:

     git pull
     git checkout -b name-of-your-bugfix-or-feature
    

    Now you can make your changes locally.

  4. Create a test in:

     register_apps/tests
    
  5. Run pytest with coverage, pylint and pydocstyle using tox:

     tox
    

    To just run pytest:

     py.test tests --cov=register_apps
    

    To just check that your changes pass our pylint and pydocstyle requirements:

     pylint --rcfile=.pylintrc register_apps
     pydocstyle --config=.pydocstylerc register_apps
    
  6. Run tests inside the docker container:

     bash test-container.sh
    
  7. Commit your changes and push your branch to GitHub (see our .gitmessage template):

     git add .
     git config commit.template .gitmessage
     git commit -m ":emoji-name: your short and nice description"
     git push origin name-of-your-bugfix-or-feature
    

    emoji-name should be one of the following:

    emoji name type of change
    🚀 :rocket: new feature
    🐛 :bug: bug fix
    📝 :memo: changes to documentation
    🎨 :art: formatting no code change
    🔧 :wrench: refactoring production code
    :white_check_mark: adding/editing test logic
    👕 :shirt: no production code change
    💎 :gem: bump to new version

    If you are suggesting a new version make sure you are following the semantic versioning guidelines and then update the VERSION file:

     git add register_apps/VERSION
     git commit -m ":gem: bump to version 0.1.0"
    
  8. Submit a pull request through the GitHub website.