snip-snap 0.1.0

data/README.rdoc

@@ -0,0 +1,45 @@
+= SnipSnap
+
+== Description
+
+SnipSnap is a Ruby library that will allow you to extract the URL of an image from
+one of many popular image sharing services.  Just give it the shortened URL and it can
+give you the full URL to the embedded image.  This library currently supports Img.ly,
+Skitch, Twitpic, and Yfrog - others are coming.
+
+== Installation
+
+    sudo gem install snip-snap
+
+== Usage
+
+    require 'rubygems
+    require 'snip_snap'
+    
+    client = SnipSnap.factory('http://yfrog.com/7hb9lj')
+    puts client.image_url
+
+== License
+
+Copyright (c) 2009 Patrick Reagan (reaganpr@gmail.com)
+
+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,56 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rake/testtask'
+
+require 'lib/snip_snap/version'
+
+spec = Gem::Specification.new do |s|
+  s.name             = 'snip-snap'
+  s.version          = SnipSnap::Version.to_s
+  s.has_rdoc         = true
+  s.extra_rdoc_files = %w(README.rdoc)
+  s.rdoc_options     = %w(--main README.rdoc)
+  s.summary          = "A ruby library that allows you to extract images from popular image-sharing services"
+  s.author           = 'Patrick Reagan'
+  s.email            = 'reaganpr@gmail.com'
+  s.homepage         = 'http://sneaq.net'
+  s.files            = %w(README.rdoc Rakefile) + Dir.glob("{lib,test}/**/*")
+  # s.executables    = ['snip-snap']
+  
+  s.add_dependency('curb', '>= 0.5.1.0')
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList["test/**/*_test.rb"]
+  t.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+
+  Rcov::RcovTask.new(:coverage) do |t|
+    t.libs       = ['test']
+    t.test_files = FileList["test/**/*_test.rb"]
+    t.verbose    = true
+    t.rcov_opts  = ['--text-report', "-x #{Gem.path}", '-x /Library/Ruby', '-x /usr/lib/ruby']
+  end
+  
+  task :default => :coverage
+  
+rescue LoadError
+  warn "\n**** Install rcov (sudo gem install relevance-rcov) to get coverage stats ****\n"
+  task :default => :test
+end
+
+
+desc 'Generate the gemspec to serve this Gem from Github'
+task :github do
+  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
+  File.open(file, 'w') {|f| f << spec.to_ruby }
+  puts "Created gemspec: #{file}"
+end

data/lib/snip_snap.rb

@@ -0,0 +1,54 @@
+$:.unshift File.dirname(__FILE__)
+
+require 'curb'
+require 'uri'
+
+require 'snip_snap/client'
+
+require 'snip_snap/skitch'
+require 'snip_snap/imgly'
+require 'snip_snap/yfrog'
+require 'snip_snap/twitpic'
+
+# = SnipSnap
+#
+# This is a small Ruby library that allows you to extract images from the more popular
+# image sharing services.  Currently supported services are:
+#
+# * Img.ly
+# * Skitch
+# * Twitpic
+# * Yfrog
+#
+# To use, just point it at a URL:
+# 
+#  require 'rubygems'
+#  require 'snip_snap'
+#
+#  client = SnipSnap.factory('http://yfrog.com/7hb9lj')
+#  puts client.image_url
+#
+# That's it.
+#
+module SnipSnap
+  
+  def self.host_map # :nodoc:
+    {
+      'skitch.com'  => 'Skitch',
+      'img.ly'      => 'Imgly',
+      'twitpic.com' => 'Twitpic',
+      'yfrog.com'   => 'Yfrog'
+    }
+  end
+
+  # Use the correct class to handle image extraction for a given URL
+  def self.factory(url)
+    const_get(class_name_for(url)).new(url)
+  end
+  
+  def self.class_name_for(url) # :nodoc:
+    uri = URI.parse(url)
+    host_map[uri.host]
+  end
+  
+end

data/lib/snip_snap/client.rb

