enstratus 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+config.yaml
+examples/load.rb

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in enstratus.rb.gemspec
+gemspec

data/NOTES.md

@@ -0,0 +1,80 @@
+_This is currently just the contents of the previous README_
+
+# Setup
+
+- Copy config-sample.yaml to config.yaml
+- Edit config.yaml with your API keys
+- Try running `examples/list-servers.rb`
+
+# Notes
+The only part of the library that's fleshed out right now is the request signer.
+The examples are mainly the way I'm testing each aspect of the API right now.
+
+## Specific example notes
+Other than `list-regions`,`list-servers` and `list-clouds`, all the examples require some additional configuration. Take `list-datacenters` for instance:
+
+- The list datacenters call REQUIRES a regionID as a query param
+- If you run `list-regions.rb`, you can get a list of regionIds that API key has access to
+- replace `@region_id = "11111111"` in `list-datacenters` with the appropriate region
+- run `list-datacenters` and you should get the details back for that.
+
+
+# Creating/Deleting a server
+Now to be able to create a server, you'll need three bits of information:
+
+- datacenterId
+- machineImageId
+- productId
+
+We have a way of getting the datacenterID as described above. Now we need to get the machineImageId.
+
+To get a list of machineImageIds, we HAVE to provide a regionId. We have that from above. So we update `list-images` with the regionId and we get back a list of machine images for that region.
+
+_Note there are bugs in the current release of the API that are fixed in the next release. If you get an auth failure, please retry your request_
+
+To get the list of available product ids, you'll need to run `list-products` with the appropriate regionID (or alternately a machineImageId). Since there's currently a bug with listing by region (you must provide an architecture), we're going to pass in a machineImageId instead.
+
+This will give us a list of valid products for the image we want to use.
+
+Now that you have all that information (datacenterID,machineImageId and productID), you can update create-server and run it. Server creation is an async process. Your response will look something like this:
+
+```ruby
+{"jobs"=>[{"jobId"=>56681, "status"=>"RUNNING"}]}
+```
+
+To see the status of all jobs, there's a `list-jobs` script that returns:
+
+```ruby
+{"jobs"=>
+  [
+   {"startDate"=>"2012-04-18T17:11:34.613+0000",
+    "jobId"=>56681,
+    "status"=>"RUNNING",
+    "description"=>"Launch Server enstratus.rb"}]}
+```
+
+When it's finally done, you'll see this:
+
+```ruby
+{"jobs"=>
+  [{"message"=>"241542",
+    "startDate"=>"2012-04-18T17:11:34.613+0000",
+    "jobId"=>56681,
+    "status"=>"COMPLETE",
+    "description"=>"Launch Server enstratus.rb",
+    "endDate"=>"2012-04-18T17:13:16.658+0000"}]}
+```
+
+Obviously, we don't want to leave this running so we edit `delete-server` and put in the machine ID. Again, you can call list-servers to get that. Delete calls do not return any content so you'll have to list jobs to see what's up:
+
+```ruby
+{"jobs"=>
+  [
+   {"startDate"=>"2012-04-18T17:23:54.075+0000",
+    "jobId"=>56682,
+    "status"=>"RUNNING",
+    "description"=>"Terminate 241542"}]}
+```
+
+If you call list-servers after the job is finished, the server should be gone
+ 

data/README.md

