koha 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0

data/CHANGELOG

@@ -0,0 +1,3 @@
+## v0.0.1
+
+* Initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in koha.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 fitz
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+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.

data/README.md

@@ -0,0 +1,84 @@
+# Koha [![Build Status](https://travis-ci.org/cfitz/koha.png?branch=master)](https://travis-ci.org/cfitz/koha) [![Code Climate](https://codeclimate.com/github/cfitz/koha.png)](https://codeclimate.com/github/cfitz/koha)
+
+A simple ruby wrapper for the Koha ILS RESTFUL API. 
+
+### Prerequisites
+
+You must install the RESTFUL api code to your instance of Koha. This project can be found here =>
+http://git.biblibre.com/?p=koha-restful;a=summary
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'koha'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install koha
+
+## Usage
+
+Here a quick irb walk-through...
+
+> $ irb  
+
+> 1.9.3-p286 :001 > require 'koha'  
+  => true 
+
+Make a Connection...  
+
+  > 1.9.3-p286 :002 > k = Koha.connect({:url => "http://my.library.se/cgi-bin/koha/rest.pl"} )  
+  > => #<Koha::Client:0x007fbcec9b6fd0 @uri=#<URI::HTTP:0x007fbcec9c3a00 URL:http://my.library.se/cgi-bin/koha/rest.pl/>, @proxy=nil, @connection=#<Koha::Connection:0x007fbcec9b6ff8>, @options={:url=>"http://my.library.se/cgi-bin/koha/rest.pl"}>  
+
+now get branch information...  
+
+  > 1.9.3-p286 :003 > k.branches  
+  > => [ { "name"=>"World Maritime University Library", "code"=>"WMU"}, { "name"=>"ebrary", "code"=>"EBR" } ]   
+
+
+find a bibliographic record  
+  > 1.9.3-p286 :006 > k.find_biblio("17454")  
+  > => [{"withdrawn"=>"1", "biblioitemnumber"=>"17454", .......  
+
+check is an biblio is holdable.....  
+  > 1.9.3-p286 :009 >    k.biblio_holdable?("17454" )  
+  > => false  
+ 
+... for a specific user ...  
+  > 1.9.3-p286 :011 >  k.biblio_holdable?("17454", :borrowernumber => "544" )  
+  > => true  
+
+
+... by user name ...  
+  > 1.9.3-p286 :012 >  k.biblio_holdable?("17454", :borrowername => "cf" )  
+  > => true  
+ 
+get the user's holds.  
+  > 1.9.3-p286 :013 >  k.user_holds :borrowername => "cf"  
+  > => [{"itemnumber"=>nil, "branchname"=>"World Maritime University Library", "itemcallnumber"=>nil, "hold_id"=>nil, "reservedate"=>"2013-02-20", "barcode"=>nil, "found"=>nil, "biblionumber"=>"76356", "cancellationdate"=>nil, "title"=>"Asian approaches to international law and the legacy of colonialism and imperialism :", "rank"=>"1", "branchcode"=>"WMU"}]  
+
+or get the user's issues  
+ 
+  > 1.9.3-p286 :014 >  k.user_issues :borrowernumber => "544"   
+  > => [{"itemnumber"=>"42414", "itemcallnumber"=>"KD1819 .H54 2003", "barcode"=>"022593", "date_due"=>"2013-03-11T23:59:00", "renewable"=>true, "issuedate"=>"2012-11-21T00:00:00", "biblionumber"=>"17454", "title"=>"Maritime law", "borrowernumber"=>"544", "branchcode"=>"WMU"}]  
+
+
+
+### Development
+
+Checkout the code. rake will run the tests. rake coverage will generate coverage. rake yard will generate documentation. 
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+2.5 Write the code and add tests. 
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,21 @@
+require 'rake'
+require 'bundler/gem_tasks'
+
+require 'rubygems/package_task'
+ 
+task :environment do
+  require File.dirname(__FILE__) + '/lib/koha_client'
+end
+ 
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+task :default => ['spec:api']
+
+
+
+task :coverage do
+  # add simplecov
+  ENV["COVERAGE"] = 'yes'
+  # run the specs
+  Rake::Task['spec:api'].execute
+end

data/koha.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+require "koha"
+
+Gem::Specification.new do |s|
+  s.name        = "koha"
+  s.summary     = "A Ruby client for Koha ILSDI interface"
+  s.description = %q{Easy interface for the Koha ILSDI API (https://github.com/Koha-Community/Koha/blob/master/C4/ILSDI/Services.pm) }
+  s.version     = Koha.version
+  s.authors     = ["chris fitzpatrick"]
+  s.email       = ["chrisfitzpat@gmail.com"]
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {spec}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_development_dependency 'simplecov', '0.7.1'
+  s.add_development_dependency 'yard', '~> 0.8.4.1'
+  s.add_development_dependency 'webmock', '~> 1.9.3'
+  s.add_development_dependency 'rake', '~> 10.0.3'
+  s.add_development_dependency 'rdoc', '~> 3.9.5'
+  s.add_development_dependency 'rspec', '~> 2.6.0'
+  s.add_development_dependency 'redcarpet'
+end

data/lib/koha.rb

@@ -0,0 +1,20 @@
+$: << "#{File.dirname(__FILE__)}" unless $:.include? File.dirname(__FILE__)
+
+require 'rubygems'
+
+module Koha
+  
+  %W(Client Error Connection Uri Version).each{|n| autoload n.to_sym, "koha/#{n.downcase}"}
+  
+  def self.version; "0.0.1" end
+  
+  VERSION = self.version
+  
+  def self.connect *args
+    driver = Class === args[0] ? args[0] : Koha::Connection
+    opts = Hash === args[-1] ? args[-1] : {}
+    Client.new driver.new, opts
+  end
+  
+  
+end

data/lib/koha/client.rb

@@ -0,0 +1,210 @@
+require 'json'
+
+class Koha::Client
+  
+  attr_reader :connection, :uri, :proxy, :options
+  
+  def initialize connection, options = {}
+    @proxy = @uri = nil
+    @connection = connection
+    unless false === options[:url]
+      url = options[:url] ? options[:url].dup : 'http://localhost/cgi-bin/koha/rest.pl/'
+      url << "/" unless url[-1] == ?/
+      @uri = Koha::Uri.create url
+      if options[:proxy]
+        proxy_url = options[:proxy].dup
+        proxy_url << "/" unless proxy_url.nil? or proxy_url[-1] == ?/
+        @proxy = Koha::Uri.create proxy_url if proxy_url
+      end
+    end
+    @options = options
+  end
+   
+  # returns the uri proxy if present,
+  # otherwise just the uri object.
+  def base_uri
+    @proxy ? @proxy : @uri
+  end
+  
+  # Create the get, post, and head methods
+  %W(get post put).each do |meth|
+     class_eval <<-RUBY
+     def #{meth} path, opts = {}, &block
+       send_and_receive path, opts.merge(:method => :#{meth}), &block
+     end
+     RUBY
+   end
+ 
+  
+  # +send_and_receive+ is the main request method responsible for sending requests to the +connection+ object.
+  # 
+  # "path" : A string value that directs the client to the API REST method
+  # "opts" : A hash, which can contain the following keys:
+  #   :method : optional - the http method (:get, :post or :put)
+  #   :params : optional - the query string params in hash form
+  # All other options are passed right along to the connection's +send_and_receive+ method (:get, :post, or :put)
+  # 
+  #
+  # creates a request context hash,
+  # sends it to the connection's +execute+ method
+  # which returns a simple hash,
+  # then passes the request/response into +adapt_response+.
+  def send_and_receive path, opts
+    request_context = build_request path, opts
+    [:open_timeout, :read_timeout].each do |k|
+      request_context[k] = @options[k]
+    end
+    execute request_context
+  end
+  
+  # send a request to the connection to be submitted
+  def execute request_context
+    raw_response = connection.execute self, request_context
+    adapt_response(request_context, raw_response) unless raw_response.nil?
+  end
+  
+  # +build_request+ accepts a path and options hash,
+  # then prepares a normalized hash to return for sending
+  # +build_request+ sets up the uri/query string
+  # and converts the +data+ arg to form-urlencoded,
+  # returns a hash with the following keys:
+  #   :method
+  #   :params
+  #   :uri
+  #   :path
+  #   :query
+  
+  def build_request path, opts
+    raise "path must be a string or symbol, not #{path.inspect}" unless [String,Symbol].include?(path.class)
+    path = path.to_s
+    opts[:proxy] = proxy unless proxy.nil?
+    opts[:method] ||= :get
+    opts[:params] ||= {}
+    opts[:params][:borrowernumber] = opts[:borrowernumber] if opts[:borrowernumber]
+    opts[:params][:user_name] = opts[:borrowername] if opts[:borrowername]
+    query = Koha::Uri.to_params(opts[:params]) unless opts[:params].empty?
+    opts[:query] = query
+    opts[:path] = path
+    if base_uri
+      opts[:uri] = URI.join(base_uri, path.to_s)
+      opts[:uri].merge!("?#{query}" ) if query
+    end
+    opts
+  end
+  
+  
+  #  A mixin for used by #adapt_response
+   module Context
+     attr_accessor :request, :response
+   end
+
+   # This method will evaluate the :body value
+   # if the request has an :evaulte value, the response is send to
+   # the evaluate_json_response, which returns just the node. 
+   # this is a convience to simply return "false" or "true" and not a bunch of stupid
+   # json that has nothing that makes any god-damn sense. 
+   # ... otherwise, the json is simply returned.
+   def adapt_response request, response
+     raise "The response does not have the correct keys => :body, :headers, :status" unless
+       %W(body headers status) == response.keys.map{|k|k.to_s}.sort
+     raise Koha::Error::Http.new request, response unless [200,302].include? response[:status]
+     result = request[:evaluate] ? evaluate_json_response(request, response, request[:evaluate]) : response[:body]
+     result.extend Context
+     result.request, result.response = request, response
+     result
+   end
+  
+  
+  
+  ##### KOHA REST API METHODS #######
+  
+  ### Info Methods ###
+  
+  # returns a hash of [ { :code => "1", :name => "Our Branch Name "}]
+  def branches opts= {}
+     JSON.parse(get "branches", opts)
+  end
+  
+  
+  ### USER Methods ###
+  
+  # returns a hash of all the users
+  def all_users opts= {}
+    JSON.parse(get "user/all", opts )
+  end
+  
+  # returns a hash of patrons enrolled today
+  def today_users opts= {}
+    JSON.parse(get "user/today", opts)
+  end
+  
+  
+  def user_holds opts= {}
+    path, opts = build_user_path("holds", opts)
+    JSON.parse(get path, opts)
+  end
+  
+  def user_issues opts= {}
+    path, opts = build_user_path("issues", opts)
+    JSON.parse(get path, opts)
+  end
+  
+  def build_user_path rest_method, opts= {}
+    raise ArgumentError unless (  opts[:borrowernumber] or opts[:borrowername] ) #we have to be passed either a name or number
+    borrowernumber, borrowername = opts.delete(:borrowernumber), opts.delete(:borrowername)
+    path = borrowernumber ? "user/byid/#{borrowernumber}/#{rest_method}" : "user/#{borrowername}/#{rest_method}" 
+    return  path, opts
+  end
+    
+      
+  ### Biblio and Item Methods ###
+  
+  # This method will get the item record from koha given the biblionumber
+  def find_biblio biblionumber, opts = {}
+      biblionumber = biblionumber.to_s
+      JSON.parse(get "biblio/#{biblionumber}/items", opts)
+  end
+  
+  # wrapper to check if a biblio is holdable
+  # take a koha biblio number and standard client opts
+  def biblio_holdable?(biblionumber, opts = {})
+    is_holdable?(:biblio, biblionumber, opts )
+  end
+  
+  # wrapper to check a biblio items holdabale statues. 
+  # takes a koha bilionumber and standard client opts
+  # this returns just a hash of the items and their status, no need to evaulate.
+  def biblio_items_holdable?(biblionumber, opts = {} )
+    opts ||= {} 
+    opts[:holdable] = "items_holdable_status"
+    opts[:evaluate] ||= false
+    is_holdable?(:biblio, biblionumber, opts)
+  end
+  
+  # wrapper to check is an item is holdable
+  def item_holdable?(itemnumber, opts = {})
+    is_holdable?(:item, itemnumber, opts)
+  end
+  
+  def is_holdable?(koha_type, identifier, opts = {} )
+    opts ||= {}
+    opts[:evaluate] = :is_holdable unless opts[:evaluate] == false
+    holdable = opts[:holdable] ? opts[:holdable] : "holdable" 
+    koha_type = koha_type.to_s == "item" ? "item" : "biblio"
+    identifier = identifier.to_s
+    get "#{koha_type}/#{identifier}/#{holdable}", opts
+  end
+    
+  protected
+
+  # this is used to retrun a ruby primitive based on a json node. For example holdable returns { "is_holdable" : true, "reasons" : [] }
+  # and we just want true. 
+  def evaluate_json_response request, response, node
+    json = JSON.parse(response[:body])
+    json[node.to_s]
+  end
+  
+  
+  
+   
+end

data/lib/koha/connection.rb

@@ -0,0 +1,70 @@
+require 'net/http'
+require 'net/https'
+
+
+# taken from RSOLR's http client
+class Koha::Connection
+
+  def execute client, request_context
+    h = http request_context[:uri], request_context[:proxy], request_context[:read_timeout], request_context[:open_timeout]
+    request = setup_raw_request request_context
+    request.body = request_context[:data] if request_context[:method] == :post and request_context[:data]
+    begin
+      response = h.request request
+      charset = response.type_params["charset"]
+      {:status => response.code.to_i, :headers => response.to_hash, :body => force_charset(response.body, charset)}
+    rescue Errno::ECONNREFUSED => e
+      raise(Errno::ECONNREFUSED.new(request_context.inspect))
+    # catch the undefined closed? exception -- this is a confirmed ruby bug
+    rescue NoMethodError
+      $!.message == "undefined method `closed?' for nil:NilClass" ?
+        raise(Errno::ECONNREFUSED.new) :
+        raise($!)
+    end
+  end
+
+  protected
+
+  # This returns a singleton of a Net::HTTP or Net::HTTP.Proxy request object.
+  def http uri, proxy = nil, read_timeout = nil, open_timeout = nil
+    @http ||= (
+      http = if proxy
+        proxy_user, proxy_pass = proxy.userinfo.split(/:/) if proxy.userinfo
+        Net::HTTP.Proxy(proxy.host, proxy.port, proxy_user, proxy_pass).new uri.host, uri.port
+      else
+        Net::HTTP.new uri.host, uri.port
+      end
+      http.use_ssl = uri.port == 443 || uri.instance_of?(URI::HTTPS)
+      http.read_timeout = read_timeout if read_timeout
+      http.open_timeout = open_timeout if open_timeout
+      http
+    )
+  end
+
+  #
+   def setup_raw_request request_context
+     http_method = case request_context[:method]
+     when :get
+       Net::HTTP::Get
+     when :post
+       Net::HTTP::Post
+     when :put
+       Net::HTTP::Put
+     else
+       raise "Only :get, :post and :head http method types are allowed."
+     end
+     headers = request_context[:headers] || {}
+     raw_request = http_method.new request_context[:uri].request_uri
+     raw_request.initialize_http_header headers
+     raw_request.basic_auth(request_context[:uri].user, request_context[:uri].password) if request_context[:uri].user && request_context[:uri].password
+     raw_request
+   end
+
+  private
+
+  def force_charset body, charset
+    return body unless charset and body.respond_to?(:force_encoding)
+    body.force_encoding(charset)
+  end
+
+end

data/lib/koha/error.rb

@@ -0,0 +1,75 @@
+module Koha::Error
+  
+ 
+  
+  class Http < RuntimeError
+    
+    
+    # ripped right from ActionPack
+    # Defines the standard HTTP status codes, by integer, with their
+    # corresponding default message texts.
+    # Source: http://www.iana.org/assignments/http-status-codes
+    STATUS_CODES = {
+      100 => "Continue",
+      101 => "Switching Protocols",
+      102 => "Processing",
+
+      200 => "OK",
+      201 => "Created",
+      202 => "Accepted",
+      203 => "Non-Authoritative Information",
+      204 => "No Content",
+      205 => "Reset Content",
+      206 => "Partial Content",
+      207 => "Multi-Status",
+      226 => "IM Used",
+
+      300 => "Multiple Choices",
+      301 => "Moved Permanently",
+      302 => "Found",
+      303 => "See Other",
+      304 => "Not Modified",
+      305 => "Use Proxy",
+      307 => "Temporary Redirect",
+
+      400 => "Bad Request",
+      401 => "Unauthorized",
+      402 => "Payment Required",
+      403 => "Forbidden",
+      404 => "Not Found",
+      405 => "Method Not Allowed",
+      406 => "Not Acceptable",
+      407 => "Proxy Authentication Required",
+      408 => "Request Timeout",
+      409 => "Conflict",
+      410 => "Gone",
+      411 => "Length Required",
+      412 => "Precondition Failed",
+      413 => "Request Entity Too Large",
+      414 => "Request-URI Too Long",
+      415 => "Unsupported Media Type",
+      416 => "Requested Range Not Satisfiable",
+      417 => "Expectation Failed",
+      422 => "Unprocessable Entity",
+      423 => "Locked",
+      424 => "Failed Dependency",
+      426 => "Upgrade Required",
+
+      500 => "Internal Server Error",
+      501 => "Not Implemented",
+      502 => "Bad Gateway",
+      503 => "Service Unavailable",
+      504 => "Gateway Timeout",
+      505 => "HTTP Version Not Supported",
+      507 => "Insufficient Storage",
+      510 => "Not Extended"
+    }
+    
+    def initialize request, response
+      @request, @response = request, response
+    end
+    
+  end
+ 
+  
+end

data/lib/koha/uri.rb

@@ -0,0 +1,59 @@
+require 'uri'
+
+module Koha::Uri
+  
+  def create url
+    ::URI.parse url[-1] == ?/ ? url : "#{url}/"
+  end
+  
+  # Returns a query string param pair as a string.
+  # Both key and value are escaped.
+  def build_param(k,v, escape = true)
+    escape ? 
+      "#{escape_query_value(k)}=#{escape_query_value(v)}" :
+      "#{k}=#{v}"
+  end
+
+  # Return the bytesize of String; uses String#size under Ruby 1.8 and
+  # String#bytesize under 1.9.
+  if ''.respond_to?(:bytesize)
+    def bytesize(string)
+      string.bytesize
+    end
+  else
+    def bytesize(string)
+      string.size
+    end
+  end
+
+  # Creates a ILSDI based query string.
+    # Keys that have arrays values are set multiple times:
+    #   params_to_solr(:service => 'foo', :biblionumbers => ['1', '2'])
+    # is converted to:
+    #   ?service=foo&biblinumbers=1+2
+    def to_params(params, escape = true)
+      mapped = params.map do |k, v|
+        next if v.to_s.empty?
+        if v.class == Array 
+          build_param k, v.join("+"), false
+        else
+          build_param k, v, escape
+        end
+      end
+      mapped.compact.join("&")
+    end
+
+
+  # Performs URI escaping so that you can construct proper
+  # query strings faster.  Use this rather than the cgi.rb
+  # version since it's faster.
+  # (Stolen from Rack).
+  def escape_query_value(s)
+    s.to_s.gsub(/([^ a-zA-Z0-9_.-]+)/u) {
+      '%'+$1.unpack('H2'*bytesize($1)).join('%').upcase
+    }.tr(' ', '+')
+  end
+  
+  extend self
+  
+end

data/lib/koha/version.rb

@@ -0,0 +1,6 @@
+module Koha
+
+  VERSION =  "0.0.1"
+  
+  
+end

data/spec/api/client_spec.rb

@@ -0,0 +1,172 @@
+require 'spec_helper'
+describe "Koha::Client" do
+  
+  module ClientHelper
+    def client
+      @client ||= (
+        connection = Koha::Connection.new
+        Koha::Client.new connection, :url => "http://localhost/koha", :read_timeout => 42, :open_timeout=>43
+      )
+    end
+  end
+  
+  context "initialize" do
+    it "should accept whatevs and set it as the @connection" do
+      Koha::Client.new(:whatevs).connection.should == :whatevs
+    end
+    
+    
+  end
+  
+  context "send_and_receive" do
+    include ClientHelper
+    it "should forward these method calls the #connection object" do
+      [:get, :post, :put].each do |meth|
+        client.connection.should_receive(:execute).
+            and_return({:status => 200, :body => "{}", :headers => {}})
+        client.send_and_receive '', :method => meth, :params => {}, :data => nil, :headers => {}
+      end
+    end
+
+    it "should be timeout aware" do
+      [:get, :post, :put].each do |meth|
+        client.connection.should_receive(:execute).with(client, hash_including(:read_timeout => 42, :open_timeout=>43))
+        client.send_and_receive '', :method => meth, :params => {}, :data => nil, :headers => {}
+      end
+    end
+  end
+
+  context "post" do
+    include ClientHelper
+    it "should pass the expected params to the connection's #execute method" do
+      request_opts = {:data => "the data", :method=>:post, :headers => {"Content-Type" => "text/plain"}}
+      client.connection.should_receive(:execute).
+        with(client, hash_including(request_opts)).
+        and_return(
+          :body => "",
+          :status => 200,
+          :headers => {"Content-Type"=>"text/plain"}
+        )
+      client.post "biblio/update", request_opts
+    end
+  end
+  
+ 
+  
+  context "adapt_response" do
+    include ClientHelper
+  
+    
+  end
+  
+  context "build_request" do
+    include ClientHelper
+    it 'should return a request context array' do
+      result = client.build_request('select',
+        :method => :get,
+        :params => {},
+        :borrowernumber => "512",
+        :borrowername => "cf"
+      )
+      [/user_name=cf/, /borrowernumber=512/].each do |pattern|
+        result[:query].should match pattern
+      end
+    end
+  
+  
+  
+    # Check responses to see how the KOHA RESTFUL API v1.0 responds.
+    context "koha methods" do
+      include ClientHelper
+      
+      # branches
+      it "should call the REST API branch method with #client" do
+        stub_request(:get, "http://localhost/koha/branches").to_return(:status => 200, :body =>
+        "[{\"name\":\"World Maritime University Library\",\"code\":\"WMU\"},{\"name\":\"ebrary\",\"code\":\"EBR\"}]",
+         :headers => {})
+        client.branches
+        WebMock.should have_requested(:get, "http://localhost/koha/branches")
+      end
+      
+      
+      # user
+      it "should call the user/all method for #all_users" do
+        stub_request(:get, "http://localhost/koha/user/all").to_return(:status => 200, :body => 
+        "[{\"categorycode\":\"T\",\"B_address\":\"\",\"contactnote\":\"\",\"ethnicity\":null,\"email\":\"foo@wmu.se\",\"password\":\"1+1898juif\",\"B_country\":\"\",\"borrowernumber\":\"5\",\"lost\":\"0\",\"branchcode\":\"WMU\",\"streettype\":null,\"altcontactaddress3\":\"\",\"contactfirstname\":null,\"title\":\"\",\"attributes\":[],\"ethnotes\":null,\"relationship\":null,\"mobile\":\"\",\"fax\":\"\",\"altcontactphone\":\"\",\"contactname\":\"WMU\",\"country\":\"Sweden\",\"dateenrolled\":\"2010-02-03\",\"altcontactstate\":null,\"guarantorid\":\"0\",\"address2\":\"\",\"borrowernotes\":\"\",\"dateexpiry\":\"2018-05-03\",\"sort2\":\"\",\"contacttitle\":null,\"phonepro\":\"+46-40-35 63 90\",\"smsalertnumber\":null,\"B_streetnumber\":null,\"emailpro\":\"mbf@wmu.se\",\"firstname\":\"Michael\",\"altcontactcountry\":\"\",\"gonenoaddress\":\"0\",\"othernames\":\"\",\"state\":null,\"dateofbirth\":null,\"altcontactaddress2\":\"\",\"B_streettype\":null,\"debarred\":null,\"B_state\":null,\"address\":\"PO Box 500\",\"B_address2\":\"\",\"privacy\":\"1\",\"streetnumber\":\"\",\"surname\":\"BALDAUF\",\"cardnumber\":\"MBF\",\"altcontactsurname\":\"\",\"altcontactzipcode\":\"\",\"opacnote\":\"\",\"altcontactfirstname\":\"\",\"userid\":\"mbf\",\"B_zipcode\":\"\",\"B_email\":\"\",\"city\":\"Malm\",\"B_phone\":\"\",\"debarredcomment\":null,\"initials\":\"MB\",\"sort1\":\"\",\"flags\":null,\"zipcode\":\"20124\",\"phone\":\"\",\"sex\":\"M\",\"altcontactaddress1\":\"\",\"B_city\":\"\"}]"
+        )
+        client.all_users
+        WebMock.should have_requested(:get, "http://localhost/koha/user/all")
+      end
+        
+        
+      it "should call the user/all method for #all_users" do
+        stub_request(:get, "http://localhost/koha/user/today").to_return(:status => 200, :body => 
+        "[{\"categorycode\":\"T\",\"B_address\":\"\",\"contactnote\":\"\",\"ethnicity\":null,\"email\":\"foo@wmu.se\",\"password\":\"1+1898juif\",\"B_country\":\"\",\"borrowernumber\":\"5\",\"lost\":\"0\",\"branchcode\":\"WMU\",\"streettype\":null,\"altcontactaddress3\":\"\",\"contactfirstname\":null,\"title\":\"\",\"attributes\":[],\"ethnotes\":null,\"relationship\":null,\"mobile\":\"\",\"fax\":\"\",\"altcontactphone\":\"\",\"contactname\":\"WMU\",\"country\":\"Sweden\",\"dateenrolled\":\"2010-02-03\",\"altcontactstate\":null,\"guarantorid\":\"0\",\"address2\":\"\",\"borrowernotes\":\"\",\"dateexpiry\":\"2018-05-03\",\"sort2\":\"\",\"contacttitle\":null,\"phonepro\":\"+46-40-35 63 90\",\"smsalertnumber\":null,\"B_streetnumber\":null,\"emailpro\":\"mbf@wmu.se\",\"firstname\":\"Michael\",\"altcontactcountry\":\"\",\"gonenoaddress\":\"0\",\"othernames\":\"\",\"state\":null,\"dateofbirth\":null,\"altcontactaddress2\":\"\",\"B_streettype\":null,\"debarred\":null,\"B_state\":null,\"address\":\"PO Box 500\",\"B_address2\":\"\",\"privacy\":\"1\",\"streetnumber\":\"\",\"surname\":\"BALDAUF\",\"cardnumber\":\"MBF\",\"altcontactsurname\":\"\",\"altcontactzipcode\":\"\",\"opacnote\":\"\",\"altcontactfirstname\":\"\",\"userid\":\"mbf\",\"B_zipcode\":\"\",\"B_email\":\"\",\"city\":\"Malm\",\"B_phone\":\"\",\"debarredcomment\":null,\"initials\":\"MB\",\"sort1\":\"\",\"flags\":null,\"zipcode\":\"20124\",\"phone\":\"\",\"sex\":\"M\",\"altcontactaddress1\":\"\",\"B_city\":\"\"}]"
+        )
+        client.today_users
+        WebMock.should have_requested(:get, "http://localhost/koha/user/today")
+      end
+      
+      it "should call the user holds method for #user_holds" do
+        stub_request(:get, "http://localhost/koha/user/byid/1/holds").to_return(:status => 200, :body => 
+"[{\"itemnumber\":null,\"branchname\":\"World Maritime University Library\",\"itemcallnumber\":null,\"hold_id\":null,\"reservedate\":\"2013-02-20\",\"barcode\":null,\"found\":null,\"biblionumber\":\"76356\",\"cancellationdate\":null,\"title\":\"Asian approaches to international law and the legacy of colonialism and imperialism :\",\"rank\":\"1\",\"branchcode\":\"WMU\"}]"         )
+        client.user_holds(:borrowernumber => "1")
+        WebMock.should have_requested(:get, "http://localhost/koha/user/byid/1/holds")
+      end
+    
+    
+     it "should call the user issues method for #user_issues" do
+        stub_request(:get, "http://localhost/koha/user/cf/issues").to_return(:status => 200, :body => 
+"[{\"itemnumber\":\"42414\",\"itemcallnumber\":\"KD1819 .H54 2003\",\"barcode\":\"022593\",\"date_due\":\"2013-03-11T23:59:00\",\"renewable\":true,\"issuedate\":\"2012-11-21T00:00:00\",\"biblionumber\":\"17454\",\"title\":\"Maritime law\",\"borrowernumber\":\"544\",\"branchcode\":\"WMU\"}]"         )
+        client.user_issues(:borrowername => "cf")
+        WebMock.should have_requested(:get, "http://localhost/koha/user/cf/issues")
+      end
+    
+    
+      # biblio and items
+      
+      it "should call the biblio items method for #find_biblio" do
+          stub_request(:get, "http://localhost/koha/biblio/1/items").to_return(:status => 200, :body => 
+"[{\"withdrawn\":\"0\",\"biblioitemnumber\":\"1\",\"restricted\":null,\"wthdrawn\":\"0\",\"holdingbranchname\":\"World Maritime University Library\",\"notforloan\":\"0\",\"replacementpricedate\":\"2010-02-05\",\"itemnumber\":\"1\",\"ccode\":null,\"itemnotes\":null,\"location\":\"GEN\",\"itemcallnumber\":\"HD30.3 .A32 1989\",\"stack\":null,\"date_due\":\"\",\"barcode\":\"011376\",\"itemlost\":\"0\",\"uri\":null,\"materials\":null,\"datelastseen\":\"2010-02-05\",\"price\":null,\"issues\":null,\"homebranch\":\"WMU\",\"replacementprice\":null,\"more_subfields_xml\":null,\"cn_source\":\"lcc\",\"homebranchname\":\"World Maritime University Library\",\"booksellerid\":null,\"biblionumber\":\"1\",\"renewals\":null,\"holdingbranch\":\"WMU\",\"timestamp\":\"2012-11-28 07:47:23\",\"damaged\":\"0\",\"stocknumber\":null,\"cn_sort\":\"HD_00030_3_A32_1989\",\"reserves\":null,\"dateaccessioned\":\"2010-02-05\",\"datelastborrowed\":null,\"enumchron\":null,\"copynumber\":\"1\",\"permanent_location\":null,\"onloan\":null,\"paidfor\":null,\"itype\":\"BOOK\"}]" ) 
+          client.find_biblio("1")
+          WebMock.should have_requested(:get, "http://localhost/koha/biblio/1/items")
+      end
+    
+    
+     it "should call the biblio items method for #find_biblio" do
+          stub_request(:get, "http://localhost/koha/biblio/1/items").to_return(:status => 200, :body => 
+"[{\"withdrawn\":\"0\",\"biblioitemnumber\":\"1\",\"restricted\":null,\"wthdrawn\":\"0\",\"holdingbranchname\":\"World Maritime University Library\",\"notforloan\":\"0\",\"replacementpricedate\":\"2010-02-05\",\"itemnumber\":\"1\",\"ccode\":null,\"itemnotes\":null,\"location\":\"GEN\",\"itemcallnumber\":\"HD30.3 .A32 1989\",\"stack\":null,\"date_due\":\"\",\"barcode\":\"011376\",\"itemlost\":\"0\",\"uri\":null,\"materials\":null,\"datelastseen\":\"2010-02-05\",\"price\":null,\"issues\":null,\"homebranch\":\"WMU\",\"replacementprice\":null,\"more_subfields_xml\":null,\"cn_source\":\"lcc\",\"homebranchname\":\"World Maritime University Library\",\"booksellerid\":null,\"biblionumber\":\"1\",\"renewals\":null,\"holdingbranch\":\"WMU\",\"timestamp\":\"2012-11-28 07:47:23\",\"damaged\":\"0\",\"stocknumber\":null,\"cn_sort\":\"HD_00030_3_A32_1989\",\"reserves\":null,\"dateaccessioned\":\"2010-02-05\",\"datelastborrowed\":null,\"enumchron\":null,\"copynumber\":\"1\",\"permanent_location\":null,\"onloan\":null,\"paidfor\":null,\"itype\":\"BOOK\"}]" ) 
+          client.find_biblio("1")
+          WebMock.should have_requested(:get, "http://localhost/koha/biblio/1/items")
+      end
+    
+     it "should call the biblio holdable for #biblio_holdable?" do
+        stub_request(:get, "http://localhost/koha/biblio/1/holdable").to_return(:status => 200, :body =>
+        "{\"is_holdable\":true,\"reasons\":[]}"  )
+        client.biblio_holdable?("1").should be_true
+        WebMock.should have_requested(:get, "http://localhost/koha/biblio/1/holdable")
+     end
+    
+    # show how to use a borrowername
+    it "should call the biblio holdable items for #biblio_items_holdable?" do
+       stub_request(:get, "http://localhost/koha/biblio/1/items_holdable_status?user_name=cf").to_return(:status => 200, :body =>
+       "{\"is_holdable\":true,\"reasons\":[]}"  )
+       client.biblio_items_holdable?("1", :borrowername => "cf" ).should be_true
+       WebMock.should have_requested(:get, "http://localhost/koha/biblio/1/items_holdable_status?user_name=cf")
+    end
+    
+    # show how to use a borrowernumber
+    it "should call the  items holdable API method for #item_holdable?" do
+       stub_request(:get, "http://localhost/koha/item/74297/holdable?user_name=cf").to_return(:status => 200, :body =>
+       "{\"is_holdable\":false,\"reasons\":[]}"  )
+       client.item_holdable?("74297", :borrowername => "cf" ).should be_false
+       WebMock.should have_requested(:get, "http://localhost/koha/item/74297/holdable?user_name=cf")
+    end
+    
+    
+    
+    end  
+  
+    
+  end
+end

data/spec/api/connection_spec.rb

@@ -0,0 +1,152 @@
+require 'spec_helper'
+require 'base64'
+
+describe "Koha::Connection" do
+  
+  context "setup_raw_request" do
+    
+    before(:each) do 
+      @c = Koha::Connection.new
+      @base_url = "http://localhost:8983/koha/rest.pl"
+      @client = Koha::Client.new @c, :url => @base_url
+    end
+       
+    it "should set up a get request" do
+      req = @c.send :setup_raw_request, {:headers => {"content-type" => "application/json"}, :method => :get, :uri => URI.parse(@base_url + "/biblio/1/items?borrowername=cf")}
+      headers = {}
+      req.each_header{|k,v| headers[k] = v}
+      req.method.should == "GET"
+      headers.should == {"content-type"=>"application/json"}
+    end
+    
+     it "should set up a post request" do
+        req = @c.send :setup_raw_request, {:headers => {"content-type" => "application/json"}, :method => :post, :uri => URI.parse(@base_url + "/biblio/1/items?borrowername=cf")}
+        headers = {}
+        req.each_header{|k,v| headers[k] = v}
+        req.method.should == "POST"
+        headers.should == {"content-type"=>"application/json"}
+    end
+    
+     it "should set up a post request" do
+        req = @c.send :setup_raw_request, {:headers => {"content-type" => "application/json"}, :method => :put, :uri => URI.parse(@base_url + "/biblio/1/items?borrowername=cf")}
+        headers = {}
+        req.each_header{|k,v| headers[k] = v}
+        req.method.should == "PUT"
+        headers.should == {"content-type"=>"application/json"}
+    end
+    
+     it "should raise error if something weird is set as method" do
+        expect { @c.send :setup_raw_request, {:headers => {"content-type" => "application/json"}, :method => :head, :uri => URI.parse(@base_url + "/biblio/1/items?borrowername=cf")} }.to raise_error("Only :get, :post and :head http method types are allowed.")
+       
+    end
+    
+  end
+
+  context "read timeout configuration" do
+    let(:client) { mock.as_null_object }
+
+    let(:http) { mock(Net::HTTP).as_null_object }
+
+    subject { Koha::Connection.new } 
+
+    before do
+      Net::HTTP.stub(:new) { http }
+    end
+
+    it "should configure Net:HTTP read_timeout" do
+      http.should_receive(:read_timeout=).with(42)
+      subject.execute client, {:uri => URI.parse("http://localhost/some_uri"), :method => :get, :read_timeout => 42}
+    end
+
+    it "should use Net:HTTP default read_timeout if not specified" do
+      http.should_not_receive(:read_timeout=)
+      subject.execute client, {:uri => URI.parse("http://localhost/some_uri"), :method => :get}
+    end
+  end
+
+  context "open timeout configuration" do
+    let(:client) { mock.as_null_object }
+
+    let(:http) { mock(Net::HTTP).as_null_object }
+
+    subject { Koha::Connection.new } 
+
+    before do
+      Net::HTTP.stub(:new) { http }
+    end
+
+    it "should configure Net:HTTP open_timeout" do
+      http.should_receive(:open_timeout=).with(42)
+      subject.execute client, {:uri => URI.parse("http://localhost/some_uri"), :method => :get, :open_timeout => 42}
+    end
+
+    it "should use Net:HTTP default open_timeout if not specified" do
+      http.should_not_receive(:open_timeout=)
+      subject.execute client, {:uri => URI.parse("http://localhost/some_uri"), :method => :get}
+    end
+  end
+
+  context "connection refused" do
+    let(:client) { mock.as_null_object }
+
+    let(:http) { mock(Net::HTTP).as_null_object }
+    let(:request_context) {
+      {:uri => URI.parse("http://localhost/some_uri"), :method => :get, :open_timeout => 42}
+    }
+    subject { Koha::Connection.new } 
+
+    before do
+      Net::HTTP.stub(:new) { http }
+    end
+
+    it "should configure Net:HTTP open_timeout" do
+      http.should_receive(:request).and_raise(Errno::ECONNREFUSED)
+      lambda {
+        subject.execute client, request_context
+      }.should raise_error(Errno::ECONNREFUSED, /#{request_context}/)
+    end
+    
+      # there is a strange ruby bug about closing a connection....this catches it. 
+     it "should raise NoMethodError if a non-method is called" do
+        http.should_receive(:request).and_raise(NoMethodError)
+        lambda {
+          subject.execute client, request_context
+        }.should raise_error(NoMethodError, /NoMethodError/)
+      end
+      
+      it "should raise NoMethodError if a non-method is called" do
+          error = NoMethodError.new("undefined method `closed?' for nil:NilClass")
+          http.should_receive(:request).and_raise(error) 
+          lambda {
+            subject.execute client, request_context
+          }.should raise_error(Errno::ECONNREFUSED)
+        end
+    
+  end
+  
+  describe "basic auth support" do
+    let(:http) { mock(Net::HTTP).as_null_object }
+    
+    before do
+      Net::HTTP.stub(:new) { http }
+    end
+    
+    it "sets the authorization header" do
+      http.should_receive(:request) do |request|
+        request.fetch('authorization').should == "Basic #{Base64.encode64("joe:pass")}".strip
+        mock(Net::HTTPResponse).as_null_object
+      end
+      Koha::Connection.new.execute nil, :uri => URI.parse("http://joe:pass@localhost/koha/rest.pl"), :method => :get
+    end
+  end
+  
+  describe "proxy support" do
+    it "set the proxy" do
+      @mock_proxy = mock('Proxy')
+      @mock_proxy.should_receive(:new).with("localhost", 80).and_return( mock(Net::HTTP).as_null_object)  
+      Net::HTTP.should_receive(:Proxy).with("proxy", 80, nil, nil).and_return(@mock_proxy)
+      Koha::Connection.new.execute nil, :uri => URI.parse("http://localhost/koha/rest.pl"),  :method => :get, :proxy =>  URI.parse("http://proxy/pass.pl")
+    end
+  end
+  
+end

data/spec/api/uri_spec.rb

@@ -0,0 +1,71 @@
+require 'spec_helper'
+describe "Koha::Uri" do
+  
+  context "class-level methods" do
+    
+    let(:uri){ Koha::Uri }
+    
+    it "should return a URI object with a trailing slash" do
+      u = uri.create 'http://koha.org'
+      u.path[0].should == ?/
+    end
+  
+    it "should return the bytesize of a string" do
+      uri.bytesize("test").should == 4
+    end
+  
+  
+  
+    context "escape_query_value" do
+      
+      it 'should escape &' do
+        uri.to_params(:biblionumber => "&").should == 'biblionumber=%26'
+      end
+
+       it 'should escape &' do
+          uri.to_params({:biblionumber => "&" }, false).should == 'biblionumber=&'
+        end
+
+          it 'should escape &' do
+              uri.to_params(:biblionumber => [1,2,3] ).should == 'biblionumber=1+2+3'
+            end
+
+
+      it 'should convert spaces to +' do
+        uri.to_params(:biblionumber => "me and you").should == 'biblionumber=me+and+you'
+      end
+
+      it 'should escape comlex queries, part 1' do
+        my_params = {'fq' => '{!raw f=field_name}crazy+\"field+value'}
+        expected = 'fq=%7B%21raw+f%3Dfield_name%7Dcrazy%2B%5C%22field%2Bvalue'
+        uri.to_params(my_params).should == expected
+      end
+
+      it 'should escape complex queries, part 2' do
+        my_params = {'q' => '+popularity:[10 TO *] +section:0'}
+        expected = 'q=%2Bpopularity%3A%5B10+TO+%2A%5D+%2Bsection%3A0'
+        uri.to_params(my_params).should == expected
+      end
+      
+      it 'should escape properly' do
+        uri.escape_query_value('+').should == '%2B'
+        uri.escape_query_value('This is a test').should == 'This+is+a+test'
+        uri.escape_query_value('<>/\\').should == '%3C%3E%2F%5C'
+        uri.escape_query_value('"').should == '%22'
+        uri.escape_query_value(':').should == '%3A'
+      end
+
+      it 'should escape brackets' do
+        uri.escape_query_value('{').should == '%7B'
+        uri.escape_query_value('}').should == '%7D'
+      end
+
+      it 'should escape exclamation marks!' do
+        uri.escape_query_value('!').should == '%21'
+      end
+      
+    end
+    
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require File.expand_path('../../lib/koha', __FILE__)
+require 'webmock/rspec'
+if ENV["COVERAGE"] == 'yes'
+  require 'simplecov'
+  SimpleCov.start do
+    add_filter 'spec'
+  end
+end

data/tasks/spec.rake

@@ -0,0 +1,28 @@
+require "rubygems"
+require 'rspec'
+require 'rspec/core/rake_task'
+
+namespace :spec do
+  
+  desc 'run api specs (mock out Koha dependency)'
+  RSpec::Core::RakeTask.new(:api) do |t|
+    
+    t.pattern = [File.join('spec', 'spec_helper.rb')]
+    t.pattern += FileList[File.join('spec', 'api', '**', '*_spec.rb')]
+    
+    t.verbose = true
+    t.rspec_opts = ['--color']
+  end
+=begin  
+  desc 'run integration specs'
+  RSpec::Core::RakeTask.new(:integration) do |t|
+    
+    t.pattern = [File.join('spec', 'spec_helper.rb')]
+    t.pattern += FileList[File.join('spec', 'integration', '**', '*_spec.rb')]
+    
+    t.verbose = true
+    t.rspec_opts = ['--color']
+  end
+=end
+  
+end

data/tasks/yard.rake

@@ -0,0 +1,6 @@
+require 'yard'
+
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']   # optional
+  t.options = ['--any', '--extra', '--opts'] # optional
+end

metadata

@@ -0,0 +1,178 @@
+--- !ruby/object:Gem::Specification
+name: koha
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- chris fitzpatrick
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.4.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.4.1
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.9.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.9.3
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.0.3
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.9.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.9.5
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! 'Easy interface for the Koha ILSDI API (https://github.com/Koha-Community/Koha/blob/master/C4/ILSDI/Services.pm) '
+email:
+- chrisfitzpat@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- CHANGELOG
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- koha.gemspec
+- lib/koha.rb
+- lib/koha/client.rb
+- lib/koha/connection.rb
+- lib/koha/error.rb
+- lib/koha/uri.rb
+- lib/koha/version.rb
+- spec/api/client_spec.rb
+- spec/api/connection_spec.rb
+- spec/api/uri_spec.rb
+- spec/spec_helper.rb
+- tasks/spec.rake
+- tasks/yard.rake
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A Ruby client for Koha ILSDI interface
+test_files: []
+has_rdoc: