cloudability 0.0.5 → 0.1.0

data/spec/fixtures/cost/reports

@@ -0,0 +1,18 @@
+HTTP/1.1 200 OK
+Server: nginx/1.4.4
+Date: Thu, 26 Dec 2013 07:58:43 GMT
+Content-Type: application/json
+Content-Length: 17437
+Connection: keep-alive
+Status: 200 OK
+Strict-Transport-Security: max-age=31536000
+Set-Cookie: _mkra_ctxt=38a29ac591a907a6ea6462573e6309c4--200; path=/; secure
+X-UA-Compatible: IE=Edge,chrome=1
+ETag: "ea20a4170651ebda67ae994220b6c558"
+Cache-Control: max-age=0, private, must-revalidate
+X-Request-Id: 95e301a456925e1ff3b97bf0cb673bde
+X-Runtime: 0.663877
+X-Rack-Cache: miss
+Origin: app.cloudability.com
+
+[{"id":1,"category":"Invoice Costs","title":"Account","description":null,"end_date":"today","start_date":"last week","end_date_is_relative":true,"start_date_is_relative":true,"owned_by_user":false,"shared":false,"custom":false,"metrics":[{"type":"metric","name":"invoiced_cost","label":"Total Invoiced Costs","description":"Total cost including taxes and credits","data_type":"currency","group":{"key":"billing","name":"Billing"},"sub_group":{"key":"costs","name":"Costs"}}],"dimensions":[{"type":"dimension","name":"linked_account_name","label":"Linked Account Name","description":"The account name for a linked account in consolidated billing","data_type":"string","group":{"key":"billing","name":"Billing"},"sub_group":{"key":"vendor","name":"Vendor"}}],"filters":[],"report_dimension_links":[]},{"id":2,"category":"Top Products","title":"All Products","description":null,"end_date":"today","start_date":"last week","end_date_is_relative":true,"start_date_is_relative":true,"owned_by_user":false,"shared":false,"custom":false,"metrics":[{"type":"metric","name":"invoiced_cost","label":"Total Invoiced Costs","description":"Total cost including taxes and credits","data_type":"currency","group":{"key":"billing","name":"Billing"},"sub_group":{"key":"costs","name":"Costs"}}],"dimensions":[{"type":"dimension","name":"service_key","label":"Product Code","description":"Shortened name of the product","data_type":"string","group":{"key":"billing","name":"Billing"},"sub_group":{"key":"vendor","name":"Vendor"}}],"filters":[],"report_dimension_links":[]}]

data/spec/fixtures/usage/filters

@@ -0,0 +1,18 @@
+HTTP/1.1 200 OK
+Server: nginx/1.4.4
+Date: Thu, 26 Dec 2013 18:23:36 GMT
+Content-Type: application/json
+Content-Length: 39
+Connection: keep-alive
+Status: 200 OK
+Strict-Transport-Security: max-age=31536000
+Set-Cookie: _mkra_ctxt=4b25dd0859fe4bffe0cff2b14c615917--200; path=/; secure
+X-UA-Compatible: IE=Edge,chrome=1
+ETag: "8762e8222fbc8f34a7359e143314adab"
+Cache-Control: max-age=0, private, must-revalidate
+X-Request-Id: c7062d59dc778b533dc4e0cfd94a9431
+X-Runtime: 0.010188
+X-Rack-Cache: miss
+Origin: app.cloudability.com
+
+["==","!=","<=",">=","<",">","=@","=~"]

data/spec/fixtures/usage/measures

