eoflife 0.1.0.pre

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rvmrc

@@ -0,0 +1 @@
+rvm --create 1.9.2-p180@eoflife

data/Gemfile

@@ -0,0 +1,17 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+gem "httparty", "~> 0.7"
+gem "hashie", "~> 1.0.0"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "yard", "~> 0.6.0"
+  gem "cucumber", ">= 0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.2"
+  gem "rcov", ">= 0"
+  gem "webmock", ">= 1.6.2"
+end

data/Gemfile.lock

@@ -0,0 +1,53 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.4)
+    builder (3.0.0)
+    crack (0.1.8)
+    cucumber (0.10.0)
+      builder (>= 2.1.2)
+      diff-lcs (~> 1.1.2)
+      gherkin (~> 2.3.2)
+      json (~> 1.4.6)
+      term-ansicolor (~> 1.0.5)
+    diff-lcs (1.1.2)
+    gherkin (2.3.4)
+      json (~> 1.4.6)
+    git (1.2.5)
+    hashie (1.0.0)
+    httparty (0.7.4)
+      crack (= 0.1.8)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    json (1.4.6)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    term-ansicolor (1.0.5)
+    webmock (1.6.2)
+      addressable (>= 2.2.2)
+      crack (>= 0.1.7)
+    yard (0.6.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  cucumber
+  hashie (~> 1.0.0)
+  httparty (~> 0.7)
+  jeweler (~> 1.5.2)
+  rcov
+  rspec (~> 2.3.0)
+  webmock (>= 1.6.2)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Marc Chung
+
+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.rdoc

@@ -0,0 +1,47 @@
+eoflife - API for EOL.org/API
+=============================
+
+## Description
+
+The eoflife rubygem is a wrapper for eol.org/api. API development is currently a work in progress.
+
+## Synopsis
+
+    eol = Eoflife::Client.new
+    eol.ping #=> Hash response
+    eol.search("Western Honeybee") #=> Hash response
+
+## Getting Started
+
+Use RubyGems to install the Eoflife gem
+
+    $ gem install eoflife
+
+## Installing on Rails 3
+
+Add this to your `Gemfile`:
+
+    gem "eoflife"
+
+## Contributing to eoflife
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Thanks
+
+ * www.eol.org
+
+## See Also
+
+ * [EOL API documentation](http://www.eol.org/api)
+
+## Copyright
+
+Copyright (c) 2011 Marc Chung. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+require './lib/eoflife/version'
+
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "eoflife"
+  gem.homepage = "http://github.com/mchung/eoflife"
+  gem.license = "MIT"
+  gem.summary = %Q{API for the Encylopedia of Life}
+  gem.description = %Q{Programmatic access to the Encylopedia of Life's API}
+  gem.email = "mchung@gmail.com"
+  gem.authors = ["Marc Chung"]
+  gem.version = Eoflife::Version::STRING
+
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/examples/pages.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'eoflife'
+
+client = Eoflife::Client.new
+# rv = client.pages("328672", {:images => 6, :vetted => 1, :format => "html"})
+# rv = client.pages("1045608", {:common_names => "1", :details => "1", :images => "2", :subjects => "all", :text => "2"})
+rv = client.pages("1045608", {:details => "1", :subjects => "all"})
+pp [:response, rv]

data/examples/ping.rb

@@ -0,0 +1,7 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'eoflife'
+
+client = Eoflife::Client.new
+rv = client.ping
+puts rv.response.message

data/examples/search.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'eoflife'
+
+client = Eoflife::Client.new
+pp client.search("lion")
+
+# pp client.search("lion", {:page => 1, :exact => 1})

data/lib/eoflife.rb

@@ -0,0 +1,12 @@
+require 'httparty'
+require 'hashie'
+require 'uri'
+
+require 'pp'
+
+module Eoflife
+
+end
+
+require 'eoflife/error'
+require 'eoflife/client'

data/lib/eoflife/client.rb

@@ -0,0 +1,57 @@
+module Eoflife
+  class Client
+    include HTTParty
+    base_uri "http://www.eol.org/api"
+
+    # Pings the API
+    #
+    # @see http://www.eol.org/api/docs/ping
+    # @return [Hashie::Mash] Success or failure results
+    def ping
+      handle_response self.class.get("/ping.json")
+    end
+    
+    # Searches EOL
+    #
+    # @see http://www.eol.org/api/docs/search
+    # @param [String] search_query The species you're looking for.
+    # @param [Hash] query_options The QUERY_STRING as a hash
+    # @option query_options [String] :page Limits the number of returned image objects, 0-75. 
+    # @option query_options [String] :exact will find taxon pages if the preferred name or any synonym or common name exactly matches the search term, `0` or `1`
+    # @return [Hashie::Mash] Parsed OpenSearch query
+    def search(search_query, query_options = {})
+      s = URI.escape(search_query)
+      handle_response self.class.get("/search/1.0/#{s}.json", :query => query_options)
+    end
+    
+    # Pages returns the scientific name for that page, and optionally returns information 
+    # about common names, media (text, images and videos), and references to the hierarchies 
+    # which recognize the taxon described on the page.
+    #
+    # @see http://www.eol.org/api/docs/pages
+    # @param [String] taxon_id The taxon ID
+    # @param [Hash] query_options The QUERY_STRING as a hash
+    # @option query_options [String] :images Limits the number of returned image objects, `0` to `75`
+    # @option query_options [String] :videos Limits the number of returned videos objects, `0` to `75`
+    # @option query_options [String] :text Limits the number of returned text objects, `0` to `75`
+    # @return [Hashie::Mash] the scientific name for that page
+    def pages(taxon_id, query_options = {})
+      handle_response self.class.get("/pages/1.0/#{taxon_id}.json", :query => query_options)
+    end
+
+    # @private
+    def handle_response(response)
+      # case response.code
+      # when 400...500
+      #   raise Error.new(response)
+      # else
+      #   response
+      # end
+      if response.is_a?(Array)
+        response.map{|item| Hashie::Mash.new(item)}
+      else
+        Hashie::Mash.new(response)
+      end
+    end
+  end
+end

data/lib/eoflife/error.rb

@@ -0,0 +1,10 @@
+module Eoflife
+  class Error < StandardError
+    attr_reader :data
+
+    def initialize(data)
+      @data = data
+      super
+    end
+  end
+end

data/lib/eoflife/version.rb

@@ -0,0 +1,10 @@
+class Eoflife
+  module Version
+    MAJOR = 0
+    MINOR = 1
+    PATCH = 0
+    BUILD = 'pre'
+
+    STRING = [MAJOR, MINOR, PATCH, BUILD].compact.join('.')
+  end
+end

data/spec/eoflife_spec.rb

@@ -0,0 +1,30 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Eoflife" do
+
+  before(:each) do
+    @client = Eoflife::Client.new
+  end
+
+  it "should #ping" do
+    stub_endpoint("http://www.eol.org/api/ping.json", "ping.json")
+      
+    r = @client.ping
+    r.response.message.should == "Success"
+  end
+
+  it "should #search" do
+    stub_endpoint("http://www.eol.org/api/search/1.0/Ursus.json?", "search.json")  
+      
+    r = @client.search("Ursus")
+    r.totalResults.should == 126
+  end
+
+  # it "should fetch #pages" do
+  #   stub_endpoint("http://www.eol.org/api/pages/1.0/1045608.json?", "pages.json")  
+  #     
+  #   r = @client.pages("1045608", {:common_names => 1, :details => 1, :images => 2, :subjects => "all", :text => 2})
+  #   r.taxonConcepts[0].sourceIdentfier.should == 154396
+  # end
+
+end

data/spec/fixtures/pages.json

@@ -0,0 +1,378 @@
+{
+    "taxonConcepts":
+    [
+        {
+            "sourceIdentfier":"154396",
+            "nameAccordingTo":"Integrated Taxonomic Information System (ITIS)",
+            "scientificName":"Apis mellifera Linnaeus 1758",
+            "identifier":20451196
+        },
+        {
+            "sourceIdentfier":"1926761",
+            "nameAccordingTo":"Species 2000 & ITIS Catalogue of Life: Annual Checklist 2009",
+            "scientificName":"Apis mellifera Linnaeus 1758",
+            "identifier":25435626
+        },
+        {
+            "sourceIdentfier":"7460",
+            "nameAccordingTo":"NCBI Taxonomy",
+            "scientificName":"Apis mellifera",
+            "identifier":29080011
+        }
+    ],
+    "dataObjects":
+    [
+        {
+            "mediaURL":"http://upload.wikimedia.org/wikipedia/commons/thumb/c/cd/Honeybee-27527-1.jpg/460px-Honeybee-27527-1.jpg",
+            "modified":"0000-00-00 00:00:00",
+            "title":"File:Honeybee-27527-1.jpg",
+            "license":"http://creativecommons.org/licenses/publicdomain/",
+            "mimeType":null,
+            "eolMediaURL":"http://content8.eol.org/content/2009/09/15/14/65086_large.jpg",
+            "language":"en",
+            "dataType":"http://purl.org/dc/dcmitype/StillImage",
+            "agents":
+            [
+                {
+                    "role":"provider",
+                    "homepage":"http://commons.wikimedia.org/",
+                    "full_name":"Wikimedia Commons"
+                },
+                {
+                    "role":"photographer",
+                    "homepage":"http://commons.wikimedia.org/wiki/User:Ken_Thomas",
+                    "full_name":"Ken Thomas"
+                }
+            ],
+            "eolThumbnailURL":"http://content9.eol.org/content/2009/09/15/14/65086_medium.jpg",
+            "description":"<a href='http://en.wikipedia.org/wiki/Apis mellifera ligustica'>Italian honeybee</a> (<i>Apis mellifera ligustica</i>) <a href='http://en.wikipedia.org/wiki/Worker_bee'>worker</a>.<br>Photo taken with a <a href='http://en.wikipedia.org/wiki/Panasonic_Lumix_DMC-FZ50'>Panasonic Lumix DMC-FZ50</a> (with a <a href='http://en.wikipedia.org/wiki/Tiffen'>Tiffen</a> +4 <a href='http://en.wikipedia.org/wiki/Close-up_lens'>Dioptic Lens</a>) in <a href='http://en.wikipedia.org/wiki/Caldwell_County%2C_North_Carolina'>Caldwell County, USA</a>.",
+            "source":"http://commons.wikimedia.org/wiki/File:Honeybee-27527-1.jpg",
+            "identifier":"5bd05f95cc663ef658a6cbd33e8f3e8d",
+            "references":
+            [
+            ],
+            "created":"0000-00-00 00:00:00"
+        },
+        {
+            "mediaURL":"http://farm3.static.flickr.com/2619/3730360050_1336b71208.jpg",
+            "modified":"0000-00-00 00:00:00",
+            "latitude":"39.989368",
+            "location":"Yorklyn, Pennsylvania, United States",
+            "title":"Honey Bee on Mountain Mint",
+            "license":"http://creativecommons.org/licenses/by/2.0/",
+            "mimeType":"image/jpeg",
+            "eolMediaURL":"http://content10.eol.org/content/2009/08/26/01/47113_large.jpg",
+            "language":"en",
+            "dataType":"http://purl.org/dc/dcmitype/StillImage",
+            "agents":
+            [
+                {
+                    "role":"provider",
+                    "homepage":"http://www.flickr.com/groups/encyclopedia_of_life",
+                    "full_name":"EOL Images Group on Flickr"
+                },
+                {
+                    "role":"photographer",
+                    "homepage":"http://www.flickr.com/photos/38875278@N08",
+                    "full_name":"John Baker"
+                }
+            ],
+            "eolThumbnailURL":"http://content1.eol.org/content/2009/08/26/01/47113_medium.jpg",
+            "longitude":"-76.648567",
+            "description":"A honey bee (Apis mellifera) visiting a mountain mint (Pycnanthemum muticum) blossom.&nbsp;&nbsp;The Pennsylvania Department of Agriculture is conducting a citizen scientist native bee monitoring project that will ultimately allow us ( The Pa Dept of Ag) to make reccommendations to gardeners as to what kind of plants they should plant in a garden to make it pollinator friendly.&nbsp;&nbsp;The project is in part funded by Haagen--Dazs.  For more information please visit:&nbsp;<a href=\"http://www.helpthehoneybees.com\" rel=\"nofollow\">www.helpthehoneybees.com</a>&nbsp;&nbsp;For information on the Penn State Master Gardeners,
+             please visit:  &nbsp;horticulture.psu.edu/extension/mg&quot;",
+            "source":"http://www.flickr.com/photos/38875278@N08/3730360050/",
+            "identifier":"d72801627bf4adf1a38d9c5f10cc767f",
+            "references":
+            [
+            ],
+            "created":"2009-07-12 11:13:19"
+        },
+        {
+            "modified":"0000-00-00 00:00:00",
+            "title":"Biology",
+            "rights":"Copyright Wildscreen 2003-2008",
+            "license":"http://creativecommons.org/licenses/by-nc-sa/3.0/",
+            "mimeType":"text/html",
+            "language":"en",
+            "dataType":"http://purl.org/dc/dcmitype/Text",
+            "agents":
+            [
+                {
+                    "role":"provider",
+                    "homepage":"http://www.arkive.org/",
+                    "full_name":"ARKive"
+                }
+            ],
+            "subject":"http://rs.tdwg.org/ontology/voc/SPMInfoItems#TaxonBiology",
+            "rightsHolder":"Wildscreen",
+            "description":"The hive structure consists of wax 'honeycombs',
+             each honeycomb is made of small cells,
+             which are used to store food or to rear the brood. Bees feed on nectar and pollen taken from flowers; stores of honey (regurgitated nectar) and pollen (gathered on the legs in special 'pollen baskets') see them through the winter (5). Honey bees have a complex system of communication; when a good supply of flowers has been discovered,
+             a returning forager can convey the location of the food to other workers by means of special dances. The discovery of a good foraging location is announced by the 'round dance' in which the forager circles around rapidly,
+             while the 'waggle dance',
+             involving a rapid movement of the tail,
+             contains information on the distance and direction of the flowers in relation to the hive,
+             using the sun as a compass (5).&nbsp;The queen is the only bee within the colony to lay eggs,
+             the workers care for the brood,
+             and carry out many other duties for the hive,
+             including foraging and cleaning (5). The queen mates just once,
+             on a 'nuptial flight' during spring,
+             and stores enough sperm inside her body to allow her to fertilise her eggs for the rest of her life. Eggs are laid from March to October; each egg is deposited into a cell,
+             and a small,
+             white larva emerges after around 3 days. Workers provide the larva with food; after 6 days the pupal stage will develop,
+             and the workers cap the cells containing fully developed larvae with wax. The adult bee will climb out of the cell 12 days later.  Drones (males) are produced from unfertilised eggs,
+             and appear in the colony during spring and early summer; they take three days longer to develop into adults than workers,
+             and are ejected from the colony later in the year by the workers (5). Both worker and queen bee larvae are fed on a rich liquid known as 'royal jelly' in the first days of life. Workers are then fed on pollen and nectar,
+             but larvae that continue to be given royal jelly develop into queens. The first new queen to emerge may sting the other developing queens to death. After mating she may either take the place of her mother (who may have departed the hive in a swarm,
+             taking half of the workers with her),
+             or establish a new colony (5).",
+            "source":"http://www.arkive.org/honey-bee/apis-mellifera/",
+            "identifier":"8ad9be27871b41c112353d179130cf27",
+            "references":
+            [
+            ],
+            "created":"0000-00-00 00:00:00"
+        },
+        {
+            "modified":"0000-00-00 00:00:00",
+            "title":"Groups vote on hive locations: honeybees",
+            "rights":"\u00a92008-2009,
+             The Biomimicry Institute",
+            "license":"http://creativecommons.org/licenses/by-nc/3.0/",
+            "mimeType":"text/html",
+            "language":"en",
+            "dataType":"http://purl.org/dc/dcmitype/Text",
+            "agents":
+            [
+                {
+                    "role":"provider",
+                    "homepage":"http://www.AskNature.org/",
+                    "full_name":"AskNature"
+                },
+                {
+                    "role":"editor",
+                    "homepage":"",
+                    "full_name":"Aron Kisdi"
+                }
+            ],
+            "subject":"http://rs.tdwg.org/ontology/voc/SPMInfoItems#GeneralDescription",
+            "rightsHolder":"The Biomimicry Institute",
+            "description":"&nbsp;              <p><strong>Honeybees in a colony select a new hive location via range voting.</strong></p>&nbsp;              <div><a href=\"http://www.asknature.org/browse/type/aof/selected/strategy%7C921\">Maintain community</a> &gt; <a href=\"http://www.asknature.org/browse/type/aof/selected/strategy%7C921%7C946\">Cooperate and compete</a> &gt; <a href=\"http://www.asknature.org/browse/type/aof/selected/strategy%7C921%7C946%7C951\"><strong>Within the same species</strong></a>&nbsp;</div>&nbsp;<br/>&nbsp;              <a href=\"http://www.youtube.com/watch?v=NFdUahlyHGI\" target=\"_blank\"><img class=\"wiser left\" src=\"http://www.asknature.org/images/icons/play_video.png\" alt=\"\" width=\"33\" height=\"33\" /></a> <a href=\"http://www.youtube.com/watch?v=NFdUahlyHGI\" target=\"_blank\"> View this animation of bee voting</a>,
+             a collaboration of Sweet Onion Creations and The Biomimicry Institute.<br /><br /><br />\"Thomas Seeley,
+             a biologist at Cornell University,
+             has been looking into the uncanny ability of honeybees to make good decisions. With as many as 50,
+            000 workers in a single hive,
+             honeybees have evolved ways to work through individual differences of opinion to do what's best for the colony. If only people could be as effective in boardrooms,
+             church committees,
+             and town meetings,
+             Seeley says,
+             we could avoid problems making decisions in our own lives. <br /><br />\"During the past decade,
+             Seeley,
+             Kirk Visscher of the University of California,
+             Riverside,
+             and others have been studying colonies of honeybees (<em>Apis mellifera</em>) to see how they choose a new home. In late spring,
+             when a hive gets too crowded,
+             a colony normally splits,
+             and the queen,
+             some drones,
+             and about half the workers fly a short distance to cluster on a tree branch. There the bees bivouac while a small percentage of them go searching for new real estate. Ideally,
+             the site will be a cavity in a tree,
+             well off the ground,
+             with a small entrance hole facing south,
+             and lots of room inside for brood and honey. Once a colony selects a site,
+             it usually won't move again,
+             so it has to make the right choice.<br /><br />\"To find out how,
+             Seeley's team applied paint dots and tiny plastic tags to identify all 4,
+            000 bees in each of several small swarms that they ferried to Appledore Island,
+             home of the Shoals Marine Laboratory. There,
+             in a series of experiments,
+             they released each swarm to locate nest boxes they'd placed on one side of the half-mile-long (one kilometer) island,
+             which has plenty of shrubs but almost no trees or other places for nests.<br /><br />\"In one test they put out five nest boxes,
+             four that weren't quite big enough and one that was just about perfect. Scout bees soon appeared at all five. When they returned to the swarm,
+             each performed a waggle dance urging other scouts to go have a look. (These dances include a code giving directions to a box's location.) The strength of each dance reflected the scout's enthusiasm for the site. After a while,
+             dozens of scouts were dancing their little feet off,
+             some for one site,
+             some for another,
+             and a small cloud of bees was buzzing around each box.<br /><br />\"The decisive moment didn't take place in the main cluster of bees,
+             but out at the boxes,
+             where scouts were building up. As soon as the number of scouts visible near the entrance to a box reached about 15&mdash;a threshold confirmed by other experiments&mdash;the bees at that box sensed that a quorum had been reached,
+             and they returned to the swarm with the news. <br /><br />\"'It was a race,
+            ' Seeley says. 'Which site was going to build up 15 bees first?' <br /><br />\"Scouts from the chosen box then spread through the swarm,
+             signaling that it was time to move. Once all the bees had warmed up,
+             they lifted off for their new home,
+             which,
+             to no one's surprise,
+             turned out to be the best of the five boxes.<br /><br />\"The bees' rules for decision-making&mdash;seek a diversity of options,
+             encourage a free competition among ideas,
+             and use an effective mechanism to narrow choices&mdash;so impressed Seeley that he now uses them at Cornell as chairman of his department.\" (Miller 2007:4-5)<br /><br/>&nbsp;              <a class=\"external_link\" href=\"http://www.asknature.org/strategy/209b5fa3de3573d76df73854f1cd9dba\">Learn more about this functional adaptation.</a>",
+            "source":"http://www.asknature.org/strategy/209b5fa3de3573d76df73854f1cd9dba",
+            "identifier":"45deb1b01be4aa3cbfa93a2b8c7bbd10",
+            "references":
+            [
+                "Miller,
+                 Peter.  July. The Genius of Swarms.  National Geographic."
+            ],
+            "created":"2008-11-02 06:18:53"
+        },
+        {
+            "mediaURL":"http://www.flickr.com/apps/video/stewart.swf?v=71377&photo_id=3236419704&photo_secret=68be62ac11",
+            "modified":"0000-00-00 00:00:00",
+            "latitude":"37.287574",
+            "location":"Faro,
+             Portugal",
+            "title":"Abelhas numa Azinheira // Honey Bees on a Holm Oak (Apis mellifera)",
+            "license":"http://creativecommons.org/licenses/by-nc-sa/2.0/",
+            "mimeType":"video/x-flv",
+            "language":"en",
+            "dataType":"http://purl.org/dc/dcmitype/MovingImage",
+            "agents":
+            [
+                {
+                    "role":"provider",
+                    "homepage":"http://www.flickr.com/groups/encyclopedia_of_life",
+                    "full_name":"EOL Images Group on Flickr"
+                },
+                {
+                    "role":"photographer",
+                    "homepage":"http://www.flickr.com/photos/58213213@N00",
+                    "full_name":"Valter Jacinto"
+                }
+            ],
+            "longitude":"-7.500743",
+            "description":"<b>Location</b>: Azinhal &gt; Castro Marim &gt; Algarve &gt; Portugal&nbsp;&nbsp;<b>Recording Date</b>: January 24,
+             2009&nbsp;",
+            "source":"http://www.flickr.com/photos/valter/3236419704/",
+            "identifier":"e70cb321fd2933d4db48b6c41271068b",
+            "references":
+            [
+            ],
+            "created":"2009-01-24 11:44:09"
+        },
+        {
+            "mediaURL":"http://www.flickr.com/apps/video/stewart.swf?v=71377&photo_id=3272354945&photo_secret=5d62f7dda0",
+            "modified":"0000-00-00 00:00:00",
+            "latitude":"-27.6223",
+            "location":"Hodgson Vale,
+             Queensland,
+             Australia",
+            "title":"Apis mellifera (European Honeybee) - Introduced",
+            "license":"http://creativecommons.org/licenses/by-nc-sa/2.0/",
+            "mimeType":"video/x-flv",
+            "language":"en",
+            "dataType":"http://purl.org/dc/dcmitype/MovingImage",
+            "agents":
+            [
+                {
+                    "role":"provider",
+                    "homepage":"http://www.flickr.com/groups/encyclopedia_of_life",
+                    "full_name":"EOL Images Group on Flickr"
+                },
+                {
+                    "role":"photographer",
+                    "homepage":"http://www.flickr.com/photos/32005048@N06",
+                    "full_name":"Arthur Chapman"
+                }
+            ],
+            "longitude":"151.9376",
+            "description":"European Honeybee (Apis mellifera) - an introduced species near Toowoomba,
+             Queensland,
+             Australia. Photographed on 3 February 2005.&nbsp;&nbsp;High quality .avi files are held and may be available by individual request.",
+            "source":"http://www.flickr.com/photos/arthur_chapman/3272354945/",
+            "identifier":"24cd66d45036306efa84c5792ba99c14",
+            "references":
+            [
+            ],
+            "created":"2005-02-03 15:25:07"
+        }
+    ],
+    "scientificName":"Apis mellifera Linnaeus 1758",
+    "identifier":1045608,
+    "vernacularNames":
+    [
+        {
+            "vernacularName":"\u041c\u0435\u0434\u043e\u043d\u043e\u0441\u043d\u0430 \u043f\u0447\u0435\u043b\u0430",
+            "language":"bg"
+        },
+        {
+            "vernacularName":"V\u010dela medonosn\u00e1",
+            "language":"cs"
+        },
+        {
+            "vernacularName":"Honningbi",
+            "language":"da"
+        },
+        {
+            "vernacularName":"honey bee",
+            "language":"en"
+        },
+        {
+            "vernacularName":"Tarhamehil\u00e4inen",
+            "language":"fi"
+        },
+        {
+            "vernacularName":"abeille domestique",
+            "language":"fr"
+        },
+        {
+            "vernacularName":"Honigbiene",
+            "language":"de"
+        },
+        {
+            "vernacularName":"\u05d3\u05d1\u05d5\u05e8\u05ea \u05d4\u05d3\u05d1\u05e9",
+            "language":"he"
+        },
+        {
+            "vernacularName":"M\u00e9zel\u0151 m\u00e9h",
+            "language":"hu"
+        },
+        {
+            "vernacularName":"Alib\u00fdfluga",
+            "language":"is"
+        },
+        {
+            "vernacularName":"ape del miele",
+            "language":"it"
+        },
+        {
+            "vernacularName":"\u30bb\u30a4\u30e8\u30a6\u30df\u30c4\u30d0\u30c1",
+            "language":"ja"
+        },
+        {
+            "vernacularName":"Eiropas medus bite",
+            "language":"lv"
+        },
+        {
+            "vernacularName":"Europeisk honningbie",
+            "language":"nn"
+        },
+        {
+            "vernacularName":"Pszczo\u0142a miodna",
+            "language":"pl"
+        },
+        {
+            "vernacularName":"abelha do mel",
+            "language":"pt"
+        },
+        {
+            "vernacularName":"\u041c\u0435\u0434\u043e\u043d\u043e\u0441\u043d\u0430\u044f \u043f\u0447\u0435\u043b\u0430",
+            "language":"ru"
+        },
+        {
+            "vernacularName":"V\u010dela medonosn\u00e1",
+            "language":"sk"
+        },
+        {
+            "vernacularName":"Apis mellifera",
+            "language":"es"
+        },
+        {
+            "vernacularName":"\u0411\u0434\u0436\u043e\u043b\u0430 \u043c\u0435\u0434\u043e\u043d\u043e\u0441\u043d\u0430",
+            "language":"uk"
+        },
+        {
+            "vernacularName":"Huningbij",
+            "language":"fy"
+        }
+    ]
+}

data/spec/fixtures/ping.json

@@ -0,0 +1,6 @@
+{
+    "response":
+    {
+        "message":"Success"
+    }
+}

data/spec/fixtures/search.json

@@ -0,0 +1,36 @@
+{
+    "results":
+    [
+        {
+            "title":"Ursus",
+            "id":14349,
+            "content":"Ursus Linnaeus, 1758",
+            "link":"http://www.eol.org/pages/14349"
+        },
+        {
+            "title":"Megathymus ursus ursus Poling 1902",
+            "id":2683230,
+            "content":"Megathymus ursus ursus Poling 1902",
+            "link":"http://www.eol.org/pages/2683230"
+        },
+        {
+            "title":"Ursus arctor",
+            "id":10695434,
+            "content":"Ursus arctor\n\n",
+            "link":"http://www.eol.org/pages/10695434"
+        },
+        {
+            "title":"Ursus ingressus",
+            "id":12136362,
+            "content":"Ursus ingressus\n\n",
+            "link":"http://www.eol.org/pages/12136362"
+        }
+    ],
+    "totalResults":126,
+    "self":"http://www.eol.org/api/search/Ursus.json?page=1",
+    "itemsPerPage":30,
+    "last":"http://www.eol.org/api/search/Ursus.json?page=5",
+    "startIndex":1,
+    "first":"http://www.eol.org/api/search/Ursus.json?page=1",
+    "next":"http://www.eol.org/api/search/Ursus.json?page=2"
+}

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'eoflife'
+require 'webmock/rspec'
+require 'json'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end
+
+def fixture_file(filename)
+  return '' if filename == ''
+  file_path = File.expand_path(File.dirname(__FILE__) + '/fixtures/' + filename)
+  JSON.parse(File.read(file_path))
+end
+
+def stub_endpoint(endpoint, expected_data)
+  stub_request(:get, endpoint)
+    .to_return(:status => 200, :body => fixture_file(expected_data), :headers => {})
+end

metadata

@@ -0,0 +1,181 @@
+--- !ruby/object:Gem::Specification 
+name: eoflife
+version: !ruby/object:Gem::Version 
+  prerelease: 6
+  version: 0.1.0.pre
+platform: ruby
+authors: 
+- Marc Chung
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-12 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.7"
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: yard
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.5.2
+  type: :development
+  prerelease: false
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.6.2
+  type: :development
+  prerelease: false
+  version_requirements: *id009
+description: Programmatic access to the Encylopedia of Life's API
+email: mchung@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- examples/pages.rb
+- examples/ping.rb
+- examples/search.rb
+- lib/eoflife.rb
+- lib/eoflife/client.rb
+- lib/eoflife/error.rb
+- lib/eoflife/version.rb
+- spec/eoflife_spec.rb
+- spec/fixtures/pages.json
+- spec/fixtures/ping.json
+- spec/fixtures/search.json
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/mchung/eoflife
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -719393837
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 1.3.1
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: API for the Encylopedia of Life
+test_files: 
+- examples/pages.rb
+- examples/ping.rb
+- examples/search.rb
+- spec/eoflife_spec.rb
+- spec/spec_helper.rb