Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update docstrings to rely on mypy annotations and add sphinx autodoc extension #26

Closed
mattsb42-aws opened this issue Oct 8, 2017 · 1 comment

Comments

@mattsb42-aws
Copy link
Member

mattsb42-aws commented Oct 8, 2017

Sphinx autodoc extension that reads types from mypy annotations: https://pypi.python.org/pypi/sphinx-autodoc-typehints

This lets us both single-source typing hints and forces more granular typing hints in the Sphinx docs than is normally used.

@mattsb42-aws
Copy link
Member Author

Unfortunately, it looks like sphinx-autodoc-typehints only works with Python 3 mypy annotations, not Python 2-compatible mypy annotations.

@mattsb42-aws mattsb42-aws removed their assignment Dec 10, 2018
farleyb-amazon pushed a commit that referenced this issue May 27, 2021
See GHSA-89v2-g37m-g3ff

Co-authored-by: Alex Chew <alex@alexchew.net>
Co-authored-by: Valerie Lambert <lavaleri@amazon.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants