fog 1.0.0 → 1.5.0

data/README.rdoc

@@ -1,154 +0,0 @@
-http://geemus.s3.amazonaws.com/fog.png
-
-fog is the Ruby cloud computing library, top to bottom:
-
-* Collections provide a simplified interface, making clouds easier to work with and switch between.
-* Requests allow power users to get the most out of the features of each individual cloud.
-* Mocks make testing and integrating a breeze.
-
-== Getting Started
-
-  sudo gem install fog
-
-Now type 'fog' to try stuff, confident that fog will let you know what to do. Here is an example of wading through server creation for Amazon Elastic Compute Cloud:
-
-  >> server = Compute[:aws].servers.create
-  ArgumentError: image_id is required for this operation
-
-  >> server = Compute[:aws].servers.create(:image_id => 'ami-5ee70037')
-  <Fog::AWS::EC2::Server [...]>
-
-  >> server.destroy # cleanup after yourself or regret it, trust me
-  true
-
-== Collections
-
-A high level interface to each cloud is provided through collections, such as `images` and `servers`.
-You can see a list of available collections by calling `collections` on the connection object. You can try it out using the `fog` command:
-
-  >> Compute[:aws].collections
-  [:addresses, :directories, ..., :volumes, :zones]
-
-Some collections are available across multiple providers:
-
-* compute providers have +flavors+, +images+ and +servers+
-* dns providers have +zones+ and +records+
-* storage providers have +directories+ and +files+
-
-Collections share basic CRUD type operations, such as:
-* +all+ - fetch every object of that type from the provider.
-* +create+ - initialize a new record locally and a remote resource with the provider.
-* +get+ - fetch a single object by it's identity from the provider.
-* +new+ - initialize a new record locally, but do not create a remote resource with the provider.
-
-As an example, we'll try initializing and persisting a Rackspace Cloud server:
-
-  require 'fog'
-
-  compute = Fog::Compute.new(
-    :provider           => 'Rackspace',
-    :rackspace_api_key  => key,
-    :rackspace_username => username
-  )
-
-  # boot a gentoo server (flavor 1 = 256, image 3 = gentoo 2008.0)
-  server = compute.servers.create(:flavor_id => 1, :image_id => 3, :name => 'my_server')
-  server.wait_for { ready? } # give server time to boot
-
-  # DO STUFF
-
-  server.destroy # cleanup after yourself or regret it, trust me
-
-== Models
-
-Many of the collection methods return individual objects, which also provide common methods:
-* +destroy+ - will destroy the persisted object from the provider
-* +save+ - persist the object to the provider
-* +wait_for+ - takes a block and waits for either the block to return true for the object or for a timeout (defaults to 10 minutes)
-
-== Mocks
-
-As you might imagine, testing code using Fog can be slow and expensive, constantly turning on and and shutting down instances.
-Mocking allows skipping this overhead by providing an in memory representation resources as you make requests.
-Enabling mocking easy to use, before you run other commands, simply run:
-
-  Fog.mock!
-
-Then proceed as usual, if you run into unimplemented mocks fog will raise an error and as always contributions are welcome!
-
-== Requests
-
-Requests allow you to dive deeper when the models just can't cut it.
-You can see a list of available requests by calling #requests on the connection object.
-
-For instance, ec2 provides methods related to reserved instances that don't have any models (yet). Here is how you can lookup your reserved instances:
-
-  $ fog
-  >> Compute[:aws].describe_reserved_instances
-  #<Excon::Response [...]>
-
-It will return an {excon}[http://github.com/geemus/excon] response, which has `body`, `headers` and `status`. Both return nice hashes.
-
-== Go forth and conquer
-
-Play around and use the console to explore or check out {fog.io}[http://fog.io] for more details and examples. Once you are ready to start scripting fog, here is a quick hint on how to make connections without the command line thing to help you.
-
-  # create a compute connection
-  compute = Fog::Compute.new(:provider => 'AWS', :aws_access_key_id => ACCESS_KEY_ID, :aws_secret_access_key => SECRET_ACCESS_KEY)
-  # compute operations go here
-
-  # create a storage connection
-  storage = Fog::Storage.new(:provider => 'AWS', :aws_access_key_id => ACCESS_KEY_ID, :aws_secret_access_key => SECRET_ACCESS_KEY)
-  # storage operations go here
-
-geemus says: "That should give you everything you need to get started, but let me know if there is anything I can do to help!"
-
-== Contributing
-
-* Find something you would like to work on. For suggestions look for the `easy`, `medium` and `hard` tags in the {issues}[http://github.com/geemus/fog/issues]
-* Fork the project and do your work in a topic branch.
-* Add shindo tests to prove your code works and run all the tests using `bundle exec rake`.
-* Rebase your branch against geemus/fog to make sure everything is up to date.
-* Commit your changes and send a pull request.
-
-== T-Shirts
-
-Wonder how you can get a lovely fog shirt? Look no further!
-
-* Blue shirts go to people who have contributed indirectly, great examples are writing blog posts or giving lightning talks.
-* Grey shirts and a follow from @fog go to people who have made it on to the {contributors list}[https://github.com/geemus/fog/contributors] by submitting code.
-* Black shirts go to people who have made it on to the {collaborators list}[https://github.com/api/v2/json/repos/show/geemus/fog/collaborators] by coercing geemus into adding them.
-
-== Additional Resources
-
-{fog.io}[http://fog.io]
-
-== Sponsorship
-
-http://www.engineyard.com/images/logo.png
-
-All new work on fog is sponsored by {Engine Yard}[http://engineyard.com]
-== Copyright
-
-(The MIT License)
-
-Copyright (c) 2010 {geemus (Wesley Beary)}[http://github.com/geemus]
-
-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/examples/compute_tests.rb

@@ -1,71 +0,0 @@
-require 'rubygems'
-require 'shindo'
-
-require File.join(File.dirname(__FILE__), '..', 'lib', 'fog')
-require File.join(File.dirname(__FILE__), '..', 'tests', 'helper')
-
-Shindo.tests('compute examples', 'compute') do
-
-  # iterate over all the providers
-  Fog.providers.each do |provider|
-
-    # FIXME: implement expected shared compute stuff for these providers as well
-    next if ['Bluebox', 'Brightbox', 'Ecloud', 'GoGrid', 'Linode', 'NewServers', 'Ninefold', 'Slicehost', 'StormOnDemand', 'VirtualBox', 'Voxel'].include?(provider)
-
-    provider = eval(provider) # convert from string to object
-
-    # skip if provider does not have compute
-    next unless provider.respond_to?(:services) && provider.services.include?(:compute)
-
-    tests(provider, provider.to_s.downcase) do
-
-      # use shortcuts to instantiate connection
-      @compute = Fog::Compute.new(:provider => provider.to_s)
-
-      # create a server
-      tests('@server = @compute.servers.bootstrap').succeeds do
-        @server = @compute.servers.bootstrap
-      end
-
-      # list servers
-      tests('@servers = @compute.servers').succeeds do
-        @servers = @compute.servers
-      end
-
-      # get a server
-      tests('@compute.servers.get(@server.identity)').succeeds do
-        @compute.servers.get(@server.identity)
-      end
-
-      # ssh to a server
-      tests('@server.ssh("pwd")').succeeds do
-        @server.ssh('pwd')
-      end
-
-      # scp a file to a server
-      lorem_path = File.join([File.dirname(__FILE__), '..', 'tests', 'lorem.txt'])
-      tests("@server.scp('#{lorem_path}', 'lorem.txt')").succeeds do
-        @server.scp(lorem_path, 'lorem.txt')
-      end
-
-      # scp a directory to a server
-      Dir.mkdir('/tmp/lorem')
-      file = ::File.new('/tmp/lorem/lorem.txt', 'w')
-      file.write(File.read(lorem_path))
-      lorem_dir = File.join([File.dirname(__FILE__), '..', 'tests'])
-      tests("@server.scp('#{lorem_dir}', '/tmp/lorem', :recursive => true)").succeeds do
-        @server.scp(lorem_dir, '/tmp/lorem', :recursive => true)
-      end
-      File.delete('/tmp/lorem/lorem.txt')
-      Dir.rmdir('/tmp/lorem')
-
-      # destroy the server
-      tests('@server.destroy').succeeds do
-        @server.destroy
-      end
-
-    end
-
-  end
-
-end

data/examples/dns_tests.rb

@@ -1,78 +0,0 @@
-require 'rubygems'
-require 'shindo'
-
-require File.join(File.dirname(__FILE__), '..', 'lib', 'fog')
-require File.join(File.dirname(__FILE__), '..', 'tests', 'helper')
-
-Shindo.tests('dns examples', 'dns') do
-
-  # iterate over all the providers
-  Fog.providers.each do |provider|
-
-    provider = eval(provider) # convert from string to object
-
-    # skip if provider does not have storage
-    next unless provider.respond_to?(:services) && provider.services.include?(:dns)
-
-    tests(provider, provider.to_s.downcase) do
-
-      # use shortcuts to instantiate connection
-      @dns = Fog::DNS.new(:provider => provider.to_s)
-
-      # create a zone
-      #   domain should be the hostname
-      #   email is only required for linode, but included for consistency
-      tests('@zone = @dns.zones.create').succeeds do
-        @zone = @dns.zones.create(
-          :domain => 'fogdnsexamples.com',
-          :email => 'tests@fogdnsexamples.com'
-        )
-      end
-
-      # create a record in the zone
-      #   ip is the address to route to
-      #   name is the name for the record
-      #   type is the type of record to create
-      tests('@record = @zone.records.create').succeeds do
-        @record = @zone.records.create(
-          :value  => '1.2.3.4',
-          :name   => 'www.fogdnsexamples.com',
-          :type   => 'A'
-        )
-      end
-
-      # list zones
-      tests('@zones = @dns.zones').succeeds do
-        @zones = @dns.zones
-      end
-
-      # get a zone
-      tests('@dns.zones.get(@zone.identity)').succeeds do
-        @dns.zones.get(@zone.identity)
-      end
-
-      # list records
-      tests('@records = @zone.records').succeeds do
-        @records = @zone.records
-      end
-
-      # get a record
-      tests('@zone.records.get(@record.identity)').succeeds do
-        @zone.records.get(@record.identity)
-      end
-
-      # destroy the record
-      tests('@record.destroy').succeeds do
-        @record.destroy
-      end
-
-      # destroy the zone
-      tests('@zone.destroy').succeeds do
-        @zone.destroy
-      end
-
-    end
-
-  end
-
-end

data/examples/storage_tests.rb

@@ -1,105 +0,0 @@
-require 'rubygems'
-require 'shindo'
-
-require File.join(File.dirname(__FILE__), '..', 'lib', 'fog')
-require File.join(File.dirname(__FILE__), '..', 'tests', 'helper')
-
-Shindo.tests('storage examples', 'storage') do
-
-  # iterate over all the providers
-  Fog.providers.each do |provider|
-
-    provider = eval(provider) # convert from string to object
-
-    # skip if provider does not have storage
-    next unless provider.respond_to?(:services) && provider.services.include?(:storage)
-
-    tests(provider, provider.to_s.downcase) do
-
-      # use shortcuts to instantiate connection
-      @storage = Fog::Storage.new(:provider => provider.to_s)
-
-      # for compatibility public is simply true or false
-      [false, true].each do |publicity|
-
-        tests(":public => #{publicity}") do
-
-          # create a directory
-          #   key should be a unique string
-          #   public should be a boolean
-          tests('@directory = @storage.directories.create').succeeds do
-            @directory = @storage.directories.create(
-              :key    => "fogstoragedirectory#{Time.now.to_i}",
-              :public => publicity
-            )
-          end
-
-          # list directories
-          tests('@directories = @storage.directories').succeeds do
-            @directories = @storage.directories
-          end
-
-          # get a directory
-          tests('@storage.directories.get(@directory.identity)').succeeds do
-            @storage.directories.get(@directory.identity)
-          end
-
-          # create a file in the directory
-          #   key can be any string
-          #   body can be a string or a file as File.open(path)
-          #   public should be a boolean and match the directory
-          tests('@file = @directory.files.create').succeeds do
-            @file = @directory.files.create(
-              :body   => 'fog_storage_object_body',
-              :key    => 'fogstorageobject',
-              :public => publicity
-            )
-          end
-
-          # list files
-          tests('@files = @directory.files').succeeds do
-            @files = @directory.files
-          end
-
-          # get a file
-          tests('@directory.files.get(@file.identity)').succeeds do
-            @directory.files.get(@file.identity)
-          end
-
-          # test the publicity of files
-          # Local is unable to inherently serve files, so we can skip it
-          unless provider == Local
-            # if the file is public it should have a url
-            test('!!@file.public_url == publicity') do
-              pending if Fog.mocking?
-              !!@file.public_url == publicity
-            end
-
-            # if it is public ensure that public url is usable
-            if publicity
-              tests('Excon.get(@file.public_url).body').returns('fog_storage_object_body') do
-                pending if Fog.mocking?
-                Excon.get(@file.public_url).body
-              end
-            end
-          end
-
-          # destroy the file
-          tests('@file.destroy').succeeds do
-            @file.destroy
-          end
-
-          # destroy the directory
-          tests('@directory.destroy').succeeds do
-            @directory.destroy
-          end
-
-        end
-
-      end
-
-    end
-
-  end
-
-end

data/lib/fog/aws/requests/storage/hash_to_acl.rb

@@ -1,44 +0,0 @@
-module Fog
-  module Storage
-    class AWS
-      private
-        def self.hash_to_acl(acl)
-          data =
-<<-DATA
-<AccessControlPolicy>
-  <Owner>
-    <ID>#{acl['Owner']['ID']}</ID>
-    <DisplayName>#{acl['Owner']['DisplayName']}</DisplayName>
-  </Owner>
-  <AccessControlList>
-DATA
-
-          acl['AccessControlList'].each do |grant|
-            data << "    <Grant>\n"
-            type = case grant['Grantee'].keys.sort
-            when ['DisplayName', 'ID']
-              'CanonicalUser'
-            when ['EmailAddress']
-              'AmazonCustomerByEmail'
-            when ['URI']
-              'Group'
-            end
-            data << "      <Grantee xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"#{type}\">\n"
-            data << "        <ID>#{grant['Grantee']['ID']}</ID>\n"
-            data << "        <DisplayName>#{grant['Grantee']['DisplayName']}</DisplayName>\n"
-            data << "      </Grantee>\n"
-            data << "      <Permission>#{grant['Permission']}</Permission>\n"
-            data << "    </Grant>\n"
-          end
-          
-          data <<
-<<-DATA
-  </AccessControlList>
-</AccessControlPolicy>
-DATA
-          data
-        end
-    end
-  end      
-end
-

data/lib/fog/bin/new_servers.rb

@@ -1,31 +0,0 @@
-class NewServers < Fog::Bin
-  class << self
-
-    def class_for(key)
-      case key
-      when :compute
-        Fog::Compute::NewServers
-      else 
-        raise ArgumentError, "Unsupported #{self} service: #{key}"
-      end
-    end
-
-    def [](service)
-      @@connections ||= Hash.new do |hash, key|
-        hash[key] = case key
-        when :compute
-          Fog::Logger.warning("NewServers[:compute] is deprecated, use Compute[:newservers] instead")
-          Fog::Compute.new(:provider => 'NewServers')
-        else
-          raise ArgumentError, "Unrecognized service: #{key.inspect}"
-        end
-      end
-      @@connections[service]
-    end
-
-    def services
-      Fog::NewServers.services
-    end
-
-  end
-end

data/lib/fog/bin/slicehost.rb

@@ -1,36 +0,0 @@
-class Slicehost < Fog::Bin
-  class << self
-
-    def class_for(key)
-      case key
-      when :compute
-        Fog::Compute::Slicehost
-      when :dns
-        Fog::DNS::Slicehost
-      else 
-        raise ArgumentError, "Unrecognized service: #{key}"
-      end
-    end
-
-    def [](service)
-      @@connections ||= Hash.new do |hash, key|
-        hash[key] = case key
-        when :compute
-          Fog::Logger.warning("Slicehost[:compute] is deprecated, use Compute[:slicehost] instead")
-          Fog::Compute.new(:provider => 'Slicehost')
-        when :dns
-          Fog::Logger.warning("Slicehost[:dns] is deprecated, use Storage[:slicehost] instead")
-          Fog::DNS.new(:provider => 'Slicehost')
-        else
-          raise ArgumentError, "Unrecognized service: #{key.inspect}"
-        end
-      end
-      @@connections[service]
-    end
-
-    def services
-      Fog::Slicehost.services
-    end
-
-  end
-end

data/lib/fog/brightbox/requests/compute/resize_server.rb

@@ -1,19 +0,0 @@
-module Fog
-  module Compute
-    class Brightbox
-      class Real
-
-        def resize_server(identifier, options = {})
-          request(
-            :expects  => [202],
-            :method   => 'POST',
-            :path     => "/1.0/servers/#{identifier}/resize",
-            :headers  => {"Content-Type" => "application/json"},
-            :body     => MultiJson.encode(options)
-          )
-        end
-
-      end
-    end
-  end
-end

data/lib/fog/ecloud/models/compute/ip.rb

@@ -1,49 +0,0 @@
-module Fog
-  module Compute
-    class Ecloud
-      class Ip < Fog::Ecloud::Model
-
-        ignore_attributes :xmlns_i, :xmlns
-
-        identity :href, :aliases => :Href
-
-        attribute :name, :aliases => :Name
-        attribute :status, :aliases => :Status
-        attribute :server, :aliases => :Server
-        attribute :rnat, :aliases => :RnatAddress
-        attribute :id, :aliases => :Id, :type => :integer
-
-        def rnat=(new_rnat)
-          attributes[:rnat] = new_rnat
-          @changed = true
-        end
-
-        def save
-          if @changed
-            connection.configure_network_ip( href, _compose_network_ip_data )
-          end
-          true
-        end
-
-        def reload
-          super
-          @changed = false
-          self
-        end
-
-        private
-        def _compose_network_ip_data
-          {
-            :id => id,
-            :href => href,
-            :name => name,
-            :status => status,
-            :server => server,
-            :rnat => rnat
-          }
-        end
-
-      end
-    end
-  end
-end

data/lib/fog/ecloud/models/compute/ips.rb

@@ -1,32 +0,0 @@
-require 'fog/ecloud/models/compute/ip'
-
-module Fog
-  module Compute
-    class Ecloud
-      class Ips < Fog::Ecloud::Collection
-
-        model Fog::Compute::Ecloud::Ip
-
-        undef_method :create
-
-        attribute :href
-
-        def all
-          check_href!( :messages => "Ips href of a Network you want to enumerate" )
-          if data = connection.get_network_ips(href).body[:IpAddress]
-            load(data)
-          end
-        end
-
-        def get(uri)
-          if data = connection.get_network_ip(uri).body
-            new(data)
-          end
-        rescue Fog::Errors::NotFound
-          nil
-        end
-
-      end
-    end
-  end
-end