@@ -0,0 +1,18 @@
+HTTP/1.1 200 OK
+Server: nginx/1.4.4
+Date: Thu, 26 Dec 2013 18:21:53 GMT
+Content-Type: application/json
+Content-Length: 15116
+Connection: keep-alive
+Status: 200 OK
+Strict-Transport-Security: max-age=31536000
+Set-Cookie: _mkra_ctxt=de570b8bd77b09a8585e532d37847226--200; path=/; secure
+X-UA-Compatible: IE=Edge,chrome=1
+ETag: "c96f24bb9f20de7fcca0972b52aa64f9"
+Cache-Control: max-age=0, private, must-revalidate
+X-Request-Id: 656a6fc360cb046750819e6fc2cc1028
+X-Runtime: 0.044087
+X-Rack-Cache: miss
+Origin: app.cloudability.com
+
+[{"type":"metric","name":"estimated_cost","label":"Estimated Cost","description":"Estimated based on usage hours multiplied by on-demand pricing","data_type":"currency","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"billing","name":"Billing"}},{"type":"metric","name":"avg_estimated_cost","label":"Avg Estimated Cost","description":"Average estimated cost","data_type":"currency","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"billing","name":"Billing"}},{"type":"metric","name":"avg_estimated_hourly_cost","label":"Avg Estimated Hourly Instance Cost","description":"Average estimated hourly cost","data_type":"currency","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"billing","name":"Billing"}},{"type":"metric","name":"num_attached_storage","label":"Storage Devices","description":"Number of attached storage devices","data_type":"integer","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"usage","name":"Usage"}},{"type":"metric","name":"inbound_bandwidth","label":"Bandwidth In","description":"The number of bytes inbound on the network","data_type":"bytes","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"usage","name":"Usage"}}]

data/spec/fixtures/usage/reports

@@ -0,0 +1,18 @@
+HTTP/1.1 200 OK
+Server: nginx/1.4.4
+Date: Fri, 27 Dec 2013 05:31:15 GMT
+Content-Type: application/json
+Content-Length: 44476
+Connection: keep-alive
+Status: 200 OK
+Strict-Transport-Security: max-age=31536000
+Set-Cookie: _mkra_ctxt=1f0f9e994c1eda7c8aaca1c638e169e7--200; path=/; secure
+X-UA-Compatible: IE=Edge,chrome=1
+ETag: "575c428e918fe64a860eaf6e6cc8ba2e"
+Cache-Control: max-age=0, private, must-revalidate
+X-Request-Id: 9534fd1ae2484ed36a74011e9f5816e4
+X-Runtime: 1.713328
+X-Rack-Cache: miss
+Origin: app.cloudability.com
+
+[{"id":2,"category":"Utilization","title":"Longest Running","description":null,"end_date":"today","start_date":"last week","end_date_is_relative":true,"start_date_is_relative":true,"owned_by_user":false,"shared":false,"custom":false,"metrics":[{"type":"metric","name":"hours_since_launch","label":"Hours Since Launch","description":"Hours since instance launch","data_type":"float","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"time","name":"Time"}},{"type":"metric","name":"utilization_hours","label":"Utilization Hours","description":"Utilization hours","data_type":"integer","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"usage","name":"Usage"}},{"type":"metric","name":"avg_estimated_hourly_cost","label":"Avg Estimated Hourly Instance Cost","description":"Average estimated hourly cost","data_type":"currency","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"billing","name":"Billing"}}],"dimensions":[{"type":"dimension","name":"instance_identifier","label":"Instance ID","description":"Instance ID","data_type":"string","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"common","name":"Common"}},{"type":"dimension","name":"instance_size","label":"Size","description":"Size of the Instance","data_type":"string","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"common","name":"Common"}}],"filters":[],"report_dimension_links":[]},{"id":3,"category":"Utilization","title":"Instance Aging","description":null,"end_date":"today","start_date":"last week","end_date_is_relative":true,"start_date_is_relative":true,"owned_by_user":false,"shared":false,"custom":false,"metrics":[{"type":"metric","name":"terminated_instances","label":"Terminated Instances","description":"Number of terminated instances","data_type":"integer","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"usage","name":"Usage"}},{"type":"metric","name":"running_instances","label":"Running Instances","description":"Number of running instances","data_type":"integer","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"usage","name":"Usage"}}],"dimensions":[{"type":"dimension","name":"days_since_launch","label":"Days Alive","description":"Days since instance was launched","data_type":"integer","group":{"key":"compute","name":"Compute"},"sub_group":{"key":"usage","name":"Usage"}}],"filters":[],"report_dimension_links":[]}]

data/spec/spec_helper.rb

@@ -1,4 +1,6 @@
 require 'rubygems'
+require 'coveralls'
+Coveralls.wear!
 require 'bundler'
 require 'fakeweb'
 require 'cloudability'
@@ -33,7 +35,6 @@ module FakeRequestHelpers
   end
 end
 
-
 RSpec.configure do |c|
   c.include(FakeRequestHelpers)
 
@@ -43,6 +44,7 @@ RSpec.configure do |c|
 end
 
 FakeWeb.allow_net_connect = false
+FakeWeb.allow_net_connect = %r[^https?://coveralls.io/api/v1/jobs]
 
 # Creating fixtures:
 # curl -is https://app.cloudability.com/api/0/billing_reports?auth_token=token&by=account > spec/fixtures/billing_report

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cloudability
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.1.0
 platform: ruby
 authors:
 - Colby Aley
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-25 00:00:00.000000000 Z
+date: 2013-12-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -81,6 +81,20 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Ruby wrapper for the Cloudability API
 email:
 - colby@cloudability.com
@@ -97,24 +111,33 @@ files:
 - Rakefile
 - cloudability.gemspec
 - lib/cloudability.rb
-- lib/cloudability/billing.rb
-- lib/cloudability/budgets.rb
-- lib/cloudability/credentials.rb
-- lib/cloudability/organizations.rb
-- lib/cloudability/time_helper.rb
+- lib/cloudability/client/billing_reports.rb
+- lib/cloudability/client/budgets.rb
+- lib/cloudability/client/cost_reports.rb
+- lib/cloudability/client/credentials.rb
+- lib/cloudability/client/organizations.rb
+- lib/cloudability/client/usage_reports.rb
 - lib/cloudability/version.rb
 - spec/cloduability/billing_spec.rb
 - spec/cloduability/budgets_spec.rb
+- spec/cloduability/cost_spec.rb
 - spec/cloduability/credentials_spec.rb
 - spec/cloduability/organizations_spec.rb
-- spec/fixtures/all_budgets
+- spec/cloduability/usage_spec.rb
+- spec/fixtures/billing_reports
+- spec/fixtures/budgets
+- spec/fixtures/cost/filters
+- spec/fixtures/cost/measures
+- spec/fixtures/cost/report
+- spec/fixtures/cost/reports
 - spec/fixtures/credentials
 - spec/fixtures/organization
 - spec/fixtures/organization_invitation
 - spec/fixtures/organization_invitations
 - spec/fixtures/organization_roles
-- spec/fixtures/report_by_account
-- spec/fixtures/report_by_period
+- spec/fixtures/usage/filters
+- spec/fixtures/usage/measures
+- spec/fixtures/usage/reports
 - spec/spec_helper.rb
 homepage: https://github.com/colbyaley/cloudability
 licenses:
@@ -143,14 +166,22 @@ summary: Ruby wrapper for the Cloudability API built with HTTParty
 test_files:
 - spec/cloduability/billing_spec.rb
 - spec/cloduability/budgets_spec.rb
+- spec/cloduability/cost_spec.rb
 - spec/cloduability/credentials_spec.rb
 - spec/cloduability/organizations_spec.rb
-- spec/fixtures/all_budgets
+- spec/cloduability/usage_spec.rb
+- spec/fixtures/billing_reports
+- spec/fixtures/budgets
+- spec/fixtures/cost/filters
+- spec/fixtures/cost/measures
+- spec/fixtures/cost/report
+- spec/fixtures/cost/reports
 - spec/fixtures/credentials
 - spec/fixtures/organization
 - spec/fixtures/organization_invitation
 - spec/fixtures/organization_invitations
 - spec/fixtures/organization_roles
-- spec/fixtures/report_by_account
-- spec/fixtures/report_by_period
+- spec/fixtures/usage/filters
+- spec/fixtures/usage/measures
+- spec/fixtures/usage/reports
 - spec/spec_helper.rb

data/lib/cloudability/billing.rb

@@ -1,65 +0,0 @@
-module Cloudability
-  class Billing
-    include HTTParty
-    base_uri "https://app.cloudability.com/api/0"
-    format :json
-
-    attr_accessor :auth_token
-
-    def initialize(options={})
-      raise ArgumentError, "You must provide an auth token" if options[:auth_token].nil?
-
-      @auth_token = options[:auth_token]
-      @params=[]
-    end
-
-    # Define which dimension the billing report will return.
-    #
-    # @param [Symbol] dimension to report on.
-    # @return [Array] array of Hashie::Mashes
-    def report_by(dimension)
-      case dimension
-      when :account
-        @params << "&by=account"
-      when :credential
-        @params << "&by=credential"
-      when :period
-        @params << "&by=period"
-      when :service
-        @params << "&by=service"
-      when :vendor
-        @params << "&by=vendor"
-      else
-        raise ArgumentError, "You must provide a valid dimension to report on."
-      end
-
-      billings = get_url(@params)
-      billings.map { |b| Hashie::Mash.new(b) }
-    end
-
-    # Find a particular period, based on its month.
-    # Period must be in YY-MM-01 format with the date always 01.
-    def filter_by_period(period)
-      unless period =~ /^[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$/
-        raise ArgumentError, "You must provide a valid date in the form of 'YY-MM-DD'."
-      end
-
-      @params << "&period=#{period}"
-      single_billing = get_url(@params).first
-
-      Hashie::Mash.new(single_billing)
-    end
-
-    private
-
-    # GET a URL with HTTParty
-    #
-    # @param [Array] array of URL params to pass to HTTParty
-    def get_url(params)
-      joined_param = params.join
-      response = self.class.get("/billing_reports?auth_token=#{@auth_token}#{joined_param}")
-      response.success? ? response : raise(response.response)
-    end
-
-  end
-end

data/lib/cloudability/budgets.rb

@@ -1,61 +0,0 @@
-module Cloudability
-  class Budgets
-    include HTTParty
-    base_uri "https://app.cloudability.com/api/1"
-    format :json
-
-    attr_accessor :auth_token
-
-    def initialize(options={})
-      raise ArgumentError, "You must provide an auth token" if options[:auth_token].nil?
-      @auth_token = options[:auth_token]
-    end
-
-    # Return all the budgets for the current account, and return as mash's.
-    def find_all
-      convert_to_mashes(get_budgets)
-    end
-
-    # Find a particular budget, based on its id, and return a mash.
-    def find_by_id(id)
-      find_all.select {|b| b.id == id}.first
-    end
-
-    # Find a particular budget, based on its subject, and return a mash.
-    def find_by_subject(subject)
-      unless subject.length == 14
-        raise ArgumentError, "You must provide a valid subject such as 1234-5678-9101."
-      end
-      
-      find_all.select {|b| b.subject == subject}.first
-    end
-
-    # Find a particular budget, based on a key, and return a mash.
-    def find_by_key(options={})
-      case options[:key]
-      when :id
-        budget = find_by_id(options[:value])
-      when :subject
-        budget = find_by_subject(options[:value])
-      else
-        raise ArgumentError, "You must provide a valid key."
-      end
-    end
-
-    private
-
-    def get_budgets
-      response = self.class.get("/budgets/index?auth_token=#{@auth_token}")
-      response.success? ? response : raise(response.response)
-    end
-
-    # Convert the JSON into an Array of Mashes.
-    #
-    # @param [String] JSON array
-    # @return [Array] array of Hashie::Mashes
-    def convert_to_mashes(response)
-      response.map { |budget| Hashie::Mash.new(budget) }
-    end
-
-  end
-end

data/lib/cloudability/credentials.rb

@@ -1,34 +0,0 @@
-module Cloudability
-  class Credentials
-    include HTTParty
-    base_uri "https://app.cloudability.com/api/0"
-    format :json
-
-    attr_accessor :auth_token
-
-    def initialize(options={})
-      raise ArgumentError, "You must provide an auth token" if options[:auth_token].nil?
-      @auth_token = options[:auth_token]
-    end
-
-    def find_all
-      convert_to_mashes(get_credentials)
-    end
-
-    private
-
-    def get_credentials
-      response = self.class.get("/credentials/index?auth_token=#{@auth_token}")
-      response.success? ? response : raise(response.response)
-    end
-
-    # Convert the JSON into an Array of Mashes.
-    #
-    # @param [String] JSON array
-    # @return [Array] array of Hashie::Mashes
-    def convert_to_mashes(response)
-      response.map { |credential| Hashie::Mash.new(credential) }
-    end
-
-  end
-end

data/lib/cloudability/organizations.rb

@@ -1,71 +0,0 @@
-module Cloudability
-  class Organizations
-    include HTTParty
-    base_uri "https://app.cloudability.com/api/1"
-    format :json
-
-    attr_accessor :auth_token
-
-    def initialize(options={})
-      raise ArgumentError, "You must provide an auth token" if options[:auth_token].nil?
-
-      @auth_token = options[:auth_token]
-    end
-
-    def my_organization
-      response = get_url("/organizations?auth_token=#{@auth_token}")
-      Hashie::Mash.new(response)
-    end
-
-    def invitations
-      response = get_url("/organizations/invitations?auth_token=#{@auth_token}")
-      convert_to_mashes(response)
-    end
-
-    def roles
-      response = get_url("/organizations/roles?auth_token=#{@auth_token}")
-      convert_to_mashes(response)
-    end
-
-    # Invite a user to your organization
-    #
-    # @param [Hash] args to pass to HTTParty
-    #   @option [String] email (required)
-    #   @option [String] name
-    #   @option [String] role_id
-    def invite_user(args)
-      raise ArgumentError, "You must provide an email" if args[:email].nil?
-
-      response = post_url("/organizations/invitations?auth_token=#{@auth_token}", args)
-      Hashie::Mash.new(response)
-    end
-
-    private
-
-    # POST a URL with HTTParty
-    #
-    # @param [String] URL to post
-    # @param [Hash] params to pass to HTTParty
-    def post_url(url, params={})
-      response = self.class.post(url, query: params)
-      response.success? ? response : raise(response.response)
-    end
-
-    # GET a URL with HTTParty
-    #
-    # @param [String] URL to get
-    def get_url(url)
-      response = self.class.get(url)
-      response.success? ? response : raise(response.response)
-    end
-
-    # Convert the JSON into an Array of Mashes.
-    #
-    # @param [String] JSON array
-    # @return [Array] array of Hashie::Mashes
-    def convert_to_mashes(response)
-      response.map { |budget| Hashie::Mash.new(budget) }
-    end
-
-  end
-end

data/lib/cloudability/time_helper.rb

@@ -1,25 +0,0 @@
-require 'date'
-require 'hashie'
-
-# Cloudability requires time periods formatted in YYYY-MM-01 The date must always be 1.
-# This provides a set of helpers to always return the correct period format.
-
-class TimeHelper
-
-  def last_three_months
-    dt = DateTime.now
-
-    current_month = dt.strftime("%Y-%m-01")
-    last_month    = (dt << 1).strftime("%Y-%m-01")
-    three_month   = (dt << 2).strftime("%Y-%m-01")
-   
-    hash = { current: current_month, last: last_month, three: three_month }    
-    Hashie::Mash.new(hash)
-  end
-
-  # Returns the current month
-  def current_month
-    DateTime.now.strftime("%Y-%m-01")
-  end
-
-end