evri 0.03

data/History.txt

@@ -0,0 +1,6 @@
+=== 0.0.1 / 2008-09-25
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,15 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+TODO
+evri-api.gemspec
+lib/evri.rb
+lib/evri/entity.rb
+lib/evri/media.rb
+lib/evri/relation.rb
+lib/evri/zeitgeist.rb
+test/test_entity.rb
+test/test_evri.rb
+test/test_media.rb
+test/test_zeitgeist.rb

data/README.txt

@@ -0,0 +1,48 @@
+= evri-api
+
+* http://github.com/joevandyk/evri-api
+
+== DESCRIPTION:
+
+A beautiful API that wraps the RESTful services provided by evri.com.
+
+== FEATURES/PROBLEMS:
+
+None yet.
+
+== SYNOPSIS:
+
+None yet.
+
+== REQUIREMENTS:
+
+none yet.
+
+== INSTALL:
+
+gem install evri-api
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Joe Van Dyk
+
+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,22 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/evri.rb'
+
+Hoe.new('evri', Evri::VERSION) do |p|
+  p.rubyforge_name = 'evri-api'
+  p.developer('Joe Van Dyk', 'joe@@fixieconsulting.com')
+  p.extra_deps = [:json]
+  p.extra_dev_deps = [:mocha]
+end
+
+task :github do
+  data = `rake check_manifest | sed 1d`
+  IO.popen("patch -p0 Manifest.txt", "w") do |p|
+    p << data
+  end
+  `rake debug_gem | sed 1d > evri-api.gemspec`
+end
+
+# vim: syntax=Ruby

data/TODO

@@ -0,0 +1,13 @@
+STUFF LEFT TO DO
+
+* Handle Query Tokens
+  - QTs are initially generated here:
+    - query token for whole medias/entity document
+    - query token for each entity in the returned results of ^
+    - query token for each pair of entities in above ^
+  - Then pass them into the calls that can take them (and handle the returned QTs)
+
+* Refactor code to make Resource and JSON handling flexible (after API is done)
+
+* Ability to batch requests (via threading)
+  - see how facebooker does it

data/evri-api.gemspec

@@ -0,0 +1,39 @@
+Gem::Specification.new do |s|
+  s.name = %q{evri}
+  s.version = "0.03"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Joe Van Dyk"]
+  s.date = %q{2008-10-27}
+  s.description = %q{A beautiful API that wraps the RESTful services provided by evri.com.}
+  s.email = ["joe@@fixieconsulting.com"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.txt"]
+  s.files = ["History.txt", "Manifest.txt", "README.txt", "Rakefile", "TODO", "evri-api.gemspec", "lib/evri.rb", "lib/evri/entity.rb", "lib/evri/media.rb", "lib/evri/relation.rb", "lib/evri/zeitgeist.rb", "test/test_entity.rb", "test/test_evri.rb", "test/test_media.rb", "test/test_zeitgeist.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/joevandyk/evri-api}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{evri}
+  s.rubygems_version = %q{1.2.0}
+  s.summary = %q{A beautiful API that wraps the RESTful services provided by evri.com.}
+  s.test_files = ["test/test_media.rb", "test/test_zeitgeist.rb", "test/test_entity.rb", "test/test_evri.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if current_version >= 3 then
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<mocha>, [">= 0"])
+      s.add_development_dependency(%q<hoe>, [">= 1.7.0"])
+    else
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<mocha>, [">= 0"])
+      s.add_dependency(%q<hoe>, [">= 1.7.0"])
+    end
+  else
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<mocha>, [">= 0"])
+    s.add_dependency(%q<hoe>, [">= 1.7.0"])
+  end
+end

data/lib/evri/entity.rb

@@ -0,0 +1,240 @@
+module Evri
+  # Represents an Evri Entity.
+  class Entity
+    attr_reader :properties
+
+    # Finds a specific entity, given an ID.
+    def self.find id
+      @entended_properties = true
+      @results ||= {}
+      id = "/" + id unless id =~ /\A\//
+      return @results[id] if @results[id]
+      @results[id] = create_from_json do 
+        Evri.query(:type => :uri, :query => id) 
+      end
+    end
+
+    # Searches for an exact match.
+    def self.search name
+      create_from_jsons do
+        Evri.query(:type => :search, :query => name)
+      end
+    end
+
+    # Searches for a partial match.  i.e. 'ob' will return 'Obama'.
+    def self.search_by_prefix prefix
+      create_from_jsons do
+        Evri.query(:type => :prefix, :query => prefix)
+      end
+    end
+
+    # Given a :uri and :text options, return the related entities.
+    def self.from_media options={}
+      uri, text = options[:uri], options[:text]
+      raise ArgumentError, "Must specify URI via the :uri option" unless uri
+      raise ArgumentError, "Must specify some text via the :text option" unless text
+
+      json = Evri.parse_json(Evri.query(:type => :from_media, :uri => uri, :text => text))
+      json["graph"]["entities"].map do |e, entity_json|
+        Entity.new entity_json
+      end
+    end
+
+    # Returns where the information for this entity came from.
+    def source_url
+      @source_url
+    end
+
+    # Returns information about an entity.
+    # i.e obama.info(:birth_date)
+    def info option=nil
+      @properties ||= {}
+      if defined?(@extended_properties) 
+        if option
+          @properties[option]
+        else
+          @properties
+        end
+      else
+        @properties = Entity.find(uri).properties
+        @extended_properties = true
+        info(option)
+      end
+    end
+
+    def to_s
+      "#{name} (#{ id })"
+    end
+
+    def inspect
+      "#<Evri::Entity:#{to_s}>"
+    end
+
+    # Returns the name of the entity
+    def name
+      @parsed_json["name"]["$"] || @parsed_json["name"]
+    end
+
+    def initialize json
+      @parsed_json  = json
+      @relations    = []
+      @source_url = Evri.source_url
+      if json["properties"]
+        set_properties json["properties"]
+      end
+    end
+
+    def == b
+      self.id == b.id
+    end
+
+    # Returns the Evri URI of the entity
+    def href
+      @parsed_json["@href"]
+    end
+
+    alias id href
+    alias uri href
+
+     # TODO
+    def target_href
+      @parsed_json["@targetHref"]
+    end
+
+    # Returns relationships for the entity
+    def relations options={}
+      from_domains = nil
+      if options[:from]
+        if options[:from].class == String
+          from_domains = options[:from]
+        else
+          from_domains = options[:from].join(',')
+        end
+      end
+      json = Evri.query(:type => :relations, :query => id, :from_domains => from_domains)
+      Evri.parse_json(json)["relations"].each do |type, relation_json|
+        next if type != 'relation'
+        relation_json.each do |r|
+          @relations << Relation.new(r)
+        end
+      end
+      @relations
+    end
+
+    # Returns which entities are related to the current entity
+    def related_by  options={}
+      media, verb, verb_value, entity, uri = nil, nil, nil, nil, nil
+      options.each do |key, value|
+        if key == :entity
+          entity = value 
+        elsif key == :uri
+          uri = value
+        elsif key == :type
+          media = value
+        else
+          verb = key
+          verb_value = value
+        end
+      end
+      @entities = []
+      json = Evri.query(:type => :related_by, :media => media, :query => id, :uri => uri, :entity => entity, :verb => verb, :value => verb_value)
+      Evri.parse_json(json)["relations"].each do |type, relation_json|
+        next if type != 'relation'
+        relation_json["targets"].each do |type, r|
+          r.each do |entity|
+            if entity.class == Hash
+              if entity["@href"]
+                @entities << Entity.new(entity)
+              end
+            end
+          end
+        end
+      end
+      @entities
+    end
+
+    # Returns images relating to the current entity
+    def images options={}
+      medias = []
+      if options[:entities]
+        entity_uris = options[:entities].map do |e|
+          if e.class == Evri::Entity
+            e.uri
+          else
+            e
+          end
+        end
+      end
+
+      json = Evri.parse_json(Evri.query(:type => :related_medias, :query => href, :entities => entity_uris, :media => 'image'))
+      # TODO handle images here
+      if json["mediaResult"]["imageList"]
+        json["mediaResult"]["imageList"]["image"].each do |media_json|
+          medias << Image.new(media_json)
+        end
+      end
+      medias
+    end
+
+    # Returns articles relating to the current entity
+    def articles options={}
+      medias = []
+      if options[:entities]
+        entity_uris = options[:entities].map do |e|
+          if e.class == Evri::Entity
+            e.uri
+          else
+            e
+          end
+        end
+      end
+
+      type = options[:type] ? options[:type] : nil
+      json = Evri.parse_json(Evri.query(:type => :related_medias, :query => href, :entities => entity_uris, :media => type))
+      if json["mediaResult"]["articleList"]
+        json["mediaResult"]["articleList"]["article"].each do |media_json|
+          medias << Article.new(media_json)
+        end
+      end
+      medias
+    end
+
+
+    private
+
+    def self.create_from_json json=nil, &block
+      begin
+        json = block.call if block
+        Entity.new Evri.parse_json(json)["entity"]
+      rescue Evri::Error => e
+        raise Evri::EntityNotFound.new(e.message)
+      end
+    end
+    
+    def self.create_from_jsons jsons=nil, &block
+      jsons = block.call if block
+      result = []
+      Evri.parse_json(jsons)["entities"].each  do |type, entity|
+        if entity.class == Array
+          entity.each do |e|
+            result << Entity.new(e)
+          end
+        else
+          result << Entity.new(entity)
+        end
+      end
+      result
+    end
+
+    def set_properties json
+      @properties = {}
+      json["property"].each do |prop|
+        if prop.class == Array
+          @properties[prop.first.to_sym] = prop.last["$"]
+        else
+          @properties[prop["name"]["$"].to_sym] = prop["value"]["$"]
+        end
+      end
+    end
+  end
+end

