.github/workflows/codeql-analysis.yml

@@ -0,0 +1,40 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [develop]
+  pull_request:
+    branches: [develop]
+  schedule:
+    - cron: '0 21 * * 0'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        # Override automatic language detection by changing the below list
+        # Supported options are ['csharp', 'cpp', 'go', 'java', 'javascript', 'python']
+        language: ['python']
+        # Learn more...
+        # https://docs.github.com/en/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1

.github/workflows/python_docs.yml

@@ -13,14 +13,17 @@ on:
     types: [published] # update Docs upon new release
 
 jobs:
-  docs:
+  api-docs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v1
       - name: Set up Python
         uses: actions/setup-python@v1
         with:
           python-version: "3.8"
+      - uses: actions/setup-node@v1
+        with:
+          node-version: '12'
       - name: Capture branch and tag
         id: branch_name
         run: |

CHANGELOG.md

@@ -6,6 +6,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.7.0] - 2020-10-26
+
+### Added
+- **Utilities**: Add new `Parser` utility to provide parsing and deep data validation using Pydantic Models
+- **Utilities**: Add case insensitive header lookup, and Cognito custom auth triggers to `Event source data classes`
+
+### Fixed
+- **Logger**: keeps Lambda root logger handler, and add log filter instead to prevent child log records duplication
+- **Docs**: Improve wording on adding log keys conditionally
+
 ## [1.6.1] - 2020-09-23
 
 ### Fixed

Makefile

@@ -4,18 +4,18 @@ target:
 
 dev:
 	pip install --upgrade pip poetry pre-commit
-	poetry install --extras "jmespath"
+	poetry install --extras "pydantic"
 	pre-commit install
 
 dev-docs:
-	cd docs && npm install
+	cd docs && yarn install
 
 format:
-	poetry run isort -rc aws_lambda_powertools tests example
+	poetry run isort -rc aws_lambda_powertools tests
 	poetry run black aws_lambda_powertools tests
 
 lint: format
