Mypy-boto3

Notes

Starting from this release, `boto3-stubs-*` version is the same as `boto3` version and follows PEP 440. In case of hotfixes, updates will be published as post releases. For example, for `boto3 1.17.70` generated versions are `boto3-stubs 1.17.70` and `boto3-stubs 1.17.70.post1` etc.

Fixed
- `[services]` incorrect link to generated docs in `README.md`
- `[services]` generated MarkDown links did not work on PyPI
- `[master]` generated MarkDown links did not work on PyPI
- `[builder]` support for post-releases in build version

Added
- `[builder]` [finspace](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/finspace.html) service support
- `[builder]` [FinSpaceData](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/finspace-data.html) service support

Changed
- `[builder]` Docker image rebased to `Python 3.9.4`

Changed
- `[docs]` representation for methods and classes
- `[docs]` show links to related resources
- `[docs]` MarkDown files are beautified with [mdformat](https://pypi.org/project/mdformat/)
- `[services]` README is beautified with [mdformat](https://pypi.org/project/mdformat/)

Fixed
- `[services]` ToC links in generated READMEs (provided by [md-toc](https://pypi.org/project/md-toc/))
- `[docs]` incorrect links to `boto3` documentation

Fixed
- Package dependencies were invalid

Notes

Hi, fellow Pythonistas!

This package grows bigger and allows you to do more and more with every release! However, entropy grows as well, and we sometimes lack documentation to cover all the changes. As always, `boto3` documentation is not the best place to check if types are correct.

So, now we have [auto-generated docs](https://github.com/vemel/mypy_boto3_builder/service_docs/index.md) for every module. And they are generated with... Yes, `mypy_boto3_builder` can now also generate docs for all `boto3` services!

Also, it will be easier for me to announce if something has changed in `botocore` schemas because docs will be affected.

Let me know how the docs can be improved and do not forget to report bugs!

Added
- `[builder]` `--docs` CLI flag to generate MD documentation
- `[services]` MarkDown docs now have Table of Contents

Changed
- `[builder]` single-value literals inlined for readability, but class in `literals.py` is still available for import
- `[builder]` `black` updated to `21.4b2`
- `[builder]` improved logging setup for easier subclassing
- `[services]` updated auto-generated READMEs
- `[services]` added links to new documentation to all classes and methods docstrings
- `[builder]` typed dictionaries are rendered as classes if they do not have any reserved words
- `[services]` all output typed dictionaries have keys marked as required (use `pyright` to check totality properly)

Fixed
- `[services]` literal values were sorted incorrectly in rare cases
- `[apigatewayv2]` to literals were conflicting because they have no names in `botocore` spec, added generated names
- `[builder]` installation works as it should on `pip 21.x`
- `[fsx]` some literals were not extracted, partially breaking the annotations
- `[services]` circular typed dictionaries were replaced with `Dict[str, Any]` too agressively

Notes

Thank you for your bug reports and feature requests!

In this release, we get better support for `ec2` and `s3` resource methods. And a new `literals.py` module for each service for better reusability and type checking! Check `pypi` pages of your favorite modules to start using them.

CI scripts got updated too. You probably will not notice any changes, because were good already. But trust me, builds for new `boto3` versions are more reliable now.

Almost forgot, `NimbleStudio` service is now officially supported as well, so now we have all 263 services covered and carefully annotated!

Let me know if there are any issues or if you come up with new ideas on how to make type checking even better.

Added
- `[services]` new `literals.py/pyi` module that contains all literals specified in the service
- `[builder]` [NimbleStudio](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/nimble.html) service support
- `[builder]` check if generated names are unique
- `[builder]` check if generated names do not conflict with `builtins`, `typing`, or reserved keywords

Fixed
- `[ec2]` arguments in resources inherited from list collections were not correctly ignored (potentially affects other services as well)
- `[builder]` files were not properly formatted with `black` due to imports sorting applied afterward
- `[services]` typos in readme