dbpedia_concept_search 0.1.0

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Rob Nichols
+
+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,25 @@
+DbpediaConceptSearch
+====================
+
+A tool that queries dbpedia.org's lookup tool to find concepts, and then
+bundles the results into either ruby objects (using Hashie) or json.
+
+Usage
+-----
+
+The initial search is defined by creating a new DbpediaConceptSearch:
+
+    search = DbpediaConceptSearch.new('place', 'London')
+
+This will lead to a query matching [this](http://lookup.dbpedia.org/api/search.asmx/KeywordSearch?QueryClass=place&QueryString=London)
+
+Results
+-------
+
+The results method will return an array of objects. See lib/example.rb
+
+JSON
+----
+
+Use search.to_json to return a JSON representation of the data.
+

data/lib/dbpedia_concept_search.rb

@@ -0,0 +1,97 @@
+require 'typhoeus'
+require 'nori'
+require 'hashie'
+require 'json'
+
+class DbpediaConceptSearch
+  attr_reader :query_class, :query_string
+  
+  def initialize(query_class, query_string)
+    @query_class = query_class
+    @query_string = query_string
+  end
+  
+  def dbpedia_url
+    %Q{http://lookup.dbpedia.org/api/search.asmx/KeywordSearch?QueryClass=#{query_class}&QueryString=#{cleaned_query_string}}
+  end
+  
+  def cleaned_query_string
+    query_string.gsub(/\s/, '%20')
+  end
+  
+  def xml
+    @xml ||= response.body
+  end
+  
+  def response
+    @response ||= Typhoeus::Request.get(dbpedia_url)
+  end
+  
+  def results
+    hash_results_array.compact.collect{|result| Hashie::Mash.new(processed_hash(result))}
+  end
+  
+  def processed_hash(hash)
+    hash = infanticide(hash)
+    hash = downcase_hash(hash)
+  end
+  
+  def downcase_hash(hash)
+    if hash.kind_of? Hash
+      hash.each_with_object({}) do |(k, v), h|
+        h[k.downcase] = downcase_hash(v)
+        h.delete(k) unless k == k.downcase
+      end
+    elsif hash.kind_of? Array
+      hash.collect do |h| 
+        downcase_hash(h)
+      end
+    else
+      return hash
+    end
+  end
+  
+  def infanticide(hash)
+    if hash.kind_of?(Hash)
+      hash = collapse_singular_child_into_plural_parent(hash)
+      hash.each_with_object({}) do |(k, v), h|
+        h[k] = infanticide(v)
+      end
+      
+    end
+    if hash.kind_of?(Array)
+      hash.collect do |h|
+        infanticide(h)
+      end
+    else
+      return hash
+    end
+  end
+  
+  def hash_from_xml
+    @hash ||= Nori.parse(xml)
+  end
+  
+  def to_json
+    processed_hash(hash_results_array.compact).to_json
+  end
+  
+  def hash_results
+    hash_from_xml['ArrayOfResult']['Result']
+  end
+  
+  def hash_results_array
+    hash_results.kind_of?(Array) ? hash_results : [hash_results]
+  end
+  
+  def collapse_singular_child_into_plural_parent(hash)
+    parents = Hash.new
+    hash.each do |key, value| 
+      if value.kind_of?(Hash) and Regexp.new("^#{value.keys.first.gsub(/y\s*$/, 'i')}(s|es)") =~ key
+        parents[key] = value.values.first
+      end
+    end
+    hash.merge(parents)
+  end
+  
+end

data/lib/example.rb

@@ -0,0 +1,27 @@
+require_relative 'dbpedia_concept_search'
+
+search = DbpediaConceptSearch.new('person', 'Yukihiro Matsumoto ')
+
+puts "\nLabels for each result:"
+puts "======================="
+search.results.each{|result| puts "\t#{result.label}"}
+
+
+puts "\nDetails of first result"
+puts "======================="
+
+one = search.results.first
+puts " Label = #{one.label}"
+puts one.description
+puts " URI = #{one.uri}"
+
+puts " With Classes"
+one.classes.each do |klass|
+  puts "   URI = #{klass.uri}"
+end
+
+puts "\ and Caterogies"
+one.categories.each do |category|
+  puts "   #{category.label}"
+end
+

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: dbpedia_concept_search
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Rob Nichols
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-16 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: &12501460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *12501460
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &12501020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *12501020
+- !ruby/object:Gem::Dependency
+  name: nori
+  requirement: &12500300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *12500300
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: &12499800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *12499800
+description: A tool that queries dbpedia.org's lookup tool to find concepts, and then
+  bundles the results into either ruby objects (using Hashie) or json.
+email: rob@undervale.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- LICENSE
+- lib/dbpedia_concept_search.rb
+- lib/example.rb
+homepage: https://github.com/reggieb/DbpediaConceptSearch
+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.10
+signing_key: 
+specification_version: 3
+summary: Dbpedia Concept Search queries dbpedia.org's lookup tool to find concepts
+test_files: []