data/lib/evri/media.rb

@@ -0,0 +1,47 @@
+module Evri
+  class Media
+  end
+
+  # Represents an Article.
+  class Article < Media
+    attr_accessor :title, :href, :uri, :author, :published_at, :content
+    def initialize json
+      @title        = json["title"]["$"]
+      @author       = json["author"]["$"]
+      @content      = json["content"] ? json["content"]["$"] : "No content provided" 
+      @published_at = json["published"]["$"]
+      @href         = Evri.api_host + json["link"]["@href"]
+      @uri          = json["link"]["@hostName"] + json["link"]["@path"]
+    end
+  end
+
+  # Represents an Image.
+  class Image < Media
+    attr_accessor :size, :title, :article_href, :mime_type, :thumbnail, :date, :content, :width, :url, :click_url, :height
+    def initialize json
+      @title    = json["title"]
+      @width    = json["@width"]
+      @height   = json["@height"]
+      @url      = json["@url"]
+      @size      = json["size"]
+      @title      = json["title"]
+      @article_href      = json["articleHref"]["$"]
+      @mime_type      = json["mimeType"]
+      @date      = Date.parse(json["date"]["$"])
+      @content  = json["content"]["$"]
+      @click_url  = json["clickUrl"]["$"]
+      @thumbnail = Thumbnail.new(json["thumbnail"])
+    end
+
+    # Represents an Thumbnail for an Image.
+    class Thumbnail
+      attr_accessor :size, :width, :height, :url
+      def initialize json
+        @size    = json["size"]
+        @width    = json["@width"]
+        @height   = json["@height"]
+        @url      = json["@url"]
+      end
+    end
+  end
+end

data/lib/evri/relation.rb

@@ -0,0 +1,22 @@
+module Evri
+  # Represents a relation.
+  class Relation
+    attr_accessor :name, :href, :type
+    def initialize json
+      @name = json["name"]["$"]
+      @href = json["@href"]
+      @type = json["type"]["$"]
+      @entities = []
+    end
+
+    # Returns the entities in this relation.
+    def entities
+      return @entities unless @entities.empty?
+      json = JSON.parse(Evri.query(:type => :uri, :query => @href))
+      json["relations"]["relation"]["targets"]["entity"].each do |entity_json|
+        @entities << Entity.new(entity_json)
+      end
+      @entities
+    end
+  end
+end

data/lib/evri/zeitgeist.rb

@@ -0,0 +1,31 @@
+module Evri
+  # Returns information about a specific trend.
+  #
+  # To access the information, combine a TREND with a TYPE to form a class method.  
+  #
+  # i.e.
+  #
+  # * Zeitgeist.all_chemical
+  # * Zeitgeist.falling_person
+  # * Zeitgeist.popular_organization
+  #
+  # etc
+  class Zeitgeist
+
+    TYPES   = %w( animal backterium chemical concept disorder event location organization person plant product virus )
+    TRENDS  = %w( all popular rising falling )
+
+    TRENDS.each do |t|
+      TYPES.each do |et|
+        eval %(
+          def self.#{t}_#{et}
+            json =  Evri.parse_json(Evri.query :type => :zeitgeist, :query => "#{et}/#{t}")
+            json["zeitgeist"]["#{t}"]["entities"]["entity"].map do |entity_json|
+              Entity.new(entity_json)
+            end
+          end
+        )
+      end
+    end
+  end
+end

