Skip to main content

core-aws

This project/library contains common elements related to AWS services…


PyPI Downloads Python Versions License Pipeline Status Docs Status Security

Installation

Install from PyPI using pip:

pip install core-aws
uv pip install core-aws  # Or using UV...

Features

  • AWS Service Clients: High-level wrappers for S3, SQS, SNS, Kinesis, SSM, DynamoDB, ECS, and CloudFormation with improved error handling and type safety.

  • ETL Base Classes: Reusable base classes for building ETL pipelines on AWS (base, S3 bucket-based, SQS-based).

  • Lambda Decorators: Event processing decorators for SQS, SNS, and Kinesis with automatic batch failure handling.

  • Comprehensive Type Hints: Full type definitions for Lambda contexts, events (SQS, SNS, Kinesis), SSM parameters, Cognito identity, and mobile clients.

  • CDC Targets: Change Data Capture targets for streaming data to SQS, SNS, and Kinesis.

  • KMS Cipher: Utilities for encryption/decryption using AWS KMS.

  • Testing Utilities: Base classes and helpers for testing AWS-based applications.

Quick Start

Installation

Install the package:

pip install core-aws
uv pip install core-aws     # Or using UV...
pip install -e ".[dev]"     # For development...

Setting Up Environment

  1. Install required libraries:

pip install --upgrade pip
pip install virtualenv
  1. Create Python virtual environment:

virtualenv --python=python3.12 .venv
  1. Activate the virtual environment:

source .venv/bin/activate

Install packages

pip install .
pip install -e ".[dev]"

Check tests and coverage

python manager.py run-tests
python manager.py run-tests --test-type integration
python manager.py run-coverage

# Having proper AWS credentials...
python manager.py run-tests --test-type functional --pattern "*.py"

Contributing

Contributions are welcome! Please:

  1. Fork the repository

  2. Create a feature branch

  3. Write tests for new functionality

  4. Ensure all tests pass: pytest -n auto

  5. Run linting: pylint core_aws

  6. Run security checks: bandit -r core_aws

  7. Submit a pull request

License

This project is licensed under the MIT License. See the LICENSE file for details.

Support

For questions or support, please open an issue on GitLab or contact the maintainers.

Authors

Metadata

Release files for core-aws 3.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for core-aws 3.1.2
File Size Uploaded
core_aws-3.1.2.tar.gz 66.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for core-aws 3.1.2
File Interpreter ABI Platform
core_aws-3.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 154.8 kB

Release files / core_aws-3.1.2.tar.gz

Download URL core_aws-3.1.2.tar.gz
Size 66.5 kB
Tags Source
SHA-256 checksum
How to use checksums
aa3bbe97ed352fbb1b9d12efa02013a9d2410847e80a052e679be6592bdb8baa
BLAKE2b-256 checksum
How to use checksums
41128f02b756068f31af5d60396018f34b2a4673ca926c41e49acbac2f3501c5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / core_aws-3.1.2-py3-none-any.whl

Download URL core_aws-3.1.2-py3-none-any.whl
Size 88.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6ddf0fd2aea93a3a06d09a1d1a356b6ebdf51a197492b935a5cb1a3865bb4607
BLAKE2b-256 checksum
How to use checksums
ac3c5e2e925c21766c754692158060d4bba0310da811b8ccc378d1b738d4d3d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

This release

3.1.2 This release

2 release files

3.1.1

2 release files

3.1.0

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page