fleakr 0.3.0

data/lib/fleakr/support/object.rb

@@ -0,0 +1,88 @@
+module Fleakr
+  module Support # :nodoc:all
+    module Object
+    
+      module ClassMethods
+      
+        def attributes
+          @attributes ||= []
+        end
+      
+        def flickr_attribute(name, options = {})
+          self.attributes << Attribute.new(name, options)
+          class_eval "attr_accessor :#{name}"
+        end
+      
+        def has_many(*attributes)
+          options = attributes.extract_options!
+          class_name = self.name
+
+          attributes.each do |attribute|
+            target = "Fleakr::Objects::#{attribute.to_s.classify}"
+            finder_attribute = options[:using].nil? ? "#{class_name.demodulize.underscore}_id": options[:using]
+            class_eval <<-CODE
+              def #{attribute}
+                @#{attribute} ||= #{target}.send("find_all_by_#{finder_attribute}".to_sym, self.id)
+              end
+            CODE
+          end
+        end
+      
+        def find_all(condition, options)
+          attribute    = options[:using].nil? ? condition.to_s.sub(/^by_/, '') : options[:using]
+          target_class = options[:class_name].nil? ? self.name : "Fleakr::Objects::#{options[:class_name]}"
+        
+          class_eval <<-CODE
+            def self.find_all_#{condition}(value)
+              response = Fleakr::Api::Request.with_response!('#{options[:call]}', :#{attribute} => value)
+              (response.body/'rsp/#{options[:path]}').map {|e| #{target_class}.new(e) }
+            end
+          CODE
+        end
+      
+        def find_one(condition, options)
+          attribute = options[:using].nil? ? condition.to_s.sub(/^by_/, '') : options[:using]
+        
+          class_eval <<-CODE
+            def self.find_#{condition}(value)
+              response = Fleakr::Api::Request.with_response!('#{options[:call]}', :#{attribute} => value)
+              #{self.name}.new(response.body)
+            end
+          CODE
+        end
+        
+        def scoped_search
+          key = "#{self.name.demodulize.underscore.downcase}_id".to_sym
+
+          class_eval <<-CODE
+            def search(search_text)
+              Fleakr::Objects::Search.new(:text => search_text, :#{key} => self.id).results
+            end
+          CODE
+        end
+      
+      end
+    
+      module InstanceMethods
+      
+        def initialize(document = nil)
+          self.populate_from(document) unless document.nil?
+        end
+      
+        def populate_from(document)
+          self.class.attributes.each do |attribute|
+            value = attribute.value_from(document)
+            self.send("#{attribute.name}=".to_sym, value) unless value.nil?
+          end
+        end
+      
+      end
+
+      def self.included(other)
+        other.send(:extend, Fleakr::Support::Object::ClassMethods)
+        other.send(:include, Fleakr::Support::Object::InstanceMethods)
+      end
+      
+    end
+  end
+end

data/lib/fleakr/version.rb

@@ -0,0 +1,13 @@
+module Fleakr
+  module Version # :nodoc:
+    
+    MAJOR = 0
+    MINOR = 3
+    TINY  = 0
+    
+    def self.to_s
+      [MAJOR, MINOR, TINY].join('.')
+    end
+    
+  end
+end

data/lib/fleakr.rb

@@ -0,0 +1,74 @@
+$:.unshift(File.dirname(__FILE__))
+
+require 'uri'
+require 'cgi'
+require 'net/http'
+require 'rubygems'
+require 'hpricot'
+require 'activesupport'
+
+%w(support api objects).each do |path|
+  full_path = File.expand_path(File.dirname(__FILE__)) + "/fleakr/#{path}"
+  Dir["#{full_path}/*.rb"].each {|f| require f }
+end
+
+# = Fleakr: A teeny tiny gem to interface with Flickr
+#
+# Getting started is easy, just make sure you have a valid API key from Flickr and you can
+# then start making any non-authenticated request to pull back data for yours and others' 
+# photostreams, sets, contacts, groups, etc...
+#
+# For now, all activity originates from a single user which you can find by username or
+# email address.
+#
+# Example:
+#
+#  require 'rubygems'
+#  require 'fleakr'
+#
+#  # Our API key is ABC123 (http://www.flickr.com/services/api/keys/apply/)
+#  Fleakr.api_key = 'ABC123'
+#  user = Fleakr.user('bees')
+#  user = Fleakr.user('user@host.com')
+#  # Grab a list of sets
+#  user.sets
+#  # Grab a list of the user's public groups
+#  user.groups
+#
+# To see what other associations and attributes are available, see the Fleakr::Objects::User class
+#
+module Fleakr
+
+  mattr_accessor :api_key
+
+  # Find a user based on some unique user data.  This method will try to find
+  # the user based on username and will fall back to email if that fails.  Example:
+  #
+  #  Fleakr.api_key = 'ABC123'
+  #  Fleakr.user('the decapitator') # => #<Fleakr::Objects::User:0x692648 @username="the decapitator", @id="21775151@N06">
+  #  Fleakr.user('user@host.com')   # => #<Fleakr::Objects::User:0x11f484c @username="bckspcr", @id="84481630@N00">
+  #
+  def self.user(user_data)
+    begin
+      Objects::User.find_by_username(user_data)
+    rescue Api::Request::ApiError
+      Objects::User.find_by_email(user_data)
+    end
+  end
+  
+  # Search all photos on the Flickr site.  By default, this searches based on text, but you can pass
+  # different search parameters (passed as hash keys):
+  #
+  # [tags] The list of tags to search on (either as an array or comma-separated)
+  # [user_id] Scope the search to this user
+  # [group_id] Scope the search to this group
+  #
+  # If you're interested in User- and Group-scoped searches, you may want to use User#search and Group#search
+  # instead.
+  #
+  def self.search(params)
+    params = {:text => params} unless params.is_a?(Hash)
+    Objects::Search.new(params).results
+  end
+  
+end

data/test/fixtures/contacts.getPublicList.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+<contacts page="1" pages="1" per_page="1000" perpage="1000" total="17">
+	<contact nsid="9302864@N42" username="blinky" iconserver="2263" iconfarm="3" ignored="0" />
+	<contact nsid="63204625@N20" username="inky" iconserver="53" iconfarm="1" ignored="0" />
+</contacts>
+</rsp>

data/test/fixtures/groups.pools.getPhotos.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+<photos page="1" pages="796" perpage="100" total="79509">
+	<photo id="3101830908" owner="64008250@N00" secret="e85e249e72" server="3042" farm="4" title="Canal Gate" ispublic="1" isfriend="0" isfamily="0" ownername="oakraidr" dateadded="1229049777" />
+	<photo id="3100780049" owner="98821864@N00" secret="f46fbe211b" server="3274" farm="4" title="2alarm" ispublic="1" isfriend="0" isfamily="0" ownername="LooknFeel" dateadded="1229042651" />
+</photos>
+</rsp>

data/test/fixtures/people.findByEmail.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+  <user id="31066442@N69" nsid="31066442@N69">
+    <username>frootpantz</username>
+  </user>
+</rsp>

data/test/fixtures/people.findByUsername.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+  <user id="31066442@N69" nsid="31066442@N69">
+    <username>frootpantz</username>
+  </user>
+</rsp>

data/test/fixtures/people.getInfo.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+  <person id="31066442@N69" nsid="31066442@N69" isadmin="0" ispro="1" iconserver="30" iconfarm="1">
+  	<username>frootpantz</username>
+  	<realname>Sir Froot Pantz</realname>
+  	<mbox_sha1sum>e52ed1e5b91c763694995460e9796fc2adc02019</mbox_sha1sum>
+  	<location />
+  	<photosurl>http://www.flickr.com/photos/frootpantz/</photosurl>
+  	<profileurl>http://www.flickr.com/people/frootpantz/</profileurl>
+  	<mobileurl>http://m.flickr.com/photostream.gne?id=34225</mobileurl>
+  	<photos>
+  		<firstdatetaken>2006-10-11 08:19:57</firstdatetaken>
+  		<firstdate>1160612247</firstdate>
+  		<count>3907</count>
+  		<views>9002</views>
+  	</photos>
+  </person>
+</rsp>

data/test/fixtures/people.getPublicGroups.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+<groups>
+	<group nsid="13378274@N00" name="Group #1" admin="0" eighteenplus="0" />
+	<group nsid="52242140489@N01" name="Group #2" admin="0" eighteenplus="0" />
+</groups>
+</rsp>

data/test/fixtures/people.getPublicPhotos.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+<photos page="1" pages="1" perpage="100" total="76">
+	<photo id="2924549350" owner="21775151@N06" secret="cbc1804258" server="3250" farm="4" title="Photo #1" ispublic="1" isfriend="0" isfamily="0" />
+	<photo id="2923697303" owner="21775151@N06" secret="649aa95f29" server="3208" farm="4" title="Photo #2" ispublic="1" isfriend="0" isfamily="0" />
+</photos>
+</rsp>

data/test/fixtures/photos.getSizes.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+  <sizes canblog="0" canprint="0" candownload="1">
+  	<size label="Square" width="75" height="75" source="http://farm4.static.flickr.com/3093/2409912100_71e14ed08a_s.jpg" url="http://www.flickr.com/photos/the_decapitator/2409912100/sizes/sq/" media="photo" />
+  	<size label="Thumbnail" width="100" height="67" source="http://farm4.static.flickr.com/3093/2409912100_71e14ed08a_t.jpg" url="http://www.flickr.com/photos/the_decapitator/2409912100/sizes/t/" media="photo" />
+  	<size label="Small" width="240" height="160" source="http://farm4.static.flickr.com/3093/2409912100_71e14ed08a_m.jpg" url="http://www.flickr.com/photos/the_decapitator/2409912100/sizes/s/" media="photo" />
+  	<size label="Medium" width="500" height="334" source="http://farm4.static.flickr.com/3093/2409912100_71e14ed08a.jpg" url="http://www.flickr.com/photos/the_decapitator/2409912100/sizes/m/" media="photo" />
+  	<size label="Original" width="700" height="467" source="http://farm4.static.flickr.com/3093/2409912100_3305c4a108_o.jpg" url="http://www.flickr.com/photos/the_decapitator/2409912100/sizes/o/" media="photo" />
+  </sizes>
+</rsp>

data/test/fixtures/photos.search.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+<photos page="1" pages="385" perpage="100" total="38424">
+	<photo id="3076020861" owner="31987693@N05" secret="b956549c07" server="3278" farm="4" title="Mona and Lisa" ispublic="1" isfriend="0" isfamily="0" />
+	<photo id="3075386827" owner="9377349@N05" secret="4e40291b2d" server="3151" farm="4" title="IMG_0055 1.JPG" ispublic="1" isfriend="0" isfamily="0" />
+</photos>
+</rsp>

data/test/fixtures/photosets.getList.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<rsp stat="ok">
+  <photosets>
+  	<photoset videos="0" primary="3044180117" farm="4" photos="138" id="72157609490909659" server="3012" secret="01cd1a741d">
+  		<title>Second Set</title>
+  		<description>This is the second set.</description>
+  	</photoset>
+  	<photoset videos="0" primary="2988511085" farm="4" photos="139" id="72157608538140671" server="3241" secret="a7b90926ba">
+  		<title>First Set</title>
+  		<description>This is the first set.</description>
+  	</photoset>
+  </photosets>
+</rsp>

data/test/fixtures/photosets.getPhotos.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+  <photoset id="72157609490909659" primary="3044180117" owner="31066442@N69" ownername="frootpantz" page="1" per_page="500" perpage="500" pages="1" total="138">
+  	<photo id="3044163577" secret="fa27e5a824" server="3153" farm="4" title="Photo #1" isprimary="0" />
+  	<photo id="3045001128" secret="a8c0e51b39" server="3204" farm="4" title="Photo #2" isprimary="0" />
+  </photoset>
+</rsp>

data/test/test_helper.rb

@@ -0,0 +1,123 @@
+$:.reject! { |e| e.include? 'TextMate' }
+
+require 'rubygems'
+require 'matchy'
+require 'context'
+require 'mocha'
+
+require File.dirname(__FILE__) + '/../lib/fleakr'
+
+class Test::Unit::TestCase
+
+  def self.should_have_a_value_for(attribute_test)
+    it "should have a value for :#{attribute_test.keys.first}" do
+      @object.send(attribute_test.keys.first).should == attribute_test.values.first
+    end
+  end
+
+  def self.should_search_by(key)
+    it "should be able to perform a scoped search by :#{key}" do
+      photos = [stub()]
+      search = stub(:results => photos)
+      
+      klass = self.class.name.sub(/Test$/, '').constantize
+      
+      instance = klass.new
+      instance.stubs(:id).with().returns('1')
+      
+      Fleakr::Objects::Search.expects(:new).with(:text => 'foo', key => '1').returns(search)
+      
+      instance.search('foo').should == photos
+    end
+  end
+
+  def self.should_have_many(*attributes)
+    class_name = self.name.demodulize.sub(/Test$/, '')
+    this_klass = "Fleakr::Objects::#{class_name}".constantize
+
+    options = attributes.extract_options!
+    finder_attribute = options[:using].nil? ? "#{class_name.downcase}_id" : options[:using]
+    
+    attributes.each do |attribute|
+      target_klass = "Fleakr::Objects::#{attribute.to_s.singularize.classify}".constantize
+      it "should be able to retrieve the #{class_name.downcase}'s #{attribute}" do
+        results = [stub()]
+        object = this_klass.new
+        object.stubs(:id).with().returns('1')
+
+        target_klass.expects("find_all_by_#{finder_attribute}".to_sym).with('1').returns(results)
+        object.send(attribute).should == results
+      end
+      
+      it "should memoize the results for the #{class_name.downcase}'s #{attribute}" do
+        object = this_klass.new
+        
+        target_klass.expects("find_all_by_#{finder_attribute}".to_sym).once.returns([])
+        2.times { object.send(attribute) }
+      end
+      
+    end
+  end
+
+  def self.should_find_one(thing, options)
+    class_name  = thing.to_s.singularize.camelcase
+    klass       = "Fleakr::Objects::#{class_name}".constantize
+    object_type = class_name.downcase    
+
+    options[:with] = options[:by] if options[:with].nil?
+
+    it "should be able to find a #{thing} by #{options[:by]}" do
+      condition_value = '1'
+      stub = stub()
+      response = mock_request_cycle :for => options[:call], :with => {options[:with] => condition_value}
+
+      klass.expects(:new).with(response.body).returns(stub)
+      klass.send("find_by_#{options[:by]}".to_sym, condition_value).should == stub
+    end
+  end
+
+  def self.should_find_all(thing, options)
+    class_name  = thing.to_s.singularize.camelcase
+    klass       = "Fleakr::Objects::#{class_name}".constantize
+    object_type = class_name.downcase
+    
+    it "should be able to find all #{thing} by #{options[:by]}" do
+      condition_value = '1'
+      response = mock_request_cycle :for => options[:call], :with => {options[:by] => condition_value}
+      
+      stubs = []
+      elements = (response.body/options[:path]).map
+      
+      
+      elements.each do |element|
+        stub = stub()
+        stubs << stub
+        
+        klass.expects(:new).with(element).returns(stub)
+      end
+      
+      klass.send("find_all_by_#{options[:by]}".to_sym, condition_value).should == stubs
+    end
+    
+  end
+  
+  def read_fixture(method_call)
+    fixture_path = File.dirname(__FILE__) + '/fixtures'
+    File.read("#{fixture_path}/#{method_call}.xml")
+  end
+  
+  def mock_request_cycle(options)
+    response = stub(:body => Hpricot.XML(read_fixture(options[:for])))
+    Fleakr::Api::Request.expects(:with_response!).with(options[:for], options[:with]).returns(response)
+    
+    response
+  end
+  
+  def create_temp_directory
+    tmp_dir = File.dirname(__FILE__) + '/tmp'
+    FileUtils.mkdir(tmp_dir)  
+    
+    tmp_dir
+  end
+  
+end

data/test/unit/fleakr/api/request_test.rb

@@ -0,0 +1,93 @@
+require File.dirname(__FILE__) + '/../../../test_helper'
+
+module Fleakr::Api
+    class RequestTest < Test::Unit::TestCase
+
+      describe "A Request instance" do
+
+        context "with an API key" do
+
+          before do
+            @api_key = 'f00b4r'
+            Fleakr.stubs(:api_key).with().returns(@api_key)
+          end
+
+          it "should know the full query parameters" do
+            request = Request.new('flickr.people.findByUsername', :username => 'foobar')
+
+            expected = [
+              "api_key=#{@api_key}",
+              "method=flickr.people.findByUsername",
+              "username=foobar"
+            ]
+
+            request.query_parameters.split('&').sort.should == expected
+          end
+
+          it "should escape the keys and values in the parameter list" do
+            request = Request.new('flickr.people.findByUsername', :username => 'the decapitator')
+            request.query_parameters.split('&').include?("username=#{CGI.escape('the decapitator')}").should be(true)
+          end
+
+          it "should translate a shorthand API call" do
+            request = Request.new('people.findByUsername')
+            request.query_parameters.split('&').include?('method=flickr.people.findByUsername').should be(true)
+          end
+
+          it "should know the endpoint with full parameters" do
+            query_parameters = 'foo=bar'
+
+            request = Request.new('people.getInfo')
+            request.stubs(:query_parameters).with().returns(query_parameters)
+
+            uri_mock = mock() {|m| m.expects(:query=).with(query_parameters)}
+
+            URI.expects(:parse).with("http://api.flickr.com/services/rest/").returns(uri_mock)
+
+            request.endpoint_uri.should == uri_mock
+          end
+
+          it "should be able to make a request" do
+            endpoint_uri = stub()
+
+            request = Request.new('flickr.people.findByUsername')
+
+            request.stubs(:endpoint_uri).with().returns(endpoint_uri)
+            Net::HTTP.expects(:get).with(endpoint_uri).returns('<xml>')
+
+            request.send
+          end
+
+          it "should create a response from the request" do
+            response_xml  = '<xml>'
+            response_stub = stub()
+
+            request = Request.new('flickr.people.findByUsername')
+
+            Net::HTTP.stubs(:get).returns(response_xml)
+            Response.expects(:new).with(response_xml).returns(response_stub)
+
+            request.send.should == response_stub
+          end
+
+          it "should be able to make a full request and response cycle" do
+            response = stub(:error? => false)
+            Response.expects(:new).with(kind_of(String)).returns(response)
+
+            Request.with_response!('flickr.people.findByUsername', :username => 'foobar').should == response
+          end
+
+          it "should raise an exception when the full request / response cycle has errors" do
+            response = stub(:error? => true, :error => stub(:code => '1', :message => 'User not found'))
+            Response.stubs(:new).with(kind_of(String)).returns(response)
+
+            lambda do
+              Request.with_response!('flickr.people.findByUsername', :username => 'foobar')
+            end.should raise_error(Fleakr::Api::Request::ApiError)
+          end
+
+        end
+
+      end
+    end
+  end

data/test/unit/fleakr/api/response_test.rb

@@ -0,0 +1,49 @@
+require File.dirname(__FILE__) + '/../../../test_helper'
+
+module Fleakr::Api
+  class ResponseTest < Test::Unit::TestCase
+
+    describe "An instance of Response" do
+
+      it "should provide the response body as an Hpricot element" do
+        response_xml = '<xml>'
+        hpricot_stub = stub()
+
+        Hpricot.expects(:XML).with(response_xml).returns(hpricot_stub)
+        
+        response = Response.new(response_xml)
+        response.body.should == hpricot_stub
+      end
+      
+      it "should memoize the Hpricot document" do
+        response = Response.new('<xml>')
+        
+        Hpricot.expects(:XML).with(kind_of(String)).once.returns(stub())
+        
+        2.times { response.body }
+      end
+      
+      it "should know if there are errors in the response" do
+        response_xml = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<rsp stat=\"fail\">\n\t<err code=\"1\" msg=\"User not found\" />\n</rsp>\n"
+        response = Response.new(response_xml)
+        
+        response.error?.should be(true)
+      end
+      
+      it "should not have an error if there are no errors in the XML" do
+        response = Response.new(read_fixture('people.findByUsername'))
+        response.error.should be(nil)
+      end
+      
+      it "should have an error if there is an error in the response" do
+        response_xml = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<rsp stat=\"fail\">\n\t<err code=\"1\" msg=\"User not found\" />\n</rsp>\n"
+        response = Response.new(response_xml)
+        
+        response.error.code.should == '1'
+        response.error.message.should == 'User not found'
+      end
+
+    end
+
+  end
+end

data/test/unit/fleakr/objects/contact_test.rb

@@ -0,0 +1,58 @@
+require File.dirname(__FILE__) + '/../../../test_helper'
+
+module Fleakr::Objects
+  class ContactTest < Test::Unit::TestCase
+
+    describe "The Contact class" do
+      
+      should "return a list of users for a specified user's contacts" do
+        user_1, user_2 = [stub(), stub()]
+        contact_1, contact_2 = [stub(:to_user => user_1), stub(:to_user => user_2)]
+        
+        response = mock_request_cycle :for => 'contacts.getPublicList', :with => {:user_id => '1'}
+        
+        contact_1_doc, contact_2_doc = (response.body/'rsp/contacts/contact').map
+        
+        Contact.stubs(:new).with(contact_1_doc).returns(contact_1)
+        Contact.stubs(:new).with(contact_2_doc).returns(contact_2)
+        
+        Contact.find_all_by_user_id('1').should == [user_1, user_2]
+      end
+      
+    end
+
+    describe "An instance of the Contact class" do
+      context "when populating from an XML document" do
+        before do
+          @object = Contact.new(Hpricot.XML(read_fixture('contacts.getPublicList')).at('contacts/contact'))
+        end
+
+        should_have_a_value_for :id          => '9302864@N42'
+        should_have_a_value_for :username    => 'blinky'
+        should_have_a_value_for :icon_server => '2263'
+        should_have_a_value_for :icon_farm   => '3'
+
+      end
+
+      context "in general" do
+        
+        should "be able to convert to a user" do
+          contact = Contact.new
+          user    = mock()
+          
+          User.stubs(:new).returns(user)
+          
+          [:id, :username, :icon_server, :icon_farm].each do |method|
+            contact.stubs(method).with().returns(method.to_s)
+            user.expects("#{method}=".to_sym).with(method.to_s)
+          end
+          
+          contact.to_user.should == user
+        end
+        
+      end
+
+    end
+    
+  end
+end

data/test/unit/fleakr/objects/error_test.rb

@@ -0,0 +1,21 @@
+require File.dirname(__FILE__) + '/../../../test_helper'
+
+module Fleakr::Objects
+  class ErrorTest < Test::Unit::TestCase
+    
+    describe "An instance of the Error class" do
+      
+      it "should have a code and a message" do
+        response_xml = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<rsp stat=\"fail\">\n\t<err code=\"1\" msg=\"User not found\" />\n</rsp>\n"
+        
+        error = Error.new(Hpricot.XML(response_xml))
+        
+        error.code.should == '1'
+        error.message.should == 'User not found'
+      end
+      
+    end
+    
+    
+  end
+end

data/test/unit/fleakr/objects/group_test.rb

@@ -0,0 +1,31 @@
+require File.dirname(__FILE__) + '/../../../test_helper'
+
+module Fleakr::Objects
+  class GroupTest < Test::Unit::TestCase
+
+    should_have_many :photos
+    
+    should_search_by :group_id
+
+    describe "The Group class" do
+      
+      should_find_all :groups, :by => :user_id, :call => 'people.getPublicGroups', :path => 'rsp/groups/group'
+      
+    end
+    
+    describe "An instance of the Group class" do
+      context "when initializing from an Hpricot document" do
+        
+        before do
+          doc = Hpricot.XML(read_fixture('people.getPublicGroups')).at('rsp/groups/group')
+          @object = Group.new(doc)
+        end
+        
+        should_have_a_value_for :id   => '13378274@N00'
+        should_have_a_value_for :name => 'Group #1'
+        
+      end
+    end
+    
+  end
+end