Metadata-Version: 2.1
Name: madeira
Version: 1.0.5
Summary: Common AWS operation wrappers
Home-page: https://github.com/mxmader/madeira
Author: Joe Mader
Author-email: jmader@jmader.com
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
Requires-Dist: boto3

# Madeira

This is a python package which provides wrapper classes and convenience methods for the 
Amazon Web Servces (AWS) python deployment SDK (`boto3`).

In several deployment automation projects I've built over the years, I've found that 
"bare metal control" over interaction with AWS services allows me to leverage features 
released by AWS into `boto3` the moment they're available, rather than waiting on 3rd 
party CM tool authors/vendors to wrap *all* required functionality. Concurrently, this 
reduces the footprint of project external dependencies.

Given that most projects I work on are "pure python", this approach requires less mental 
context switching compared to using template-driven CM tools. 

## Installation

This package is hosted on [PyPI](pypi.org), so you may simply:

```
pip install --user madeira
```

## Support

Intended for use with Python 3.7 or later.

## Limitations

Not all AWS services are represented; similarly, not all features of AWS services
that are represented here are "wrapped".

## Package name origins

Since the AWS python SDK is called `boto`, which refers to Amazon River dolphins,
I figured I'd attempt to follow the pattern and name this after a tributary of the 
Amazon River, given that the point of these wrappers is to deploy objects into AWS,
The analogy seemed to solve the problem of developer naming creativity...
:stuck_out_tongue_winking_eye:

