fog 0.7.1 → 2.3.0

data/bin/fog

@@ -1,16 +1,42 @@
 #!/usr/bin/env ruby
+
 require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'fog'))
+require 'optparse'
 require 'irb'
 require 'yaml'
+
+options = OptionParser.new do |opts|
+  opts.banner = 'usage: fog [options] CREDENTIAL'
+
+  opts.on('-C', '--credentials-path FILE', 'Path to the credentials file') do |file|
+    Fog.credentials_path = file
+  end
+
+  opts.on_tail('-v', '--version', 'Prints the version') do
+    puts Fog::VERSION
+    exit
+  end
+
+  opts.on_tail('-h', '--help', 'Prints this message') do
+    puts opts
+    exit
+  end
+end
+options.parse!
+
 Fog.credential = ARGV.first ? ARGV.first.to_sym : nil
 Fog.mock! if ENV['FOG_MOCK']
-unless Fog.credentials
-  exit
+if Fog.credentials.empty?
+  begin
+    Fog::Errors.missing_credentials
+  rescue Fog::Errors::LoadError => error
+    abort error.message
+  end
 end
 
 require 'fog/bin'
 
-providers = Fog.providers
+providers = Fog.available_providers
 providers = if providers.length > 1
   providers[0...-1].join(', ') << ' and ' << providers[-1]
 else
@@ -19,7 +45,8 @@ end
 
 if ARGV.length > 1
 
-  puts(instance_eval(ARGV[1..-1].join(' ')).to_json)
+  result = instance_eval(ARGV[1..-1].join(' '))
+  puts(Fog::JSON.encode(result))
 
 else
 
@@ -32,10 +59,20 @@ else
   @irb.context.prompt_mode = :FOG
   @irb.context.workspace = IRB::WorkSpace.new(binding)
 
-  Formatador.display_line('Welcome to fog interactive!')
-  Formatador.display_line(":#{Fog.credential} provides #{providers}")
+  trap 'INT' do
+    @irb.signal_handle
+  end
+
+  Fog::Formatador.display_line('Welcome to fog interactive!')
+  Fog::Formatador.display_line(":#{Fog.credential} provides #{providers}")
   providers = Fog.providers
 
+  # FIXME: hacks until we can `include Fog` in bin
+  CDN     = Fog::CDN
+  Compute = Fog::Compute
+  DNS     = Fog::DNS
+  Storage = Fog::Storage
+
   catch(:IRB_EXIT) { @irb.eval_input }
 
 end

data/fog.gemspec

@@ -1,63 +1,123 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "fog/version"
+
 Gem::Specification.new do |s|
   s.specification_version = 2 if s.respond_to? :specification_version=
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.rubygems_version = '1.3.5'
 
   ## Leave these as is they will be modified for you by the rake gemspec task.
   ## If your rubyforge_project name is different, then edit it and comment out
   ## the sub! line in the Rakefile
-  s.name              = 'fog'
-  s.version           = '0.7.1'
-  s.date              = '2011-03-21'
-  s.rubyforge_project = 'fog'
+  s.name              = "fog"
+  s.version           = "2.3.0"
+  s.date              = "2022-10-03"
 
   ## Make sure your summary is short. The description may be as long
   ## as you like.
   s.summary     = "brings clouds to you"
-  s.description = "The Ruby cloud services library."
+  s.description = "The Ruby cloud services library. Supports all major cloud providers including AWS, Rackspace, Linode, Blue Box, StormOnDemand, and many others. Full support for most AWS services including EC2, S3, CloudWatch, SimpleDB, ELB, and RDS."
 
   ## List the primary authors. If there are a bunch of authors, it's probably
   ## better to set the email to an email list or something. If you don't have
   ## a custom homepage, consider using your GitHub URL or the like.
   s.authors  = ["geemus (Wesley Beary)"]
-  s.email    = 'geemus@gmail.com'
-  s.homepage = 'http://github.com/geemus/fog'
-
-  ## This gets added to the $LOAD_PATH so that 'lib/NAME.rb' can be required as
-  ## require 'NAME.rb' or'/lib/NAME/file.rb' can be as require 'NAME/file.rb'
-  s.require_paths = %w[lib]
+  s.email    = "geemus@gmail.com"
+  s.homepage = "https://github.com/fog/fog"
+  s.license  = "MIT"
 
   ## This sections is only necessary if you have C extensions.
   # s.require_paths << 'ext'
   # s.extensions = %w[ext/extconf.rb]
 
