didata_cloud_sdk 0.3.1

data/lib/opsource/api/vip.rb

@@ -0,0 +1,125 @@
+module Opsource::API
+  class VIP < Core
+
+  # Real Server section
+    def real_servers_list (network_id)
+      org_endpoint "/network/#{network_id}/realServer"
+      get
+    end
+
+    # Examples name = RealServer1, server_id = "415a7f70-1008-42a3-8375-5dcf52636cc5", in_service = true/false
+    def real_server_create (network_id, name, server_id, in_service)
+      org_endpoint "/network/#{network_id}/realServer"
+      xml_params(tag: "NewRealServer", schema: "vip", name: name, server_id: server_id, in_service: in_service)
+      post
+    end
+
+
+    def real_server_delete (network_id, rserver_id)
+      org_endpoint "/network/#{network_id}/realServer/#{rserver_id}?delete"
+      get
+    end
+
+
+    def real_server_modify (network_id, rserver_id, in_service)
+      org_endpoint "/network/#{network_id}/realServer/#{rserver_id}"
+      xml_params(in_service: in_service)
+      post
+    end
+
+  # Probe section
+    def probe_list (network_id)
+      org_endpoint "/network/#{network_id}/probe"
+      get
+    end
+
+    # Note this is for TCP, UDP & ICMP only additional xml fields need to be added to be complete
+    # Examples name = Probe1, type = TCP, probeIntervalSeconds = "60", errorCountBeforeServerFail = "5" maxReplyWaitSeconds = "10"
+    def probe_create
+      org_endpoint "/network/#{network_id}/probe"
+      xml_params(name: name, type: type, probeIntervalSeconds: probeIntervalSeconds, errorCountBeforeServerFail: errorCountBeforeServerFail, successCountBeforeServerEnable: successCountBeforeServerEnable, failedProbeIntervalSeconds: failedProbeIntervalSeconds, maxReplyWaitSeconds: maxReplyWaitSeconds)
+      post
+    end
+
+
+    def probe_delete (network_id, probe_id)
+      org_endpoint "/network/#{network_id}/probe/{probe_id}?delete"
+      get
+    end
+
+
+  # Server Farm Section
+    def server_farm_list (network_id)
+      org_endpoint "/network/#{network_id}/serverFarm"
+      get
+    end
+
+    def server_farm_details (network_id, server_farm_id)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}"
+      get
+    end
+
+    def server_farm_create (network_id, name, real_server_id, port, predictor)
+      if ["ROUND_ROBIN", "LEAST_CONNECTIONS"].include? predictor
+        org_endpoint "/network/#{network_id}/serverFarm"
+        xml_params(schema: "vip", tag: "NewServerFarm", name: name, predictor: predictor, real_server: {id: real_server_id, port: port})
+        post
+      else
+        raise "Unknown predictor: #{predictor}"
+      end
+    end
+
+    def server_farm_delete (network_id, server_farm_id)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}?delete"
+      get
+    end
+
+    # Examples realServerId = "RealServer1", realSeverPort = "80"
+    def real_server_to_server_farm (network_id, server_farm_id, real_server_id, real_server_port)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}/addRealServer"
+      simple_params(real_server_id: real_server_id, real_server_port: real_server_port)
+      post_simple
+    end
+
+    # Examples realServerId = "RealServer1", realSeverPort = "80"
+    def real_server_from_server_farm (network_id, server_farm_id, real_server_id, real_server_port)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}/removeRealServer"
+      simple_params(real_server_id: real_server_id, real_server_port: real_server_port)
+      post_simple
+    end
+
+
+    # Examples probe_id = TCP1
+    def probe_to_server_farm (network_id, server_farm_id, probe_id)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}/addProbe"
+      xml_params(probe_id: probe_id)
+      post
+    end
+
+    # Examples probe_id = TCP1
+    def probe_from_server_farm (network_id, server_farm_id, probe_id)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}/removeProbe"
+      xml_params(probe_id: probe_id)
+      post
+    end
+
+    # Examples predictor= LEAST_CONNECTIONS | ROUND_ROBIN
+    def server_farm_predictor(network_id, server_farm_id, predictor)
+      org_endpoint "/network/#{network_id}/serverFarm/#{server_farm_id}"
+      xml_params(predictor: predictor)
+      post
+    end
+
+    def vip_list(network_id)
+      org_endpoint "/network/#{network_id}/vip"
+      get
+    end
+
+    def vip_create(network_id, name, port, protocol, server_farm_id)
+      org_endpoint "/network/#{network_id}/vip"
+      xml_params(schema: "vip", tag: "NewVip", name: name, port: port, protocol: protocol, vip_target_type: "SERVER_FARM", vip_target_id: server_farm_id, reply_to_icmp: true, in_service: true)
+      post
+    end
+
+  end
+end