@@ -0,0 +1,51 @@
+module SnipSnap
+  module Client # :nodoc:
+
+    module InstanceMethods
+      
+      attr_reader :url
+      
+      def initialize(url)
+        @url = url
+      end
+      
+      def get
+        get_response {|c| c.http_get }
+      end
+
+      def head
+        get_response {|c| c.http_head }
+      end
+
+      def get_response(&block)
+        client = Curl::Easy.new(url) do |config|
+          config.follow_location = true
+          config.max_redirects = 5
+        end
+
+        block.call(client)
+
+        client
+      end
+
+    end
+    
+    module ClassMethods
+      
+      def request_method(method_name)
+        class_eval <<-CODE
+          def response
+            @response ||= #{method_name}
+          end
+        CODE
+      end
+      
+    end
+    
+    def self.included(other)
+      other.send(:include, SnipSnap::Client::InstanceMethods)
+      other.send(:extend, SnipSnap::Client::ClassMethods)
+    end
+    
+  end
+end

data/lib/snip_snap/imgly.rb

@@ -0,0 +1,18 @@
+module SnipSnap
+  class Imgly
+
+    include Client
+
+    request_method :head
+    
+    def url
+      identifier = @url.match(/([^\/]+)$/)[1]
+      "http://img.ly/show/large/#{identifier}"
+    end
+    
+    def image_url
+      response.last_effective_url
+    end
+    
+  end
+end

data/lib/snip_snap/skitch.rb

@@ -0,0 +1,14 @@
+module SnipSnap
+  class Skitch
+
+    include Client
+    
+    request_method :get
+    
+    def image_url
+      body = response.body_str
+      body.match(/addImage\(\s*'([^']+)'/)[1]
+    end
+    
+  end
+end

data/lib/snip_snap/twitpic.rb

@@ -0,0 +1,18 @@
+module SnipSnap
+  class Twitpic
+    
+    include Client
+    
+    request_method :head
+    
+    def url
+      identifier = @url.match(/([^\/]+)$/)[1]
+      "http://twitpic.com/show/large/#{identifier}"
+    end
+    
+    def image_url
+      response.last_effective_url
+    end
+    
+  end
+end

data/lib/snip_snap/version.rb

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

data/lib/snip_snap/yfrog.rb

@@ -0,0 +1,19 @@
+module SnipSnap
+  class Yfrog
+    
+    include Client
+
+    request_method :get
+    
+    def url
+      identifier = @url.match(/([^\/]+)$/)[1]
+      "http://yfrog.com/api/xmlInfo?path=#{identifier}"
+    end
+
+    def image_url
+      body = response.body_str
+      body.match(/<image_link>(.+)<\/image_link>/)[1]
+    end
+    
+  end
+end

data/test/fixtures/skitch.html

