Skip to content

Latest commit

 

History

History
40 lines (30 loc) · 2.07 KB

CONTRIBUTING.md

File metadata and controls

40 lines (30 loc) · 2.07 KB
Raw

How-to contribute

Those are the main contributing guidelines for contributing to this project:

  • Verify that your contribution does not embark proprietary code or infringe any copyright of any sort.
  • Avoid adding any unnecessary dependencies to the project, espcially of those are not easily packaged and installed through pip.
  • Python contributions must follow the PEP 8 style guide.
  • Use Pull Request mechanism and please be patient while waiting for reviews.
  • Remain polite and civil in all exchanges with the maintainers and other contributors.
  • Any issue submitted which does not respect provided template, or lack of information, will be considered as invalid and automatically closed.

Get started

in order to contribute, the safest is to create your own fork of inaFaceAnalyzer first and then setup your development environment:

# Clone inaFaceAnalyzer repository fork
git clone https://github.com/<your_name>/inaFaceAnalyzer && cd inaFaceAnalyzer
# create a virtual environment for this project and activate it
virtualenv -p python3 env && source env/bin/activate
# create a dependency list
python setup.py egg_info
# install dependencies
pip install -r inaFaceAnalyzer.egg-info/requires.txt
# Run unit test suite
python test_inaFaceAnalyzer.py

You can then make your changes and experiment freely. Once you're done, remember to check that the tests still run. If you've added a new feature, add tests!

Then finally, you're more than welcome to create a Pull Request in inaFaceAnalyzer main repo. We will look at it as soon as possible and eventually integrate your changes in the project.

PR requirements

Following command should be ran successfully before to consider a PR for merging:

python test_inaFaceAnalyzer.py