-	poetry run flake8 aws_lambda_powertools/* tests/* example/*
+	poetry run flake8 aws_lambda_powertools/* tests/*
 
 test:
 	poetry run pytest -vvv --cov=./ --cov-report=xml
@@ -26,7 +26,7 @@ coverage-html:
 pr: lint test security-baseline complexity-baseline
 
 build: pr
-	poetry run build
+	poetry build
 
 build-docs:
 	@$(MAKE) build-docs-website
@@ -40,11 +40,11 @@ build-docs-api: dev
 
 build-docs-website: dev-docs
 	mkdir -p dist
-	cd docs && npm run build
+	cd docs && yarn build
 	cp -R docs/public/* dist/
 
-docs-local:
-	cd docs && npm run start
+docs-local: dev-docs
+	cd docs && yarn start
 
 docs-api-local:
 	poetry run pdoc --http : aws_lambda_powertools

README.md

@@ -1,11 +1,11 @@
-# AWS Lambda Powertools
+# AWS Lambda Powertools (Python)
 
 ![Build](https://github.com/awslabs/aws-lambda-powertools/workflows/Powertools%20Python/badge.svg?branch=master)
 ![PythonSupport](https://img.shields.io/static/v1?label=python&message=3.6%20|%203.7|%203.8&color=blue?style=flat-square&logo=python) ![PyPI version](https://badge.fury.io/py/aws-lambda-powertools.svg) ![PyPi monthly downloads](https://img.shields.io/pypi/dm/aws-lambda-powertools)
 
-A suite of utilities for AWS Lambda functions to ease adopting best practices such as tracing, structured logging, custom metrics, and more.
+A suite of Python utilities for AWS Lambda functions to ease adopting best practices such as tracing, structured logging, custom metrics, and more. ([AWS Lambda Powertools Java](https://github.com/awslabs/aws-lambda-powertools-java) is also available).
 
-**[📜Documentation](https://awslabs.github.io/aws-lambda-powertools-python/)** | **[API Docs](https://awslabs.github.io/aws-lambda-powertools-python/api/)** | **[🐍PyPi](https://pypi.org/project/aws-lambda-powertools/)** | **[Feature request](https://github.com/awslabs/aws-lambda-powertools-python/issues/new?assignees=&labels=feature-request%2C+triage&template=feature_request.md&title=)** | **[🐛Bug Report](https://github.com/awslabs/aws-lambda-powertools-python/issues/new?assignees=&labels=bug%2C+triage&template=bug_report.md&title=)** | **[Kitchen sink example](https://github.com/awslabs/aws-lambda-powertools-python/tree/develop/example)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-lambda-powertools/)**
+**[📜Documentation](https://awslabs.github.io/aws-lambda-powertools-python/)** | **[API Docs](https://awslabs.github.io/aws-lambda-powertools-python/api/)** | **[🐍PyPi](https://pypi.org/project/aws-lambda-powertools/)** | **[Feature request](https://github.com/awslabs/aws-lambda-powertools-python/issues/new?assignees=&labels=feature-request%2C+triage&template=feature_request.md&title=)** | **[🐛Bug Report](https://github.com/awslabs/aws-lambda-powertools-python/issues/new?assignees=&labels=bug%2C+triage&template=bug_report.md&title=)** | **[Hello world example](https://github.com/aws-samples/cookiecutter-aws-sam-python)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-lambda-powertools/)**
 
 > **Join us on the AWS Developers Slack at `#lambda-powertools`** - **[Invite, if you don't have an account](https://join.slack.com/t/awsdevelopers/shared_invite/zt-gu30gquv-EhwIYq3kHhhysaZ2aIX7ew)**
 
@@ -21,9 +21,11 @@ A suite of utilities for AWS Lambda functions to ease adopting best practices su
 
 With [pip](https://pip.pypa.io/en/latest/index.html) installed, run: ``pip install aws-lambda-powertools``
 
-## Example
+## Examples
 
-See **[example](./example/README.md)** of all features, testing, and a SAM template with all Powertools env vars. All features also provide full docs, and code completion for VSCode and PyCharm.
+* [Serverless Shopping cart](https://github.com/aws-samples/aws-serverless-shopping-cart)
+* [Serverless Airline](https://github.com/aws-samples/aws-serverless-airline-booking)
+* [Serverless E-commerce platform](https://github.com/aws-samples/aws-serverless-ecommerce-platform)
 
 ## Credits
 

aws_lambda_powertools/logging/filters.py

@@ -0,0 +1,16 @@
+import logging
+
+
+class SuppressFilter(logging.Filter):
+    def __init__(self, logger):
+        self.logger = logger
+
+    def filter(self, record):  # noqa: A003
+        """Suppress Log Records from registered logger
+
+        It rejects log records from registered logger e.g. a child logger
+        otherwise it honours log propagation from any log record
+        created by loggers who don't have a handler.
+        """
+        logger = record.name
+        return False if self.logger in logger else True

aws_lambda_powertools/logging/logger.py

@@ -8,6 +8,7 @@
 from typing import Any, Callable, Dict, Union
 
 from .exceptions import InvalidLoggerSamplingRateError
+from .filters import SuppressFilter
 from .formatter import JsonFormatter
 from .lambda_context import build_lambda_context_model
 
@@ -147,13 +148,6 @@ def _get_logger(self):
     def _init_logger(self, **kwargs):
         """Configures new logger"""
 
-        # Lambda by default configures the root logger handler
-        # therefore, we need to remove it to prevent messages being logged twice
-        # when customers use our Logger
-        logger.debug("Removing Lambda root handler whether it exists")
-        root_logger = logging.getLogger()
-        root_logger.handlers.clear()
-
         # Skip configuration if it's a child logger to prevent
         # multiple handlers being attached as well as different sampling mechanisms
         # and multiple messages from being logged as handlers can be duplicated
@@ -163,6 +157,13 @@ def _init_logger(self, **kwargs):
             self._logger.addHandler(self._handler)
             self.structure_logs(**kwargs)
 
+            logger.debug("Adding filter in root logger to suppress child logger records to bubble up")
+            for handler in logging.root.handlers:
+                # It'll add a filter to suppress any child logger from self.service
+                # Where service is Order, it'll reject parent logger Order,
+                # and child loggers such as Order.checkout, Order.shared
+                handler.addFilter(SuppressFilter(self.service))
+
     def _configure_sampling(self):
         """Dynamically set log level based on sampling rate