data/lib/opsource/client.rb

@@ -0,0 +1,91 @@
+module Opsource
+  class Client
+    include Opsource::Connection
+    include Opsource::Params
+    include Opsource::XML
+
+    attr_reader :api_base, :org_id, :username, :password
+    attr_reader :image, :directory, :network, :server, :account, :report
+    attr_reader :datacenter, :default_password
+
+    ### FILTERS
+    # client.page_size = 10
+    # client.page_number = 1
+    # client.order_by = 'location,created.DESCENDING'
+    # client.filter_with = {location: %w(NA1 NA2), key: 'value'}
+    attr_accessor :silent, :colors # log setting
+    attr_accessor :page_size, :page_number, :order_by, :filter_with
+
+
+
+    def initialize(api_base, org_id, username, password, default_password="verysecurepassword", datacenter="EU1", colors = true, silent = false)
+      @api_base = api_base
+      @org_id       = org_id
+      @username     = username
+      @password     = password
+      @datacenter   = datacenter
+      @default_password     = default_password
+
+      @colors = colors
+      @silent = silent
+
+      if @colors
+        require 'colorize'
+      end
+    end
+
+    def directory
+      Opsource::API::Directory.new(self)
+    end
+
+    def image
+      Opsource::API::Image.new(self)
+    end
+
+    def network
+      Opsource::API::Network.new(self)
+    end
+
+    def server
+      Opsource::API::Server.new(self)
+    end
+
+    def account
+      Opsource::API::Account.new(self)
+    end
+
+    def report
+      Opsource::API::Report.new(self)
+    end
+
+    def vip
+      Opsource::API::VIP.new(self)
+    end
+
+    def filter_params
+      params = {}
+      params[:page_size] = @page_size if @page_size.present?
+      params[:page_number] = @page_number if @page_number.present?
+      params[:order_by] = @order_by if @order_by.present?
+
+      if @filter_with.present?
+        @filter_with.each do |k, val|
+          params[k.to_sym] = val
+        end
+      end
+      params
+    end
+
+    # mode: bold, underscore, default
+    def log(message, color = nil, mode = nil)
+      return if @silent
+      if @colors
+        color = color.to_sym if color
+        mode = mode.to_sym if mode
+        puts message.colorize(:color => color, :mode => mode)
+      else
+        puts message
+      end
+    end
+  end
+end

data/lib/opsource/connection.rb

@@ -0,0 +1,60 @@
+module Opsource
+  module Connection
+    def build_request(type, endpoint, query = nil, body = nil, xml=true)
+      # url = "https://cloudapi.nttamerica.com/oec/0.9" + "/server"
+      uri = api_base + endpoint
+      append_query(uri, query) if query
+
+      if xml
+        request = Typhoeus::Request.new(
+          uri,
+          method: type,
+          body: body,
+          userpwd: "#{@username}:#{@password}",
+            headers: { 'Content-Type' =>'text/xml', 'User-Agent' => 'ACP Ruby SDK' }
+        )
+      else
+        request = Typhoeus::Request.new(
+          uri,
+          method: type,
+          body: body,
+          userpwd: "#{@username}:#{@password}",
+            headers: {  'User-Agent' => 'ACP Ruby SDK' }
+        )
+      end
+    end
+
+    def append_query(uri, query)
+      if uri.include?('?')
+        uri << '&'
+      else
+        uri << '?'
+      end
+      uri << query
+    end
+
+
+    def perform_request(request)
+      log "\nrequesting #{request.url}...", :yellow
+      request.run
+    end
+
+    def log_response(request, response)
+      if response.success?
+        log "...........success!", :yellow
+      elsif response.timed_out?
+        log "ERROR\n-----", :red
+        log "got a time out"
+      elsif response.code == 0
+        # Could not get an http response, something's wrong.
+        log "ERROR\n-----", :red
+        log response.return_message
+      else
+        # Received a non-successful http response.
+        log "ERROR\n-----", :red
+        log "HTTP request failed: " + response.code.to_s, :red
+        log response.body, :yellow
+      end
+    end
+  end
+end

