Mypy-boto3

Notes

`Resource.attributes` are now parsed correctly from `botocore` shapes. This change affects many services, so the changes are included in `boto3-stubs==1.20.46.post1` release with all services.

Fixed
- `[services]` `Resource.attributes` types were not retrieved from botocore shapes and relied only on documentation
- `[services]` `Resource.references` that represent a list of resources are now typed correctly as lists (reported by adamnovak)
- `[docs]` Links in AWS docs are no longer broken to wrap text and converted to MarkDown style

Notes
- `botocore-stubs` now cover 100% of `botocore`
- Fixed builder and generated packages classifiers, added `Python 3.11`
- Added new script `scripts/check_stubs.sh` to verify that stubs match `boto3` and `botocore`

Added
- `[botocore-stubs]` Missing stubs for `botocore.exceptions`
- `[botocore-stubs]` Missing stubs for `botocore.configprovider`
- `[botocore-stubs]` Missing stubs for `botocore.httpsession`
- `[botocore-stubs]` Missing stubs for `botocore.utils`
- `[botocore-stubs]` Full coverage of all other modules

Changed
- `[docker]` Rebased to `Python 3.10.2` on `Alpine 3.15`

Fixed
- `[botocore-stubs]` `CachedProperty` should act as a `property` while type checking
- `[docs]` Removed `**Request syntax**` from method short docstrings
- `[builder]` Removed incorrect classifiers
- `[boto3-stubs]` Added classifiers for `Python 3.11`
- `[botocore-stubs]` Added classifiers for `Python 3.11`
- `[services]` Added classifiers for `Python 3.11`

Fixed
- `[botocore-stubs]` Added proper `urllib3` stubs instead of `requests.packages.urllib3` (fixed by benesch)
- `[docs]` Replaced `boto-stubs` with `boto3-stubs` in many places (reported by daveisfera)
- `[boto3-stubs]` Added compatibility with `pyright>=1.1.211`
- `[ci]` Support `boto3` update with no services changed

Notes

Thanks to [Adam Novak](https://github.com/adamnovak) and [Dave Johansen](https://github.com/daveisfera) for their useful bug reports.
We still support all 299 AWS services, so expect 300+ services in the next major update!

Fixed
- `[boto3-stubs]` `boto3.session.Session` arguments are now `Optional`
- `[services]` `a file-like object` accepts `Union[IO[Any], StreamingBody]`

Fixed
- `[botocore-stubs]` `botocore.auth.*Auth` accept both `Credentials` and `ReadOnlyCredentials`
- `[docs]` Updated to the latest `handsdown` generator, branch name fixed

Notes

`boto3-stubs` are as stable as they could be, so no massive changes this time. Even though `boto3` team works hard on changing `botocore` to improve user experience, our type annotations still cover everything. Please report bugs and request new features, because currently, I am out of ideas, how to make your `boto3` experience even better.

Meanwhile, our [VSCode extension](https://marketplace.visualstudio.com/items?itemName=Boto3typed.boto3-ide) grows and almost reached its first stable release. Give it a shot!

Changed
- `[builder]` updated `black` to `21.12b0`
- `[builder]` added compatibility with `Python 3.10.1`
- `[docker]` updated to `Python 3.10.1` on `Alpine 3.15`

Fixed
- `[docker]` removed useless `regex` pre-build, thanks to `Alpine 3.15`
- `[docker]` Python packages are installed to user site-packages to avoid permission issues
- `[sanity]` `pyright` no longer reports empty functions as an error
- `[botocore-stubs]` updated signatures for `AWSConnection`
- `[docs]` instructions for `Docker` usage were incorrect