metamolecular-chemcaster-ruby 0.1.2

data/README.rdoc

@@ -0,0 +1,35 @@
+= Chemcaster Ruby API
+
+This is the Ruby interface for the Chemcaster[http://chemcaster.com] RESTful Web
+API. It consists of basic functionality needed to create
+applications using chemical structure registration, storage, imaging, and
+search.
+
+== Example Use
+
+=== Connecting to the Service
+
+   require 'lib/chemcaster'
+   include Chemcaster
+
+   service = Service.connect 'username', 'password'
+
+=== Loading a Registry
+
+   require 'lib/chemcaster'
+   include Chemcaster
+
+   service = Service.connect 'username', 'password'
+   registries = service.registries
+   registries.size # => 3
+   registry = registries[0]
+
+=== Creating a Registry
+
+   require 'lib/chemcaster'
+   include Chemcaster
+
+   service = Service.connect 'username', 'password'
+   registries = service.registries
+
+   registries.create :name => 'CarboBlocks, Inc.'

data/Rakefile

@@ -0,0 +1,8 @@
+require 'rubygems'
+require 'rake'
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end

data/lib/chemcaster.rb

@@ -0,0 +1,15 @@
+require File.dirname(__FILE__) + "/chemcaster/service"
+require File.dirname(__FILE__) + '/chemcaster/service'
+require File.dirname(__FILE__) + '/chemcaster/registry'
+require File.dirname(__FILE__) + '/chemcaster/structure'
+require File.dirname(__FILE__) + '/chemcaster/query'
+require File.dirname(__FILE__) + '/chemcaster/image'
+require File.dirname(__FILE__) + '/chemcaster/link'
+require File.dirname(__FILE__) + '/chemcaster/index'
+require File.dirname(__FILE__) + '/chemcaster/item'
+require File.dirname(__FILE__) + '/chemcaster/representation'
+require File.dirname(__FILE__) + '/chemcaster/media_type'
+require File.dirname(__FILE__) + '/chemcaster/error'
+
+require 'rubygems'
+require 'json'

data/lib/chemcaster/error.rb

@@ -0,0 +1,36 @@
+module Chemcaster
+  class Error < RuntimeError; end
+  class LinkNotDefined < Error; end
+  class HTTPError < Error
+    attr_accessor :response
+    def initialize response
+      @response = response
+    end
+    
+    def to_s
+      "received response code #{@response.code} with message:\n\n#{parse_errors}"
+    end
+    
+    protected
+    
+    def parse_errors
+      errors = nil
+      message = ""
+      begin
+        errors = JSON.parse response.body
+      rescue
+        return response.body
+      end
+      
+      errors.each do |error|
+        if error['field']
+          message << "- field '#{error['field']}' #{error['text']}\n"
+        else
+          message << "- #{error['text']}\n"
+        end
+      end
+      
+      message
+    end
+  end
+end

data/lib/chemcaster/image.rb

@@ -0,0 +1,6 @@
+module Chemcaster
+  class Image < Item
+    attributes :width, :height, :data
+    resources :imageable
+  end
+end

data/lib/chemcaster/index.rb

@@ -0,0 +1,31 @@
+require File.dirname(__FILE__) + '/../chemcaster/representation'
+
+module Chemcaster
+  class Index < Representation
+    attr_accessor :item_links#, :items
+    resources :parent
+    
+    def create representation_attributes
+      @create_link.post representation_attributes
+    end
+    
+    def size
+      @item_links.size
+    end
+    
+    def [](index)
+      @item_links[index].get
+    end
+    
+    protected
+    
+    def load_hash atts
+      super
+
+      @create_link = Link.new atts['create']
+      @item_links = atts['items'].inject([]) do |result, atts|
+        result << Link.new(atts)
+      end
+    end
+  end
+end

data/lib/chemcaster/item.rb

@@ -0,0 +1,24 @@
+require File.dirname(__FILE__) + '/../chemcaster/representation'
+
+module Chemcaster
+  class Item < Representation
+    resources :index
+    
+    def update representation_attributes
+      @update_link.put representation_attributes
+    end
+    
+    def destroy
+      @destroy_link.delete
+    end
+    
+    protected
+    
+    def load_hash atts
+      super
+      
+      @update_link = Link.new atts['update']
+      @destroy_link = Link.new atts['destroy']
+    end
+  end
+end

data/lib/chemcaster/link.rb

@@ -0,0 +1,89 @@
+require 'net/http'
+require 'net/https'
+
+module Chemcaster  
+  class Link
+    def initialize atts=nil
+      if atts
+        @uri = URI.parse(atts['uri']) if atts['uri']
+        @media_type = atts['media_type']
+        @media_class = MediaType.representation(@media_type) if @media_type
+      end
+    end
+    
+    def get
+      do_http 'get'
+    end
+    
+    def put attributes
+      do_http 'put', attributes
+    end
+
+    def post attributes
+      do_http 'post', attributes
+    end
+    
+    def delete
+      do_http 'delete'
+    end
+    
+    private
+    
+    def do_http method, representation=nil
+      validate
+      request = request_for_method method, representation
+      response = send_request request
+
+      raise(HTTPError, response) unless response.code.to_i < 300
+      @media_class.new self, decode(response.body)
+    end
+    
+    def send_request request
+      http = Net::HTTP.new(@uri.host, @uri.port)
+      http.use_ssl = (@uri.scheme == 'https')
+      
+      if File.exists? Service.root_ca
+        http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+        http.ca_path = Service.root_ca
+      else
+        message =
+          "net/http couldn't locate this system's root SSL certificate files."+
+          "On Debian Linux systems, these files are located at /etc/ssl/certs "+
+          "(this library's default). For more information, see:\n\n"+
+          "http://codeidol.com/other/rubyckbk/Internet-Services/Making-an-HTTPS-Web-Request\n"+
+          "http://redcorundum.blogspot.com/2008/03/ssl-certificates-and-nethttps.html\n"+
+          "http://notetoself.vrensk.com/2008/09/verified-https-in-ruby\n"
+        raise(message)
+      end
+      
+      http.request(request)
+    end
+    
+    def request_for_method method, attributes=nil
+      request = case method
+      when "get" then Net::HTTP::Get.new(@uri.path)
+      when "put" then Net::HTTP::Put.new(@uri.path)
+      when "post" then Net::HTTP::Post.new(@uri.path)
+      when "delete" then Net::HTTP::Delete.new(@uri.path)
+      end
+      
+      request['accept'] = @media_type
+      request.basic_auth Service.username, Service.password
+      
+      if attributes
+        request.body = {MediaType.hash_key(@media_type) => attributes}.to_json
+        request.content_type = @media_type
+      end
+      
+      request
+    end
+    
+    def validate
+      raise LinkNotDefined unless @uri && @media_class
+    end
+    
+    def decode response
+      JSON.parse response
+    end
+  end
+end

data/lib/chemcaster/media_type.rb

@@ -0,0 +1,27 @@
+module Chemcaster
+  class MediaType  
+    def self.representation name
+      name.match(/application\/vnd\.com\.chemcaster\.(.*)\+json/)
+      raise "No such media type: #{name}" unless klass = $1
+      
+      begin
+        Object.const_get(klass)
+      rescue
+        raise "No such class: #{klass}"
+      end
+    end
+    
+    def self.hash_key full_mime_type_name
+      full_mime_type_name.match(/application\/vnd\.com\.chemcaster\.(.*)\+json/)
+      raise "No such media type: #{full_mime_type_name}" unless key = $1
+      
+      begin
+        Object.const_get(key)
+      rescue
+        raise "No such class: #{key}"
+      end
+      
+      key.downcase
+    end
+  end
+end

data/lib/chemcaster/query.rb

@@ -0,0 +1,6 @@
+module Chemcaster
+  class Query < Item
+    attributes :molfile
+    resources :images, :registry
+  end
+end

data/lib/chemcaster/registry.rb

@@ -0,0 +1,8 @@
+require File.dirname(__FILE__) + '/../chemcaster/item'
+
+module Chemcaster
+  class Registry < Item
+    attributes :name, :deletable
+    resources :queries, :structures
+  end
+end

data/lib/chemcaster/representation.rb

@@ -0,0 +1,66 @@
+module Chemcaster
+  class Representation
+    # class instance variables - see: http://martinfowler.com/bliki/ClassInstanceVariable.html
+    class << self; attr_accessor :resource_ids; end
+    class << self; attr_accessor :attribute_ids; end
+
+    attr_accessor :attributes
+    attr_accessor :link
+    
+    def initialize link, raw
+      @link = link
+      @attributes = {}
+      load_hash raw
+    end
+    
+    def self.attributes *atts
+      self.attribute_ids ||= []
+      atts.each do |m|
+        self.attribute_ids << m.to_s
+        define_method(m) do
+          attributes[m.to_s]
+        end        
+
+        define_method("#{m}=") do |val|
+          attributes.merge!({m.to_s => val})
+        end
+      end
+    end
+    
+    def self.resources *res
+      self.resource_ids ||= self.superclass.resource_ids || []
+      res.each do |id|
+        self.resource_ids << id
+        define_method(id) do  
+          instance_variable_get("@#{id}_link").send('get')
+        end
+      end
+    end
+    
+    def to_json
+      JSON({attributes_name => @attributes})
+    end
+    
+    def attributes_name
+      self.class.to_s.gsub(/Chemcaster::/, '').downcase
+    end
+    
+    protected
+    
+    def load_hash hash
+      self.class.attribute_ids ||= []
+      if hash[name = attributes_name]
+        hash[name].each do |attribute|
+          if self.class.attribute_ids.member? attribute[0]
+            attributes[attribute[0]] = attribute[1]
+          end
+        end
+      end
+
+      self.class.resource_ids ||= []
+      self.class.resource_ids.each do |resource_id|
+        instance_variable_set("@#{resource_id}_link".to_sym, Link.new(hash[resource_id.to_s]))
+      end
+    end
+  end
+end

data/lib/chemcaster/service.rb

@@ -0,0 +1,41 @@
+require File.dirname(__FILE__) + '/../chemcaster/representation'
+
+module Chemcaster
+  class Service < Representation
+    attr_accessor :registries_link
+    
+    # Ruby SSL needs to be told the location of the system's SSL CA files.
+    # On Debian Linux systems, these files are located at /etc/ssl/certs,
+    # which is this library's default. For more information, see:
+    # 
+    # http://codeidol.com/other/rubyckbk/Internet-Services/Making-an-HTTPS-Web-Request
+    # http://redcorundum.blogspot.com/2008/03/ssl-certificates-and-nethttps.html
+    # http://notetoself.vrensk.com/2008/09/verified-https-in-ruby
+    
+    @@root_ca = nil; def self.root_ca; @@root_ca; end
+    @@username = nil; def self.username; @@username; end
+    @@password = nil; def self.password; @@password; end
+    
+    def self.connect username, password, options = {}
+      @@username = username; @@password = password
+      
+      @@root_ca = options[:root_ca] || '/etc/ssl/certs'
+      uri = options[:uri] || 'https://chemcaster.com/rest'
+      
+      service_link = Link.new 'uri' => uri,
+        'media_type' => 'application/vnd.com.chemcaster.Service+json', 'name' => 'root'
+      service_link.get
+    end
+    
+    def registries
+      @registries_link.get
+    end
+    
+    protected
+    
+    def load_hash hash
+      super
+      @registries_link = Link.new hash['registries']
+    end
+  end
+end

data/lib/chemcaster/structure.rb

@@ -0,0 +1,6 @@
+module Chemcaster
+  class Structure < Item
+    attributes :name, :molfile
+    resources :images, :registry
+  end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: metamolecular-chemcaster-ruby
+version: !ruby/object:Gem::Version 
+  version: 0.1.2
+platform: ruby
+authors: 
+- Richard Apodaca
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-08-17 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json_pure
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A hypertext-driven Ruby client for the Chemcaster cheminformatics Web services platform.
+email: info@metamolecular.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- Rakefile
+- lib/chemcaster.rb
+- lib/chemcaster/error.rb
+- lib/chemcaster/image.rb
+- lib/chemcaster/index.rb
+- lib/chemcaster/item.rb
+- lib/chemcaster/link.rb
+- lib/chemcaster/media_type.rb
+- lib/chemcaster/query.rb
+- lib/chemcaster/registry.rb
+- lib/chemcaster/representation.rb
+- lib/chemcaster/service.rb
+- lib/chemcaster/structure.rb
+has_rdoc: false
+homepage: http://chemcaster.com
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A hypertext-driven Ruby client for the Chemcaster cheminformatics Web services platform. End.
+test_files: []
+