+  ## This gets added to the $LOAD_PATH so that 'lib/NAME.rb' can be required as
+  ## require 'NAME.rb' or'/lib/NAME/file.rb' can be as require 'NAME/file.rb'
+  s.require_paths = %w[lib]
+
   ## If your gem includes any executables, list them here.
   s.executables = ["fog"]
-  s.default_executable = 'fog'
 
   ## Specify any RDoc options here. You'll want to add your README and
   ## LICENSE files to the extra_rdoc_files list.
   s.rdoc_options = ["--charset=UTF-8"]
-  s.extra_rdoc_files = %w[README.rdoc]
-
-  ## List your runtime dependencies here. Runtime dependencies are those
-  ## that are needed for an end user to actually USE your code.
-  s.add_dependency('builder')
-  s.add_dependency('excon', '>=0.5.7')
-  s.add_dependency('formatador', '>=0.1.2')
-  s.add_dependency('json')
-  s.add_dependency('mime-types')
-  s.add_dependency('net-ssh', '>=2.0.23')
-  s.add_dependency('nokogiri', '>=1.4.4')
-  s.add_dependency('ruby-hmac')
-
-  ## List your development dependencies here. Development dependencies are
-  ## those that are only needed during development
-  s.add_development_dependency('rake')
-  s.add_development_dependency('rspec', '1.3.1')
-  s.add_development_dependency('shindo', '0.3.4')
-  s.add_development_dependency('virtualbox', '0.8.3')
+  s.extra_rdoc_files = %w[README.md]
+
+  s.required_ruby_version = '>= 2.5.0'
+
+  s.add_dependency("fog-core", "~> 2.1")
+  s.add_dependency("fog-json")
+  s.add_dependency("fog-xml", "~> 0.1.1")
+
+  s.add_dependency("json", "~> 2.3")
+  s.add_dependency("ipaddress", "~> 0.5")
+
+  # Modular providers (please keep sorted)
+  s.add_dependency("fog-aliyun",">= 0.1.0")
+  s.add_dependency("fog-atmos")
+  s.add_dependency("fog-aws", ">= 0.6.0")
+  s.add_dependency("fog-brightbox", ">= 0.4", "< 2.0")
+  s.add_dependency("fog-cloudatcost", "~> 0.4")
+  s.add_dependency("fog-cloudstack", "~> 0.1.0")
+  s.add_dependency("fog-digitalocean", ">= 0.3.0")
+  s.add_dependency("fog-dnsimple", "~> 2.1")
+  s.add_dependency("fog-dynect", ">= 0.0.2", "< 0.6.0")
+  s.add_dependency("fog-ecloud", "~> 0.1")
+  s.add_dependency("fog-google", "~> 1.0")
+  s.add_dependency("fog-internet-archive")
+  s.add_dependency("fog-local")
+  s.add_dependency("fog-openstack")
+  s.add_dependency("fog-ovirt")
+  s.add_dependency("fog-powerdns", ">= 0.1.1")
+  s.add_dependency("fog-profitbricks")
+  s.add_dependency("fog-rackspace")
+  s.add_dependency("fog-radosgw", ">= 0.0.2")
+  s.add_dependency("fog-riakcs")
+  s.add_dependency("fog-sakuracloud", ">= 0.0.4")
+  s.add_dependency("fog-serverlove")
+  s.add_dependency("fog-softlayer")
+  s.add_dependency("fog-storm_on_demand")
+  s.add_dependency("fog-terremark")
+  s.add_dependency("fog-vmfusion")
+  s.add_dependency("fog-voxel")
+  s.add_dependency("fog-vsphere", ">= 0.4.0")
+  s.add_dependency("fog-xenserver")
+
+  s.add_development_dependency("docker-api", ">= 1.13.6")
+  s.add_development_dependency("fission")
+  s.add_development_dependency("mime-types")
+  s.add_development_dependency("minitest")
+  s.add_development_dependency("minitest-stub-const")
+  s.add_development_dependency("opennebula")
+  s.add_development_dependency("pry")
+  s.add_development_dependency("rake")
+  s.add_development_dependency("rbvmomi")
+  s.add_development_dependency("rubocop", "1.28.2")
+  s.add_development_dependency("shindo", "~> 0.3.4")
+  s.add_development_dependency("simplecov")
+  s.add_development_dependency("thor")
+  s.add_development_dependency("yard")
+  s.add_development_dependency("rspec-core")
+  s.add_development_dependency("rspec-expectations")
+  s.add_development_dependency("vcr")
+  s.add_development_dependency("webmock","~>3.18.1")
 
   s.files = `git ls-files`.split("\n")
   s.test_files = `git ls-files -- {spec,tests}/*`.split("\n")
