abiquo 0.1.0

data/README

@@ -0,0 +1,39 @@
+=Abiquo API Ruby client
+
+Rest client to work with the Abiquo's API.
+
+==Installation
+
+gem install abiquo
+
+==Usage
+
+The first version of the api just uses basic authentication, so we need to create an instance with our credentials:
+
+  auth = Abiquo::Auth('Abiquo', 'username', 'password')
+
+The entry point for the Abiquo's API is an atom document service:
+
+  api = Abiquo::Resource('http://abiquo.example.com/api', auth)
+
+from this point we can access to every resource exposed by the api calling nested methods:
+
+  datacenters = api.datacenters
+  racks = api.datacenters.first.racks
+
+or get the values of their elements:
+
+  datacenter = api.datacenters.first
+  datacenter.name  # => The name of the datacenter
+
+You can find further example into the specs:
+
+  http://github.com/abiquo/api_ruby_client/tree/master/spec/acceptance
+
+Further documentation of the API can be found in our wiki:
+
+  http://abicloud.org/display/ABI16/Abiquo's+API
+
+==Copyright
+
+Copyright (c) 2010 Abiquo Holdings. See LICENSE for details.

data/lib/abiquo.rb

@@ -0,0 +1,179 @@
+require 'resourceful'
+require 'nokogiri'
+require 'active_support'
+require File.expand_path('../core_ext', __FILE__)
+require File.expand_path('../to_xml', __FILE__)
+require 'uri'
+
+module Abiquo
+  
+  class BasicAuth < Resourceful::BasicAuthenticator
+    def can_handle?(request); true; end
+
+  end
+  
+  module HttpAccessor
+    
+    def xml
+      @xml ||= begin
+        response = http.resource(url_with_params).get
+        Nokogiri.parse(response.body).root
+      end
+    end
+    
+    private
+    
+    def url_with_params
+      @options[:expand] = @options[:expand].join(",") if @options[:expand].is_a?(Array)
+      params = @options.map { |k, v| "#{k}=#{v}" }.join("&")
+      params = "?#{params}" unless params.empty?
+      @url + params
+    end
+    
+    def http
+      Resourceful::HttpAccessor.new(:authenticator => @auth)
+    end
+    
+  end
+  
+  class SingleResource
+    
+    include HttpAccessor
+    
+    undef id
+    
+    def initialize(url, auth, xml = nil, options = {})
+      @url = url
+      @auth = auth
+      @xml = xml
+      @options = options
+    end
+    
+    def update(attrs = {})
+      response = http.resource(url).put(attrs.to_xml(:root => object_type), :content_type => "application/xml")
+      @xml = Nokogiri.parse(response.body).root
+    end
+    
+    def delete
+      http.resource(url).delete
+    end
+    
+    def url
+      @url ||= xml.at_xpath("./link[@rel='edit']").try(:[], "href")
+    end
+    
+    delegate :to_xml, :to => :xml
+    alias_method :inspect, :to_xml
+    
+    private
+    
+    def object_type
+      @object_type ||= URI.parse(url).path.split("/")[-2].singularize
+    end
+    
+    def method_missing(meth, *args, &blk)
+      attribute = xml.at_xpath("./*[name()='#{meth}' or name()='#{attribute_name(meth)}']")
+      return node_text(attribute) if attribute
+      
+      link = xml.at_xpath("./link[@rel='#{meth}' or @rel='#{attribute_name(meth)}']")
+      return Resource.new(link["href"], @auth, link.at_xpath("./*"), *args) if link
+
+      if xml.namespaces.has_key?('xmlns:ns2')
+        @xml = Nokogiri.parse(xml.to_s.downcase).root
+        link = xml.at_xpath("//ns2:collection/xmlns:title[. = '#{meth}']").try(:parent)
+        return Resource.new(link['href'], @auth, nil, *args) if link
+      end
+      
+      super
+    end
+    
+    def node_text(node)
+      node.text
+    end
+    
+    def attribute_name(attribute)
+      attribute.to_s.gsub('_', '-')
+    end
+    
+  end
+  
+  class ResourceCollection
+    
+    include HttpAccessor
+    
+    delegate :inspect, :to => :resources
+    
+    def initialize(url, auth, xml = nil, options = {})
+      @url = url
+      @auth = auth
+      @xml = xml if options.empty?
+      @options = options
+    end
+    
+    def create(attrs = {})
+      response = http.resource(url_with_params).post(attrs.to_xml(:root => object_type, :convert_links => true), :content_type => "application/xml")
+      Resource.new(nil, @auth, Nokogiri.parse(response.body).root)
+    end
+    
+    private
+    
+    def object_type
+      @object_type ||= URI.parse(@url).path.split("/").last.singularize
+    end
+    
+    def resources
+      @resources ||= xml.xpath("./*").map { |subnode| Resource.new(subnode.at_xpath("./link[@rel='edit']").try(:[], "href"), @auth, subnode, @options) }
+    end
+    
+    def method_missing(meth, *args, &blk)
+      resources.send(meth, *args, &blk)
+    end
+  end
+  
+  class Resource
+    
+    include HttpAccessor
+    
+    undef id
+    
+    delegate :inspect, :to => :get!
+    
+    def self.from_xml(xml, auth = nil)
+      new(nil, auth, Nokogiri.parse(xml).root)
+    end
+    
+    def initialize(url, auth, xml = nil, options = {})
+      @url = url
+      @auth = auth
+      @xml = xml
+      @options = options
+    end
+    
+    def method_missing(meth, *args, &blk)
+      @resource_object ||= resource_class(meth).new(@url, @auth, @xml, @options)
+      @resource_object.send(meth, *args, &blk)
+    end
+    
+    def resource_class(meth)
+      @resource_class ||= if (Array.instance_methods + ["create"] - ["delete", "id"]).include?(meth.to_s)
+        ResourceCollection
+      else
+        SingleResource
+      end
+    end
+    
+    def get!
+      klass = SingleResource
+      if (!xml.children.empty? && xml.name.singularize == xml.children.first.name)
+        klass = ResourceCollection
+      end
+      @resource_object = klass.new(@url, @auth, @xml, @options)
+    end
+        
+  end
+  
+  def self.Resource(url, auth, params = {})
+    Resource.new(url, auth, nil, params)
+  end
+  
+end

data/lib/core_ext.rb

@@ -0,0 +1,10 @@
+module Resourceful
+  class Resource
+    def host_with_port
+      add = Addressable::URI.parse(uri)
+      !add.port.blank? && add.port != 80 ? [add.host, add.port].join(':') : add.host
+    end
+
+    alias_method_chain :host, :port
+  end
+end

data/lib/to_xml.rb

@@ -0,0 +1,22 @@
+module Abiquo
+  
+  module ToXml
+    
+    def to_xml_with_links(options = {})
+      if options[:convert_links] && options[:builder]
+        options[:builder].tag!(:link, :rel => options[:root]) do
+          to_xml_without_links(options)
+        end
+      else
+        to_xml_without_links(options)
+      end
+    end
+    
+  end
+  
+end
+
+class Array
+  include Abiquo::ToXml
+  alias_method_chain :to_xml, :links
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification 
+name: abiquo
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Abiquo
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-28 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: resourceful
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: steak
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
+description: 
+email: support@abiquo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- lib/to_xml.rb
+- lib/core_ext.rb
+- lib/abiquo.rb
+- README
+has_rdoc: true
+homepage: http://wiki.github.com/abiquo/abiquo/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Abiquo API client
+test_files: []
+