data/lib/evri.rb

@@ -0,0 +1,144 @@
+$: << File.dirname(__FILE__) 
+
+require 'uri'
+require 'net/http'
+require 'cgi'
+
+begin
+  require 'rubygems' 
+rescue LoadError 
+  nil
+end
+
+require 'json'
+
+for file in Dir[File.join(File.dirname(__FILE__), 'evri', '*')]
+  require file
+end
+
+module Evri
+
+  # A general error.
+  class Error < Exception; end
+  
+  # Raised whenever the entity you are searching for cannot be found.
+  class EntityNotFound < Error; end
+
+  VERSION     = "0.03"
+  @@api_host    = "api.evri.com"
+  @@source_host  = @@api_host
+  @@source_url   = nil
+
+  # Sets the hostname for the Evri API.
+  def self.api_host= host
+    @@api_host = validate_host(host)
+  end
+
+  # Returns the hostname for the Evri API.
+  def self.api_host
+    @@api_host
+  end
+
+  # Returns the source host for the Evri API
+  def self.source_host
+    @@source_host
+  end
+
+  # Returns the source host for the Evri API
+  def self.source_host= host
+    @@source_host = validate_host(host)
+  end
+
+  # Returns the source url for the Evri API
+  def self.source_url
+    @@source_url
+  end
+
+  # Parses JSON data
+  def self.parse_json json
+    begin
+      JSON.parse(json)
+    rescue JSON::ParserError => e
+      # puts "Error!"
+      # puts e.message
+      # puts json
+      raise Error.new(e)
+    end
+  end
+
+  # TODO Rewrite
+  def self.query options={}
+    query = ""
+    case options[:type]
+    when :uri
+      path = options[:query]
+    when :relations
+      path = options[:query] + "/relations"
+      if options[:from_domains]
+        query = "includeDomain=#{options[:from_domains]}"
+      end
+    when :related_by
+      if options[:uri]
+        path = options[:query] + "/related/entities"
+        query = "uri=#{escape(options[:uri])}"
+      else
+        path = options[:query] + "/relations"
+        if options[:verb]
+          path += "/#{options[:verb]}/#{escape(options[:value])}"
+          if options[:entity]
+            path += options[:entity].href
+          end
+        end
+        if options[:media]
+          query += "media=#{options[:media]}"
+        end
+      end
+    when :zeitgeist
+      path = "/zeitgeist/entities/" + options[:query]
+    when :related_medias
+      path = options[:query] + "/media/related"
+      if options[:entities]
+        query = options[:entities].map do |e|
+          "entityURI=#{e}&"
+        end
+        query = query.join
+      end
+      query += "type=#{options[:media]}" if options[:media]
+    when :from_media
+      path = "/media/entities"
+      query = "uri=#{escape(options[:uri])}&text=#{escape(options[:text])}"
+    when :search
+      path  = "/entities/find"
+      query = "name=#{escape(options[:query])}"
+    when :prefix
+      path  = "/entities/find"
+      query = "prefix=#{escape(options[:query])}"
+    else
+      raise ArgumentError, "unexpected type #{ options[:type] }"
+    end
+    query = nil if query.empty?
+    uri   = URI::HTTP.build :host => self.api_host, :path => path + '.json', :query => query
+    # puts "getting #{ uri }"
+    response = Net::HTTP.get_response(uri)
+    raise Error.new("unexpected http response: #{ response.code }") unless response.code == "200"
+    @@source_url = @@source_host + uri.request_uri
+    response.body
+  end
+
+  # Escapes CGI text
+  def self.escape text
+    text ? CGI.escape(text.to_s) : ''
+  end
+
+  private
+
+  def self.validate_host host
+    host = host.to_s
+    begin
+      URI::HTTP.build(:host => host)
+      host
+    rescue URI::InvalidComponentError
+      raise ArgumentError.new("Invalid host name specified (#{host}).  Use something like 'api.evri.com'")
+    end
+  end
+end

data/test/test_entity.rb

