Add type hints in Python API
Created by: paulromano
If we decide to drop Python 3.4 support (it has already reached end-of-life), we can start using type hints (which were effectively standardized in Python 3.5) in our Python API. This can also help simplify our docstrings by using the sphinx-autodoc-typehints package to automatically pick up the type from the annotation.