astroboa-rb 0.4.0

data/COPYING.LESSER

@@ -0,0 +1,166 @@
+		   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions. 
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version. 
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
+

data/Gemfile

@@ -0,0 +1,4 @@
+# encoding: utf-8
+source :rubygems
+
+gemspec

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (C) 2005-2012 BetaCONCEPT LP.
+
+Astroboa Ruby Client is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+Astroboa Ruby Client is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE or NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+The included files named COPYING and COPYING.LESSER contain the full text 
+of the GNU and the GNU Lesser General Public License respectively. 
+Please read them in order to know the full details of Astroboa Ruby Client License Terms.

data/README.md

@@ -0,0 +1,122 @@
+# astroboa-rb
+
+While you can directly use the REST-based "Astroboa Resource API" from your Ruby projects 
+using the net/http library or any one of the rest client libraries, Astroboa Ruby Client greatly eases your work.
+
+The Ruby client allows you to read, write and search content in any local or remote astroboa repository with just a few lines of code.
+
+## Install
+
+=== For your project using bundler
+
+Add to your Gemfile:
+
+  gem "astroboa-rb"
+
+and run at the command prompt:
+
+  bundle install
+
+=== or as a gem in your ruby environment
+
+Run at the command prompt:
+
+gem install astroboa-rb
+ 
+
+Below are some examples on how to use the client
+
+## EXAMPLE USE
+
+	# encoding: utf-8
+	require 'astroboa-rb'
+	
+	# CONNECT TO THE REPOSITORY
+	# provide the server where astroboa runs and the repository to connect to
+	astroboaClient = Astroboa::Client.new('demo.betaconcept.com', 'demorepository')
+
+	astroboaClient.on_error do |exception|
+  		puts exception.message
+	end
+
+	# CREATE A NEW OBJECT
+	# createObject(objectHash, &exception_block)
+	# The example uses the 'out of the box' object type:'genericContentResourceObject'
+	# This type simulates a simple article or blog entry with "title", "description", "subject"(tags) and "body"(the body text) properties
+	# The "title", "description" and "subject" properties are stored inside the "group property" called "profile".
+	# "profile" is a default property inherited to all asstroboa objects and groups all dublin core metadata    
+	my_new_text_resource = {"contentObjectTypeName" => "genericContentResourceObject", "profile" => {"title" => "My First blog entry", "description" => "How I installed astroboa"}, "body" => 'Go to github and check the installation instructions...'}
+	my_new_text_resource_id = astroboaClient.createObject my_new_text_resource
+	puts "created object with id: #{my_new_text_resource_id}" 
+	
+	# GET AN OBJECT AS A RUBY HASH
+	# getObject(idOrName, options = {}, &exception_block)
+	options = {}
+	options[:project] = 'profile.title,body' # project/filter which properties to get back
+	options[:output] = 'hash' # in which form to get back the object, possible values are "hash","object","xml","json", default is "hash"
+	retrieved_text_resource = astroboaClient.getObject my_new_text_resource_id, options
+	puts "The retrieved resource is: #{retrieved_text_resource}"
+	puts retrieved_text_resource['profile']['title']
+
+	# GET AN OBJECT AS A RUBY OBJECT
+	retrieved_text_resource = astroboaClient.getObject my_new_text_resource_id, output: 'object'  
+	puts "I retrieved the resource as object and the title is: #{retrieved_text_resource.profile.title}"
+	puts "The retrieved resource is: #{retrieved_text_resource}"
+
+	# UPDATE AN EXISTING OBJECT
+	# updateObject(objectHash, updateLastModificationTime = true, &exception_block)
+	resource = {"contentObjectTypeName" => "genericContentResourceObject", "cmsIdentifier" => my_new_text_resource_id, "body" => "Updated Body Text...."}
+	response = astroboaClient.updateObject resource
+	puts "I updated the object and the response is: #{response}"
+
+	# GET THE UPDATED OBJECT BACK
+	text_resource = astroboaClient.getObject my_new_text_resource_id
+	puts "I will read the updated resource back and the updated body is #{text_resource['body']}"
+
+	# SEARCH AN OBJECT COLLECTION
+	# getObjectCollection(query = nil, options = {}, &exception_block)
+	options = {}
+	
+	# project/filter which properties to get back, here we get back only the object titles
+	options[:project] = 'profile.title' 
+	
+	# get objects counting from 'offset' and up. Default is 0. Use it together with limit for result paging
+	options[:offset] = 0 
+	
+	# how many object to get back. Default is 50
+	options[:limit] = 50 
+	
+	# by which property to order the results. 
+	# Use 'desc or asc after the field to ask for ascenting or descenting ordering'.
+	# use commas to add more ordering fields, eg. 'profile.modified desc, profile.title asc'
+	# Default is 'profile.modified desc'
+	options[:orderBy] = 'profile.modified desc'  
+	
+	# in which form to get back the object, possible values are "hash","object","xml","json", default is "hash"
+	options[:output] = 'hash'
+	
+	# Express the query in a similar way you specify the WHERE in SQL queries.
+	# Values should be ALWAYS inside double quotes ("")
+	query = 'objectType="genericContentResourceObject" AND body CONTAINS "Hello"'
+	resource_collection = astroboaClient.getObjectCollection query, options
+
+	text_resources = resource_collection['resourceCollection']['resource']
+	found_id = nil
+	puts "Looking for resource #{my_new_text_resource_id}"
+	text_resources.each do |text_resource|
+  		puts text_resource['cmsIdentifier']
+  		if text_resource['cmsIdentifier'] == my_new_text_resource_id
+    		found_id = text_resource['cmsIdentifier']
+    		break
+  		end 
+	end
+	puts "found #{found_id}"
+
+
+# LICENSE
+-------
+Released under the LGPL license; see the files LICENSE, COPYING and COPYING.LESSER.
+
+
+   
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/astroboa-rb.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "astroboa-rb/version"
+
+Gem::Specification.new do |s|
+  s.name = "astroboa-rb"
+  s.version = Astroboa::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.authors = ["BetaCONCEPT","Gregory Chomatas"]
+  s.email = ["support@betaconcept.com"]
+  s.homepage = "http://www.astroboa.org"
+  s.date = Date.today.to_s
+  s.summary = %q{Astroboa Client for Ruby.}
+  s.description = %q{Provides easy access to the REST-based 'Astroboa Resource API'. With just a few lines of code you can read, write and search semi-structured content to any astroboa repository hosted in any server in the world.}
+
+  s.rubyforge_project = "astroboa-rb"
+
+  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_runtime_dependency 'rest-client','>= 1.6'
+  s.add_runtime_dependency 'json','>= 1.6'
+  s.add_development_dependency 'cucumber','~> 1.1'
+  s.add_development_dependency 'rspec-expectations','~> 2.8'
+end

