rbook 0.4.3 → 0.5

data/lib/rbook/titlepage/client.rb

@@ -1,126 +0,0 @@
-$LOAD_PATH.unshift(File.dirname(__FILE__) + "/../")
-
-require 'rbook/isbn'
-require 'rbook/errors'
-require 'rbook/titlepage/titlepage_driver'
-require 'drb'
-
-module RBook
-  module TitlePage
-
-    # a convenience class for accessing the SOAP API for http://www.titlepage.com.
-    # Uses boilerplate code generated by soap4r.
-    #
-    # You should be aware of any limits of query volume imposed by the provider - currently a
-    # maximum of 30 queries per minute is permitted.
-    #
-    # For a basic usage overview, check out RBook::TitlePage
-    class Client
-
-      @@uri = nil
-
-      # Tells all instances of this class to query the titlepage API via a Distributed Ruby
-      # proxy. This is useful where multiple machines need to make queries and you need to be
-      # careful not to exceed the maximum query rate.
-      #
-      # There is an example proxy executable available in the bin/ directory of rbook.
-      #
-      # Assuming the proxy is running on port 61676 of the local machine, the following
-      # code can be used to query titlepage:
-      #   
-      #   RBook::TitlePage::Client.use_proxy("druby://127.0.0.1:61676")
-      #   RBook::TitlePage::Client.open("username", "password") do |tp|
-      #     puts tp.find("0091835135").product.title.titleText
-      #   end
-      def self.use_proxy(uri)
-        @@uri = uri
-      end
-
-      # Optional driver parameter allows an alternative SOAP driver to the default to be specified.
-      # This is primarily for testing purposes and probably isn't useful to anyone in the real world.
-      def initialize(driver = nil)
-        @driver = driver || TitleQueryPortType.new
-        @token = nil
-      end
-
-      # login to the titlepage API.
-      def login(username, password)
-        raise InvalidRubyVersionError, 'Ruby 1.8.3 or higher is required to use this class' unless RUBY_VERSION >= "1.8.3"
-        logout if @token
-        @username = username
-        @password = password
-        unless @@uri
-          @token = @driver.login(username, password)
-          return true if @token
-        end
-      end
-
-      # logout from the titlepage API
-      def logout
-        @username = nil
-        @password = nil
-        if @token and @@uri != nil
-          @driver.logout(@token)
-        else
-          true
-        end
-      end
-
-      # retrieve information on a specified ISBN
-      def find(isbn)
-        return NotLoggedInError, 'You must login to titlepage API before performing a search' unless @token || @@uri
-        isbn = ISBN::convert_to_isbn13(isbn)
-        return nil if isbn.nil?
-        begin
-          if @@uri
-            proxy = DRbObject.new_with_uri(@@uri)
-            result = proxy.find(@username, @password, isbn) 
-          else
-            result = @driver.SearchByEAN(@token, isbn)
-          end
-          if result.Product.nil?
-            return nil
-          else
-            return result
-          end
-        rescue 
-          return nil
-        end
-
-      end
-
-      # a convenience method to make single queries to title page a little cleaner. 
-      #
-      #  result = RBook::TitlePage.find("username","password","9780091835132")
-      #  puts result.inspect
-      def self.find(username, password, isbn, driver = nil)
-        result = nil
-        RBook::TitlePage::Client.open(username, password, driver) do |tp|
-          result = tp.find(isbn)
-        end
-        return result
-      end
-
-      # a convenience method to make queries to title page a little cleaner. This function
-      # essentially calls the login and logout functions for you automatically.
-      #
-      #  RBook::TitlePage.open("username","password") do |tp|
-      #    result = tp.find("9780091835132")
-      #  end
-      def self.open(username, password, driver = nil)
-
-        tp = self.new(driver || TitleQueryPortType.new)
-
-        begin
-          tp.login(username, password)
-
-          yield(tp)
-
-        ensure
-          tp.logout
-        end
-      end
-
-    end
-  end
-end

data/lib/rbook/titlepage/titlepage_driver.rb

