Python tips and tricks

python_tips_and_tricks.rst

Documentation

Google Style Guide - Comments

https://google.github.io/styleguide/pyguide.html#Comments

Python Developer's Guide - Documenting Python

https://docs.python.org/devguide/documenting.html

Sphinx Napoleon

http://sphinxcontrib-napoleon.readthedocs.io/en/latest/

PEP 257 -- Docstring Conventions

https://www.python.org/dev/peps/pep-0257/

Doctest

https://docs.python.org/2/library/doctest.html#module-doctest

Building Python

Install python as a framework on OS X with pyenv

env PYTHON_CONFIGURE_OPTS="--enable-framework CC=clang" pyenv install 2.7.11

Install python as a framework on OS X with pyenv (support matplotlib)

pyenv/pyenv-virtualenv#140

env PYTHON_CONFIGURE_OPTS="--enable-framework --enable-unicode=ucs2 CC=clang" pyenv install 2.7.11

Code Snippits

bin() with leading zeros

def lzbin(x):
    return "0b"+bin(x)[2:].zfill(8)