+
+  postinstall_message =  <<-POSTINST
+------------------------------
+Thank you for installing fog!
+
+IMPORTANT NOTICE:
+If there's a metagem available for your cloud provider, e.g. `fog-aws`,
+you should be using it instead of requiring the full fog collection to avoid
+unnecessary dependencies.
+
+'fog' should be required explicitly only if the provider you use doesn't yet
+have a metagem available.
+------------------------------
+  POSTINST
+
+  s.post_install_message = postinstall_message
 end

data/gemfiles/Gemfile-2.0

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+
+gem "nokogiri", "1.6.8.1"
+
+group :development, :test do
+  gem "coveralls", :require => false
+  gem "netrc", :require => false
+  gem "octokit", :require => false
+end
+
+gemspec :path => "../"

data/gemfiles/Gemfile-edge

@@ -0,0 +1,14 @@
+source "https://rubygems.org"
+
+# Shared components
+gem "fog-core", :github => "fog/fog-core"
+gem "fog-json", :github => "fog/fog-json"
+
+group :development, :test do
+  gem "coveralls", :require => false
+  gem "netrc", :require => false
+  gem "octokit", :require => false
+  gem "term-ansicolor", "1.3.2"
+end
+
+gemspec :path => "../"

data/gemfiles/Gemfile-edge-2.0

@@ -0,0 +1,16 @@
+source "https://rubygems.org"
+
+# Shared components
+gem "fog-core", :github => "fog/fog-core"
+gem "fog-json", :github => "fog/fog-json"
+
+gem "nokogiri", "1.6.8.1"
+
+group :development, :test do
+  gem "coveralls", :require => false
+  gem "netrc", :require => false
+  gem "octokit", :require => false
+  gem "term-ansicolor", "1.3.2"
+end
+
+gemspec :path => "../"

data/lib/fog/aws/service_mapper.rb

@@ -0,0 +1,129 @@
+module Fog
+  module AWS
+    # @api private
+    #
+    # This is a temporary lookup helper for extracting into external module.
+    #
+    # Cleaner provider/service registration will replace this code.
+    #
+    class ServiceMapper
+      def self.class_for(key)
+        case key
+        when :auto_scaling
+          Fog::AWS::AutoScaling
+        when :beanstalk
+          Fog::AWS::ElasticBeanstalk
+        when :cdn
+          Fog::CDN::AWS
+        when :cloud_formation
+          Fog::AWS::CloudFormation
+        when :cloud_watch
+          Fog::AWS::CloudWatch
+        when :compute
+          Fog::Compute::AWS
+        when :data_pipeline
+          Fog::AWS::DataPipeline
+        when :ddb, :dynamodb
+          Fog::AWS::DynamoDB
+        when :dns
+          Fog::DNS::AWS
+        when :elasticache
+          Fog::AWS::Elasticache
+        when :elb
+          Fog::AWS::ELB
+        when :emr
+          Fog::AWS::EMR
+        when :glacier
+          Fog::AWS::Glacier
+        when :iam
+          Fog::AWS::IAM
+        when :redshift
+          Fog::AWS::Redshift
+        when :sdb, :simpledb
+          Fog::AWS::SimpleDB
+        when :ses
+          Fog::AWS::SES
+        when :sqs
+          Fog::AWS::SQS
+        when :eu_storage, :storage
+          Fog::Storage::AWS
+        when :rds
+          Fog::AWS::RDS
+        when :sns
+          Fog::AWS::SNS
+        when :sts
+          Fog::AWS::STS
+        else
+          # @todo Replace most instances of ArgumentError with NotImplementedError
+          # @todo For a list of widely supported Exceptions, see:
+          # => http://www.zenspider.com/Languages/Ruby/QuickRef.html#35
+          raise ArgumentError, "Unsupported #{self} service: #{key}"
+        end
+      end
+
+      def self.[](service)
+        @@connections ||= Hash.new do |hash, key|
+          hash[key] = case key
+                      when :auto_scaling
+                        Fog::AWS::AutoScaling.new
+                      when :beanstalk
+                        Fog::AWS::ElasticBeanstalk.new
+                      when :cdn
+                        Fog::Logger.warning("AWS[:cdn] is not recommended, use CDN[:aws] for portability")
+                        Fog::CDN.new(:provider => 'AWS')
+                      when :cloud_formation
+                        Fog::AWS::CloudFormation.new
+                      when :cloud_watch
+                        Fog::AWS::CloudWatch.new
+                      when :compute
+                        Fog::Logger.warning("AWS[:compute] is not recommended, use Compute[:aws] for portability")
+                        Fog::Compute.new(:provider => 'AWS')
+                      when :data_pipeline
+                        Fog::AWS::DataPipeline.new
+                      when :ddb, :dynamodb
+                        Fog::AWS::DynamoDB.new
+                      when :dns
+                        Fog::Logger.warning("AWS[:dns] is not recommended, use DNS[:aws] for portability")
+                        Fog::DNS.new(:provider => 'AWS')
+                      when :elasticache
+                        Fog::AWS::Elasticache.new
+                      when :elb
+                        Fog::AWS::ELB.new
+                      when :emr
+                        Fog::AWS::EMR.new
+                      when :glacier
+                        Fog::AWS::Glacier.new
+                      when :iam
+                        Fog::AWS::IAM.new
+                      when :redshift
+                        Fog::AWS::Redshift.new
+                      when :rds
+                        Fog::AWS::RDS.new
+                      when :eu_storage
+                        Fog::Storage.new(:provider => 'AWS', :region => 'eu-west-1')
+                      when :sdb, :simpledb
+                        Fog::AWS::SimpleDB.new
+                      when :ses
+                        Fog::AWS::SES.new
+                      when :sqs
+                        Fog::AWS::SQS.new
+                      when :storage
+                        Fog::Logger.warning("AWS[:storage] is not recommended, use Storage[:aws] for portability")
+                        Fog::Storage.new(:provider => 'AWS')
+                      when :sns
+                        Fog::AWS::SNS.new
+                      when :sts
+                        Fog::AWS::STS.new
+                      else
+                        raise ArgumentError, "Unrecognized service: #{key.inspect}"
+                      end
+        end
+        @@connections[service]
+      end
+
+      def self.services
+        Fog::AWS.services
+      end
+    end
+  end
+end