@@ -1,137 +0,0 @@
-require File.dirname(__FILE__) + '/titlepage_utils.rb'
-
-require 'soap/rpc/driver'
-
-module RBook
-  module TitlePage
-    class TitleQueryPortType < ::SOAP::RPC::Driver
-      DefaultEndpointUrl = "http://www.titlepage.com.au/ws/TitleQuery.php"
-      MappingRegistry = ::SOAP::Mapping::Registry.new
-
-      MappingRegistry.set(
-        SearchResults,
-        ::SOAP::SOAPStruct,
-        ::SOAP::Mapping::Registry::TypedStructFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "SearchResults") }
-      )
-      MappingRegistry.set(
-        Product,
-        ::SOAP::SOAPStruct,
-        ::SOAP::Mapping::Registry::TypedStructFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "Product") }
-      )
-      MappingRegistry.set(
-        ArrayOfProductIdentifier,
-        ::SOAP::SOAPArray,
-        ::SOAP::Mapping::Registry::TypedArrayFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "ProductIdentifier") }
-      )
-      MappingRegistry.set(
-        Title,
-        ::SOAP::SOAPStruct,
-        ::SOAP::Mapping::Registry::TypedStructFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "Title") }
-      )
-      MappingRegistry.set(
-        ArrayOfContributor,
-        ::SOAP::SOAPArray,
-        ::SOAP::Mapping::Registry::TypedArrayFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "Contributor") }
-      )
-      MappingRegistry.set(
-        SupplyDetail,
-        ::SOAP::SOAPStruct,
-        ::SOAP::Mapping::Registry::TypedStructFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "SupplyDetail") }
-      )
-      MappingRegistry.set(
-        Stock,
-        ::SOAP::SOAPStruct,
-        ::SOAP::Mapping::Registry::TypedStructFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "Stock") }
-      )
-      MappingRegistry.set(
-        Price,
-        ::SOAP::SOAPStruct,
-        ::SOAP::Mapping::Registry::TypedStructFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "Price") }
-      )
-      MappingRegistry.set(
-        ProductIdentifier,
-        ::SOAP::SOAPStruct,
-        ::SOAP::Mapping::Registry::TypedStructFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "ProductIdentifier") }
-      )
-      MappingRegistry.set(
-        Contributor,
-        ::SOAP::SOAPStruct,
-        ::SOAP::Mapping::Registry::TypedStructFactory,
-        { :type => XSD::QName.new("urn:TitleQuery", "Contributor") }
-      )
-
-      Methods = [
-        [ XSD::QName.new("http://www.titlepage.com/ws", "Login"),
-          "http://www.titlepage.com.au/ws/TitleQuery.php/Login",
-          "login",
-          [ ["in", "UserName", ["::SOAP::SOAPString"]],
-            ["in", "Password", ["::SOAP::SOAPString"]],
-            ["retval", "Token", ["::SOAP::SOAPString"]] ],
-          { :request_style =>  :rpc, :request_use =>  :encoded,
-            :response_style => :rpc, :response_use => :encoded }
-        ],
-        [ XSD::QName.new("http://www.titlepage.com/ws", "SearchByISBN"),
-          "http://www.titlepage.com.au/ws/TitleQuery.php/SearchByISBN",
-          "searchByISBN",
-          [ ["in", "Token", ["::SOAP::SOAPString"]],
-            ["in", "ISBN", ["::SOAP::SOAPString"]],
-            ["retval", "SearchResults", ["SearchResults", "urn:TitleQuery", "SearchResults"]] ],
-          { :request_style =>  :rpc, :request_use =>  :encoded,
-            :response_style => :rpc, :response_use => :encoded }
-        ],
-        [ XSD::QName.new("http://www.titlepage.com/ws", "SearchByEAN"),
-          "http://www.titlepage.com.au/ws/TitleQuery.php/SearchByEAN",
-          "searchByEAN",
-          [ ["in", "Token", ["::SOAP::SOAPString"]],
-            ["in", "EAN", ["::SOAP::SOAPString"]],
-            ["retval", "SearchResults", ["SearchResults", "urn:TitleQuery", "SearchResults"]] ],
-          { :request_style =>  :rpc, :request_use =>  :encoded,
-            :response_style => :rpc, :response_use => :encoded }
-        ],
-        [ XSD::QName.new("http://www.titlepage.com/ws", "Logout"),
-          "http://www.titlepage.com.au/ws/TitleQuery.php/Logout",
-          "logout",
-          [ ["in", "token", ["::SOAP::SOAPString"]] ],
-          { :request_style =>  :rpc, :request_use =>  :encoded,
-            :response_style => :rpc, :response_use => :encoded }
-        ]
-      ]
-
-      def initialize(endpoint_url = nil)
-        endpoint_url ||= DefaultEndpointUrl
-        super(endpoint_url, nil)
-        self.mapping_registry = MappingRegistry
-        init_methods
-      end
-
-    private
-
-      def init_methods
-        Methods.each do |definitions|
-          opt = definitions.last
-          if opt[:request_style] == :document
-            add_document_operation(*definitions)
-          else
-            add_rpc_operation(*definitions)
-            qname = definitions[0]
-            name = definitions[2]
-            if qname.name != name and qname.name.capitalize == name.capitalize
-              ::SOAP::Mapping.define_singleton_method(self, qname.name) do |*arg|
-                __send__(name, *arg)
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/rbook/titlepage/titlepage_utils.rb