@@ -0,0 +1,51 @@
+# enstratus-ruby
+This will soon be the gem to use for interacting with the enStratus API.
+
+## Currently Implemented GET operations (by resource group)
+
+_testing against enStratus SaaS api version 2012-02-29_
+
+- Admin (all)
+- Anayltics (all)
+- Finance (all)
+- Geography (all)
+- Infrastructure (all)
+- Automation (deployment, tier)
+
+## status - 2012/05/06
+I'm currently adding read-only support for all resources. The actual structure of a resource class may change.
+
+**HOWEVER**
+
+If you'd like to test against, your account:
+
+
+(in an irb/pry session)
+```ruby
+require 'enstratus'
+require 'pp'
+
+Enstratus.configure("/path/to/config.yaml")
+
+Enstratus::Infrastructure::Server.all
+
+# array of Enstratus::Infrastructure::Server objects returned
+```
+
+See `lib/enstratus/infrastructure/` or `lib/enstratus/geography` for other resources currently done.
+
+There is currently no error handling in place for calls that require query params. If you get some wonky errors, try
+
+```ruby
+Enstratus::Geography::Region.all
+
+# list of known regions returned
+
+Enstratus::Infrastructure::MachineImage.all :regionId => some_region_id_from_above
+
+# list of Machine Images returned
+```
+
+Again, currently read-only operations (so any `GET` call documented is implemented but not against all resources.
+
+There's a small sample program in `examples` that shows what the current API I'm using to validate reads is. Likely to change.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/TODO.md

@@ -0,0 +1,21 @@
+# Fix `to_underscore` helper
+Currently borking on all caps strings i.e. `subscribedCDN` becomes `subscribed_cd_n` instead of `subscribed_cdn`
+
+# move attributes to elements where appropriate
+Need to create a dsl for `elements` similar to attributes with appropriate distinction
+
+# finish wiring up attributes (and elements)
+Placeholders exist for handling extended information (mutability, type) but this needs to be fleshed out fully.
+Same goes for elements when they come in to play.
+
+# flesh out collections
+Shitty array of objects is shitty. Do it right.
+
+# error/exception handling
+yeah...could use some
+
+# remainder of CRUD
+need to wire up ALL The operations
+
+# tests
+I don't always test but when I do....

data/config-sample.yaml

@@ -0,0 +1,5 @@
+debug: false
+endpoint: "https://api.enstratus.com"
+version: "2012-02-29"
+access_key: XXXXXXXXXXXXXXXXXXXXXXXXXXX
+secret_key: YYYYYYYYYYYYYYYYYYYYYYYYYYY

data/enstratus.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "enstratus/version"
+
+Gem::Specification.new do |s|
+  s.name        = "enstratus"
+  s.version     = Enstratus::VERSION
+  s.authors     = ["John E. Vincent"]
+  s.email       = ["lusis.org+github.com@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{enStratus API gem}
+  s.description = %q{gem for interacting with the enStratus API}
+
+  s.rubyforge_project = "enstratus"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  s.add_runtime_dependency "excon"
+end

data/examples/list-servers.rb

@@ -0,0 +1,17 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), "..", "lib")))
+require 'enstratus'
+require 'pp'
+
+Enstratus.configure("#{File.expand_path(File.join(File.dirname(__FILE__), ".."))}/config.yaml")
+# uncomment and set to true for raw repsonses
+# or set debug: true in config.yaml
+
+#Enstratus.configuration.debug = false
+
+all_servers = Enstratus::Infrastructure::Server.all
+
+# Pick the first server from all servers
+single_server = Enstratus::Infrastructure::Server[all_servers.first.server_id]
+
+pp all_servers
+pp single_server

data/lib/enstratus.rb

@@ -0,0 +1,49 @@
+require "enstratus/version"
+require 'base64'
+require 'openssl'
+require 'excon'
+require 'yaml'
+require 'json'
+
+module Enstratus
+  UA = "enstratus.rb"
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure(config_file=nil)
+    self.configuration ||= Configuration.new
+    if config_file.nil?
+      yield(configuration)
+    else
+      begin
+        c = YAML.load(File.open(config_file, 'r'){|f| f.read})
+        c.each do |k,v|
+          self.configuration.instance_variable_set("@#{k}", v)
+        end
+      rescue Exception => e
+        puts e.message
+      end
+    end
+  end
+
+  def self.debug?
+    Enstratus.configuration.debug || false
+  end
+
+end
+
+require 'enstratus/util'
+require 'enstratus/configuration'
+require 'enstratus/request_signer'
+require 'enstratus/request'
+require 'enstratus/resource'
+require 'enstratus/platform'
+require 'enstratus/infrastructure'
+require 'enstratus/geography'
+require 'enstratus/admin'
+require 'enstratus/analytics'
+require 'enstratus/automation'
+require 'enstratus/finance'
+require 'enstratus/network'

data/lib/enstratus/admin.rb

