Skip to main content

Common opinionated utilities for every day development.

Project description

B.LambdaLayerCommon

Pipeline

DEPRECATION WARNING !!!

This library no longer supports lambda layers and eventually will be moved to another repository. It is a simple python library of common methods to develop in AWS environment. Create your own lambda layer using B.CfnLambdaLayer and specify this library as a dependency. Example given below.

from b_cfn_lambda_layer.lambda_layer import LambdaLayer
layer = LambdaLayer(
  ...,
  dependencies={
     'b-lambda_layer_common': PackageVersion.from_string_version('4.0.0'),
  }
)

Description

This is a simple python library, that contains various useful methods that will make infrastructure development much easier.

Remarks

Biomapas aims to modernise life-science industry by sharing its IT knowledge with other companies and the community. This is an open source library intended to be used by anyone. Improvements and pull requests are welcome.

Related technology

  • Python3
  • Docker
  • AWS CDK
  • AWS Lambda

Assumptions

This project assumes you have good knowledge in AWS.

  • Good Python skills and basis of OOP.

Useful sources

  • None.

Install

Before installing this library, ensure you have these tools setup:

  • Python / Pip

To install this project from source run:

pip install .

Or you can install it from a PyPi repository:

pip install b-lambda_layer_common

Usage & Examples

Main modules:

  • api_gateway
    Contains various functionalities related to API Gateway service and integrations.

  • cache
    Contains caching mechanisms for lambda functions.

  • events
    Contains functionality that supports event-driven architectures.

  • exceptions
    Contains advanced exception handling and propagation between lambda function chains.

  • ssm
    Contains SSM parameter store handling logic.

  • util
    Contains random fun stuff ;)

  • validation
    Various value validations for python.

  • ws_api_gateway
    Contains various functionalities related to API Gateway websocket service and integrations.

Testing

This package has unit tests based on pytest. To run tests simply run:

pytest --cov=b_lambda_layer_common b_lambda_layer_common_test/unit --cov-fail-under=80

Contribution

Found a bug? Want to add or suggest a new feature? Contributions of any kind are gladly welcome. You may contact us directly, create a pull-request or an issue in github platform. Lets modernize the world together.

Release history

4.5.0

  • Update of the CognitoAccessToken class to parse authentication token either from the request headers or from the request context.

4.4.0

  • Add decorator remove_header removing desired headers from API Gateway integration lambda event.

4.3.0

  • Improve ValueValidator by adding not_contains_whitespace method.
  • Make ValueValidatorPresets more flexible.

4.2.2

  • Make MalformedPermissionErorr inherit straight from HttpException.

4.2.1

  • Typehint fixes.

4.2.0

  • Add more custom BException exceptions.
  • 420 hehe...

4.1.0

  • Add ability to specify custom exception when performing value validation.

4.0.0

3.3.0

  • Allow access of the value within validators.

3.2.0

  • Add epic validation!
  • Add ValueValidator for basic validation.
  • Add ValueValidatorPreset for convenient validation.

3.1.0

  • Extract api key from lambda event.
  • Extract body from lambda event.

3.0.1

  • Extend boto3 step-functions call timeout to maximum lambda execution time (15 minutes).

3.0.0

  • Use the newest base layer B.CfnLambdaLayer which uses new asset bundling mechanism (Dockerfile).

2.4.0

  • Add Boto3 client validation under SfnCall function.

2.3.4

  • Add functionality to pass Boto3 client to SfnCall function for multithreding support.

2.3.3

  • Fix api empty dict serialization.

2.3.2

  • Improve parsing of JWT claims from API Gateway authorizer output.

2.3.1

  • If you want to use cryptography module, you must use Python 3.8.
  • Add explanations for Python 3.8 versions.
  • Fix supported layer python versions.

2.3.0

  • Add Fernet encryption PynamoDB attribute.

2.2.1

  • Fix KmsAttribute by introducing base64 encode/decode.

2.2.0

  • Add field validator in util directory. Simple string validation.
  • Add KMS attribute for PynamoDB.

2.1.2

  • Add a list bytes batching utility.

2.0.6

  • Handle errors when raising ValueError in SfnCall class.

2.0.4

  • Simple return JSON of an output if SfnCall raised ValueError.

2.0.1

  • Include .txt files.

2.0.0

  • Complete refactor.
  • Fix ugly if/else imports.
  • Run unit tests inside lambda functions.
  • Use b_cfn_lambda_layer dependency.
  • Write more unit and integration tests.
  • Add README documentation.

1.20.0

  • Add validation when bundling with Docker.

1.19.0

  • General testing improvements.
  • Add Layer V2 integration tests.

1.18.0

  • Add V2 Layer class to enable installation of dependencies.

1.16.0

  • Add response method to return any type.
  • Add text/html and text/plain headers.
  • Add missing fields parameter support to NeighbourEndpoint class.

1.15.1

  • Improve function return value handling for InMemoryDataCache class.

1.15.0

  • Add in-memory data caching functionality.

1.14.0

  • Add fields parameter support to HttpEndpoint class.

