Python API formatting / code style and extended typing

[carlmartus]

• Format with black.
• Conform to pycodestyle.
• Add types to API functions as a method of documentation.

[jrask]

All print to stdout must be removed due to compliance with cli