data/lib/fog/bare_metal_cloud/compute.rb

@@ -0,0 +1,93 @@
+require 'fog/bare_metal_cloud/core'
+
+module Fog
+  module Compute
+    class BareMetalCloud < Fog::Service
+      requires :bare_metal_cloud_password, :bare_metal_cloud_username
+      recognizes :host, :port, :scheme, :persistent
+
+      model_path 'fog/bare_metal_cloud/models/compute'
+
+      request_path 'fog/bare_metal_cloud/requests/compute'
+      request :add_server
+      request :add_server_by_configuration
+      request :cancel_server
+      request :get_server
+      request :list_images
+      request :list_plans
+      request :list_servers
+      request :list_configurations
+      request :reboot_server
+
+      class Mock
+        def self.data
+          @data ||= Hash.new do |hash, key|
+            hash[key] = {}
+          end
+        end
+
+        def self.reset
+          @data = nil
+        end
+
+        def initialize(options={})
+          @bare_metal_cloud_username = options[:bare_metal_cloud_username]
+        end
+
+        def data
+          self.class.data[@bare_metal_cloud_username]
+        end
+
+        def reset_data
+          self.class.data.delete(@bare_metal_cloud_username)
+        end
+      end
+
+      class Real
+        def initialize(options={})
+
+          @bare_metal_cloud_password = options[:bare_metal_cloud_password]
+          @bare_metal_cloud_username = options[:bare_metal_cloud_username]
+          @connection_options = options[:connection_options] || {}
+          @host       = options[:host]        || "noc.newservers.com"
+          @persistent = options[:persistent]  || false
+          @port       = options[:port]        || 443
+          @scheme     = options[:scheme]      || 'https'
+          @connection = Fog::XML::Connection.new("#{@scheme}://#{@host}:#{@port}", @persistent, @connection_options)
+        end
+
+        def reload
+          @connection.reset
+        end
+
+        def request(params)
+          params[:query] ||= {}
+          params[:query].merge!({
+            :password => @bare_metal_cloud_password,
+            :username => @bare_metal_cloud_username
+          })
+          params[:headers] ||= {}
+          case params[:method]
+          when 'DELETE', 'GET', 'HEAD'
+            params[:headers]['Accept'] = 'application/xml'
+          when 'POST', 'PUT'
+            params[:headers]['Content-Type'] = 'application/xml'
+          end
+
+          begin
+            response = @connection.request(params)
+          rescue Excon::Errors::HTTPStatusError => error
+            raise case error
+            when Excon::Errors::NotFound
+              Fog::Compute::BareMetalCloud::NotFound.slurp(error)
+            else
+              error
+            end
+          end
+
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/bare_metal_cloud/core.rb

