Improv tracer - async support, patch, test coverage and X-Ray escape hatch (#29)

* feat: use new TraceProvider

* improv: update tests

* improv: update docs, linting

* improv: docstring readability and links

* improv: remove tracer provider

* fix: patch modules type

* improv: use client ctx_manager for race conditions

* improv: make disabling provider private again

* chore: linting

* fix: race condition annotation/metadata

* chore: linting

* feat: add async support for methods

* improv: document async use cases, and edge cases

* improv: upgrade xray, flex pinning

* chore: linting

* improv: update example for async, escape hatch

* fix: add example dev deps in project

* improv: add patch_modules example, formatting

* improv: break down concurrent async calls example

* docs: main doc clean up

* docs: document async, escape hatch usage

* chore: lint

* docs: update example SAM template comments

* chore: updates poetry lock file

* improv: example to use py 3.8

* fix: AsyncMockMixin not being awaitable in 3.8

* fix: 3.8 defaulting to AsyncMock

* improv: include x-ray bug for concurrent async calls

* fix: address nicolas's feedback

* improv: add security baseline as part of PR process

* improv: enforce lower code complexity

* chore: whitespace

* improv: add complexity baseline

* chore: bump version to 0.9.0

* chore: clean up history changes

Co-authored-by: heitorlessa <[email protected]>

Author: heitorlessa

Diff for: python/.flake8

@@ -2,12 +2,11 @@
 exclude = docs, .eggs, setup.py, example, .aws-sam
 ignore = E203, E266, W503, BLK100, W291, I004
 max-line-length = 120
-max-complexity = 18
+max-complexity = 15
 
 [isort]
 multi_line_output = 3
 include_trailing_comma = true
 force_grid_wrap = 0
 use_parentheses = true
 line_length = 120
-

Diff for: python/HISTORY.md

@@ -1,11 +1,20 @@
 # HISTORY 
 
+## May 12th
+
+**0.9.0**
+
+* **Tracer**: Support for async functions in `Tracer` via `capture_method` decorator
+* **Tracer**: Support for `aiohttp` via `aiohttp_trace_config` trace config
+* **Tracer**: Support for patching specific modules via `patch_modules` param
+* **Tracer**: Document escape hatch mechanisms via `tracer.provider`
+
 ## May 1st
 
 **0.8.1**
 
-* Fix metric unit casting logic if one passes plain string (value or key)
-* Fix `MetricUnit` enum values for
+* **Metrics**: Fix metric unit casting logic if one passes plain string (value or key)
+* **Metrics: **Fix `MetricUnit` enum values for
     - `BytesPerSecond`
     - `KilobytesPerSecond`
     - `MegabytesPerSecond`
@@ -22,35 +31,35 @@
 
 **0.8.0**
 
-* Introduces `Logger` for stuctured logging as a replacement for `logger_setup`
-* Introduces `Logger.inject_lambda_context` decorator as a replacement for `logger_inject_lambda_context`
-* Raise `DeprecationWarning` exception for both `logger_setup`, `logger_inject_lambda_context`
+* **Logger**: Introduces `Logger` class for stuctured logging as a replacement for `logger_setup`
+* **Logger**: Introduces `Logger.inject_lambda_context` decorator as a replacement for `logger_inject_lambda_context`
+* **Logger**: Raise `DeprecationWarning` exception for both `logger_setup`, `logger_inject_lambda_context`
 
 ## April 20th, 2020
 
 **0.7.0**
 
-* Introduces Middleware Factory to build your own middleware
-* Fixes Metrics dimensions not being included correctly in EMF
+* **Middleware factory**: Introduces Middleware Factory to build your own middleware via `lambda_handler_decorator`
+* **Metrics**: Fixes metrics dimensions not being included correctly in EMF
 
 ## April 9th, 2020
 
 **0.6.3**
 
-* Fix `log_metrics` decorator logic not calling the decorated function, and exception handling
+* **Logger**: Fix `log_metrics` decorator logic not calling the decorated function, and exception handling
 
 ## April 8th, 2020
 
 **0.6.1**
 
-* Introduces Metrics middleware to utilise CloudWatch Embedded Metric Format
-* Adds deprecation warning for `log_metrics`
+* **Metrics**: Introduces Metrics middleware to utilise CloudWatch Embedded Metric Format
+* **Metrics**: Adds deprecation warning for `log_metrics`
 
 ## February 20th, 2020
 
 **0.5.0**
 
-* Introduces log sampling for debug - Thanks to [Danilo's contribution](https://github.com/awslabs/aws-lambda-powertools/pull/7)
+* **Logger**: Introduces log sampling for debug - Thanks to [Danilo's contribution](https://github.com/awslabs/aws-lambda-powertools/pull/7)
 
 ## November 15th, 2019 
 

Diff for: python/Makefile

@@ -20,7 +20,7 @@ test:
 coverage-html:
 	poetry run pytest --cov-report html
 
-pr: lint test 
+pr: lint test security-baseline complexity-baseline
 
 build: pr
 	poetry run build
@@ -31,6 +31,15 @@ docs: dev
 docs-dev:
 	poetry run pdoc --http : aws_lambda_powertools
 
+security-baseline:
+	poetry run bandit --baseline bandit.baseline -r aws_lambda_powertools
+
+complexity-baseline:
+	$(info Maintenability index)
+	poetry run radon mi aws_lambda_powertools
+	$(info Cyclomatic complexity index)
+	poetry run xenon --max-absolute C --max-modules A --max-average A aws_lambda_powertools
+
 #
 # Use `poetry version <major>/<minor></patch>` for version bump
 #