1.11.1

  • Update DoNotUpdate class to be usable as a type.

1.11.0

  • Add WebSocket Api Gateway message class to form consistent messages.

1.10.2

  • Allow for changing HttpEndpoint behavior.

1.10.1

  • Add ability to specify if to fail to errors.
  • Try to read from env event bus name.

1.10.0

  • Add factory to emit EventBridge events.

1.9.5

  • Make the code a little more robust and less error prone.

1.9.4

  • Assets input may contain garbage files too, hence, apply cleanup commands directly on asset outputs folder.

1.9.3

  • Add builds badge.

1.9.2

  • Remove leftover code.
  • Update requirements.

1.9.1

  • Delete unnecessary files which result in different asset hash.
  • Calculate hash when bundling.

1.9.0

  • Add CSV headers.

1.8.3

  • Ensure everything works with a robust integration test.

1.8.2

  • Improve Boto3Version class.

1.8.1

  • Fix bug when boto3 version is specified project files are not copied.

1.8.0

  • Change asset bundling to asset docker bundling if additional dependencies are specified.
  • Add ability to install boto3 library.
  • Add more unit tests.
  • Add integration tests to deploy and test the Layer in AWS.

1.7.0

  • Simplify SSM parameters functionality.
  • Add robust SSM parameter tests.

1.6.2

  • Do not serialize returned ssm parameters.

1.6.1

  • Add more logging for better visibility.

1.6.0

  • SSM should_refresh function should be public.

1.5.1

  • Add logging on ssm error decorator.

1.5.0

  • Force using error_class to error_classes.

1.4.0

  • Add functionality to fetch and cache SSM parameters.
  • Add OS type parameters.

1.3.0

  • Add media Response and wav/mpeg headers.

1.2.0

  • Add DoNotUpdate class, useful when checking what parameters to update and what not.

1.1.3

  • Implement retrying logic to HttpCall.

1.1.2

  • Make sure test coverage is at least 80%.
  • Add CI/CD pipeline.
  • Add more encodings to decode responses.

1.1.1

  • Add urllib3 dependency.

1.1.0

  • Add DynamoDBEncoder that subclasses DecimalEncoder and additionally encodes sets as lists.

1.0.3

  • Modify call_to_json function by checking whether the response contains body.

1.0.2

  • Add exception logging for failed imports.

1.0.1

  • Expose http_endpoint on NeigbourEndpoint class.

1.0.0

  • Release version with major braking changes.
  • Consistent naming for imports.
  • Unit tests to cover all functions and classes.
  • Add neighbour endpoint.
  • General code improvements and cleanup.

0.0.16

  • Fix logging imports.
  • Add logging of exception tracebacks to exception_middleware.
  • Add logging about HTTP requests.
  • Set request scheme for parent API Gateway urls depending on current protocol.

0.0.15

  • Add a CognitoAccessToken for parsing access token information provided by the API Gateway using Cognito authorizer.

0.0.14

  • Add a LoggingManager for setting up logging configuration

0.0.13

  • Add custom JSON encoder with support for decimal.Decimal encoding

0.0.12

  • Implement API Gateway body parsing.

0.0.11

  • Fix imports.

0.0.10

  • Implement exceptions.

0.0.9

  • Fix api gateway url.

0.0.8

  • Add xml to dict converter utility. No dependencies.

0.0.7

  • Fix imports.

0.0.6

  • Add ability to check whether singleton was initialized.

0.0.5

  • Remove description.

0.0.4

  • Do not create an extra stack.

0.0.3

  • Add safe initialization.

0.0.2

  • Add Layer class and Singleton.

0.0.1

  • Initial build.

Project details


Release history Release notifications | RSS feed

This version

4.5.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

b_lambda_layer_common-4.5.0.tar.gz (43.8 kB view details)

Uploaded Source

Built Distribution

b_lambda_layer_common-4.5.0-py3-none-any.whl (69.0 kB view details)

Uploaded Python 3

File details

Details for the file b_lambda_layer_common-4.5.0.tar.gz.

File metadata

  • Download URL: b_lambda_layer_common-4.5.0.tar.gz
  • Upload date:
  • Size: 43.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.8.18

File hashes

Hashes for b_lambda_layer_common-4.5.0.tar.gz
Algorithm Hash digest
SHA256 b94e731823e2ee32e51d777384f9b0b52c672bab3875f4b750e92da41cf72d50
MD5 52247d2ae9b76a9c6c4c9f4c3d07ab08
BLAKE2b-256 2a7fd5d97e2558935c8e7d2fc4051b4c0e963e82445c31d863f0793a9cd816ad

See more details on using hashes here.

File details

Details for the file b_lambda_layer_common-4.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for b_lambda_layer_common-4.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c3909b16ec43543d2b81a1b9f84c660ec5b0d5599bfe41ac2caafb4f635aeb97
MD5 ea19adf9a6477e2b745ba50b1729755a
BLAKE2b-256 b486676565bdc13108fe0080d147eb39c2c32f843ec77b4071618b4014474a86

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page