awsimple 0.2.0

Simple AWS API for S3 and DynamoDB

awsimple

Simple API for basic AWS services

Usage

pip install awsimple

Examples

S3

# print string contents of an existing S3 object
s = S3Access(profile_name="testawsimple", bucket="testawsimple").read_string("helloworld.txt")
print(s)

DynamoDB

dynamodb_access = DynamoDBAccess(profile_name="testawsimple", table_name="testawsimple")

# put an item into DynamoDB
dynamodb_access.put_item({"id": "batman", "city": "Gotham"})

# now get it back
item = dynamodb_access.get_item("id", "batman")
print(item["city"])  # Gotham

Introduction

awsimple is a simple interface into basic AWS services such as S3 (Simple Storage Service) and DynamoDB (a simple NoSQL database). It has a set of higher level default settings and behavior that should cover many basic usage models.

Discussion

While AWS has many varied services with extensive flexibility, using it for more straight-forward applications is sometimes a daunting task. There are access modes that are probably not requried and some default behaviors are not best for common usages. awsimple aims to create a higher level API to AWS services (such as S3 and DynamoDB) to improve programmer productivity.

S3

awsimple calculates the local file hash (sha512) and inserts it into the S3 object metadata. This is used to test for file equivalency.

Caching

S3 objects and DynamoDB tables can be cached locally to reduce network traffic, minimize AWS costs, and potentially offer a speedup.

Whatawsimple Is Not

• awsimple is not necessarily memory and CPU efficient

• awsimple does not provide cost monitoring hooks

• awsimple does not provide all the options and features that the regular AWS API (e.g. boto3) does