Metadata-Version: 2.1
Name: awsimple
Version: 0.0.12
Summary: Simple AWS API for S3 and DynamoDB
Home-page: https://github.com/jamesabel/awsimple
Author: abel
Author-email: j@abel.co
License: MIT License
Download-URL: https://github.com/jamesabel/awsimple
Keywords: aws,cloud,storage,database,dynamodb,s3
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: ismain
Requires-Dist: balsa
Requires-Dist: boto3
Requires-Dist: typeguard


# awsimple

Simple API for basic AWS services

## Usage

    pip install awsimple

## Examples

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

## 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.

## Caching

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

## What`awsimple` 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