@@ -0,0 +1,84 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
+<head>
+   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+   <meta name="KEYWORDS" content="Skitch Web" />
+   <meta name="DESCRIPTION" content="Skitch Web" />
+   <meta name="robots" content="index,follow" />
+   <link rel="icon" href="/favicon.ico" type="image/x-icon" />
+   <link rel="shortcut icon" href="/favicon.ico" type="image/x-icon" />
+   <title>Skitch.com &gt; reagent &gt; Clinical Reader: Research articles, news and multimedia for doctors, all in one place</title>
+   <style type="text/css" media="screen,projection">
+   /*<![CDATA[*/
+      @import "/css/mySkitch.css?13363";
+   /*]]>*/
+   </style>
+   <script type="text/javascript" src="/js/src/myskitch.composite.js?13363"></script>
+   <!-- stylesheet /-->
+   <link rel="alternate" type="application/atom+xml" title="Atom 1.0" href="http://skitch.com/feeds/reagent/atom.xml" />
+</head>
+<body id="body" onload="plasq.mySkitch.browser.loader();" onresize="plasq.mySkitch.browser.resize();">
+   
+   <div id="header">
+      <div id="logo"><a href="/"><img src="/images/logo.png" border="0" alt="" /></a></div>
+      <div id="menu">
+         <span class="shadow"><ul><li>sign-up</li> <span>|</span> <li>login</li></ul></span>
+         <span class="overlay"><ul><li><a href="/signup/">sign-up</a></li> <span class="i">|</span> <li><a href="/login/">login</a></li></ul></span>
+      </div>
+   </div>
+   
+   <div id="content"><!-- content /--></div>
+   <div id="bottomad"><!-- adzone1 /--></div>
+   
+   <div id="mtlogo"><div id="rightbar"></div><div id="rightbarbottom"><a href="http://www.mediatemple.net" target="_blank" title="Hosted by (mt)"><img src="/images/mt-hosted.png" alt="Hosted by (mt)" border="0" /></a><br /><br /><!-- adzone2 /--><br /><br /><br /><br /></div></div>
+   
+   <div id="footer">
+      <div class="left padding5px">&copy; 2007 - 2009 <a href="http://plasq.com" target="_blank">plasq</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="http://skitch.com/ToS">Terms of Service</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="http://skitch.com/Privacy">Privacy Policy</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="http://skitch.com/DMCA">DMCA Notice</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="http://help.skitch.com">Support</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="http://plasq.com/skitch">Skitch Info</a>&nbsp;&nbsp;&bull;&nbsp;&nbsp;<a href="http://blog.skitch.com">Skitch Blog</a></div>
+      <div class="right marginright"><a href="http://plasq.com" target="_blank" title="Visit plasq!"><img src="/images/footer-plasq.png" border="0" alt="Visit plasq!" /></a></div>
+   </div>
+   
+<script type="text/javascript">
+/*<![CDATA[*/
+         plasq.mySkitch.sidebar = new plasq.mySkitch.classes.container( 'content' );
+         plasq.mySkitch.sidebar.element.className = 'myskitch-image-strip-right';
+         plasq.mySkitch.sidebar.addText( '&nbsp;' );
+         plasq.mySkitch.backLink = '';
+         
+         plasq.mySkitch.selectCopyContainer = plasq.mySkitch.sidebar.addSelectCopyContainer();
+         plasq.mySkitch.selectCopyContainer.addSelectCopy( 'This page', 'http://skitch.com/reagent/baadt/clinical-reader-research-articles-news-and-multimedia-for-doctors-all-in-one-place', 'Link to the page you are looking at <b>right now</b> (Recommended)' );
+         plasq.mySkitch.selectCopyContainer.addSelectCopy( 'Image only', 'http://img.skitch.com/20090830-ejnqt1s9car55ju2sdnfirdsdn.jpg', '<b>Image only</b> link. Comments can\'t be made on these' );
+         plasq.mySkitch.selectCopyContainer.addSelectCopy( 'Embed', '<div class="thumbnail"><a href="http://skitch.com/reagent/baadt/clinical-reader-research-articles-news-and-multimedia-for-doctors-all-in-one-place"><img src="http://img.skitch.com/20090830-ejnqt1s9car55ju2sdnfirdsdn.preview.jpg" alt="Clinical Reader: Research articles, news and multimedia for doctors, all in one place" /></a><br /><span style="font-family: Lucida Grande, Trebuchet, sans-serif, Helvetica, Arial; font-size: 10px; color: #808080">Uploaded with <a href="http://plasq.com/">plasq</a>\'s <a href="http://skitch.com">Skitch</a>!</span></div>', 'HTML with zoomable <b>thumbnail</b>. (Great for eBay, MySpace blogs etc)' );
+         plasq.mySkitch.selectCopyContainer.addSelectCopy( 'Fullsize', '<img src="http://img.skitch.com/20090830-ejnqt1s9car55ju2sdnfirdsdn.jpg" alt="Clinical Reader: Research articles, news and multimedia for doctors, all in one place"/>', 'HTML to show the <b>fullsize</b> image' );
+         plasq.mySkitch.selectCopyContainer.addSelectCopy( 'Forum', '[url=http://skitch.com/reagent/baadt/clinical-reader-research-articles-news-and-multimedia-for-doctors-all-in-one-place][img]http://img.skitch.com/20090830-ejnqt1s9car55ju2sdnfirdsdn.preview.jpg[/img][/url][br][url=http://skitch.com/reagent/baadt/clinical-reader-research-articles-news-and-multimedia-for-doctors-all-in-one-place]Click for full size[/url] - [color=#A7A7A7]Uploaded with [url=http://plasq.com]plasq[/url]\'s [url=http://skitch.com]Skitch[/url][/color]', 'For use in web based <b>forums</b>' );
+         
+         $('mtlogo').style.right = '32px';
+         $('mtlogo').style.top = '304px';
+         
+         plasq.mySkitch.container = new plasq.mySkitch.classes.container( 'content' );
+         plasq.mySkitch.container.addSection( 'Clinical Reader: Research articles, news and multimedia for doctors, all in one place' );
+         plasq.mySkitch.container.addText( '<div style="display:block;" class="myskitch-header-notes">Pssst!.. This page is Secret - it can only be seen if you give people the URL</div>' );
+         plasq.mySkitch.container.addImage( 'http://img.skitch.com/20090830-ejnqt1s9car55ju2sdnfirdsdn.jpg', '', '', '', false, '472', '459' ).enableInfo().enableSlurp( 'skitch://img.skitch.com/20090830-ejnqt1s9car55ju2sdnfirdsdn.jpg?skitchtitle=Re%3A%20Clinical%20Reader%3A%20Research%20articles%2C%20news%20and%20multimedia%20for%20doctors%2C%20all%20in%20one%20place' ).enableDescription( '&nbsp;' );
+         plasq.mySkitch.container.addText( '&nbsp;<br />&nbsp;' );
+         plasq.mySkitch.container.addSection( 'Comments' );
+         plasq.mySkitch.container.comments = plasq.mySkitch.container.addComments( '77fdb5-801093-1b64d7-a01c34-df9430-dd', 'This image has no comments yet. Be the first!', '0d171c5663e826463cc1f8eb32cdb0fa', true, '0' );
+/*]]>*/
+</script>
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
+</script>
+<script type="text/javascript">
+_uacct = "UA-2305120-1";
+urchinTracker();
+</script>
+
+<!-- Start Quantcast tag -->
+<script type="text/javascript" src="https://secure.quantserve.com/quant.js"></script>
+<script type="text/javascript">
+_qacct="p-a3PI6F3Y912Tk";
+quantserve();
+</script>
+<noscript>
+<img src="https://secure.quantserve.com/pixel/p-a3PI6F3Y912Tk.gif" style="display: none" height="1" width="1" alt="Quantcast"/></noscript>
+<!-- End Quantcast tag -->
+
+</body>
+</html>