@@ -0,0 +1,144 @@
+require 'test/unit'
+require 'lib/evri'
+require 'mocha'
+
+class TestEntity < Test::Unit::TestCase
+  BARACK_ID   = "/person/barack-obama-0x16f69"
+  MICHELLE_ID = "person/michelle-obama-0x4c6e8" # Works without leading slash
+  MCCAIN_ID   = "/person/john-mccain-0x2a2a7"
+
+  def setup
+    @obama    = Evri::Entity.find BARACK_ID
+    @michelle = Evri::Entity.find MICHELLE_ID
+    @mccain   = Evri::Entity.find MCCAIN_ID
+  end
+
+  def test_failed_http_get_raises_good_error
+    bad_response = stub(:code => "500")
+    Net::HTTP.expects(:get_response).returns(bad_response)
+    assert_raises(Evri::Error) { @obama.relations }
+  end
+
+  # Ensure that when we search for Barack, we get the @obama and @michelle objects returned
+  def test_class_find
+    results = Evri::Entity.search "obama"
+    [@obama, @michelle].each do |person|
+      assert results.include?(person), "Expected search to contain #{ person }"
+    end
+  end
+
+  def test_find_raises_for_missing_ids
+    assert_raises(Evri::EntityNotFound) { Evri::Entity.find "crap" }
+  end
+
+  def test_failed_search_returns_empty_array
+    assert Evri::Entity.search("asdfasdfasdfasdfjlskdjflkasdjfkljasdklfjkladsjfklajsdl;kfjlaksdjfadklsjfkladsjlfkjasdfkljas#").empty?
+  end
+
+  def test_class_find_with_prefix
+    results = Evri::Entity.search_by_prefix "ob"
+    assert results.include?(@obama), "Expected search to contain #{ @obama }"
+  end
+
+  def test_name
+    assert_equal @obama.name, "Barack Obama"
+  end
+
+  def test_id
+    assert_equal @obama.id, BARACK_ID
+  end
+
+  def test_properties
+    vandyk_parks = Evri::Entity.find "/person/van-dyke-parks-0x16b10"
+    assert vandyk_parks.info(:occupation).include?("Composer")
+  end
+
+  def test_properties_from_search
+    vandyk_parks = Evri::Entity.search_by_prefix("van dyke parks").first
+    assert vandyk_parks.info(:occupation).include?("Composer")
+  end
+
+  def test_properties_from_related_by
+    loaded_entity = @obama.related_by(:verb => :kill).first
+    assert loaded_entity.info(:name) 
+  end
+
+  def test_relations
+    assert @obama.relations.find { |r| r.name == "US Politician" }
+    assert @obama.relations.find { |r| r.href == "#{@obama.href}/relations/facet/politician" }
+  end
+
+  def test_related_by_from_uri
+    # Sends right data, but bug in API prevents it from knowing about the URI
+    # assert !@obama.related_by(:uri => "www.boston.com/news/nation/articles/2008/10/23/obama_takes_campaign_break_to_visit_ill_grandmother/?rss_id=Boston.com+--+Latest+news")
+  end
+
+  def test_relations_from_domains
+    assert !@obama.relations(:from => "time.com").empty?
+    assert !@obama.relations(:from => ["time.com", "nytimes.com"]).empty?
+  end
+
+  def test_relations_with_type
+    # TODO tests
+    @obama.related_by(:verb => :kill, :type => :image)
+  end
+
+  def test_relations_related_to
+    # TODO tests
+    @obama.related_by(:facet => :musical_artist)
+    @obama.related_by(:qt => "joined-by-0x78")
+    @mccain.related_by(:verb => :kill, :entity => @obama)
+    @obama.related_by(:facet => :politician, :entity => @mccain)
+  end
+
+  def test_source_url
+    dude = @obama.related_by(:facet => :politician).first
+    assert_equal "#{Evri.source_host}#{@obama.uri}/relations/facet/politician.json", dude.source_url
+  end
+
+  def test_media_related_to_entities_about_an_entity
+    # articles takes either entities or entity URIs
+    # NOTE: the plural of 'media' is 'media'
+    medias = @obama.articles(:entities => [@mccain, "/person/bill-ayers-0x27a65"])
+    assert medias.size > 1
+  end
+
+  def test_medias_with_type_of_image
+    image = @obama.images.first
+    %w( size title article_href mime_type thumbnail date content width url click_url height).each do |field|
+      assert image.send(field), "Expected #{ image.inspect }'s #{ field } field to be larger than zero"
+    end
+    %w( size width height url).each do |field|
+      assert image.thumbnail.send(field), "Expected #{ image.thumbnail.inspect }'s #{ field } field to be larger than zero"
+    end
+  end
+
+  def test_relations_loading
+    politician_relation = @obama.relations.find { |r| r.name == "US Politician" }
+    assert politician_relation.entities.include?(@mccain)
+  end
+
+  def test_relations_with_verb
+    entities = @obama.related_by(:verb => :attack)
+    assert entities.first.target_href.include?("attack")
+
+    assert @obama.related_by(:qt => "joined-by-0x78").find { |e| e.name == "Joe Biden" }
+
+    assert  @obama.related_by(:facet => :politician).include?(@mccain)
+  end
+
+  def test_media
+    media = @obama.articles.first
+    # check for media.title, media.uri, etc
+    %w( title author published_at content href uri).each do |field|
+      assert media.send(field).size > 0, "Expected #{ media.inspect }'s #{ field } field to be larger than zero"
+    end
+  end
+
+  def test_find_by_media
+    uri = "http://www.reuters.com/article/industryNews/idUSTRE4981RO20081009"
+    dreamworks = Evri::Entity.find "/organization/dreamworks-0x3c510"
+    entities = Evri::Entity.from_media(:uri => uri, :text => "Dreamworks")
+    assert entities.include?(dreamworks)
+  end
+end

