rest_connection 1.0.2 → 1.0.3

data/.gitignore

@@ -0,0 +1,6 @@
+*.swp
+*.swo
+pkg/*
+
+## RubyMine
+.idea

data/Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,43 @@
+PATH
+  remote: .
+  specs:
+    rest_connection (1.0.3)
+      activesupport (= 2.3.10)
+      highline
+      json
+      net-ssh (= 2.1.4)
+      nokogiri
+      rest-client
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (2.3.10)
+    columnize (0.3.6)
+    highline (1.6.15)
+    json (1.7.5)
+    linecache (0.46)
+      rbx-require-relative (> 0.0.4)
+    mime-types (1.19)
+    net-ssh (2.1.4)
+    nokogiri (1.5.5)
+    rake (0.8.7)
+    rbx-require-relative (0.0.9)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (1.3.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  rake (= 0.8.7)
+  rest_connection!
+  rspec (= 1.3.0)
+  ruby-debug

data/README.rdoc

@@ -4,10 +4,11 @@
   "gem install rest_connection"
 
 ==== Installing from source
-  "git clone http://github.com/rightscale/rest_connection.git"
-  "gem install jeweler rspec"
-  "rake check_dependencies" <- Install any gems listed.
-  "rake install"
+  "git clone git@github.com:rightscale/rest_connection.git"
+  "cd rest_connection"
+  "gem install rconf"
+  "rconf" <- follow any further instructions from rconf
+  "bundle install"
 
 == Configuration
 
@@ -47,10 +48,16 @@ Copy the example from GEMHOME/rest_connection/config/rest_api_config.yaml.sample
 
   puts my_array.instances.map { |i| i['ip-address'] }
 
-=== To cut a new gem and push to rubygems.org
+=== To cut a new gem and push to RubyGems.org
 
-  Edit VERSION and bump the number
-  rake gemspec
-  rake install
-  visit www.rubygems.org
-    gem push pkg/rest_connection-0.0.0.gem (use your new version number in this command)
+  Edit lib/rest_connection/version.rb and bump the number according to http://semver.org
+
+  "bundle exec gem build rest_connection.gemspec"
+  "ls *.gem" <- verify that gem was built
+  "cd /tmp"
+  "bundle exec gem install /path/to/local/rest_connection-X.Y.Z.gem" <- replace X.Y.Z with your new version number
+  "bundle exec gem uninstall rest_connection"
+  "cd -"
+  "bundle exec gem push rest_connection-X.Y.Z.gem"
+
+  Check it out: https://rubygems.org/gems/rest_connection

data/Rakefile

@@ -1,17 +1,17 @@
-require 'rubygems'
-require 'jeweler'
-Jeweler::Tasks.new do |gemspec|
-  gemspec.name = "rest_connection"
-  gemspec.summary = "Modular RESTful API library"
-  gemspec.description = "A Modular RESTful API library. Current implemented modules: RightScale API"
-  gemspec.email = ["daniel.onorato@rightscale.com"]
-  gemspec.homepage = "http://github.com/rightscale/rest_connection"
-  gemspec.authors = ["Jeremy Deininger", "Timothy Rodriguez"]
-  gemspec.add_dependency('activesupport', "=2.3.10")
-  gemspec.add_dependency('net-ssh', "=2.1.4")
-  gemspec.add_dependency('json')
-  gemspec.add_dependency('highline')
-  gemspec.add_dependency('rest-client')
-  gemspec.add_dependency('nokogiri')
+require File.expand_path('../lib/rest_connection', __FILE__)
+require 'rake'
+require 'spec/rake/spectask'
+
+task :build do
+  system "gem build rest_connection.gemspec"
+end
+
+task :release => :build do
+  system "gem push rest_connection-#{RestConnection::VERSION}.gem"
+end
+
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_files = Dir.glob('spec/*_spec.rb')
+  t.spec_opts << '--format nested'
+  t.spec_opts << '--colour'
 end
-Jeweler::GemcutterTasks.new

data/git_hooks/pre-commit

@@ -1,5 +1,17 @@
 #!/bin/bash
 
+# Setup $stat_flag based on OS type
+mac_unix_name=Darwin
+uname_returned=`uname -a`
+unix_name=${uname_returned:0:${#mac_unix_name}}  	
+if [ "$unix_name" = "$mac_unix_name" ]; then
+  echo "MAC OS \"$mac_unix_name\" detected..." 	
+  stat_flag=-f	  	
+else	  	
+  echo "non-MAC OS detected..."	  	
+  stat_flag=-c	  	
+fi
+
 echo "Checking for syntax errors..."
 for FILE in `git diff-index --name-only HEAD --` ; do
   if test -f $FILE; then

data/lib/rest_connection/rightscale/ec2_security_group.rb

@@ -25,27 +25,36 @@ class Ec2SecurityGroup
   include RightScale::Api::Base
   extend RightScale::Api::BaseExtend
 
+  VALID_RULE_TYPES =  [
+                        [:group, :owner],
+                        [:cidr_ips, :from_port, :protocol, :to_port],
+                        [:from_port, :group, :owner, :protocol, :to_port],
+                      ]
+
   # NOTE - Create, Destroy, and Update require "security_manager" permissions
   # NOTE - Can't remove rules, can only add
   def add_rule(opts={})
-    opts.each { |k,v| opts["#{k}".to_sym] = v }
-    update_types = [
-      :name => [:owner, :group],
-      :cidr_ips => [:cidr_ip, :protocol, :from_port, :to_port],
-      :group => [:owner, :group, :protocol, :from_port, :to_port],
-    ]
-    type = (opts[:protocol] ? (opts[:cidr_ip] ? :cidr_ips : :group) : :name)
-    unless update_types[type].reduce(true) { |b,field| b && opts[field] }
-      arg_expectation = update_types.values.pretty_inspect
-      raise ArgumentError.new("add_rule requires one of these groupings: #{arg_expectation}")
-    end
+    rule = {}
+    opts.each { |k,v| rule["#{k}".to_sym] = v }    
 
-    params = {}
-    update_types[type].each { |field| params[field] = opts[field] }
+    unless validate_rule(rule)
+      raise ArgumentError.new("add_rule expects one of these valid rule types: #{VALID_RULE_TYPES.to_json}")
+    end
 
+    params = {:ec2_security_group => rule}
     uri = URI.parse(self.href)
     connection.put(uri.path, params)
 
     self.reload
   end
+
+  def validate_rule(rule)
+    VALID_RULE_TYPES.each do |valid_rule_type|
+      if rule.keys.sort_by {|sym| sym.to_s} == valid_rule_type.sort_by {|sym| sym.to_s}
+        return true
+      end
+    end
+
+    false
+  end
 end

data/lib/rest_connection/version.rb

@@ -0,0 +1,4 @@
+# This gem is versioned with the usual X.Y.Z notation
+module RestConnection
+  VERSION = '1.0.3'
+end

data/rest_connection.gemspec

@@ -0,0 +1,32 @@
+require File.expand_path('../lib/rest_connection/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name         = 'rest_connection'
+  s.version      = RestConnection::VERSION
+  s.platform     = Gem::Platform::RUBY
+  s.date         = Time.now.utc.strftime("%Y-%m-%d")
+  s.require_path = 'lib'
+  s.authors      = [ 'RightScale, Inc.' ]
+  s.email        = [ 'rubygems@rightscale.com' ]
+  s.homepage     = 'https://github.com/rightscale/rest_connection'
+  s.summary      = 'A Modular RESTful API library.'
+  s.description  = %{
+The rest_connection gem simplifies the use of RESTful APIs.
+It currently has support for RightScale API 1.0 and 1.5.
+  }
+  s.files = `git ls-files`.split(' ')
+  s.test_files = `git ls-files spec config`.split(' ')
+  s.rubygems_version = '1.8.24'
+
+  s.add_runtime_dependency 'activesupport',    '2.3.10'
+  s.add_runtime_dependency 'net-ssh',          '2.1.4'
+  s.add_runtime_dependency 'json'
+  s.add_runtime_dependency 'highline'
+  s.add_runtime_dependency 'rest-client'
+  s.add_runtime_dependency 'nokogiri'
+
+  s.add_development_dependency 'rake',         '0.8.7'
+  s.add_development_dependency 'bundler'
+  s.add_development_dependency 'rspec',        '1.3.0'
+  s.add_development_dependency 'ruby-debug'
+end

data/rest_connection.rconf

@@ -0,0 +1,10 @@
+ruby do
+  version  'ree-1.8.7-2012.02'
+  rubygems '1.8.24'
+  gemset   'rest_connection'
+end
+bundler do
+  version     '1.2.2'
+  exclusions  'deployment'
+  bundle_path File.join(ENV["HOME"], '.rightscale_bundle', 'rest_connection')
+end

metadata

@@ -1,28 +1,25 @@
 --- !ruby/object:Gem::Specification 
 name: rest_connection
 version: !ruby/object:Gem::Version 
-  hash: 19
-  prerelease: false
+  hash: 17
+  prerelease: 
   segments: 
   - 1
   - 0
-  - 2
-  version: 1.0.2
+  - 3
+  version: 1.0.3
 platform: ruby
 authors: 
-- Jeremy Deininger
-- Timothy Rodriguez
+- RightScale, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2012-11-29 00:00:00 -08:00
-default_executable: 
+date: 2012-12-13 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: activesupport
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - "="
@@ -34,11 +31,11 @@ dependencies:
         - 10
         version: 2.3.10
   type: :runtime
-  version_requirements: *id001
+  requirement: *id001
+  prerelease: false
 - !ruby/object:Gem::Dependency 
   name: net-ssh
-  prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - "="
@@ -50,11 +47,11 @@ dependencies:
         - 4
         version: 2.1.4
   type: :runtime
-  version_requirements: *id002
+  requirement: *id002
+  prerelease: false
 - !ruby/object:Gem::Dependency 
   name: json
-  prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -64,11 +61,11 @@ dependencies:
         - 0
         version: "0"
   type: :runtime
-  version_requirements: *id003
+  requirement: *id003
+  prerelease: false
 - !ruby/object:Gem::Dependency 
   name: highline
-  prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -78,11 +75,11 @@ dependencies:
         - 0
         version: "0"
   type: :runtime
-  version_requirements: *id004
+  requirement: *id004
+  prerelease: false
 - !ruby/object:Gem::Dependency 
   name: rest-client
-  prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -92,11 +89,11 @@ dependencies:
         - 0
         version: "0"
   type: :runtime
-  version_requirements: *id005
+  requirement: *id005
+  prerelease: false
 - !ruby/object:Gem::Dependency 
   name: nokogiri
-  prerelease: false
-  requirement: &id006 !ruby/object:Gem::Requirement 
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -106,23 +103,86 @@ dependencies:
         - 0
         version: "0"
   type: :runtime
-  version_requirements: *id006
-description: "A Modular RESTful API library. Current implemented modules: RightScale API"
+  requirement: *id006
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  name: rake
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 49
+        segments: 
+        - 0
+        - 8
+        - 7
+        version: 0.8.7
+  type: :development
+  requirement: *id007
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  requirement: *id008
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  version_requirements: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  requirement: *id009
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  name: ruby-debug
+  version_requirements: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  requirement: *id010
+  prerelease: false
+description: "\n\
+  The rest_connection gem simplifies the use of RESTful APIs.\n\
+  It currently has support for RightScale API 1.0 and 1.5.\n  "
 email: 
-- daniel.onorato@rightscale.com
+- rubygems@rightscale.com
 executables: []
 
 extensions: []
 
-extra_rdoc_files: 
-- LICENSE
-- README.rdoc
-- README.rdoc.starting.point
+extra_rdoc_files: []
+
 files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
 - LICENSE
 - README.rdoc
 - Rakefile
-- VERSION
 - config/rest_api_config.yaml.sample
 - examples/README.txt
 - examples/console.rb
@@ -209,8 +269,10 @@ files:
 - lib/rest_connection/rightscale/user.rb
 - lib/rest_connection/rightscale/vpc_dhcp_option.rb
 - lib/rest_connection/ssh_hax.rb
+- lib/rest_connection/version.rb
 - log_api_call_parser
-- login_to_connection_irb.rb
+- rest_connection.gemspec
+- rest_connection.rconf
 - spec/ec2_server_array_spec.rb
 - spec/ec2_ssh_key_internal_spec.rb
 - spec/image_jockey.rb
@@ -225,9 +287,7 @@ files:
 - spec/server_template_internal.rb
 - spec/spec_helper.rb
 - spec/tag_spec.rb
-- README.rdoc.starting.point
-has_rdoc: true
-homepage: http://github.com/rightscale/rest_connection
+homepage: https://github.com/rightscale/rest_connection
 licenses: []
 
 post_install_message: 
@@ -256,9 +316,23 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: Modular RESTful API library
-test_files: []
-
+summary: A Modular RESTful API library.
+test_files: 
+- config/rest_api_config.yaml.sample
+- spec/ec2_server_array_spec.rb
+- spec/ec2_ssh_key_internal_spec.rb
+- spec/image_jockey.rb
+- spec/mcserver_spec.rb
+- spec/method_missing_spec.rb
+- spec/multi.rb
+- spec/right_script_internal.rb
+- spec/rs_internal_spec.rb
+- spec/runtests
+- spec/server_internal_spec.rb
+- spec/server_spec.rb
+- spec/server_template_internal.rb
+- spec/spec_helper.rb
+- spec/tag_spec.rb

data/README.rdoc.starting.point

@@ -1,202 +0,0 @@
-= Rest Connection
-
-The rest_connection gem simplifies the use of RightScale's MultiCloud API. It provides
-a simple object model of the API resources, and handles all of the fine details involved
-in making HTTP calls and translating their responses.
-It is assumed that users are already familiar with the RightScale API:
-- API Documentation: http://support.rightscale.com/12-Guides/RightScale_API_1.5
-- API Reference Docs: http://support.rightscale.com/api1.5
-
-== Installation
-Ruby 1.8.7 or higher is required.
-    gem install rest_connection
-
-== Versioning
-The rest_connection gem is versioned using the usual X.Y.Z notation, where X.Y is the
-RightScale API version, and Z is the client version. For example, if you want to use
-RightScale API 1.5, you should use the latest version of the 1.5 gem. This will ensure
-that you get the latest bug fixes for the client that is compatible with that API version.
-
-== Usage Instructions
-New users can start with the following few lines of code and navigate their way around the API by following
-the available methods. You can find your account id by logging into the RightScale dashboard (https://my.rightscale.com),
-navigate to the Settings > Account Settings page. The account is is at the end of the browser address bar.
-    require 'rest_connection'
-    @client = RightApi::Client.new(:email => 'my@email.com', :password => 'my_password', :account_id => 'my_account_id')
-    puts "Available methods: #{@client.api_methods}"
-
-The client makes working with and getting to know the API much easier. It spiders the API dynamically to
-discover its resources on the fly. At every step, the user has the ability to query api_methods(), which
-indicates the potential methods that can be called. The <tt>config/login.yml.example</tt> file provides
-details of different login parameters.
-
-=== Making API calls
-Essentially, just follow the RightScale API documentation (available from http://support.rightscale.com)
-and treat every resource in the paths as objects that can call other objects using the dot (.) operator:
-
-Examples:
-   - Index:     /api/clouds/:cloud_id/datacenters             =>  @client.clouds(:id => :cloud_id).show.datacenters.index
-   - Show:      /api/clouds/:cloud_id/datacenters/:id         =>  @client.clouds(:id => :cloud_id).show.datacenters(:id => :datacenter_id).show
-   - Create:    /api/deployments/:deployment_id/servers       =>  @client.deployments(:id => :deployment_id).show.servers.create
-   - Update:    /api/deployments/:deployment_id/servers/:id   =>  @client.deployments(:id => :deployment_id).show.servers(:id => :server_id).update
-   - Destroy:   /api/deployments/:deployment_id/servers/:id   =>  @client.deployments(:id => :deployment_id).show.servers(:id => :server_id).destroy
-   - An action: /api/servers/:server_id/launch                =>  @client.servers(:id => :server_id).show.launch
-
-As seen above, whenever you need to chain methods, you must call .show before specifying the next method.
-
-=== Parameters
-Pass-in parameters to the method that they belong to. Lets say you want to filter on the index for deployments:
-    @client.deployments.index(:filter => ['name==my_deployment'])
-The filter is the parameter for the index call and not the deployment call.
-
-=== Logging HTTP Requests
-The HTTP calls made by rest_connection can be logged in two ways:
-1. Log to a file
-    @client.log('~/rest_connection.log')
-2. Log to SDTOUT
-    @client.log(STDOUT)
-
-== Examples
-Get a list of all servers (aka doing an Index call)
-    @client.servers.index
-
-Get a list of all servers in a deployment
-    @client.deployments(:id => 'my_deployment_id').show.servers.index
-
-Get a particular server (aka doing a Show call)
-    @client.servers(:id => 'my_server_id').show
-
-Creating a server involves setting up the required parameters, then calling the create method
-    server_template_href = @client.server_templates.index(:filter => ['name==Base ServerTemplate']).first.href
-    cloud = @client.clouds(:id => 'my_cloud_id').show
-    params = { :server => {
-        :name => 'Test Server',
-        :deployment_href => @client.deployments(:id => 'my_deployment_id').show.href,
-        :instance => {
-            :server_template_href => server_template_href,
-            :cloud_href           => cloud.href,
-            :security_group_hrefs => [cloud.security_groups.index(:filter => ['name==default']).first.href],
-            :ssh_key_href         => cloud.ssh_keys.index.first.href,
-            :datacenter_href      => cloud.datacenters.index.first.href
-        }}}
-    new_server = @client.servers.create(params)
-    new_server.api_methods
-
-Launch the newly created server. Inputs are a bit tricky so they have to be set in a long string
-    inputs = "inputs[][name]=NAME1&inputs[][value]=text:VALUE1&inputs[][name]=NAME2&inputs[][value]=text:VALUE2"
-    new_server.show.launch(inputs)
-
-Run a script on the server. The API does not currently expose right_scripts, hence, the script href has
-to be retrieved from the dashboard and put in the following href format.
-    script_href = "right_script_href=/api/right_scripts/382371"
-    task = new_server.show.current_instance.show.run_executable(script_href + "&inputs[][name]=TEST_NAME&inputs[][value]=text:VALUE1")
-    task.show.api_methods
-
-Update the server's name
-    params = { :server => {:name => 'New Server Name'}}
-    @client.servers(:id => 'my_server_id').update(params)
-
-Terminate the server (i.e. shutdown its current_instance)
-    @client.servers(:id => 'my_server_id').show.terminate
-
-Destroy the server (i.e. delete it)
-    @client.servers(:id => 'my_server_id').destroy
-
-== Object Types
-The client returns 3 types of objects:
-- <b>Resources</b>: returned when you are querying a collection of resources, e.g.: <tt>client.deployments</tt>
-- <b>Resource</b>: returned when you specify an id and therefore a specific resource, e.g.: <tt>@client.deployments(:id => :deployment_id)</tt>
-  - When the content-type is type=collection then an array of Resource objects will be returned, e.g.: <tt>@client.deployments.index</tt>
-  - When the content-type is not a collection then a Resource object will be returned, e.g.: <tt>@client.deployments(:id => deployment_id).show</tt>
-- <b>ResourceDetail</b>: returned when you do a .show on a Resource, e.g.: <tt>client.deployments(:id => deployment_id).show</tt>
-<b>On all 3 types of objects you can query <tt>.api_methods</tt> to see a list of available methods, e.g.: <tt>client.deployments.api_methods</tt></b>
-
-=== Exceptions:
-- <tt>inputs.index</tt> will return an array of ResourceDetail objects since you cannot do a .show on an input
-- <tt>session.index</tt> will return a ResourceDetail object since you cannot do a .show on a session
-- <tt>tags.by_resource, tags.by_tag</tt> will return an array of ResourceDetail objects since you cannot do a .show on a resource_tag
-- <tt>monitoring_metrics(:id => :m_m_id).show.data</tt> will return a ResourceDetail object since you cannot do
-  a .show on a monitoring_metric_data
-
-== Instance Facing Calls:
-The client also supports 'instance facing calls', which use the instance_token to login.
-Unlike regular email-password logins, instance-facing-calls are limited in the amount of allowable calls.
-Since in most of the cases, the calls are scoped to the instance's cloud (or the instance itself), the cloud_id and
-the instance_id will be automatically recorded by the client, so that the user does not need to specify it.
-
-=== Examples
-    @instance_client = RightApi::Client.new(:instance_token => 'my_token', :account_id => 'my_account_id')
-    @instance_client.volume_attachments     links to /api/clouds/:cloud_id/volume_attachments
-    @instance_client.volumes_snapshots      links to /api/clouds/:cloud_id/volumes_snapshots
-    @instance_client.volumes_types          links to /api/clouds/:cloud_id/volumes_types
-    @instance_client.volumes                links to /api/clouds/:cloud_id/volumes
-    @instance_client.backups                links to /api/backups
-    @instance_client.live_tasks(:id)        links to /api/clouds/:cloud_id/instances/:instance_id/live/tasks/:id
-
-=== Notes
-For volume_attachments and volumes_snapshots you can also go through the volume:
-    @instance_client.volumes(:id => :volume_id).show.volume_attachments
-    which maps to:
-    /api/clouds/:cloud_id/volumes/:volume_id/volume_attachment
-The instance's volume_attachments can be accessed using:
-    @instance_client.get_instance.volume_attachments
-    which maps to:
-    /api/clouds/:cloud_id/instances/:instance_id/volume_attachments
-
-Because the cloud_id and the instance_id are automatically added by the client, scripts that work for regular
-email-password logins will have to be modified for instance-facing calls. The main reason behind this is the
-inability for instance-facing calls to access the clouds resource (i.e.: <tt>@instance_client.clouds(:id=> :cloud_id).show</tt> will fail)
-
-When you query <tt>api_methods</tt>, it will list all of the methods that one sees with regular email-password logins.
-Due to the limiting scope of the instance-facing calls, only a subset of these methods can be called
-(see the API Reference Docs for valid methods). If you call a method that instance's are not authorized to access,
-you will get a 403 Permission Denied error.
-
-
-= Design Decisions
-In the code, we only hard-code CRUD operations for resources. We use the .show and .index methods to make the client
-more efficient. Since it dynamically creates methods it needs to query the API at times. The .show and the .index make
-it explicit that querying needs to take place. Without them a GET would have to be queried every step of the way
-(i.e.: the index call would be client.deployments, and the create call would be client.deployments.create which would
-first do an index call).
-
-<b>In general, when a new API resource is added, you need to indicate in the client whether index, show, create, update
-and delete methods are allowed for that resource.</b>
-
-== Special Cases
-=== Returning resource_types that are not actual API resources:
-  - tags:
-    - by_resource, by_tag: both return a COLLECTION of resource_type = RESOURCE_TAG
-      - no show or index is defined for that resource_type, therefore return a collection of ResourceDetail objects
-  - data:
-    - querying .data for monitoring_metrics:
-      - no show is defined for that resource_type, therefore return a ResourceDetail object
-
-=== Index call does not act like an index call
-  - session:
-    - session.index should act like a show call and not like an index call (since you cannot query show).
-      Therefore it should return a ResourceDetail object
-  - inputs
-    - inputs.index cannot return a collection of Resource objects since .show is not allowed. Therefore it should
-      return a collection of ResourceDetail objects
-
-=== Having a resource_type that cannot be accurately determined from the URL:
-  - In server_arrays.show: resource_type = current_instance(s) (although it should be instance(s))
-  - In multi_cloud_images.show: resource_type = setting(s) (although it should be multi_cloud_image_setting)
-Put these special cases in the <tt>RightApi::Helper::INCONSISTENT_RESOURCE_TYPES</tt> hash.
-
-=== Method defined on the generic resource_type itself
-  - 'instances' => {:multi_terminate => 'do_post', :multi_run_executable => 'do_post'},
-  - 'inputs'    => {:multi_update => 'do_put'},
-  - 'tags'      => {:by_tag => 'do_post', :by_resource => 'do_post', :multi_add => 'do_post', :multi_delete =>'do_post'},
-  - 'backups'   => {:cleanup => 'do_post'}
-Put these special cases in the <tt>RightApi::Helper::RESOURCE_TYPE_SPECIAL_ACTIONS</tt> hash.
-
-=== Resources are not linked together
-  - In ResourceDetail, resource_type = Instance, need live_tasks as a method.
-
-= Troubleshooting
-
-== Wrong ruby version
-
-Ruby 1.8.7 or higher is required.

data/VERSION

@@ -1 +0,0 @@
-1.0.2

data/login_to_connection_irb.rb

@@ -1,22 +0,0 @@
-# A quick way to login to the API and jump into IRB so you can experiment with the connection.
-# Add this to your bash profile to make it simpler:
-#   alias connection='bundle exec ruby login_to_connection_irb.rb'
-
-require File.expand_path('../lib/rest_connection', __FILE__)
-require 'yaml'
-require 'irb'
-
-begin
-  @connection = RestConnection::Connection.new()
-  puts "logged-in to the API, use the '@connection' variable to use the connection"
-end
-
-IRB.start
-
-#
-#require 'rubygems'
-#require 'rest_connection'
-#require 'ruby-debug'
-#
-#debugger
-#puts "done!"