resources.md

practical-practicable-good-practices resources

Version control

• Atlassian Git Tutorial
• GitHub Guides: Git Handbook
• GitHub Cheathseets: Git Cheat Sheets
• Coursera: Introduction to Git and Github
• This is how I git | daniel.haxx.se
• git-flow: A successful git branching model

Style

• PEP 8: Style Guide for Python Code
• pycodestyle: Python style guide checker
• autopep8: automatically formats Python code to conform to PEP 8
• black: the uncompromising Python code formatter
• isort: a Python utility/library to sort imports

Lint

• Pylint: code analysis for Python
• Flake8: your tool for style guide enforcement
• pyflakes: check Python source files for errors
• mypy: optional static typing for python

Documentation

• Sphinx: Python documentation generator
• sphinx autodoc: include documnentation from docstrings
• Doxygen: generate documentation from source code
• napoleon: marching towards legible docstrings

Testing

• unittest: unit testing framework
• pytest: helps you write better programs
• nose2: the successor to nose, based on unittest2
• coverage: measuring code coverage of Python programs

Open source and collaboration

• Atlassian Git Tutorial: Pull Requests
• GitHub Docs: about pull requests
• Google Engineering Practices: how to do a code review
• Are you a software gardener?
• Coding horror: Code Reviews - Just do it
• Pragmaticengineer: Good code reviews, better code reviews