wreckster 1.0.0

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/CHANGELOG.rdoc

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2010-05-26
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,12 @@
+.autotest
+CHANGELOG.rdoc
+Manifest.txt
+README.rdoc
+Rakefile
+lib/wreckster.rb
+lib/wreckster/graph.rb
+lib/wreckster/object.rb
+lib/wreckster/traversal.rb
+test/helper.rb
+test/test_object.rb
+test/test_wreckster.rb

data/README.rdoc

@@ -0,0 +1,63 @@
+= wreckster
+
+* http://github.com/tenderlove/wreckster
+
+== DESCRIPTION:
+
+Wreckster is an API for accessing
+Rexster[http://wiki.github.com/tinkerpop/rexster/].
+
+== FEATURES/PROBLEMS:
+
+* Lists graph traversals
+* Accesses Rank based traversals
+
+
+== SYNOPSIS:
+
+  graph = Wreckster::Graph.new('http://localhost:8182/')
+
+  # List the traversals available in this graph server
+  graph.traversals.each do |t|
+    puts t.name
+  end
+
+  # Execute a traversal with some parameters
+  traversal = graph.traversals.first
+  traversal.find('song.name' => 'SUGAREE').each do |song|
+    p song
+  end
+
+== REQUIREMENTS:
+
+* json
+* net-http-persistent
+
+== INSTALL:
+
+* sudo gem install wreckster
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2010 Aaron Patterson
+
+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/Rakefile

@@ -0,0 +1,15 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.spec 'wreckster' do
+  developer('Aaron Patterson', 'aaron@tenderlovemaking.com')
+  self.readme_file   = 'README.rdoc'
+  self.history_file  = 'CHANGELOG.rdoc'
+  self.extra_rdoc_files  = FileList['*.rdoc']
+  self.extra_deps       << ['net-http-persistent', '~> 1.2.1']
+  self.extra_deps       << ['json', '>= 0']
+end
+
+# vim: syntax=ruby

data/lib/wreckster.rb

@@ -0,0 +1,16 @@
+require 'json'
+require 'net/http'
+require 'net/http/persistent'
+require 'uri'
+require 'wreckster/graph'
+require 'wreckster/traversal'
+require 'wreckster/object'
+
+module Wreckster
+  VERSION = '1.0.0'
+
+  @connection = Net::HTTP::Persistent.new
+  class << self
+    attr_accessor :connection
+  end
+end

data/lib/wreckster/graph.rb

@@ -0,0 +1,19 @@
+module Wreckster
+  class Graph
+    def initialize url
+      @url     = url
+      @payload = nil
+    end
+
+    def traversals
+      t = payload['traversals']
+      t = t.keys if Hash === t
+      t.map { |name| Traversal.new(@url, name) }
+    end
+
+    private
+    def payload
+      @payload ||= JSON.parse Wreckster.connection.request(URI.parse(@url)).body
+    end
+  end
+end

data/lib/wreckster/object.rb

@@ -0,0 +1,22 @@
+module Wreckster
+  class Object
+    attr_reader :identifier, :rank, :type
+
+    def initialize traversal, properties
+      @traversal  = traversal
+      @properties = properties
+      @identifier = properties['_id']
+      @rank       = properties[traversal]
+      @type       = properties['type']
+    end
+
+    def respond_to? key
+      @properties.key?(key.to_s) || super
+    end
+
+    def method_missing key, *args
+      return super unless respond_to? key
+      @properties[key.to_s]
+    end
+  end
+end

data/lib/wreckster/traversal.rb

@@ -0,0 +1,26 @@
+module Wreckster
+  class Traversal
+    attr_reader :name
+
+    def initialize base, name
+      @base = base
+      @name = name
+    end
+
+    def find options = {}
+      params = options.map { |k,v| "#{k}=#{v}" }.join("&")
+      map = JSON.parse(
+        Wreckster.connection.request(URI.parse(url + "?#{params}")).body
+      )
+      map['ranks'].map { |thing| Wreckster::Object.new(name, thing) }
+    end
+
+    def info
+      JSON.parse Net::HTTP.get(URI.parse(url))
+    end
+
+    def url
+      @base + @name
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,21 @@
+require "test/unit"
+require "wreckster"
+
+module Wreckster
+  class FakeConnector
+    attr_accessor :last_url, :responses
+
+    def initialize
+      @last_url  = nil
+      @responses = []
+    end
+
+    def request url
+      @last_url = url
+      @responses.pop
+    end
+
+  end
+  Response = Struct.new(:body)
+  Wreckster.connection = FakeConnector.new
+end

data/test/test_object.rb

@@ -0,0 +1,32 @@
+require 'helper'
+
+module Wreckster
+  class TestObject < Test::Unit::TestCase
+    def test_identifier
+      obj = Wreckster::Object.new 'foo', '_id' => 100
+      assert_equal 100, obj.identifier
+    end
+
+    def test_rank
+      obj = Wreckster::Object.new 'foo', 'foo' => 100
+      assert_equal 100, obj.rank
+    end
+
+    def test_type
+      obj = Wreckster::Object.new 'foo', 'type' => 'america'
+      assert_equal 'america', obj.type
+    end
+
+    def test_responds_to?
+      obj = Wreckster::Object.new 'foo', 'hello' => 'world'
+      assert obj.respond_to?(:hello), 'responds to hello'
+      assert !obj.respond_to?(:world), 'does not respond to world'
+    end
+
+    def test_method_missing
+      obj = Wreckster::Object.new 'foo', 'hello' => 'world'
+      assert_equal 'world', obj.hello
+      assert_raises(NoMethodError) { obj.world }
+    end
+  end
+end

data/test/test_wreckster.rb

@@ -0,0 +1,48 @@
+require 'helper'
+
+module Wreckster
+  class TestWreckster < Test::Unit::TestCase
+    def setup
+      @url = 'http://localhost:8182/'
+    end
+
+    def test_traversals
+      conn.responses << Response.new(traversal_response)
+
+      graph = Wreckster::Graph.new('http://localhost:8182/')
+      traversals = graph.traversals
+      assert_equal 5, traversals.length
+      assert_equal 0, conn.responses.length
+
+      response = JSON.parse traversal_response
+      assert_equal response['traversals'].sort, traversals.map { |t| t.name }.sort
+    end
+
+    def test_traversal
+      conn.responses << Response.new(find_response)
+
+      t    = Wreckster::Traversal.new @url, 'grateful/co-follows-rank'
+      objs = t.find('song.name' => 'SUGAREE', 'offset.end' => 2)
+
+      assert_equal 2, objs.length
+      assert_equal %w{ song song }, objs.map { |o| o.type }
+      assert_equal [5.0, 8.0], objs.map { |o| o.rank }
+    end
+
+    def conn
+      Wreckster.connection
+    end
+
+    def traversal_response
+      <<-eojson
+    {"query_time":0,"name":"Wreckster: A Graph-Based Ranking Engine","up_time":"0[d]:00[h]:54[m]:43[s]","traversals":["grateful\/singer-writer-rank","grateful\/follows-score","grateful\/co-follows-rank","gremlin","grateful\/artist-rank"]}
+      eojson
+    end
+
+    def find_response
+      <<-eojson
+    {"ranks":[{"grateful\/co-follows-rank":5.0,"_id":"35","name":"WAY TO GO HOME","song_type":"original","performances":92,"type":"song"},{"grateful\/co-follows-rank":8.0,"_id":"36","name":"SAINT OF CIRCUMSTANCE","song_type":"original","performances":222,"type":"song"}],"query_time":1,"success":true,"size":2,"total_rank":2777.0}
+      eojson
+    end
+  end
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification 
+name: wreckster
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Aaron Patterson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-01 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: net-http-persistent
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 1
+        version: 1.2.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rubyforge
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 4
+        version: 2.0.4
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 6
+        - 0
+        version: 2.6.0
+  type: :development
+  version_requirements: *id004
+description: |-
+  Wreckster is an API for accessing
+  Rexster[http://wiki.github.com/tinkerpop/rexster/].
+email: 
+- aaron@tenderlovemaking.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- Manifest.txt
+- CHANGELOG.rdoc
+- README.rdoc
+files: 
+- .autotest
+- CHANGELOG.rdoc
+- Manifest.txt
+- README.rdoc
+- Rakefile
+- lib/wreckster.rb
+- lib/wreckster/graph.rb
+- lib/wreckster/object.rb
+- lib/wreckster/traversal.rb
+- test/helper.rb
+- test/test_object.rb
+- test/test_wreckster.rb
+has_rdoc: true
+homepage: http://github.com/tenderlove/wreckster
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: wreckster
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Wreckster is an API for accessing Rexster[http://wiki.github.com/tinkerpop/rexster/].
+test_files: 
+- test/test_object.rb
+- test/test_wreckster.rb