awspricing

A Python library for working with the AWS Price List API.

Features:

• Simple boto3-like interface
• Service-specific helpers (only EC2 and RDS thus far)
• Local caching support

Installation

$ pip install awspricing

Usage

import awspricing

ec2_offer = awspricing.offer('AmazonEC2')

ec2_offer.search_skus(
  instance_type='c4.large',
  location='US East (N. Virginia)',
  operating_system='Linux',
)  # {'4C7N4APU9GEUZ6H6', 'MBQPYDJSY3BY84BH', 'MDKVAJXMJGZFDJUE'}

ec2_offer.reserved_hourly(
  'c4.xlarge',
  operating_system='Linux',
  lease_contract_length='3yr',
  offering_class='convertible',
  purchase_option='Partial Upfront',
  region='us-east-1'
)  # 0.10845205479452055

rds_offer = awspricing.offer('AmazonRDS')

rds_offer.search_skus(
  instance_type='db.m4.large',
  location='US East (N. Virginia)',
  database_engine='MySQL',
  license_model='No license required',
  deployment_option='Multi-AZ'
) # {'QPZNR6MYN432XTPU'}

rds_offer.ondemand_hourly(
  'db.m4.large',
  'MySQL',
  license_model='No license required',
  deployment_option='Multi-AZ',
  region='us-east-1'
) # 0.35

Configuration

Cache

Cache can be configured via the following environment variables:

AWSPRICING_USE_CACHE: Whether to use a simple file-based cache. Valid values are 0|1. Defaults to 0 (false).

AWSPRICING_CACHE_PATH: Prefix to write cache files. Defaults to /tmp/awspricing.

AWSPRICING_CACHE_MINUTES: Number of minutes to keep cache for. Defaults to 1440 (1 day).

Developing

Environment setup

Run the following commands (preferably in a virtualenv) to setup your environment:

Running unit tests

Simply run make test after environment setup to run unit tests.

Running mypy (type checker)

The following commands can be used to run type checks. Note that a python3 interpreter is required for mypy.

pip install mypy
make test_mypy