A simple facade for Boto3
Project description
A simple facade for boto3 that makes some common tasks easier. The boto3facade module is not intended to be used directly but as a shared components of projects that use boto3.
Installation
To install the development version:
pip install git+https://github.com/FindHotel/boto3facade
To install the latest stable release:
pip install boto3facade
Quickstart
The boto3facade package contains a collection of modules that implement facades to different AWS services. For instance the boto3facade.ec2 module implements the facade to AWS EC2 service. Each of these modules typically contain just one class, named as the corresponding AWS service. E.g. the boto3facade.ec2 module contains an Ec2 class. In some cases, there may also be public module functions that implement utilities that don’t require access to the AWS boto3 SDK. For instance in the EC2 facade:
import boto3facade.ec2 as ec2
# Get the name of the role associated to the EC2 instance
if ec2.in_ec2():
# If this code is running in an EC2 instance
role_name = ec2.get_instance_profile_role()
else:
role_name = NoneFacade methods that actually use boto3 are always implemented as instance methods:
from boto3facade.ec2 import Ec2
# Create the facade object
my_ec2_facade = Ec2()
# Get the list of AMIs that have tags matching the provided ones
ami_tags = {'Name': 'niceimage', 'Version', 'latest'}
ami_list = my_ec2_facade.get_ami_by_tag(ami_tags)
# Get the SecurityGroup boto3 resource with a certain name
my_sg = my_ec2_facade.get_sg_by_name('sgname')Development
make develop . .env/bin/activate
Contact
If you have questions, bug reports, suggestions, etc. please create an issue on the GitHub project page.
License
This software is licensed under the MIT license
See License file
© 2016 German Gomez-Herrero, and FindHotel.
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
File details
Details for the file boto3facade-0.3.6.tar.gz.
File metadata
- Download URL: boto3facade-0.3.6.tar.gz
- Upload date:
- Size: 16.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 62b996d77ba7c0d5142c75ee2504eaa50c151f5b5460181b53fcebbfa0f52a88 |
|
| MD5 | 23ba53df7a510e23bce4fd1e5a2400b7 |
|
| BLAKE2b-256 | 79be94e5ec82277ad51924794dd95d0db30a4fb2b6fe1954f0e9cb2ad16d43a6 |
