Tomodachi

- Properly handles `aiobotocore` client using an async contextmanager. Drops support for `aiobotocore` versions prior 1.3.0, but will now supporting newer versions. (github: **drestrepom**)

- Fixes an issue to now retry calls where AWS SNS intermittently responds with 408 responses without any body, which trips up `botocore.parser.QueryParser`. (github: **technomunk**)

- Refactored options used for AWS SNS+SQS, HTTP, AMQP and the Watcher functionality. Options set on the service class should now be defined as a `tomodachi.Options` object, which provides type hints and much nicer path traversal of the class.

Only the specified typed values for `options` will now be allowed to be set. Setting a non-defined option will raise an `AttributeError` exception on service start.

The previous `dict` based approach is still supported, but will be removed in a future version.

- Dropped support for Python 3.7.

- Support for assigning values to AWS SQS queue attributes value `VisibilityTimeout` and `RedrivePolicy` that is used to assign a queue to use a dead-letter queue after a number of failed attempts to consume a message. By default no changes will be done to the existing queue attributes and a change will only be triggered by assigning values to the `visibility_timeout` or both of `dead_letter_queue_name` + `max_receive_count` keyword arguments.

python
tomodachi.aws_sns_sqs(
topic=None,
competing=True,
queue_name=None,
filter_policy=FILTER_POLICY_DEFAULT,
visibility_timeout=VISIBILITY_TIMEOUT_DEFAULT, affects MessageVisibility
dead_letter_queue_name=DEAD_LETTER_QUEUE_DEFAULT, affects RedrivePolicy
max_receive_count=MAX_RECEIVE_COUNT_DEFAULT, affects RedrivePolicy
**kwargs,
)


- Fixes a bug where SQS messages wouldn't get deleted from the queue if a middleware function catches an exception without reraising it. This is because the `delete_message` is not called from within `routine_func` (due to the exception breaking normal control flow), but the message deletion from middleware bubble is also skipped, as no exception is propagated from it. (github: **technomunk**)

- Adds basic support for FIFO queues & topics on AWS SQS queues managed by a `tomodachi` service decorated function, which can be used where one needs guaranteed ordering of the consumed messages. (github: **kjagiello**)

- Updates to the internal `tomodachi.envelope.ProtobufBase` envelope to now also support newer versions of protobuf.

- Added documentation to describe the "magic" functions that hooks into the service lifecycle; `_start_service`, `_started_service`, `_stopping_service`, `_stop_service`.

- Fixes an issue with live reloading on code changes (development mode) with services utilizing `protobuf` messages, which in same edge cases could trigger a repeated `TypeError("A Message class can only inherit from Message")` that would prevent the service from restarting correctly.

- Added an additional way of gracefully triggering shutdown of a running service, by using the new `tomodachi.exit()` function, which will initiate the termination processing flow in the same way as signaling `SIGINT` or `SIGTERM`. The `tomodachi.exit()` call can additionally take an optional exit code as an argument to support new ways of catching service operation.
- The process' exit code can also be altered by changing the value of `tomodachi.SERVICE_EXIT_CODE`, however using the new `tomodachi.exit` call with an integer argument will override any previous value set to `tomodachi.SERVICE_EXIT_CODE`. The default value is set to `0`.

- Handle exceptions lower in the stack for messaging services (AMQP and AWS SNS+SQS handlers), which now allows catching exceptions in middlewares, which was previously not possible. (github: **justcallmelarry**)
- Improved documentation for uses of `tomodachi.get_service` (github: **jmfederico**)
- Type hint annotation improvements.

- Adds the possibility to add a function called `_stopping_service` to the `tomodachi` Service class, which is run as soon as a termination signal is received by the service. (github: **justcallmelarry**)
- Fix for potential exceptions on botocore session client raising a `RuntimeError`, resulting in a tomodachi "Client has never been created in the first place" exception on reconnection to AWS APIs.
- Added Python 3.10 to the CI test matrix run via GitHub Actions.
- Additional updates for compatibility with typing libraries to improve support for installations on Python 3.10.
- Supports `aiohttp` 3.8.x versions.
- Supports `tzlocal` 3.x and 4.x releases.