core-aws
This project/library contains common elements related to AWS services…
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
Install required libraries:
pip install --upgrade pip
pip install virtualenv
Create Python virtual environment:
virtualenv --python=python3.12 .venv
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:
Fork the repository
Create a feature branch
Write tests for new functionality
Ensure all tests pass: pytest -n auto
Run linting: pylint core_aws
Run security checks: bandit -r core_aws
Submit a pull request
License
This project is licensed under the MIT License. See the LICENSE file for details.
Links
Support
For questions or support, please open an issue on GitLab or contact the maintainers.
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)
| File | Size | Uploaded | |
|---|---|---|---|
| core_aws-3.1.2.tar.gz | 66.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|