@@ -0,0 +1,13 @@
+module Enstratus
+  module Admin; end
+end
+
+require 'enstratus/admin/account'
+require 'enstratus/admin/acl'
+require 'enstratus/admin/api_key'
+require 'enstratus/admin/billing_code'
+require 'enstratus/admin/customer'
+require 'enstratus/admin/group'
+require 'enstratus/admin/job'
+require 'enstratus/admin/role'
+require 'enstratus/admin/user'

data/lib/enstratus/admin/account.rb

@@ -0,0 +1,30 @@
+module Enstratus::Admin
+  class Account < Enstratus::Resource
+    attribute :account_id
+    attribute :default_budget
+    attribute :status
+
+    # Convert to element
+    attribute :alert_configuration
+    attribute :billing_address
+    attribute :billing_credit_card
+    attribute :billing_email
+    attribute :billing_phone
+    attribute :billing_system_id
+    attribute :cloud_subscription
+    attribute :configured
+    attribute :customer
+    attribute :dns_automation
+    attribute :name
+    attribute :owner_id
+    attribute :plan_id
+    attribute :provisioned
+    attribute :storage
+    attribute :subscribed
+
+    # docerror :not_documented
+    attribute :cloud_subscription_id
+    attribute :owner
+
+  end
+end

data/lib/enstratus/admin/acl.rb

@@ -0,0 +1,8 @@
+module Enstratus::Admin
+  class Acl < Enstratus::Resource
+
+    attribute :action
+    attribute :qualifier
+    attribute :resource_type
+  end
+end

data/lib/enstratus/admin/api_key.rb

@@ -0,0 +1,24 @@
+module Enstratus::Admin
+  class ApiKey < Enstratus::Resource
+    collects_as :apiKeys
+
+    attribute :api_key_id
+    attribute :status
+
+    # elements
+    attribute :access_key
+    attribute :account
+    attribute :activation_timestamp
+    attribute :cidr_list
+    attribute :description
+    attribute :expiration_timestamp
+    attribute :configured
+    attribute :name
+    attribute :secret_key
+    attribute :user
+
+    # (docerror :undocumented)
+    attribute :state
+    attribute :activation
+  end
+end

data/lib/enstratus/admin/billing_code.rb

@@ -0,0 +1,21 @@
+module Enstratus::Admin
+  class BillingCode < Enstratus::Resource
+    collects_as :billingCodes
+
+    attribute :billing_code_id
+    attribute :status
+
+    # elements
+    attribute :budget_state
+    attribute :customer
+    attribute :current_usage
+    attribute :description
+    attribute :finance_code
+    attribute :hard_quota
+    attribute :name
+    attribute :projected_usage
+    attribute :soft_quota
+
+
+  end
+end

data/lib/enstratus/admin/customer.rb

@@ -0,0 +1,25 @@
+module Enstratus::Admin
+  class Customer < Enstratus::Resource
+    
+    attribute :customer_id
+    attribute :status
+
+    # elements
+    attribute :admin_email
+    attribute :admin_first_name
+    attribute :admin_last_name
+    attribute :admin_password
+    attribute :admin_time_zone
+    attribute :accounting_currency
+    attribute :accounts
+    attribute :automated_exchange_rates
+    attribute :created
+    attribute :name
+    attribute :time_zone
+
+    # (docerror :undocumented)
+    attribute :business_name
+    attribute :created_timestamp
+    attribute :web_site
+  end
+end

data/lib/enstratus/admin/group.rb

@@ -0,0 +1,12 @@
+module Enstratus::Admin
+  class Group < Enstratus::Resource
+
+    attribute :group_id
+    attribute :status
+
+    # elements
+    attribute :customer
+    attribute :description
+    attribute :name
+  end
+end

data/lib/enstratus/admin/job.rb

@@ -0,0 +1,16 @@
+module Enstratus::Admin
+  class Job < Enstratus::Resource
+    
+    attribute :job_id
+    attribute :status
+
+    # elements
+    attribute :description
+    attribute :end_date
+    attribute :message
+
+    # (docerror :undocumented)
+    attribute :start_date
+
+  end
+end

data/lib/enstratus/admin/role.rb

@@ -0,0 +1,13 @@
+module Enstratus::Admin
+  class Role < Enstratus::Resource
+
+    attribute :role_id
+    attribute :status
+
+    # elements
+    attribute :acl
+    attribute :customer
+    attribute :description
+    attribute :name
+  end
+end