A simple AWS utility library
Project description
Certainly! Below is a template for a README.md
file for your AWS utility library. You'll need to customize it with your own information, such as installation instructions, usage examples, and contact information. Save this content in a README.md
file in the root of your project directory.
# AWS Utility Library
This `aws_library` is a Python package that provides a simplified interface for interacting with various AWS services using `boto3`.
## Features
- Easy-to-use methods for common AWS operations.
- Handles S3 uploads/downloads, RDS queries, and triggering deployments for AWS CodeDeploy, CodeBuild, and CodePipeline.
## Installation
Install `aws_library` using pip:
```bash
pip install aws_library
Usage
Here is how you can use the aws_library
:
from aws_library import AWSLibrary
# Create an instance of the library
aws_lib = AWSLibrary()
# Save data to an S3 bucket
aws_lib.save_to_s3('my-bucket', 'test/key', 'Some data')
# Get data from an S3 bucket
data = aws_lib.get_from_s3('my-bucket', 'test/key')
print(data)
# Execute a query on RDS
records = aws_lib.execute_query('my-database', 'SELECT * FROM my_table')
print(records)
# Trigger a deployment
deployment_success = aws_lib.trigger_deployment('my-app', 'my-deployment-group', {
'revisionType': 'S3',
's3Location': {
'bucket': 'my-bucket',
'key': 'builds/my-app.zip',
'bundleType': 'zip'
}
})
print(deployment_success)
# Start a build in CodeBuild
build_success = aws_lib.start_build('my-build-project', 'sourceVersion')
print(build_success)
# Get the state of a pipeline in CodePipeline
pipeline_state = aws_lib.get_pipeline_state('my-pipeline')
print(pipeline_state)
Replace 'my-bucket'
, 'my-database'
, 'my-app'
, etc., with your actual AWS resource names.
Requirements
- Python 3.7+
- boto3
Development
To contribute to this project, please fork the repository and submit a pull request.
License
pypi-AgEIcHlwaS5vcmcCJDJlNGExYTcwLWYxNmYtNDI1Yi1iNzVhLTBhMTYxNmMzZGM4ZgACKlszLCJhNjViYWJiZi1lOTI2LTQ3NzMtOTMyNC1hZTcxOTdmNzFjZjAiXQAABiA30kNEkVPeM7cG3Jg9PGI9bI79qIGLreECTfjqpJlgjw
This project is licensed under the MIT License - see the LICENSE file for details.
Contact
If you have any questions or feedback, please contact me at your.email@example.com.
Acknowledgments
- Thanks to the
boto3
team for their excellent AWS SDK for Python.
In the `Usage` section, you can include examples of how to use your library. Make sure to provide enough information so that someone unfamiliar with your code can understand how to use it.
In the `Contact` section, put your actual contact email so users can reach out to you if they have questions or issues.
Remember to create a `LICENSE` file if you haven't already and to reference it correctly in the `README.md` file.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file aws_library-0.1.tar.gz
.
File metadata
- Download URL: aws_library-0.1.tar.gz
- Upload date:
- Size: 3.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.12.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ed17d8b6be82eda3da4b1c4ab41d2afcbc362e588d44f648bc4131c41560693d |
|
MD5 | d7d365a585b19a2c8ab428abaf7e6db7 |
|
BLAKE2b-256 | 0278dd6db2ec80548fc6a80382b2491ec9162e2d45585dc521098c837baa3bae |
File details
Details for the file aws_library-0.1-py3-none-any.whl
.
File metadata
- Download URL: aws_library-0.1-py3-none-any.whl
- Upload date:
- Size: 4.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.12.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 604eaf2db397f1ba7d607a869517e73f48c818bded19b7a9f3d03e00b2d7c4cc |
|
MD5 | 2aa1025ead3b853453a2601acc8254b6 |
|
BLAKE2b-256 | 3ee6c05aa42949c6e7d9adadd7147941e8d6acf8f5e348912fcb4602fe2f59b9 |