awscosts 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in awscosts.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Stephen Bartlett
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,86 @@
+# Awscosts
+
+AWSCosts allows programmatic access to AWS pricing.
+
+Useful for calculating the running costs of your fleet of EC2 instances and
+associated services such as ELBs, RDS, CloudWatch, etc.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'awscosts'
+
+Or install it yourself as:
+
+    $ gem install awscosts
+
+## Usage
+
+Pricing is usually defined by region
+
+    region = AWSCosts.region 'us-east-1'
+
+### On Demand
+
+To find the price of all on-demand EC2 instances running linux
+
+    region.ec2.on_demand(:linux).price
+
+You can pass an argument to price to filter by the instance type.
+
+    region.ec2.on_demand(:linux).price('m1.medium')
+
+### Reserved
+
+To find the **upfront** price of reserving Windows instance for light utilization
+
+    region.ec2.reserved(:windows, :light).upfront
+
+To find the **hourly** price of a `m1.large` reserved Windows with SQL instance for medium utilization
+
+    region.ec2.reserved(:windows_with_sql, :medium).hourly('m1.large')
+
+### ELB
+
+To find the hourly price of an ELB in the Sydney region.
+
+    AWSCosts.region('ap-southeast-2').ec2.elb.price_per_hour
+
+To find the price per GB processed of an ELB in the Sydney region.
+
+    AWSCosts.region('ap-southeast-2').ec2.elb.price_per_gb
+
+## Supported Services
+
+The following AWS services are currently support (more to come):
+
+* On-demand instances
+* Reserved light utilisation
+* Reserved medium utilisation
+* Reserved heavy utilisation
+* Elastic Load Balancer (ELB)
+
+EC2 platforms:
+
+* Linux (:linux)
+* RHEL (:rhel)
+* SLES (:sles)
+* Windows (:windows)
+* Windows with SQL (:windows_with_sql)
+* Windows with SQL Web (:windows_with_sql_web)
+
+## Roadmap
+
+Possible items on the roadmap are:
+
+1. Cost calculation using a DSL to describe your AWS environment.
+2. Cost calculation from a Cloudformation template.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+desc "Run the tests"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = ENV['rspec_pattern'] || "spec/**/*_spec.rb"
+  t.rspec_opts = [
+    "--colour",
+    "--require",  "spec_helper"
+  ]
+end

data/awscosts.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'awscosts/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "awscosts"
+  spec.version       = AWSCosts::VERSION
+  spec.authors       = ["Stephen Bartlett"]
+  spec.email         = ["stephenb@rtlett.org"]
+  spec.description   = %q{AWSCosts provides an easier way to calculate the costs of running your project in AWS}
+  spec.summary       = %q{Programmatic access to AWS pricing}
+  spec.homepage      = "https://github.com/srbartlett/awscosts"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "httparty", "~> 0.11.0"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency 'rspec'
+end

data/lib/awscosts/ec2.rb

@@ -0,0 +1,29 @@
+require 'awscosts/ec2_on_demand'
+require 'awscosts/ec2_reserved_instances'
+require 'awscosts/ec2_elb'
+
+class AWSCosts::EC2
+
+  attr_reader :region
+
+  TYPES = { windows: 'mswin', linux: 'linux', windows_with_sql: 'mswinSQL',
+            windows_with_sql_web: 'mswinSQLWeb', rhel: 'rhel', sles: 'sles' }
+
+  def initialize region
+    @region = region
+  end
+
+  def on_demand(type)
+    AWSCosts::EC2OnDemand.fetch(type, self.region.price_mapping)
+  end
+
+  def reserved(type, utilisation= :light)
+    AWSCosts::EC2ReservedInstances.fetch(type, utilisation, self.region.price_mapping)
+  end
+
+  def elb
+    AWSCosts::ELB.fetch(self.region.price_mapping)
+  end
+end
+
+

data/lib/awscosts/ec2_elb.rb

@@ -0,0 +1,36 @@
+require 'httparty'
+require 'json'
+
+class AWSCosts::ELB
+
+  def initialize data
+    @data= data
+  end
+
+  def price_per_hour
+    @data['perELBHour']
+  end
+
+  def price_per_gb
+    @data['perGBProcessed']
+  end
+
+  def self.fetch region
+    @fetch ||= begin
+      result = {}
+      data= JSON.parse(HTTParty.get('http://aws.amazon.com/ec2/pricing/pricing-elb.json').body)
+      data['config']['regions'].each do |region|
+        container = {}
+        region['types'].each do |type|
+          type['values'].each do |value|
+            container[value['rate']] = value['prices']['USD'].to_f
+          end
+        end
+        result[region['region']] = container
+      end
+      result
+    end
+    self.new(@fetch[region])
+  end
+
+end

data/lib/awscosts/ec2_on_demand.rb