data/test/fixtures/yfrog.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="iso-8859-1"?><imginfo xmlns="http://ns.imageshack.us/imginfo/7/" version="7" timestamp="1251516300">
+  <rating>
+    <ratings>0</ratings>
+    <avg>0.0</avg>
+  </rating>
+  <files server="377" bucket="9665">
+     <image size="29599" content-type="image/jpeg">b97.jpg</image>
+     <thumb size="4042" content-type="image/jpeg">b97.th.jpg</thumb>
+  </files>
+  <resolution>
+    <width>525</width>
+    <height>700</height>
+  </resolution>
+  <class>r</class>
+  <visibility>yes</visibility>
+  <uploader>
+    <ip>38.99.76.246</ip>
+    <cookie>1d5927aee7676b56f5fb5e1c6dc386bf</cookie>
+    <username>twitter~urbanflex</username>
+  </uploader>
+  <links>
+    <image_link>http://img377.imageshack.us/img377/9665/b97.jpg</image_link>
+    <image_html>&lt;a href=&quot;http://img377.imageshack.us/my.php?image=b97.jpg&quot; target=&quot;_blank&quot;&gt;&lt;img src=&quot;http://img377.imageshack.us/img377/9665/b97.jpg&quot; alt=&quot;Free Image Hosting at www.ImageShack.us&quot; border=&quot;0&quot;/&gt;&lt;/a&gt;</image_html>
+    <image_bb>[URL=http://img377.imageshack.us/my.php?image=b97.jpg][IMG]http://img377.imageshack.us/img377/9665/b97.jpg[/IMG][/URL]</image_bb>
+    <image_bb2>[url=http://img377.imageshack.us/my.php?image=b97.jpg][img=http://img377.imageshack.us/img377/9665/b97.jpg][/url]</image_bb2>
+    <thumb_link>http://img377.imageshack.us/img377/9665/b97.th.jpg</thumb_link>
+    <thumb_html>&lt;a href=&quot;http://img377.imageshack.us/my.php?image=b97.jpg&quot; target=&quot;_blank&quot;&gt;&lt;img src=&quot;http://img377.imageshack.us/img377/9665/b97.th.jpg&quot; alt=&quot;Free Image Hosting at www.ImageShack.us&quot; border=&quot;0&quot;/&gt;&lt;/a&gt;</thumb_html>
+    <thumb_bb>[URL=http://img377.imageshack.us/my.php?image=b97.jpg][IMG]http://img377.imageshack.us/img377/9665/b97.th.jpg[/IMG][/URL]</thumb_bb>
+    <thumb_bb2>[url=http://img377.imageshack.us/my.php?image=b97.jpg][img=http://img377.imageshack.us/img377/9665/b97.th.jpg][/url]</thumb_bb2>
+    <yfrog_link>http://yfrog.com/ahb97j</yfrog_link>
+    <yfrog_thumb>http://yfrog.com/ahb97j.th.jpg</yfrog_thumb>
+    <ad_link>http://img377.imageshack.us/my.php?image=b97.jpg</ad_link>
+    <done_page>http://img377.imageshack.us/content.php?page=done&amp;l=img377/9665/b97.jpg</done_page>
+  </links>
+</imginfo>

data/test/test_helper.rb

@@ -0,0 +1,15 @@
+# http://sneaq.net/textmate-wtf
+$:.reject! { |e| e.include? 'TextMate' }
+
+require 'rubygems'
+require 'throat_punch'
+
+require File.dirname(__FILE__) + '/../lib/snip_snap'
+
+class Test::Unit::TestCase
+
+  def read_fixture(filename)
+    File.read(File.dirname(__FILE__) + '/fixtures/' + filename)
+  end
+
+end

data/test/unit/snip_snap/client_test.rb

@@ -0,0 +1,106 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+
+class ClientImplementation
+  include SnipSnap::Client
+end
+
+class ClientGetImplementation
+  include SnipSnap::Client
+  request_method :get
+end
+
+class ClientHeadImplementation
+  include SnipSnap::Client
+  request_method :head
+end
+
+module SnipSnap
+  class ClientTest < Test::Unit::TestCase
+    
+    context "An instance of the ClientImplementation class" do
+      
+      should "be able to make a get request" do
+        url = 'http://example.com'
+        
+        client = mock() do |c|
+          c.expects(:http_get).with()
+        end
+        
+        config = mock() do |c|
+          c.expects(:follow_location=).with(true)
+          c.expects(:max_redirects=).with(5)
+        end
+        
+        Curl::Easy.expects(:new).with(url).yields(config).returns(client)
+        
+        c = ClientImplementation.new(url)
+        c.get.should == client
+      end
+      
+      should "be able to make a head request" do
+        url = 'http://example.com'
+        
+        client = mock() do |c|
+          c.expects(:http_head).with()
+        end
+        
+        config = mock() do |c|
+          c.expects(:follow_location=).with(true)
+          c.expects(:max_redirects=).with(5)
+        end
+        
+        Curl::Easy.expects(:new).with(url).yields(config).returns(client)
+        
+        c = ClientImplementation.new(url)
+        c.head.should == client
+      end
+      
+    end
+    
+    context "An instance of the ClientGetImplementation class" do
+      
+      should "fetch a response using a GET request when calling response" do
+        response = stub()
+        
+        c = ClientGetImplementation.new('http://example.com')
+        c.expects(:get).with().returns(response)
+        
+        c.response.should == response
+      end
+      
+      should "cache the response object" do
+        response = stub()
+        
+        c = ClientGetImplementation.new('http://example.com')
+        c.expects(:get).once.with().returns(response)
+        
+        2.times { c.response.should }
+      end
+      
+    end
+    
+    context "An instance of the ClientHeadImplementation class" do
+      
+      should "fetch a response using a GET request when calling response" do
+        response = stub()
+        
+        c = ClientHeadImplementation.new('http://example.com')
+        c.expects(:head).with().returns(response)
+        
+        c.response.should == response
+      end
+      
+      should "cache the response object" do
+        response = stub()
+        
+        c = ClientHeadImplementation.new('http://example.com')
+        c.expects(:head).once.with().returns(response)
+        
+        2.times { c.response.should }
+      end
+      
+    end
+    
+    
+  end
+end

data/test/unit/snip_snap/imgly_test.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+
+module SnipSnap
+  class ImglyTest < Test::Unit::TestCase
+    
+    context "An instance of the Imgly class" do
+      setup do
+        @url          = 'http://img.ly/3aa'
+        @expanded_url = 'http://img.ly/show/large/3aa'
+      end
+
+      should "have a url expanded from the source" do
+        i = SnipSnap::Imgly.new(@url)
+        i.url.should == @expanded_url
+      end
+      
+      should "use a HEAD request when retrieving the response" do
+        response = stub()
+        
+        i = SnipSnap::Imgly.new(@url)
+        i.expects(:head).with().returns(response)
+        
+        i.response.should == response
+      end
+      
+      should "be able to return an image url for a given url" do
+        response = stub()
+        response.stubs(:last_effective_url).with().returns(@expanded_url)
+        
+        i = SnipSnap::Imgly.new(@url)
+        i.stubs(:response).with().returns(response)
+        
+        i.image_url.should == @expanded_url
+      end
+      
+    end
+    
+  end
+end
+

data/test/unit/snip_snap/skitch_test.rb

@@ -0,0 +1,37 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+
+module SnipSnap
+  class SkitchTest < Test::Unit::TestCase
+
+    context "An instance of the Skitch class" do
+      setup { @url = 'http://skitch.com/example' }
+      
+      should "have a URL" do
+        s = SnipSnap::Skitch.new(@url)
+        s.url.should == @url
+      end
+      
+      should "use a GET request when retrieving the response" do
+        response = stub()
+        
+        s = SnipSnap::Skitch.new(@url)
+        s.expects(:get).with().returns(response)
+        
+        s.response.should == response
+      end
+            
+      should "be able to return an image url for a given url" do
+        s = SnipSnap::Skitch.new(@url)
+        
+        response = stub()
+        response.stubs(:body_str).with().returns(read_fixture('skitch.html'))
+        
+        s.stubs(:response).with().returns(response)
+        
+        s.image_url.should == 'http://img.skitch.com/20090830-ejnqt1s9car55ju2sdnfirdsdn.jpg'
+      end
+      
+    end
+    
+  end
+end

data/test/unit/snip_snap/twitpic_test.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+
+module SnipSnap
+  class TwitpicTest < Test::Unit::TestCase
+    
+    context "An instance of the Twitpic class" do
+      setup do
+        @url          = 'http://twitpic.com/203o0'
+        @expanded_url = 'http://twitpic.com/show/large/203o0'
+      end
+      
+      should "have a url derived from the source URL" do
+        t = SnipSnap::Twitpic.new(@url)
+        t.url.should == @expanded_url
+      end
+      
+      should "use a HEAD request when retrieving the response" do
+        response = stub()
+        
+        t = SnipSnap::Twitpic.new(@url)
+        t.expects(:head).with().returns(response)
+        
+        t.response.should == response
+      end
+      
+      should "be able to return an image url for a given url" do
+        response = stub()
+        response.stubs(:last_effective_url).with().returns(@expanded_url)
+        
+        t = SnipSnap::Twitpic.new(@url)
+        t.stubs(:response).with().returns(response)
+        
+        t.image_url.should == @expanded_url
+      end
+
+      
+    end
+    
+  end
+end

data/test/unit/snip_snap/yfrog_test.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+
+module SnipSnap
+  class YfrogTest < Test::Unit::TestCase
+    
+    context "An instance of the Yfrog class" do
+      setup do
+        @url          = 'http://yfrog.com/ahb97j'
+        @expanded_url = 'http://yfrog.com/api/xmlInfo?path=ahb97j'
+      end
+
+      should "have a url derived from the source URL" do
+        y = SnipSnap::Yfrog.new(@url)
+        y.url.should == @expanded_url
+      end
+      
+      should "use a GET request when retrieving the response" do
+        response = stub()
+        
+        y = SnipSnap::Yfrog.new(@url)
+        y.expects(:get).with().returns(response)
+        
+        y.response.should == response
+      end
+      
+      should "be able to return an image url for a given url" do
+        y = SnipSnap::Yfrog.new(@url)
+        
+        response = stub()
+        response.stubs(:body_str).with().returns(read_fixture('yfrog.xml'))
+        
+        y.stubs(:response).with().returns(response)
+        
+        y.image_url.should == 'http://img377.imageshack.us/img377/9665/b97.jpg'
+      end
+      
+    end
+    
+  end
+end

data/test/unit/snip_snap_test.rb

@@ -0,0 +1,57 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class SnipSnapTest < Test::Unit::TestCase
+
+  describe "The SnipSnap module" do
+
+    should "know the correct class name for a Skitch URL" do
+      url = 'http://skitch.com/reagent/bh4ei/bleeergh'
+      SnipSnap.class_name_for(url).should == 'Skitch'
+    end
+    
+    should "know the correct class name for an Imgly URL" do
+      url = 'http://img.ly/3ey'
+      SnipSnap.class_name_for(url).should == 'Imgly'
+    end
+    
+    should "know the correct class name for a Twitpic URL" do
+      url = 'http://twitpic.com/203o0'
+      SnipSnap.class_name_for(url).should == 'Twitpic'
+    end
+    
+    should "know the correct class name for a Yfrog URL" do
+      url = 'http://yfrog.com/ahb97j'
+      SnipSnap.class_name_for(url).should == 'Yfrog'
+    end
+    
+    should "be able to create an instance of the Skitch class with the supplied URL" do
+      url = 'http://skitch.com/reagent/bh4ei/bleeergh'
+      SnipSnap::Skitch.expects(:new).with(url).returns('skitch')
+      
+      SnipSnap.factory(url).should == 'skitch'
+    end
+    
+    should "be able to create an instance of the Imgly class with the supplied URL" do
+      url = 'http://img.ly/3ey'
+      SnipSnap::Imgly.expects(:new).with(url).returns('imgly')
+      
+      SnipSnap.factory(url).should == 'imgly'
+    end
+    
+    should "be able to create an instance of the Twitpic class with the supplied URL" do
+      url = 'http://twitpic.com/203o0'
+      SnipSnap::Twitpic.expects(:new).with(url).returns('twitpic')
+
+      SnipSnap.factory(url).should == 'twitpic'
+    end
+
+    should "be able to create an instance of the Yfrog class with the supplied URL" do
+      url = 'http://yfrog.com/ahb97j'
+      SnipSnap::Yfrog.expects(:new).with(url).returns('yfrog')
+
+      SnipSnap.factory(url).should == 'yfrog'
+    end
+    
+  end
+
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification 
+name: snip-snap
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Patrick Reagan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-02 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: curb
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.1.0
+    version: 
+description: 
+email: reaganpr@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- Rakefile
+- lib/snip_snap/client.rb
+- lib/snip_snap/imgly.rb
+- lib/snip_snap/skitch.rb
+- lib/snip_snap/twitpic.rb
+- lib/snip_snap/version.rb
+- lib/snip_snap/yfrog.rb
+- lib/snip_snap.rb
+- test/fixtures/skitch.html
+- test/fixtures/yfrog.xml
+- test/test_helper.rb
+- test/unit/snip_snap/client_test.rb
+- test/unit/snip_snap/imgly_test.rb
+- test/unit/snip_snap/skitch_test.rb
+- test/unit/snip_snap/twitpic_test.rb
+- test/unit/snip_snap/yfrog_test.rb
+- test/unit/snip_snap_test.rb
+has_rdoc: true
+homepage: http://sneaq.net
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+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: 
+rubygems_version: 1.3.4
+signing_key: 
+specification_version: 3
+summary: A ruby library that allows you to extract images from popular image-sharing services
+test_files: []
+