data/lib/opsource/exceptions.rb

@@ -0,0 +1,14 @@
+module Opsource
+  module Exceptions
+    CODES = {
+      "REASON_10" => "Failure at network",
+      "REASON_20" => "Unrecoverable failure cause by a timeout.",
+      "REASON_250" => "Network does not exist for this organization.",
+      "REASON_320" => "Invalid Input Data - SourceIP must be a valid IPv4 address."
+    }
+
+    class ApiError < StandardError; end
+    class ConnectionError < StandardError; end
+    class RequestError < StandardError; end
+  end
+end

data/lib/opsource/params.rb

@@ -0,0 +1,62 @@
+module Opsource
+  module Params
+    def url_query(params)
+      params = camelize_keys(params)
+      qitems = []
+      params.each do |k, vs|
+        vs = [vs].flatten.compact # remove nil values
+        vs.each {|v| qitems << "#{k}=#{v}"}
+      end
+      qitems.join('&')
+    end
+
+    def symbolize_keys(arg)
+      case arg
+      when Array
+        arg.map {  |elem| symbolize_keys elem }
+      when Hash
+        Hash[
+          arg.map {  |key, value|
+            k = key.is_a?(String) ? key.to_sym : key
+            v = symbolize_keys value
+            [k,v]
+          }]
+      else
+        arg
+      end
+    end
+
+    def underscore_keys(arg)
+      case arg
+      when Array
+        arg.map {  |elem| underscore_keys elem }
+      when Hash
+        Hash[
+          arg.map {  |key, value|
+            k = key.is_a?(String) ? key.underscore : key
+            v = underscore_keys value
+            [k,v]
+          }]
+      else
+        arg
+      end
+    end
+
+    def camelize_keys(arg)
+      case arg
+      when Array
+        arg.map {  |elem| camelize_keys elem }
+      when Hash
+        Hash[
+          arg.map {  |key, value|
+            k = key.is_a?(String) ? key.camelize(:lower) : key
+            k = key.is_a?(Symbol) ? key.to_s.camelize(:lower).to_sym : key
+            v = camelize_keys value
+            [k,v]
+          }]
+      else
+        arg
+      end
+    end
+  end
+end

data/lib/opsource/version.rb

@@ -0,0 +1,22 @@
+module Opsource
+  VERSION = "0.3.1"
+
+  {"xmlns:ns3"=>"http://oec.api.opsource.net/schemas/organization",
+    "xmlns:ns4"=>"http://oec.api.opsource.net/schemas/network",
+    "xmlns:ns2"=>"http://oec.api.opsource.net/schemas/directory",
+    "xmlns:ns8"=>"http://oec.api.opsource.net/schemas/general",
+    "xmlns:ns7"=>"http://oec.api.opsource.net/schemas/datacenter",
+    "xmlns:ns6"=>"http://oec.api.opsource.net/schemas/whitelabel",
+    "xmlns:ns5"=>"http://oec.api.opsource.net/schemas/vip",
+    "xmlns:ns9"=>"http://oec.api.opsource.net/schemas/admin",
+    "natIp"=>["207.20.54.2"],
+    "xmlns"=>"http://oec.api.opsource.net/schemas/server",
+    "sourceIp"=>["10.166.152.201"],
+    "id"=>["ac371318-f755-4dc1-bbc3-51a1522ca2fe"],
+    "name"=>["10.166.152.201"],
+    "xmlns:ns11"=>"http://oec.api.opsource.net/schemas/reset",
+    "xmlns:ns10"=>"http://oec.api.opsource.net/schemas/multigeo",
+    "xmlns:ns13"=>"http://oec.api.opsource.net/schemas/storage",
+    "xmlns:ns12"=>"http://oec.api.opsource.net/schemas/support",
+    "xmlns:ns14"=>"http://oec.api.opsource.net/schemas/manualimport"}
+end

data/lib/opsource/xml.rb