@@ -0,0 +1,67 @@
+require 'httparty'
+require 'json'
+
+class AWSCosts::EC2OnDemand
+
+  TYPE_TRANSLATION = { 'stdODI.sm' => 'm1.small',
+                     'stdODI.med' => 'm1.medium',
+                     'stdODI.lg' => 'm1.large',
+                     'stdODI.xl' => 'm1.xlarge',
+                     'secgenstdODI.xl' => 'm3.xlarge',
+                     'secgenstdODI.xxl' => 'm3.2xlarge',
+                     'uODI.u' => 't1.micro',
+                     'hiMemODI.xl' => 'm2.xlarge',
+                     'hiMemODI.xxl' => 'm2.2xlarge',
+                     'hiMemODI.xxxxl' => 'm2.4xlarge',
+                     'hiCPUODI.med' => 'c1.medium',
+                     'hiCPUODI.xl' => 'c1.xlarge',
+                     'clusterComputeI.xxxxl' => 'cc1.4xlarge',
+                     'clusterComputeI.xxxxxxxxl' => 'cc2.8xlarge',
+                     'clusterGPUI.xxxxl' => 'cg1.4xlarge',
+                     'clusterHiMemODI.xxxxxxxxl' => 'cr1.8xlarge',
+                     'hiStoreODI.xxxxxxxxl' => 'hs1.8xlarge',
+                     'hiIoODI.xxxxl' => 'hi1.4xlarge' }
+
+  def initialize type, data
+    @type = type
+    @data= data
+  end
+
+  def price size=nil
+    size ? @data[TYPE_MAPPING[@type]][size] : @data[TYPE_MAPPING[@type]]
+  end
+
+  def self.fetch type, region
+    raw_data= cache[type] ||= begin
+      result = {}
+      data= JSON.parse(HTTParty.get("http://aws.amazon.com/ec2/pricing/json/#{AWSCosts::EC2::TYPE_MAPPING[type]}-od.json").body)
+      data['config']['regions'].each do |region|
+        platforms = {}
+        region['instanceTypes'].each do |instance_type|
+          type = instance_type['type']
+          instance_type['sizes'].each do |instance_size|
+            size = instance_size['size']
+            platform_cost = Hash.new({})
+            instance_size['valueColumns'].each do |value|
+              platform_cost[value['name']] = value['prices']['USD'].to_f
+            end
+
+            platform_cost.each_pair do |p,v|
+              platforms[p] = {} unless platforms.key?(p)
+              platforms[p][TYPE_TRANSLATION["#{type}.#{size}"]] = v
+            end
+          end
+        end
+        result[region['region']] = platforms
+      end
+      result
+    end
+    self.new(type, raw_data[region])
+  end
+
+  private
+  def self.cache
+    @@cache ||= {}
+  end
+end
+

data/lib/awscosts/ec2_reserved_instances.rb

@@ -0,0 +1,81 @@
+require 'httparty'
+require 'json'
+class AWSCosts::EC2ReservedInstances
+
+  TERMS = { one_year: 'yrTerm1', three_year: 'yrTerm3' }
+
+  TYPE_TRANSLATION = { 'stdResI.sm' => 'm1.small',
+                     'stdResI.med' => 'm1.medium',
+                     'stdResI.lg' => 'm1.large',
+                     'stdResI.xl' => 'm1.xlarge',
+                     'secgenstdResI.xl' => 'm3.xlarge',
+                     'secgenstdResI.xxl' => 'm3.2xlarge',
+                     'uResI.u' => 't1.micro',
+                     'hiMemResI.xl' => 'm2.xlarge',
+                     'hiMemResI.xxl' => 'm2.2xlarge',
+                     'hiMemResI.xxxxl' => 'm2.4xlarge',
+                     'hiCPUResI.med' => 'c1.medium',
+                     'hiCPUResI.xl' => 'c1.xlarge',
+                     'clusterComputeI.xxxxl' => 'cc1.4xlarge',
+                     'clusterComputeI.xxxxxxxxl' => 'cc2.8xlarge',
+                     'clusterGPUI.xxxxl' => 'cg1.4xlarge',
+                     'clusterHiMemResI.xxxxxxxxl' => 'cr1.8xlarge',
+                     'hiStoreResI.xxxxxxxxl' => 'hs1.8xlarge',
+                     'hiIoResI.xxxxl' => 'hi1.4xlarge' }
+  def initialize data
+    @data= data
+  end
+
+  def upfront term, size=nil
+    if size
+      @data[TERMS[term]][size]
+    else
+      @data[TERMS[term]]
+    end
+  end
+
+  def hourly term, size=nil
+    if size
+      @data["#{TERMS[term]}Hourly"][size]
+    else
+      @data["#{TERMS[term]}Hourly"][size]
+    end
+  end
+
+
+  def self.fetch type, utilisation, region
+    raw_data= cache[type] ||= begin
+      result = {}
+      data= JSON.parse(HTTParty.get("http://aws.amazon.com/ec2/pricing/json/#{AWSCosts::EC2::TYPES[type]}-ri-#{utilisation}.json").body)
+      data['config']['regions'].each do |region|
+        platforms = {}
+        region['instanceTypes'].each do |instance_type|
+          type = instance_type['type']
+          instance_type['sizes'].each do |instance_size|
+            size = instance_size['size']
+            platform_cost = Hash.new({})
+
+            instance_size['valueColumns'].each do |value|
+              platform_cost[value['name']] = value['prices']['USD']
+            end
+
+            platform_cost.each_pair do |p,v|
+              platforms[p] = {} unless platforms.key?(p)
+              platforms[p][TYPE_TRANSLATION["#{type}.#{size}"]] = v
+            end
+          end
+        end
+        result[region['region']] = platforms
+      end
+      result
+    end
+    self.new(raw_data[region])
+  end
+
+
+  private
+  def self.cache
+    @@cache ||= {}
+  end
+end
+