@@ -1,379 +0,0 @@
-require 'xsd/qname'
-
-module RBook
-  module TitlePage
-
-    # {urn:TitleQuery}ProductIdentifier
-    class ProductIdentifier
-      @@schema_type = "ProductIdentifier"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["productIDType", ["SOAP::SOAPString", XSD::QName.new(nil, "ProductIDType")]], ["iDValue", ["SOAP::SOAPString", XSD::QName.new(nil, "IDValue")]]]
-
-      def ProductIDType
-        @productIDType
-      end
-
-      def ProductIDType=(value)
-        @productIDType = value
-      end
-
-      def IDValue
-        @iDValue
-      end
-
-      def IDValue=(value)
-        @iDValue = value
-      end
-
-      def initialize(productIDType = nil, iDValue = nil)
-        @productIDType = productIDType
-        @iDValue = iDValue
-      end
-    end
-
-    # {urn:TitleQuery}Title
-    class Title
-      @@schema_type = "Title"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["titleType", ["SOAP::SOAPString", XSD::QName.new(nil, "TitleType")]], ["titleText", ["SOAP::SOAPString", XSD::QName.new(nil, "TitleText")]], ["titlePrefix", ["SOAP::SOAPString", XSD::QName.new(nil, "TitlePrefix")]], ["titleWithoutPrefix", ["SOAP::SOAPString", XSD::QName.new(nil, "TitleWithoutPrefix")]], ["subtitle", ["SOAP::SOAPString", XSD::QName.new(nil, "Subtitle")]]]
-
-      def TitleType
-        @titleType
-      end
-
-      def TitleType=(value)
-        @titleType = value
-      end
-
-      def TitleText
-        @titleText
-      end
-
-      def TitleText=(value)
-        @titleText = value
-      end
-
-      def TitlePrefix
-        @titlePrefix
-      end
-
-      def TitlePrefix=(value)
-        @titlePrefix = value
-      end
-
-      def TitleWithoutPrefix
-        @titleWithoutPrefix
-      end
-
-      def TitleWithoutPrefix=(value)
-        @titleWithoutPrefix = value
-      end
-
-      def Subtitle
-        @subtitle
-      end
-
-      def Subtitle=(value)
-        @subtitle = value
-      end
-
-      def initialize(titleType = nil, titleText = nil, titlePrefix = nil, titleWithoutPrefix = nil, subtitle = nil)
-        @titleType = titleType
-        @titleText = titleText
-        @titlePrefix = titlePrefix
-        @titleWithoutPrefix = titleWithoutPrefix
-        @subtitle = subtitle
-      end
-    end
-
-    # {urn:TitleQuery}Contributor
-    class Contributor
-      @@schema_type = "Contributor"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["sequenceNumber", ["SOAP::SOAPInteger", XSD::QName.new(nil, "SequenceNumber")]], ["contributorRole", ["SOAP::SOAPString", XSD::QName.new(nil, "ContributorRole")]], ["personName", ["SOAP::SOAPString", XSD::QName.new(nil, "PersonName")]], ["personNameInverted", ["SOAP::SOAPString", XSD::QName.new(nil, "PersonNameInverted")]], ["titlesBeforeNames", ["SOAP::SOAPString", XSD::QName.new(nil, "TitlesBeforeNames")]], ["keyNames", ["SOAP::SOAPString", XSD::QName.new(nil, "KeyNames")]]]
-
-      def SequenceNumber
-        @sequenceNumber
-      end
-
-      def SequenceNumber=(value)
-        @sequenceNumber = value
-      end
-
-      def ContributorRole
-        @contributorRole
-      end
-
-      def ContributorRole=(value)
-        @contributorRole = value
-      end
-
-      def PersonName
-        @personName
-      end
-
-      def PersonName=(value)
-        @personName = value
-      end
-
-      def PersonNameInverted
-        @personNameInverted
-      end
-
-      def PersonNameInverted=(value)
-        @personNameInverted = value
-      end
-
-      def TitlesBeforeNames
-        @titlesBeforeNames
-      end
-
-      def TitlesBeforeNames=(value)
-        @titlesBeforeNames = value
-      end
-
-      def KeyNames
-        @keyNames
-      end
-
-      def KeyNames=(value)
-        @keyNames = value
-      end
-
-      def initialize(sequenceNumber = nil, contributorRole = nil, personName = nil, personNameInverted = nil, titlesBeforeNames = nil, keyNames = nil)
-        @sequenceNumber = sequenceNumber
-        @contributorRole = contributorRole
-        @personName = personName
-        @personNameInverted = personNameInverted
-        @titlesBeforeNames = titlesBeforeNames
-        @keyNames = keyNames
-      end
-    end
-
-    # {urn:TitleQuery}Stock
-    class Stock
-      @@schema_type = "Stock"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["onHand", ["SOAP::SOAPString", XSD::QName.new(nil, "OnHand")]], ["onOrder", ["SOAP::SOAPString", XSD::QName.new(nil, "OnOrder")]]]
-
-      def OnHand
-        @onHand
-      end
-
-      def OnHand=(value)
-        @onHand = value
-      end
-
-      def OnOrder
-        @onOrder
-      end
-
-      def OnOrder=(value)
-        @onOrder = value
-      end
-
-      def initialize(onHand = nil, onOrder = nil)
-        @onHand = onHand
-        @onOrder = onOrder
-      end
-    end
-
-    # {urn:TitleQuery}Price
-    class Price
-      @@schema_type = "Price"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["priceTypeCode", ["SOAP::SOAPString", XSD::QName.new(nil, "PriceTypeCode")]], ["priceAmount", ["SOAP::SOAPDecimal", XSD::QName.new(nil, "PriceAmount")]]]
-
-      def PriceTypeCode
-        @priceTypeCode
-      end
-
-      def PriceTypeCode=(value)
-        @priceTypeCode = value
-      end
-
-      def PriceAmount
-        @priceAmount
-      end
-
-      def PriceAmount=(value)
-        @priceAmount = value
-      end
-
-      def initialize(priceTypeCode = nil, priceAmount = nil)
-        @priceTypeCode = priceTypeCode
-        @priceAmount = priceAmount
-      end
-    end
-
-    # {urn:TitleQuery}SupplyDetail
-    class SupplyDetail
-      @@schema_type = "SupplyDetail"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["supplierName", ["SOAP::SOAPString", XSD::QName.new(nil, "SupplierName")]], ["supplierRole", ["SOAP::SOAPString", XSD::QName.new(nil, "SupplierRole")]], ["productAvailability", ["SOAP::SOAPString", XSD::QName.new(nil, "ProductAvailability")]], ["expectedShipDate", ["SOAP::SOAPString", XSD::QName.new(nil, "ExpectedShipDate")]], ["stock", ["Stock", XSD::QName.new(nil, "Stock")]], ["packQuantity", ["SOAP::SOAPInteger", XSD::QName.new(nil, "PackQuantity")]], ["price", ["Price", XSD::QName.new(nil, "Price")]]]
-
-      def SupplierName
-        @supplierName
-      end
-
-      def SupplierName=(value)
-        @supplierName = value
-      end
-
-      def SupplierRole
-        @supplierRole
-      end
-
-      def SupplierRole=(value)
-        @supplierRole = value
-      end
-
-      def ProductAvailability
-        @productAvailability
-      end
-
-      def ProductAvailability=(value)
-        @productAvailability = value
-      end
-
-      def ExpectedShipDate
-        @expectedShipDate
-      end
-
-      def ExpectedShipDate=(value)
-        @expectedShipDate = value
-      end
-
-      def Stock
-        @stock
-      end
-
-      def Stock=(value)
-        @stock = value
-      end
-
-      def PackQuantity
-        @packQuantity
-      end
-
-      def PackQuantity=(value)
-        @packQuantity = value
-      end
-
-      def Price
-        @price
-      end
-
-      def Price=(value)
-        @price = value
-      end
-
-      def initialize(supplierName = nil, supplierRole = nil, productAvailability = nil, expectedShipDate = nil, stock = nil, packQuantity = nil, price = nil)
-        @supplierName = supplierName
-        @supplierRole = supplierRole
-        @productAvailability = productAvailability
-        @expectedShipDate = expectedShipDate
-        @stock = stock
-        @packQuantity = packQuantity
-        @price = price
-      end
-    end
-
-    # {urn:TitleQuery}ArrayOfContributor
-    class ArrayOfContributor < ::Array
-      @@schema_type = "Contributor"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["item", ["Contributor", XSD::QName.new(nil, "item")]]]
-    end
-
-    # {urn:TitleQuery}ArrayOfProductIdentifier
-    class ArrayOfProductIdentifier < ::Array
-      @@schema_type = "ProductIdentifier"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["item", ["ProductIdentifier", XSD::QName.new(nil, "item")]]]
-    end
-
-    # {urn:TitleQuery}Product
-    class Product
-      @@schema_type = "Product"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["productIdentifiers", ["ArrayOfProductIdentifier", XSD::QName.new(nil, "ProductIdentifiers")]], ["title", ["Title", XSD::QName.new(nil, "Title")]], ["contributors", ["ArrayOfContributor", XSD::QName.new(nil, "Contributors")]], ["supplyDetail", ["SupplyDetail", XSD::QName.new(nil, "SupplyDetail")]]]
-
-      def ProductIdentifiers
-        @productIdentifiers
-      end
-
-      def ProductIdentifiers=(value)
-        @productIdentifiers = value
-      end
-
-      def Title
-        @title
-      end
-
-      def Title=(value)
-        @title = value
-      end
-
-      def Contributors
-        @contributors
-      end
-
-      def Contributors=(value)
-        @contributors = value
-      end
-
-      def SupplyDetail
-        @supplyDetail
-      end
-
-      def SupplyDetail=(value)
-        @supplyDetail = value
-      end
-
-      def initialize(productIdentifiers = nil, title = nil, contributors = nil, supplyDetail = nil)
-        @productIdentifiers = productIdentifiers
-        @title = title
-        @contributors = contributors
-        @supplyDetail = supplyDetail
-      end
-    end
-
-    # {urn:TitleQuery}SearchResults
-    class SearchResults
-      @@schema_type = "SearchResults"
-      @@schema_ns = "urn:TitleQuery"
-      @@schema_element = [["iSBN", ["SOAP::SOAPString", XSD::QName.new(nil, "ISBN")]], ["eAN", ["SOAP::SOAPString", XSD::QName.new(nil, "EAN")]], ["product", ["Product", XSD::QName.new(nil, "Product")]]]
-
-      def ISBN
-        @iSBN
-      end
-
-      def ISBN=(value)
-        @iSBN = value
-      end
-
-      def EAN
-        @eAN
-      end
-
-      def EAN=(value)
-        @eAN = value
-      end
-
-      def Product
-        @product
-      end
-
-      def Product=(value)
-        @product = value
-      end
-
-      def initialize(iSBN = nil, eAN = nil, product = nil)
-        @iSBN = iSBN
-        @eAN = eAN
-        @product = product
-      end
-    end
-  end
-end