Issues¶
If you have an idea for a feature to add or an approach for a bugfix, it is best to communicate with developers early. The most common venues for this are GitHub issues.
Pull requests¶
All changes to AskOmics should be made through pull requests to this repository.
Install AskOmics in development mode, then, create a new branch for your new feature
git checkout -b my_new_feature
Commit and push your modification to your fork. If your changes modify code, please ensure that is conform to AskOmics style
Write tests for your changes, and make sure that they passes.
Open a pull request against the master branch of flaskomics. The message of your pull request should describe your modifications (why and how).
The pull request should pass all the continuous integration which is automatically run by Github using Travis CI. The coverage must be at least remain the same (but it's better if it increases)
Coding style guidelines
General
Ensure all user-enterable strings are unicode capable. Use only English language for everything (code, documentation, logs, comments, ...)
Python
We follow PEP-8, with particular emphasis on the parts about knowing when to be inconsistent, and readability being the ultimate goal.
- Whitespace around operators and inside parentheses
- 4 spaces per indent, spaces, not tabs
- Include docstrings on your modules, class and methods
- Avoid from module import *. It can cause name collisions that are tedious to track down.
- Class should be in
CamelCase
, methods and variables inlowercase_with_underscore