data/lib/awscosts/region.rb

@@ -0,0 +1,34 @@
+
+class AWSCosts::Region
+
+  attr_reader :name, :full_name, :price_mapping
+
+  SUPPORTED =  {
+    'us-east-1' => { :full_name => 'US (Northern Virginia)', :price_mapping => 'us-east' },
+    'us-west-1' => { :full_name => 'US (Northern California)', :price_mapping => 'us-west' },
+    'us-west-2' => { :full_name => 'US (Oregon)', :price_mapping => 'us-west-2' },
+    'eu-west-1' => { :full_name => 'EU (Ireland)', :price_mapping => 'eu-ireland' },
+    'ap-southeast-1' => { :full_name => 'Asia Pacific (Singapore)', :price_mapping => 'apac-sin' },
+    'ap-southeast-2' => { :full_name => 'Asia Pacific (Sydney)', :price_mapping => 'apac-syd' },
+    'ap-northeast-1' => { :full_name => 'Asia Pacific (Tokyo)', :price_mapping => 'apac-tokyo' },
+    'sa-east-1' => { :full_name => 'South America (Sao Paulo)', :price_mapping => 'sa-east-1' }
+  }
+
+  def self.find name
+    SUPPORTED[name] ? self.new(name) : nil
+  end
+
+
+  def ec2
+    AWSCosts::EC2.new(self)
+  end
+
+
+  private
+  def initialize name
+    @name = name
+    @full_name = SUPPORTED[name][:full_name]
+    @price_mapping = SUPPORTED[name][:price_mapping]
+  end
+
+end

data/lib/awscosts/version.rb

@@ -0,0 +1,3 @@
+module AWSCosts
+  VERSION = "0.0.1"
+end

data/lib/awscosts.rb

@@ -0,0 +1,13 @@
+require "awscosts/version"
+require "awscosts/region"
+require "awscosts/ec2"
+
+module AWSCosts
+
+  extend self
+
+  def region name
+    AWSCosts::Region.find name
+  end
+
+end

data/spec/awscosts/ec2_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+describe AWSCosts::EC2 do
+
+  subject { AWSCosts::EC2.new('us-east-1') }
+
+  it { should respond_to(:region) }
+
+
+end
+
+

data/spec/awscosts/region_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe AWSCosts::Region do
+
+  subject { AWSCosts::Region.find('us-east-1') }
+
+  it { should respond_to(:name) }
+  it { should respond_to(:full_name) }
+
+  describe '.find' do
+
+    describe 'for a supported region' do
+      it 'should be an instance of Region' do
+        subject.should be_a(AWSCosts::Region)
+      end
+    end
+    describe 'for an unsupported region' do
+      it 'should return nothing' do
+        AWSCosts::Region.find('NotValid').should be_nil
+      end
+    end
+  end
+
+  describe '.ec2' do
+    it 'should be an instance of EC2' do
+      subject.ec2.should be_a(AWSCosts::EC2)
+    end
+
+  end
+end
+
+

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'awscosts'
+
+
+
+

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: awscosts
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Stephen Bartlett
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: AWSCosts provides an easier way to calculate the costs of running your
+  project in AWS
+email:
+- stephenb@rtlett.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- awscosts.gemspec
+- lib/awscosts.rb
+- lib/awscosts/ec2.rb
+- lib/awscosts/ec2_elb.rb
+- lib/awscosts/ec2_on_demand.rb
+- lib/awscosts/ec2_reserved_instances.rb
+- lib/awscosts/region.rb
+- lib/awscosts/version.rb
+- spec/awscosts/ec2_spec.rb
+- spec/awscosts/region_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/srbartlett/awscosts
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4440165124257606433
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4440165124257606433
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Programmatic access to AWS pricing
+test_files:
+- spec/awscosts/ec2_spec.rb
+- spec/awscosts/region_spec.rb
+- spec/spec_helper.rb