@@ -0,0 +1,10 @@
+require 'fog/core'
+require 'fog/xml'
+
+module Fog
+  module BareMetalCloud
+    extend Fog::Provider
+
+    service(:compute, 'Compute')
+  end
+end

data/lib/fog/bare_metal_cloud/requests/compute/add_server.rb

@@ -0,0 +1,31 @@
+module Fog
+  module Compute
+    class BareMetalCloud
+      class Real
+        # Boot a new server
+        #
+        # ==== Parameters
+        # * planId<~String> - The id of the plan to boot the server with
+        # * options<~Hash>: optional extra arguments
+        #   * imageId<~String>  - Optional image to boot server from
+        #   * name<~String>     - Name to boot new server with
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'server'<~Hash>:
+        #       * 'id'<~String> - Id of the image
+        #
+        def add_server(plan_id, options = {})
+          request(
+            :expects  => 200,
+            :method   => 'GET',
+            :parser   => Fog::ToHashDocument.new,
+            :path     => 'api/addServer',
+            :query    => {'planId' => plan_id}.merge!(options)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/bare_metal_cloud/requests/compute/add_server_by_configuration.rb

@@ -0,0 +1,31 @@
+module Fog
+  module Compute
+    class BareMetalCloud
+      class Real
+        # Boot a new server by configuration
+        #
+        # ==== Parameters
+        # * config<~String> - The Hardware configuration string
+        # * options<~Hash>: optional extra arguments
+        #   * imageName<~String>  - Optional imageName to be installed
+        #   * name<~String>     - Optional server Name
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'server'<~Hash>:
+        #       * 'id'<~String> - Id of the image
+        #
+        def add_server_by_configuration(config, options = {})
+          request(
+            :expects  => 200,
+            :method   => 'GET',
+            :parser   => Fog::ToHashDocument.new,
+            :path     => 'api/addServerByConfiguration',
+            :query    => {'configuration' => config}.merge!(options)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/bare_metal_cloud/requests/compute/cancel_server.rb

@@ -0,0 +1,28 @@
+module Fog
+  module Compute
+    class BareMetalCloud
+      class Real
+        # Shutdown a running server
+        #
+        # ==== Parameters
+        # * serverId<~String> - The id of the server to shutdown
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'server'<~Hash>:
+        #       * 'id'<~String> - Id of the image
+        #
+        def cancel_server(server_id)
+          request(
+            :expects  => 200,
+            :method   => 'GET',
+            :parser   => Fog::ToHashDocument.new,
+            :path     => 'api/cancelServer',
+            :query    => {'serverId' => server_id}
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/bare_metal_cloud/requests/compute/get_server.rb

@@ -0,0 +1,39 @@
+module Fog
+  module Compute
+    class BareMetalCloud
+      class Real
+        # List servers
+        #
+        # ==== Parameters
+        # * serverId<~String> - Id of the server
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Has>:
+        #     * server<~Hash>:
+        #       * 'id'<~String> - Id of the server
+        #       * 'mac-address'<~String>  - mac-address of the server
+        #       * 'ip'<~Hash>:
+        #         * 'address'<~String>  - Address of the ip
+        #         * 'name'<~String>     - Name of the ip
+        #       * 'login'<~Hash>:
+        #         * 'name'<~String>     - Name of the login
+        #         * 'password'<~String> - Password of the login
+        #         * 'username'<~String> - Username of the login
+        #       * 'name'<~String>   - Name of the server
+        #       * 'notes'<~String>  - Notes about the server
+        #       * 'state'<~String>  - State of the server
+        #
+        def get_server(server_id)
+          request(
+            :expects  => 200,
+            :method   => 'GET',
+            :parser   => Fog::ToHashDocument.new,
+            :path     => 'api/getServer',
+            :query    => {'serverId' => server_id}
+          )
+        end
+      end
+    end
+  end
+end

data/lib/fog/bare_metal_cloud/requests/compute/list_configurations.rb

@@ -0,0 +1,25 @@
+module Fog
+  module Compute
+    class BareMetalCloud
+      class Real
+        # List Configurations
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * available-server<~Array>:
+        #       * 'configuration'<~String>     - Hardware Configuration string
+        #       * 'quantity'<~String>:  - quantity of servers to a certain configuration
+        #
+        def list_configurations
+          request(
+            :expects  => 200,
+            :method   => 'GET',
+            :parser   => Fog::ToHashDocument.new,
+            :path     => 'api/listConfigurations'
+          )
+        end
+      end
+    end
+  end
+end