@@ -0,0 +1,53 @@
+module Opsource
+  module XML
+    def xml_header
+      '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' "\n"
+    end
+
+    def parse_response_xml_body(body)
+      # we'll not use 'KeyToSymbol' because it doesn't symbolize the keys for node attributes
+      opts = { 'ForceArray' => false, 'ForceContent' => false }
+      hash = XmlSimple.xml_in(body, opts)
+      hash.delete_if {|k, v| k =~ /(xmlns|xmlns:ns)/ } # removing the namespaces from response
+      Hashie::Mash.new(underscore_keys(hash))
+    rescue Exception => e
+      log "Impossible to convert XML to hash. Error: #{e.message}", :red
+      raise e
+    end
+
+    def build_request_simple_body(params)
+      params = camelize_keys(params)
+      #simple construction of post body...
+      body = params.map { |k, v| "#{k}=#{v}&" }
+      body.join
+    end
+
+    def build_request_xml_body(schema, tag, params)
+      params = camelize_keys(params)
+      schema_url = "http://oec.api.opsource.net/schemas/#{schema}"
+
+      xml = xml_header
+      xml += "<#{tag} xmlns=\"#{schema_url}\">\n"
+      params.each do |k, value|
+
+        xml += build_xml_helper(k, value)
+        xml += "\n"
+      end
+      xml += "</#{tag}>\n"
+    end
+
+    def build_xml_helper(key, value)
+        result = "<#{key}>"
+        if value.is_a?(Hash)
+            value.each do |k, v|
+                result += build_xml_helper(k,v)
+            end
+        else
+            result += "#{value}"
+        end
+        result += "</#{key}>"
+        result
+    end
+
+  end
+end

data/lib/opsource.rb

@@ -0,0 +1,22 @@
+require 'active_support/core_ext/object'
+require 'active_support/core_ext/string'
+require 'typhoeus'
+require 'xmlsimple'
+require 'hashie'
+
+require './opsource/version.rb'
+require './opsource/exceptions.rb'
+
+require './opsource/connection.rb'
+require './opsource/params.rb'
+require './opsource/xml.rb'
+require './opsource/client.rb'
+
+require './opsource/api/core.rb'
+require './opsource/api/directory.rb'
+require './opsource/api/image.rb'
+require './opsource/api/network.rb'
+require './opsource/api/server.rb'
+require './opsource/api/vip.rb'
+require './opsource/api/account.rb'
+require './opsource/api/report.rb'

data/opsource.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "opsource/version"
+
+Gem::Specification.new do |s|
+  s.name        = "didata_cloud_sdk"
+  s.version     = Opsource::VERSION
+  s.authors     = ["Juozas Gaigalas", "Tim Wade", "Stijn Muylle"]
+  s.email       = ["juozasgaigalas@gmail.com", "pimpingeezer@gmail.com", "stijnmuylle@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Dimension Data REST API client gem}
+  s.description = %q{SDK to access Dimension Data Cloud api'}
+
+  s.rubyforge_project = "opsource"
+
+  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"]
+
+  s.add_dependency 'i18n'
+  s.add_dependency 'activesupport'
+  s.add_dependency 'typhoeus'
+  s.add_dependency 'xml-simple'
+  s.add_dependency 'hashie'
+  s.add_dependency 'colorize'
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: didata_cloud_sdk
+version: !ruby/object:Gem::Version
+  version: 0.3.1
+platform: ruby
+authors:
+- Juozas Gaigalas
+- Tim Wade
+- Stijn Muylle
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: xml-simple
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: SDK to access Dimension Data Cloud api'
+email:
+- juozasgaigalas@gmail.com
+- pimpingeezer@gmail.com
+- stijnmuylle@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- doc/Cloud-REST-API-v09-121313.pdf
+- doc/deprecated_sections.txt
+- doc/doc.txt
+- doc/pagination-and-filtering.txt
+- doc/schemas.txt
+- doc/sections.txt
+- doc/urls.txt
+- lib/opsource.rb
+- lib/opsource/api/account.rb
+- lib/opsource/api/core.rb
+- lib/opsource/api/directory.rb
+- lib/opsource/api/image.rb
+- lib/opsource/api/network.rb
+- lib/opsource/api/report.rb
+- lib/opsource/api/server.rb
+- lib/opsource/api/vip.rb
+- lib/opsource/client.rb
+- lib/opsource/connection.rb
+- lib/opsource/exceptions.rb
+- lib/opsource/params.rb
+- lib/opsource/version.rb
+- lib/opsource/xml.rb
+- opsource.gemspec
+homepage: ''
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: opsource
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Dimension Data REST API client gem
+test_files: []