data/lib/astroboa-rb.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+module Astroboa; end
+
+require 'astroboa-rb/client'
+require 'astroboa-rb/clienterror'

data/lib/astroboa-rb/client.rb

@@ -0,0 +1,362 @@
+# encoding: utf-8
+
+require 'logger'
+require 'rest-client'
+require 'json'
+require 'ostruct'
+
+
+module Astroboa
+  
+  class Client
+  
+    def self.version
+      Astroboa::VERSION
+    end
+    
+    # get and set options for the JSON parser
+    # by default the nesting level is raised from 20 to 50
+    attr_accessor :json_options
+    
+    attr_reader :repository, :astroboaIPAddressOrFQDN, :username
+    attr_reader :resourceApiBasePath, :objectsApiPath, :taxonomiesApiPath, :topicsApiPath, :modelsApiPath
+    attr_reader :objectsResource, :taxonomiesResource, :topicsResource, :modelsResource
+  
+    def initialize(astroboaIPAddressOrFQDN, repository, username = nil , password = nil)
+      # the IP or Fully Qualified Domain Name of the server that provides the astroboa data services 
+      @astroboaIPAddressOrFQDN = astroboaIPAddressOrFQDN
+      
+      # the id of the repository from which we want to read or write resources (multiple repositories can be served by each astroboa server)
+      @repository = repository
+      
+      @username = username
+      @password = password
+      
+      @resourceApiBasePath = "http://#{astroboaIPAddressOrFQDN}/resource-api"
+      
+      # this resource is about all repositories and does not require a repository to be specified
+      @repositoriesResource = RestClient::Resource.new(@resourceApiBasePath, {:user => username, :password => password, :headers => astroboa_client_headers})
+      
+      # all other resources require a repository to be specified
+      create_repository_resources(repository)
+
+      @log = Logger.new('/tmp/astroboa-rb-log.txt')
+      @log.level = Logger::WARN
+    
+      RestClient.log = @log
+      
+      # some json payloads have very deep nesting and the JSON parser option should be set to allow deeper nesting
+      # the default parser nesting is 20. We set it to 50 and the user may set it to a higher level through :json_options accessor
+      @json_options = {:max_nesting => 50}
+      
+    end
+    
+    # set the repository
+    def repository= (repository)
+      @repository = repository
+      
+      # each time a repository is set we regenerate the resource api calls to target the specified repository
+      create_repository_resources(repository)
+    end
+    
+    # set your own logger
+    def log= (logger)
+      @log = logger
+      RestClient.log = logger
+    end
+  
+    #
+    # API
+    #
+  
+    def getObject(idOrName, options = {}, &exception_block)
+      
+      if idOrName && !idOrName.empty?
+        begin
+          projectionPaths = options[:project]
+          output = options[:output] ||= :hash
+          
+          case output
+          when :json
+            acceptHeader = :json
+            outputParam = 'json'
+          when :xml
+            acceptHeader = :xml
+            outputParam = 'xml'
+          when :hash, :object
+            acceptHeader = :json
+            outputParam = 'json'
+          else
+            message = "Astroboa API cannot return resources as #{output}. Please see the documentation for available output options."
+            log.error message
+            handle_error(message, nil, &exception_block)
+          end
+        
+          response = nil
+          params = {'output' => outputParam}
+          if projectionPaths
+            params['projectionPaths'] = projectionPaths
+          end
+          
+          response = @objectsResource["#{idOrName}"].get :params => params, :accept => acceptHeader
+          
+          case output
+          when :json, :xml
+            return response.body
+          when :hash
+            return JSON response.body
+          when :object
+            objectHash = JSON.parse(response.body, @json_options)
+            return objectHash.to_openstruct
+          end 
+        rescue => api_exception
+          @log.error "Astroboa getObject call failed. Error is #{api_exception.inspect}. The requested object id (or name) was: #{idOrName}."
+          message = "Astroboa getObject call failed. The requested object id (or name) was: #{idOrName}."
+          handle_error(message, api_exception, &exception_block)
+        end
+      else
+        message = "You should specify the id or name of the object."
+        @log.error message
+        handle_error(message, nil, &exception_block)
+      end      	
+    end
+  
+  
+    def createObject(objectHash, &exception_block)
+      if !objectHash or objectHash.empty?
+         message = "You should specify an non empty hash of the object you want to create."
+          @log.error message
+          handle_error(message, nil, &exception_block)
+          return
+      end
+      
+      if objectHash.has_key?('cmsIdentifier')
+        message = "You have specified an object identifier. Object identifiers are automatically assigned by astroboato new objects. Please remove the identifier if this is a new object or use updateObject if it is an existing object."
+        @log.warn message
+        handle_error(message, nil, &exception_block)
+      else
+        begin
+          response = @objectsResource.post objectHash.to_json, :content_type => :json 
+          objectHash['cmsIdentifier'] = response.body.to_s
+          return response.body.to_s
+        rescue => api_exception
+          @log.error "Astroboa createObject call failed. Error is #{api_exception.inspect}. The object to be created was: #{objectHash}."
+          message = "Astroboa createObject call failed. The object to be created was: #{objectHash}."
+          handle_error(message, api_exception, &exception_block)
+        end 
+      end 	
+    end
+  
+  
+    def updateObject(objectHash, updateLastModificationTime = true, &exception_block)
+      if !objectHash or objectHash.empty?
+         message = "You should specify an non empty hash of the object you want to update."
+          @log.error message
+          handle_error(message, nil, &exception_block)
+          return
+      end
+      
+      if objectHash.has_key?('cmsIdentifier')
+        begin
+          response = @objectsResource["#{objectHash['cmsIdentifier']}"].put objectHash.to_json, :params => {'updateLastModificationTime' => updateLastModificationTime}, :content_type => :json 
+          return response.body.to_s
+        rescue => api_exception
+          @log.error "Astroboa updateObject call failed. Error is #{api_exception.inspect}. The object to be updated was: #{objectHash}."
+          message = "Astroboa updateObject call failed. The object to be updated was: #{objectHash}."
+          handle_error(message, api_exception, &exception_block)
+        end
+      else
+        message = "You try to update an object that does not have an identifier. If your object is new then use createObject to create a new object."
+        @log.error message
+        handle_error(message, nil, &exception_block)
+      end      	
+    end
+    
+    def getObjectCollection(query = nil, options = {}, &exception_block)
+      begin
+        projectionPaths = options[:project] 
+        offset = options[:offset] ||= 0 
+        limit = options[:limit] ||= 50 
+        orderBy = options[:orderBy] ||= 'profile.modified desc'
+        output = options[:output] ||= :hash
+        
+        case output
+        when :json
+          acceptHeader = :json
+          outputParam = 'json'
+        when :xml
+          acceptHeader = :xml
+          outputParam = 'xml'
+        when :hash, :object
+          acceptHeader = :json
+          outputParam = 'json'
+        else
+          message = "Astroboa API cannot return resources as #{output}. Please see the documentation for available output options."
+          log.error message
+          handle_error(message, nil, &exception_block)
+        end
+      
+        response = nil
+        params = {'output' => outputParam}
+      
+        if query
+          params['cmsQuery'] = query
+        end
+      
+        if projectionPaths
+          params['projectionPaths'] = projectionPaths
+        end
+      
+        params['offset'] = offset
+        params['limit'] = limit
+        params['orderBy'] = orderBy
+      
+        response = @objectsResource.get :params => params, :accept => acceptHeader
+
+        case output
+        when :json, :xml
+          return response.body
+        when :hash
+          return JSON.parse(response.body, @json_options)
+        when :object
+          objectHash = JSON.parse(response.body, @json_options)
+          return objectHash.to_openstruct
+        end 
+      rescue => api_exception
+        @log.error "Astroboa getObjectCollection call failed. Error is #{api_exception.inspect}. The requested collection query was: #{query}, with projection paths: #{projectionPaths}, offset: #{offset}, limit: #{limit}, orderBy: #{orderBy}."
+        message = "Astroboa getObjectCollection call failed. The requested collection query was: #{query}, with projection paths: #{projectionPaths}, offset: #{offset}, limit: #{limit}, orderBy: #{orderBy}."
+        handle_error(message, api_exception, &exception_block)
+      end
+    end
+    
+    def getModel(objectTypeOrProperty='', output = :hash, &exception_block)
+      begin
+        case output
+        when :json
+          acceptHeader = :json
+          outputParam = 'json'
+        when :xml
+          acceptHeader = :xml
+          outputParam = 'xml'
+        when :hash, :object
+          acceptHeader = :json
+          outputParam = 'json'
+        else
+          message = "Astroboa API cannot return resources as #{output}. Please see the documentation for available output options."
+          log.error message
+          handle_error(message, nil, &exception_block)
+        end
+      
+        response = nil
+        params = {'output' => outputParam}
+        
+        if objectTypeOrProperty && !objectTypeOrProperty.empty?
+          response = @modelsResource["#{objectTypeOrProperty}"].get :params => params, :accept => acceptHeader
+        else 
+          response = @modelsResource.get :params => params, :accept => acceptHeader
+        end
+        
+        case output
+        when :json, :xml
+          return response.body
+        when :hash
+          return JSON.parse(response.body, @json_options)
+        when :object
+          objectHash = JSON.parse(response.body, @json_options)
+          return objectHash.to_openstruct
+        end 
+      rescue => api_exception
+        @log.error "Astroboa getModel call failed. Error is #{api_exception.inspect}. The requested object type or object property was: #{objectTypeOrProperty}."
+        message = "Astroboa getModel call failed. The requested object type or property was: #{objectTypeOrProperty}."
+        handle_error(message, api_exception, &exception_block)
+      end
+    end
+    
+    def on_error(&block)
+        @error_callback = block
+    end
+  
+    #
+    # implementation
+    #
+  
+    def handle_error(message, api_exception, &exception_block)
+      if block_given?
+        astroboaClientError = createAstroboaClientException(message, api_exception)
+        exception_block.call(astroboaClientError)
+      elsif @error_callback
+        astroboaClientError = createAstroboaClientException(message, api_exception)
+        @error_callback.call(astroboaClientError)
+      end
+    
+      return nil
+    
+    end
+  
+    def createAstroboaClientException(message, api_exception)
+      api_code = 'There is no astroboa api return code. The api call was not send due to the error'
+      api_response = 'There is no astroboa api response. The api call was not send due to the error'
+      if api_exception 
+        message = "#{message} - Cause: #{api_exception.message}"
+        if api_exception.respond_to?(:http_code)
+          api_code = api_exception.http_code
+        end
+        if api_exception.respond_to?(:response)
+          api_response = api_exception.response ||= 'The astroboa api call did not produce any response'
+        end
+      end
+      Astroboa::ClientError.new(message, api_code, api_response)
+    end
+    
+    def astroboa_client_headers
+      if (defined? self.class.gem_version_string) 
+        gem_version = self.class.gem_version_string
+      else 
+       gem_version = nil
+      end
+       
+      {
+        'X-Astroboa-API-Version' => '3.0.0',
+        'User-Agent' => gem_version,
+        'X-Ruby-Version' => RUBY_VERSION,
+        'X-Ruby-Platform' => RUBY_PLATFORM
+      }
+    end
+  
+  
+      def create_repository_resources(repository)
+        @objectsApiPath = "#{@resourceApiBasePath}/#{repository}/objects"
+        @taxonomiesApiPath = "#{@resourceApiBasePath}/#{repository}/taxonomies"
+        @topicsApiPath = "#{@resourceApiBasePath}/#{repository}/topics"
+        @modelsApiPath = "#{@resourceApiBasePath}/#{repository}/models"
+
+        @objectsResource = RestClient::Resource.new(@objectsApiPath, {:user => @username, :password => @password, :headers => astroboa_client_headers})
+        @taxonomiesResource = RestClient::Resource.new(@taxonomiesApiPath, {:user => @username, :password => @password, :headers => astroboa_client_headers})
+        @topicsResource = RestClient::Resource.new(@topicsApiPath, {:user => @username, :password => @password, :headers => astroboa_client_headers})
+        @modelsResource = RestClient::Resource.new(@modelsApiPath, {:user => @username, :password => @password, :headers => astroboa_client_headers})
+      end
+  end # class Client
+
+end # Module Astroboa
+  
+  
+class Object
+  def to_openstruct
+    self
+  end
+end
+
+class Array
+  def to_openstruct
+    map{ |el| el.to_openstruct }
+  end
+end
+
+class Hash
+  def to_openstruct
+    mapped = {}
+    each{ |key,value| mapped[key] = value.to_openstruct }
+    OpenStruct.new(mapped)
+  end
+end
+