data/test/test_evri.rb

@@ -0,0 +1,35 @@
+require 'test/unit'
+require 'lib/evri'
+require 'mocha'
+
+class TestModuleEvri < Test::Unit::TestCase
+  def test_setting_invalid_new_api_host
+    remember_original_settings(:api_host) do
+      assert_raise(ArgumentError) { Evri.api_host = "http://slashdot.org" }
+      assert_raise(ArgumentError) { Evri.api_host = "Joe's Cat" }
+      assert_raise(ArgumentError) { Evri.api_host = 3 }
+    end
+  end
+
+  def test_setting_new_api_host
+    remember_original_settings(:api_host) do
+      Evri.api_host = "new.api.evri.com"
+      assert_equal Evri.api_host, "new.api.evri.com"
+    end
+  end
+
+  def test_source_host
+    remember_original_settings(:source_host) do
+      Evri.source_host = "new.api.evri.com"
+      assert_equal Evri.source_host, "new.api.evri.com"
+    end
+  end
+
+  private
+
+  def remember_original_settings method
+    original = Evri.send method
+    yield ensure Evri.send"#{method}=", original
+  end
+end
+

data/test/test_media.rb

@@ -0,0 +1,10 @@
+require 'test/unit'
+require 'lib/evri'
+
+class TestMedia < Test::Unit::TestCase
+  BARACK_ID   = "person/barack-obama-0x16f69"
+
+  def test_this
+  end
+
+end

data/test/test_zeitgeist.rb

@@ -0,0 +1,19 @@
+require 'test/unit'
+require 'lib/evri'
+
+class TestZeitgeist < Test::Unit::TestCase
+  BARACK_ID   = "person/barack-obama-0x16f69"
+
+  def setup
+    @obama    = Evri::Entity.find BARACK_ID
+  end
+
+  def test_popular_person
+    assert Evri::Zeitgeist.popular_person.include?(@obama)
+  end
+
+  def test_falling_product
+    # just check to see that the first falling product's name is not blank.
+    assert Evri::Zeitgeist.falling_product.first.name.size > 0
+  end
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification 
+name: evri
+version: !ruby/object:Gem::Version 
+  version: "0.03"
+platform: ruby
+authors: 
+- Joe Van Dyk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-31 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: :json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: :mocha
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.2
+    version: 
+description: A beautiful API that wraps the RESTful services provided by evri.com.
+email: 
+- joe@@fixieconsulting.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- TODO
+- evri-api.gemspec
+- lib/evri.rb
+- lib/evri/entity.rb
+- lib/evri/media.rb
+- lib/evri/relation.rb
+- lib/evri/zeitgeist.rb
+- test/test_entity.rb
+- test/test_evri.rb
+- test/test_media.rb
+- test/test_zeitgeist.rb
+has_rdoc: true
+homepage: http://github.com/joevandyk/evri-api
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: evri-api
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A beautiful API that wraps the RESTful services provided by evri.com.
+test_files: 
+- test/test_entity.rb
+- test/test_evri.rb
+- test/test_zeitgeist.rb
+- test/test_media.rb