Skip to main content

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

This version

0.1

Download files

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

Source Distribution

aws_library-0.1.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

aws_library-0.1-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

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

Hashes for aws_library-0.1.tar.gz
Algorithm Hash digest
SHA256 ed17d8b6be82eda3da4b1c4ab41d2afcbc362e588d44f648bc4131c41560693d
MD5 d7d365a585b19a2c8ab428abaf7e6db7
BLAKE2b-256 0278dd6db2ec80548fc6a80382b2491ec9162e2d45585dc521098c837baa3bae

See more details on using hashes here.

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

Hashes for aws_library-0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 604eaf2db397f1ba7d607a869517e73f48c818bded19b7a9f3d03e00b2d7c4cc
MD5 2aa1025ead3b853453a2601acc8254b6
BLAKE2b-256 3ee6c05aa42949c6e7d9adadd7147941e8d6acf8f5e348912fcb4602fe2f59b9

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