profitbricks-sdk-ruby 1.0.2

data/lib/profitbricks/lan.rb

@@ -0,0 +1,75 @@
+module ProfitBricks
+  # LAN class
+  class LAN < ProfitBricks::Model
+
+    # Delete the LAN.
+    def delete
+      ProfitBricks.request(
+        method: :delete,
+        path: "/datacenters/#{self.datacenterId}/lans/#{self.id}",
+        expects: 202
+      )
+    end
+
+    # Update the LAN.
+    def update(options = {})
+      response = ProfitBricks.request(
+        method: :patch,
+        path: "/datacenters/#{self.datacenterId}/lans/#{self.id}",
+        expects: 202,
+        body: options.to_json
+      )
+      if response
+        @properties = @properties.merge(response['properties'])
+      end
+      self
+    end
+
+    # List LAN members.
+    def list_members
+      response = ProfitBricks.request(
+        method: :get,
+        path: "/datacenters/#{self.datacenterId}/lans/#{self.id}/nics",
+        expects: 200,
+      )
+      self.class.instantiate_objects(response)
+    end
+
+    class << self
+
+      # Create a new LAN.
+      def create(datacenter_id, options = {})
+        response = ProfitBricks.request(
+          method: :post,
+          path: "/datacenters/#{datacenter_id}/lans",
+          expects: 202,
+          body: { properties: options }.to_json
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # List all LANs under a datacenter.
+      def list(datacenter_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/datacenters/#{datacenter_id}/lans",
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # Retrieve a LAN under a datacenter.
+      def get(datacenter_id, lan_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/datacenters/#{datacenter_id}/lans/#{lan_id}",
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+    end
+  end
+end

data/lib/profitbricks/loadbalancer.rb

@@ -0,0 +1,126 @@
+module ProfitBricks
+  # Loadbalancer class
+  class Loadbalancer < ProfitBricks::Model
+    # Delete the loadbalancer.
+    def delete
+      ProfitBricks.request(
+        method: :delete,
+        path: "/datacenters/#{self.datacenterId}/loadbalancers/#{self.id}",
+        expects: 202
+      )
+    end
+
+    # Update the loadbalancer.
+    def update(options = {})
+      response = ProfitBricks.request(
+        method: :patch,
+        path: "/datacenters/#{self.datacenterId}/loadbalancers/#{self.id}",
+        expects: 202,
+        body: options.to_json
+      )
+      if response
+        @properties = @properties.merge(response['properties'])
+      end
+      self
+    end
+
+    def list_balanced_nics
+      response = ProfitBricks.request(
+        method: :get,
+        path: "/datacenters/#{self.datacenterId}/loadbalancers/#{self.id}/balancednics",
+        expects: 200,
+      )
+      self.class.instantiate_objects(response)
+    end
+
+    def associate_balanced_nic(nic_id)
+      response = ProfitBricks.request(
+        method: :post,
+        path: "/datacenters/#{self.datacenterId}/loadbalancers/#{self.id}/balancednics",
+        expects: 202,
+        body: { id: nic_id }.to_json
+      )
+      self.class.instantiate_objects(response)
+    end
+
+    def get_balanced_nic(nic_id)
+      response = ProfitBricks.request(
+        method: :get,
+        path: "/datacenters/#{self.datacenterId}/loadbalancers/#{self.id}/balancednics/#{nic_id}",
+        expects: 200
+      )
+      self.class.instantiate_objects(response)
+    end
+
+    def remove_balanced_nic(nic_id)
+      ProfitBricks.request(
+        method: :delete,
+        path: "/datacenters/#{self.datacenterId}/loadbalancers/#{self.id}/balancednics/#{nic_id}",
+        expects: 202
+      )
+    end
+
+    alias_method :list_nics, :list_balanced_nics
+    alias_method :associate_nic, :associate_balanced_nic
+    alias_method :remove_nic, :remove_balanced_nic
+
+    class << self
+      # Create a new loadbalancer.
+      #
+      # ==== Parameters
+      # * +options+<Hash>:
+      #   - +name+<String> - *Optional*, name of the loadbalancer
+      #   - +ip+<String> - *Optional*, IPv4 address of the loadbalancer
+      #   - +dhcp+<Boolean> - *Optional*, Indicates if the loadbalancer will reserve an IP using DHCP
+      #
+      # ==== Returns
+      # * +id+<String> - Universally unique identifer of resource
+      # * +type+<String> - Resource type
+      # * +href+<String> - Resource URL representation
+      # * +metadata+<Hash>:
+      #   - +lastModifiedDate+
+      #   - +lastModifiedBy+
+      #   - +createdDate+
+      #   - +createdBy+
+      #   - +state+
+      #   - +etag+
+      # * +properties+<Hash>:
+      #   - +name+<String>
+      #   - +ip+<String>
+      #   - +dhcp+<Boolean>
+      #
+      def create(datacenter_id, options = {})
+        response = ProfitBricks.request(
+          method: :post,
+          path: "/datacenters/#{datacenter_id}/loadbalancers",
+          expects: 202,
+          body: { properties: options }.to_json
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # List all loadbalancers under a datacenter.
+      def list(datacenter_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/datacenters/#{datacenter_id}/loadbalancers",
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # Retrieve a loadbalancer under a datacenter.
+      def get(datacenter_id, loadbalancer_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/datacenters/#{datacenter_id}/loadbalancers/#{loadbalancer_id}",
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+    end
+  end
+end

data/lib/profitbricks/location.rb

@@ -0,0 +1,28 @@
+module ProfitBricks
+  # Location class
+  class Location < ProfitBricks::Model
+
+    class << self
+
+      # List all locations.
+      def list
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/locations",
+          expects: 200
+        )
+        instantiate_objects(response)
+      end
+
+      # Retrieve a location.
+      def get(location_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/locations/#{location_id}",
+          expects: 200
+        )
+        instantiate_objects(response)
+      end
+    end
+  end
+end

data/lib/profitbricks/model.rb

@@ -0,0 +1,116 @@
+module ProfitBricks
+  # Resource model class
+  class Model
+    attr_accessor :metadata
+    attr_accessor :properties
+    attr_accessor :datacenterId
+    attr_accessor :serverId
+    attr_accessor :nicId
+    attr_accessor :requestId
+
+    def initialize(options = {})
+      options.each do |key, value|
+        self.class.send :define_method, key do
+          instance_variable_get("@#{key}")
+        end
+        instance_variable_set("@#{key}".to_sym, value)
+      end
+    end
+
+    def ready?
+      status = ProfitBricks::Request.get(self.requestId).status
+      status.metadata['status'] == 'DONE'
+    end
+
+    def reload
+      # Remove URL host and prefix path from href.
+      path = URI(self.href).path
+      path.sub!(ProfitBricks::Config.path_prefix, '/')
+      
+      response = ProfitBricks.request(
+        method: :get,
+        path: path,
+        expects: 200
+      )
+
+      # Find cleaner method to set the variable instances on reload.
+      if response
+        if @metadata
+          @metadata = @metadata.merge!(response['metadata'])
+        else
+          instance_variable_set(:@metadata, response['metadata'])
+        end
+
+        if @properties
+          @properties = @properties.merge!(response['properties'])
+        else
+          instance_variable_set(:@properties, response['properties'])
+        end
+      end
+      self
+    end
+
+    def wait_for(timeout = ProfitBricks::Config.timeout, interval = 1, &block)
+      reload_has_succeeded = false
+      duration = ProfitBricks.wait_for(timeout, interval) do # Note that duration = false if it times out
+        # if reload
+        if ready?
+          reload_has_succeeded = true
+          instance_eval(&block)
+        else
+          false
+        end
+      end
+      if reload_has_succeeded
+        return duration # false if timeout; otherwise {:duration => elapsed time }
+      else
+        raise StandardError, "Reload failed, #{self.class} #{self.id} not present."
+      end
+    end
+
+    private
+
+    # Convert text to JSON.
+    def self.parse_json(body)
+      JSON.parse(body) unless body.nil? || body.empty?
+    rescue JSON::ParserError => error
+      raise error
+    end
+
+    # Add parent resource ID's to response resources. This will provide
+    # convenient ID instance variable for subsequent methods.
+    def self.add_parent_identities(response)
+      uri = URI(response['href']).path.split('/')
+      if response.key?('items') then
+        response['items'].each do |item|
+          item.merge!(extract_identities(uri))
+        end
+      else
+        response.merge!(extract_identities(uri))
+      end
+    end
+
+    def self.extract_identities(uri)
+      identities = {}
+      identities['datacenterId'] = uri[3] if uri[2] == 'datacenters'
+      identities['serverId'] = uri[5] if uri[4] == 'servers'
+      identities['nicId'] = uri[7] if uri[6] == 'nics'
+      identities
+    end
+
+    # Construct Ruby objects from API response.
+    def self.instantiate_objects(response)
+      if response['type'] == 'collection'
+        response['items'].map { |item| new(item) }
+      else
+        new(response)
+      end
+    end
+
+    def self.method_missing(name)
+      return self[name] if key? name
+      self.each { |key, value| return value if key.to_s.to_sym == name }
+      super.method_missing name
+    end
+  end
+end

data/lib/profitbricks/nic.rb

@@ -0,0 +1,86 @@
+module ProfitBricks
+  # NIC class
+  class NIC < ProfitBricks::Model
+
+    # Delete the NIC.
+    def delete
+      ProfitBricks.request(
+        method: :delete,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.serverId}/nics/#{self.id}",
+        expects: 202
+      )
+    end
+
+    # Update the NIC.
+    def update(options = {})
+      response = ProfitBricks.request(
+        method: :patch,
+        path: "/datacenters/#{self.datacenterId}/servers/#{self.serverId}/nics/#{self.id}",
+        expects: 202,
+        body: options.to_json
+      )
+      if response
+        @properties = @properties.merge(response['properties'])
+      end
+      self
+    end
+
+    # List all NIC firewall rules
+    def list_firewall_rules
+      ProfitBricks::Firewall.list(self.datacenterId, self.serverId, self.id)
+    end
+
+    # Retrieve NIC firewall rule
+    def get_firewall_rule(fwrule_id)
+      ProfitBricks::Firewall.get(self.datacenterId, self.serverId, self.id, fwrule_id)
+    end
+
+    # Create NIC firewall rule
+    def create_firewall_rule(options = {})
+      ProfitBricks::Firewall.create(self.datacenterId, self.serverId, self.id, options)
+    end 
+
+    alias_method :list_fwrules, :list_firewall_rules
+    alias_method :fwrules, :list_firewall_rules
+    alias_method :get_fwrule, :get_firewall_rule
+    alias_method :fwrule, :get_firewall_rule
+    alias_method :create_fwrule, :create_firewall_rule
+
+    class << self
+
+      # Create a new NIC.
+      def create(datacenter_id, server_id, options = {})
+        response = ProfitBricks.request(
+          method: :post,
+          path: "/datacenters/#{datacenter_id}/servers/#{server_id}/nics",
+          expects: 202,
+          body: { properties: options }.to_json
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # List all NICs assigned to a server.
+      def list(datacenter_id, server_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/datacenters/#{datacenter_id}/servers/#{server_id}/nics",
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+
+      # Retrieve a NIC assigned to a datacenter.
+      def get(datacenter_id, server_id, nic_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/datacenters/#{datacenter_id}/servers/#{server_id}/nics/#{nic_id}",
+          expects: 200
+        )
+        add_parent_identities(response)
+        instantiate_objects(response)
+      end
+    end
+  end
+end

data/lib/profitbricks/profitbricks.rb

@@ -0,0 +1,137 @@
+# ProfitBricks SDK Ruby module
+module ProfitBricks
+  def self.configure(&block)
+    # Configuration variable defaults
+    ProfitBricks::Config.timeout = 60
+    ProfitBricks::Config.interval = 5
+    ProfitBricks::Config.global_classes = true
+    ProfitBricks::Config.debug = false
+    ProfitBricks::Config.protocol = 'https'
+    ProfitBricks::Config.port = '443'
+    ProfitBricks::Config.path_prefix = '/rest/'
+    yield ProfitBricks::Config
+
+    if ProfitBricks::Config.host
+      url = construct_url
+    else
+      url = ProfitBricks::Config.url || 'https://api.profitbricks.com/rest/'
+    end
+
+    params = {
+      user: ProfitBricks::Config.username,
+      password: ProfitBricks::Config.password,
+      debug: ProfitBricks::Config.debug,
+      omit_default_port: true,
+      query: { depth: 1 }
+    }
+
+    @client = Excon.new(url, params)
+    @client
+
+    ProfitBricks.client = @client
+
+    # Flatten module namespace.
+    if ProfitBricks::Config.global_classes
+      ProfitBricks.constants.select {
+        |c| Class === ProfitBricks.const_get(c)
+      }.each do |klass|
+        next if klass == :Config
+        unless Kernel.const_defined?(klass)
+          Kernel.const_set(klass, ProfitBricks.const_get(klass))
+        end
+      end
+    end
+  end
+
+  private
+
+  def self.request(params)
+    begin
+      params = add_headers(params)
+      response = ProfitBricks.client.request(prepend_path_prefix(params))
+    rescue Excon::Errors::Unauthorized => error
+      raise error, parse_json(error.response.body)['messages']
+    rescue Excon::Errors::HTTPStatusError => error
+      raise error, parse_json(error.response.body)['messages']
+    rescue Excon::Errors::InternalServerError => error
+      raise error, parse_json(error.response.body)['messages']
+    end
+    add_request_id(response)
+  end
+
+  def self.client=(client)
+    @client = client
+  end
+
+  def self.client
+    @client
+  end
+
+  def self.add_request_id(response)
+    location ||= response.headers['Location']
+    request_id ||= URI(location).path.split('/')[3] unless location.nil?
+    body = parse_json(response.body)
+
+    if body.nil?
+      body = { requestId: request_id }
+    else
+      body['requestId'] = request_id
+    end
+    body
+  end
+
+  def self.parse_json(body)
+    JSON.parse(body) unless body.nil? || body.empty?
+  rescue JSON::ParserError => error
+    raise error
+  end
+
+  def self.add_headers(params)
+    params[:headers] ||= {}
+    params[:headers].merge!(ProfitBricks::Config.headers) if ProfitBricks::Config.headers
+    unless params[:headers].key?('Content-Type')
+      params[:headers]['Content-Type'] = content_type(params[:method])
+    end
+    params
+  end
+
+  def self.content_type(method)
+    if method == :patch
+      'application/vnd.profitbricks.partial-properties+json'
+    else
+      'application/vnd.profitbricks.resource+json'
+    end
+  end
+
+  def self.prepend_path_prefix(params)
+    return params unless ProfitBricks::Config.path_prefix
+
+    path_prefix = ProfitBricks::Config.path_prefix.sub(/\/$/, '')
+    params[:path] = params[:path].sub(/^\//, '')
+    params[:path] = "#{path_prefix}/#{params[:path]}"
+    params
+  end
+
+  def self.construct_url
+    "#{ProfitBricks::Config.protocol}://" \
+    "#{ProfitBricks::Config.host}:" \
+    "#{ProfitBricks::Config.port}" \
+    "#{ProfitBricks::Config.path_prefix}"
+  end
+
+  def self.get_class(name, options = {})
+    klass = name.camelcase
+    klass = options[:class_name].to_s.camelcase if options[:class_name]
+    if ProfitBricks.const_defined?(klass)
+      klass = ProfitBricks.const_get(klass)
+    else
+      begin
+        require "profitbricks/#{klass.downcase}"
+        klass = ProfitBricks.const_get(klass)
+      rescue LoadError
+        raise LoadError.new("Invalid association, could not locate the class '#{klass}'")
+      end
+    end
+    klass
+  end
+end

data/lib/profitbricks/request.rb

@@ -0,0 +1,36 @@
+module ProfitBricks
+  # Request class
+  class Request < ProfitBricks::Model
+    # Retrieve status of a request.
+    def status
+      response = ProfitBricks.request(
+        method: :get,
+        path: "/requests/#{self.id}/status",
+        expects: 200
+      )
+      self.class.instantiate_objects(response)
+    end
+
+    class << self
+      # List all requests.
+      def list
+        response = ProfitBricks.request(
+          method: :get,
+          path: '/requests',
+          expects: 200
+        )
+        instantiate_objects(response)
+      end
+
+      # Retrieve a request.
+      def get(request_id)
+        response = ProfitBricks.request(
+          method: :get,
+          path: "/requests/#{request_id}",
+          expects: 200
+        )
+        instantiate_objects(response)
+      end
+    end
+  end
+end