thumbnail 0.2.0

data/spec/client_spec.rb

@@ -0,0 +1,284 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require  File.dirname(__FILE__) + '/../lib/thumbnail.rb'
+
+module SetupOpts
+  def auth_opts
+    {:access_key_id => "asdfsdfasdf", :secret_access_key => "asdfsadfasf"}
+  end
+end
+
+module NoGo
+  def stub_request
+    Net::HTTP.stub!(:get)
+  end
+end
+
+describe "Thumbnail::Client#new" do
+  include SetupOpts
+  
+  it "should default to the thumbnail action" do
+    t = Thumbnail::Client.new(auth_opts)
+    t.action.should == :thumbnail
+  end
+  
+  it "should set the action as redirect if specified" do
+    t = Thumbnail::Client.new( auth_opts.merge(:action => :redirect) )
+    t.action.should == :redirect
+  end
+  
+  it "should raise an error if the action is neither redirect nor thumbnail" do
+    lambda{ Thumbnail::Client.new(auth_opts.merge(:action => :dogs) ) }.should raise_error(ArgumentError)
+  end
+  
+  it "should raise an error if the access_key_id is not specified" do
+    lambda{ Thumbnail::Client.new(:secret_access_key => "asdfsadfasf")}.should raise_error(ArgumentError)
+  end
+  
+  it "should raise an error if the secret_access_key is not specified" do
+    lambda{ Thumbnail::Client.new(:access_key_id => "asdfsadfasf")}.should raise_error(ArgumentError)
+  end
+  
+  it "should default the size to large" do
+    t = Thumbnail::Client.new(auth_opts)
+    t.size.should == :large
+  end
+  it "should set the size to small if specified" do
+    t = Thumbnail::Client.new( auth_opts.merge(:size => :small) )
+    t.size.should == :small
+  end
+  
+  it "should raise an error if the size is neither large nor small" do
+    lambda{ Thumbnail::Client.new(auth_opts.merge(:size => :largest) ) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise an error if a default_image is specified for a Thumbnail action" do
+    lambda{ Thumbnail::Client.new(auth_opts.merge(:default_image => "http://somewhere.com/my_pict.jpg")) }.should raise_error(ArgumentError)
+  end  
+end
+
+describe "Thumbnail::Client#new for a redirect" do
+  include SetupOpts
+
+  it "should set the default_image if specified" do
+    t = Thumbnail::Client.new(auth_opts.merge(:action => :redirect, :default_image => "http://somewhere.com/my_pict.jpg"))
+    t.instance_variable_get("@default_image").should == "http://somewhere.com/my_pict.jpg"
+  end
+
+end
+
+describe "Thumbnail#query" do
+  include SetupOpts
+  
+  it "should calculate the signature and timestamp" do
+    t = Thumbnail::Client.new(auth_opts)
+    t.should_receive(:calculate_signature_and_timestamp)
+    t.send(:query)
+  end
+end
+
+describe "Thumbnail#calculate_signature_and_timestamp" do
+    include SetupOpts
+
+  before do
+    @t = Thumbnail::Client.new(auth_opts)
+  end
+
+  it "should calculate the signature" do
+    Base64.should_receive(:encode64).and_return("se5wwsefaw435rawef=")
+    @t.send(:calculate_signature_and_timestamp)
+  end
+  
+  it "should set the (correctly formatted) timestamp" do
+    Time.stub!(:now).and_return(Time.mktime(2007,7,1,12))
+    @t.send(:calculate_signature_and_timestamp)
+    @t.instance_variable_get("@timestamp").should == "2007-07-01T19:00:00.000Z"
+  end
+end
+
+describe "Thumbnail#query with thumbnail action and a single url" do
+  include SetupOpts
+  
+  before do
+    @t = Thumbnail::Client.new(auth_opts)
+    @t.instance_variable_set("@url", "www.boingboing.net")
+  end
+  
+  it "should compose a thumbnail single query" do
+    @t.should_receive(:thumbnail_query_single)
+    @t.send(:query)
+  end
+end
+
+describe "Thumbnail::Client#query with thumbnail action and an array of urls" do
+  include SetupOpts
+  
+  before do
+    @t = Thumbnail::Client.new(auth_opts)
+    @t.instance_variable_set("@url", ["www.boingboing.net", "www.craphound.com"])
+
+  end
+  
+  it "should compose a thumbnail batch query" do
+    @t.should_receive(:thumbnail_query_batch)
+    @t.send(:query)
+  end
+end
+
+describe "Thumbnail::Client#query with redirect action" do
+  include SetupOpts
+  
+  before do
+    @t = Thumbnail::Client.new( auth_opts.merge(:action => :redirect) )
+    @t.instance_variable_set("@url", "www.boingboing.net")
+  end
+  
+  it "should compose a redirect query" do
+    @t.should_receive(:redirect_query)
+    @t.send(:query)
+  end
+end
+
+describe "Thumbnail::Client#thumbnail_query_single" do
+  include SetupOpts
+  
+  before do
+    Time.stub!(:now).and_return(Time.mktime(2007,7,1,15))
+    @t = Thumbnail::Client.new( auth_opts )
+    @t.send(:calculate_signature_and_timestamp)
+  end
+
+  it "should compose the query url correctly" do
+    @t.instance_variable_set("@url", "www.boingboing.net")
+    @t.send(:thumbnail_query_single).should == "http://ast.amazonaws.com/?Action=Thumbnail&AWSAccessKeyId=#{auth_opts[:access_key_id]}&Signature=f2g%2BLOp8T1ZfWLEip7l4RXiPQkI%3D&Timestamp=2007-07-01T22:00:00.000Z&Url=www.boingboing.net&Size=Large"
+  end
+end
+
+describe "Thumbnail::Client#thumbnail_query_batch" do
+  include SetupOpts
+  
+  before do
+    Time.stub!(:now).and_return(Time.mktime(2007,7,1,15))
+    @t = Thumbnail::Client.new( auth_opts )
+    @t.send(:calculate_signature_and_timestamp)
+  end
+  
+  it "should compose the query url correctly" do
+    @t.instance_variable_set("@url", ["www.boingboing.net", "www.craphound.com"])
+    @t.send(:thumbnail_query_batch).should == 
+    "http://ast.amazonaws.com/?Action=Thumbnail&AWSAccessKeyId=#{auth_opts[:access_key_id]}&Signature=f2g%2BLOp8T1ZfWLEip7l4RXiPQkI%3D&Timestamp=2007-07-01T22:00:00.000Z&Shared.Size=Large&Thumbnail.1.Url=www.boingboing.net&Thumbnail.2.Url=www.craphound.com"
+  end
+end
+
+describe "Thumbnail::Client#redirect_query with a default_image" do
+  include SetupOpts
+  
+  before do
+    Time.stub!(:now).and_return(Time.mktime(2007,7,1,15))
+    @t = Thumbnail::Client.new( auth_opts.merge(:action => :redirect, :default_image => "http://somewhere.com/my_pict.jpg") )
+    @t.send(:calculate_signature_and_timestamp)
+  end
+  
+  it "should compose the query url correctly" do
+    @t.instance_variable_set("@url", "www.boingboing.net")
+
+    @t.send(:redirect_query).should == 
+    "http://ast.amazonaws.com/?Action=Redirect&AWSAccessKeyId=#{auth_opts[:access_key_id]}&Signature=%2FceiRH2lULi0rTvaY0mmJhxIwa4%3D&Timestamp=2007-07-01T22:00:00.000Z&Url=www.boingboing.net&Size=Large&DefaultImage=http://somewhere.com/my_pict.jpg"
+  end
+end
+
+describe "Thumbnail::Client#redirect_query without a default_image" do
+  include SetupOpts
+  
+  before do
+    Time.stub!(:now).and_return(Time.mktime(2007,7,1,15))
+    @t = Thumbnail::Client.new( auth_opts.merge(:action => :redirect) )
+    @t.send(:calculate_signature_and_timestamp)
+  end
+  
+  it "should compose the query url correctly" do
+    @t.instance_variable_set("@url", "www.boingboing.net")
+    @t.send(:redirect_query).should ==
+    "http://ast.amazonaws.com/?Action=Redirect&AWSAccessKeyId=#{auth_opts[:access_key_id]}&Signature=%2FceiRH2lULi0rTvaY0mmJhxIwa4%3D&Timestamp=2007-07-01T22:00:00.000Z&Url=www.boingboing.net&Size=Large"
+  end
+end
+
+describe "Thumbnail::Client#get with a thumbnail action" do
+  include SetupOpts
+  include NoGo
+  
+  before do
+    stub_request
+    Thumbnail::Response.stub!(:build)
+    @t = Thumbnail::Client.new(auth_opts)
+    @t.stub!(:query).and_return(@q = "http://aws.com")
+    @pq = mock('URI::HTTP')
+    @pq.stub!(:host).and_return('aws.com')
+    URI.stub!(:parse).and_return(@pq)
+    Net::HTTP.stub!(:get).and_return(@xml = mock('xmldoc'))
+  end
+  
+  it "should set the url string if given a single url" do
+    @t.get("www.boingboing.net")
+    @t.instance_variable_get("@url").should == "www.boingboing.net"
+  end
+  
+  it "should set the url array if given an array of urls" do
+    @t.get(["www.boingboing.net", "www.craphound.com"])
+    @t.instance_variable_get("@url").should == ["www.boingboing.net", "www.craphound.com"]
+  end
+  
+  it "should parse the url before conducting the query" do
+    URI.should_receive(:parse).with(@q).and_return(@pq)
+    @t.get("www.craphound.com")
+  end
+  
+  it "should use net/https to conduct the query" do
+    Net::HTTP.should_receive(:get).with(@pq)
+    @t.get("www.craphound.com")
+  end
+  
+  it "should build a response object from the xml" do
+    Thumbnail::Response.should_receive(:build).with(@xml)
+    @t.get("www.craphound.com")
+  end
+end
+
+describe "Thumbnail::Client#get with one or more invalid urls" do
+  include SetupOpts
+
+  before do
+    @t = Thumbnail::Client.new(auth_opts)
+  end
+  
+  it "should raise an error with one url that is invalid" do
+    lambda{ @t.get("89u--=sdf-://as-df-") }.should raise_error(URI::InvalidURIError)
+  end
+  
+  it "should raise an error if any of the urls in its give array are invalid" do
+    lambda{ @t.get(["89u--=s:?df-as-df-", "www.google.com"]) }.should raise_error(URI::InvalidURIError)
+  end
+  
+end
+
+describe "Thumbnail::Client#get with a redirect action" do
+  include SetupOpts
+  include NoGo
+  
+  before do
+    stub_request
+    @t = Thumbnail::Client.new(auth_opts.merge(:action => :redirect))
+  end
+  
+  it "should raise an error if given an array of urls" do
+    lambda{ @t.get(["www.boingboing.net", "www.craphound.com"]) }.should raise_error(ArgumentError)
+  end
+  
+  it "should calculate the query url" do
+    @t.should_receive(:query)
+    @t.get("www.boingboing.net")
+  end
+  
+  it "should return the redirect query" do
+    @t.get("www.boingboing.net").should == @t.send(:redirect_query)
+  end
+end

data/spec/fixtures/batch.xml

@@ -0,0 +1,64 @@
+<?xml version="1.0"?>
+<aws:ThumbnailResponse
+xmlns:aws="http://ast.amazonaws.com/doc/2005-10-05/">
+        <aws:Response>
+                <aws:OperationRequest>
+                        <aws:RequestId>
+                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+                        </aws:RequestId>
+                </aws:OperationRequest>
+                <aws:ThumbnailResult>
+                        <aws:Thumbnail Exists="true">
+                                http://location_to_thumbnail_for_alexa.com
+                        </aws:Thumbnail>
+                        <aws:RequestUrl>
+                                alexa.com
+                        </aws:RequestUrl>
+                </aws:ThumbnailResult>
+                <aws:ResponseStatus>
+                        <aws:StatusCode>
+                                Success
+                        </aws:StatusCode>
+                </aws:ResponseStatus>
+        </aws:Response>
+        <aws:Response>
+                <aws:OperationRequest>
+                        <aws:RequestId>
+                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+                        </aws:RequestId>
+                </aws:OperationRequest>
+                <aws:ThumbnailResult>
+                        <aws:Thumbnail Exists="true">
+                                http://location_to_thumbnail_for_amazon.com
+                        </aws:Thumbnail>
+                        <aws:RequestUrl>
+                                amazon.com
+                        </aws:RequestUrl>
+                </aws:ThumbnailResult>
+                <aws:ResponseStatus>
+                        <aws:StatusCode>
+                                Success
+                        </aws:StatusCode>
+                </aws:ResponseStatus>
+        </aws:Response>
+        <aws:Response>
+                <aws:OperationRequest>
+                        <aws:RequestId>
+                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+                        </aws:RequestId>
+                </aws:OperationRequest>
+                <aws:ThumbnailResult>
+                        <aws:Thumbnail Exists="true">
+                                http://location_to_thumbnail_for_a9.com
+                        </aws:Thumbnail>
+                        <aws:RequestUrl>
+                                a9.com
+                        </aws:RequestUrl>
+                </aws:ThumbnailResult>
+                <aws:ResponseStatus>
+                        <aws:StatusCode>
+                                Success
+                        </aws:StatusCode>
+                </aws:ResponseStatus>
+        </aws:Response>
+</aws:ThumbnailResponse>

data/spec/fixtures/invalid_credentials.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0"?>
+<Response>
+  <Errors>
+    <Error>
+      <Code>AuthFailure</Code>
+      <Message>AWS was not able to validate the provided access credentials</Message>
+    </Error>
+  </Errors>
+  <RequestID>5bb2ed01-8ff3-4622-a359-af9b9dcb80b2</RequestID>
+</Response>

data/spec/fixtures/single.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0"?>
+<aws:ThumbnailResponse xmlns:aws="http://ast.amazonaws.com/doc/2005-10-05/">
+  <aws:Response>
+    <aws:OperationRequest>
+      <aws:RequestId>429d5fa3-e7b3-43d7-98ee-35ec9b01750f</aws:RequestId>
+    </aws:OperationRequest>
+    <aws:ThumbnailResult>
+      <aws:Thumbnail Exists="true">http://s3-external-1.amazonaws.com/alexa-thumbnails/421922F1CA73EF1FB344425517D124FA5F84E8DDl?Signature=sL4Ldjh336C2KJ8RMaWoswMah9k%3D&amp;Expires=1181512094&amp;AWSAccessKeyId=1FVZ0JNEJDA5TK457CR2</aws:Thumbnail>
+      <aws:RequestUrl>www.boingboing.net</aws:RequestUrl>
+    </aws:ThumbnailResult>
+    <aws:ResponseStatus>
+      <aws:StatusCode>Success</aws:StatusCode>
+    </aws:ResponseStatus>
+  </aws:Response>
+</aws:ThumbnailResponse>

data/spec/fixtures/unexists.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0"?>
+<aws:ThumbnailResponse xmlns:aws="http://ast.amazonaws.com/doc/2005-10-05/"><aws:Response><aws:OperationRequest><aws:RequestId>c4ab78dc-77f1-4534-9458-45436f689c1b</aws:RequestId></aws:OperationRequest><aws:ThumbnailResult><aws:Thumbnail Exists="false">http://s3-external-1.amazonaws.com/alexa-thumbnails/noimagel?Signature=ZEDPUK7B%2FpLsNwufU%2FafuHPrIR0%3D&amp;Expires=1181687213&amp;AWSAccessKeyId=1FVZ0JNEJDA5TK457CR2</aws:Thumbnail><aws:RequestUrl>www.thenytimesexplainstheratings.com</aws:RequestUrl></aws:ThumbnailResult><aws:ResponseStatus><aws:StatusCode>Success</aws:StatusCode></aws:ResponseStatus></aws:Response></aws:ThumbnailResponse>

data/spec/response_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require  File.dirname(__FILE__) + '/../lib/thumbnail.rb'
+
+describe "Thumbnail::Response#build with a successful single response" do
+  before do
+    @xml = parse_fixture("single")
+  end
+  
+  it "should create a Thumbnail::Response::Success object" do
+    Thumbnail::Response::Success.should_receive(:new)
+    Thumbnail::Response.build(@xml)
+  end
+end
+
+describe "Thumbnail::Response#build with a successful batch response" do
+  before do
+    @xml = parse_fixture("batch")
+  end
+  
+  it "should create a Thumbnail::Response::Success object" do
+    Thumbnail::Response::Success.should_receive(:new)
+    Thumbnail::Response.build(@xml)
+  end
+end
+
+describe "Thumbnail::Response#build with an invalid credentails response" do
+  before do
+    @xml = parse_fixture("invalid_credentials")
+  end
+  
+  it "should create a Thumbnail::Response::Failure object" do
+    Thumbnail::Response::Failure.should_receive(:new)
+    Thumbnail::Response.build(@xml)
+  end
+  
+  it "should correctly parse out and format the error message" do
+    r = Thumbnail::Response.build(@xml)
+    r.to_s.should == "AuthFailure: AWS was not able to validate the provided access credentials"
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/website/index.html

@@ -0,0 +1,147 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>
+      THUMBNAIL: website pix courtesy of ruby, amazon, and alexa
+  </title>
+  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
+<style>
+
+</style>
+  <script type="text/javascript">
+    window.onload = function() {
+      settings = {
+          tl: { radius: 10 },
+          tr: { radius: 10 },
+          bl: { radius: 10 },
+          br: { radius: 10 },
+          antiAlias: true,
+          autoPad: true,
+          validTags: ["div"]
+      }
+      var versionBox = new curvyCorners(settings, document.getElementById("version"));
+      versionBox.applyCornersToAll();
+    }
+  </script>
+</head>
+<body>
+<div id="main">
+<img src="logo.png" id="logo">
+    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/thumbnail"; return false'>
+      <p>Get Version</p>
+      <a href="http://rubyforge.org/projects/thumbnail" class="numbers">0.2.0</a>
+    </div>
+
+
+	<h2>What</h2>
+<p>A Ruby wrapper for the <a href="http://www.amazon.com/b/ref=sc_fe_c_0_239513011_4/102-1130464-8229719?ie=UTF8&node=236156011&no=239513011&me=A36L942TSJ2AJA">Amazon Web Services Alexa Site Thumbnail Service</a> REST API, which provides website thumbnail images on demand for a small fee ($0.20/1000).</p>
+
+	<h2>Installing</h2>
+
+
+<pre syntax="ruby">$ sudo gem install thumbnail</pre>
+
+<p>Thumbnail depends on the terrific <a href="http://code.whytheluckystiff.net/hpricot/">Hpricot</a> XHTML parsing and manipulation library by <a href="whytheluckystiff.net">why the lucky stiff</a>; version 0.5 or better has the necessary powers.</p>
+
+	<h2>Registering with Amazon</h2>
+  <p>
+    In order to use the AWS-AST api, you must first complete the following series of bureaucratic tasks:
+    <ol>
+      <li><a href="http://aws.amazon.com">Signup for an Amazon Web Services account</a> (if you don't yet have one). You can use your existing Amazon user account for this or create a new one.</li>
+      <li><a href="http://www.amazon.com/b/ref=sc_fe_c_0_239513011_4/102-1130464-8229719?ie=UTF8&node=236156011&no=239513011&me=A36L942TSJ2AJA">Signup for the Alexa Site Thumbnail Service</a>.</li>
+      <li>Find and note your AWS Access Key Id and your Secret Access Key. You'll need to tell Thumbnail about these for authentication's sake; you should be given them at the end of the signup process.</li>
+    </ol>
+  </p>
+  <p>
+    Registering for both of these accounts is free, payment for the Site Thumbnail Service is based entirely on usage, with no charges for requests for unavailable thumbnails.
+  </p>
+	<h2>Demonstration of usage</h2>
+	<p>The API provides two actions for accessing site thumbnails: Thumbnail and Redirect and the Thumbnail::Client supports 'em both.
+	  </p>
+	  <h3>Thumbnail Action</h3>
+	  When conducting a thumbnail action (the default), the Client will conduct an api call to fetch the image url(s) from Amazon for immediate download of your thumbnail(s) as follows:
+	
+<pre>
+require 'thumbnail'
+require 'open-uri'
+
+t = Thumbnail::Client.new :access_key_id =&gt; YOUR_ACCESS_KEY_ID, 
+                          :secret_access_key =&gt; YOUR_SECRET_ACCESS_KEY
+url = t.get(&quot;www.craphound.com&quot;)[:thumbnail][:url]
+File.open(&quot;craphound.jpg&quot;, &quot;w&quot;) { |f| f.write open(url).read }
+</pre>
+The result will look something like this:<br />
+<img src="craphound.jpg">
+</p>
+<p>You can also request thumbnails for multiple images simultaneously by passing an array of urls to <code>get</code>. If you do that, you'll have to access the response object differently (see below).</p>
+<p><em>Note: Once you make the <code>get</code> call, and the request to AST goes out, you only have fifteen seconds to use the resulting image url before it expires. This can play havoc with by-hand testing. I recommend that you run something very much like the final line in the example immediately.</em></p>
+<h3>The Response Object</h3>
+  <p>
+    Thumbnail action requests will return either a Thumbnail::Response::Success or Thumbnail::Response::Failure object depending on their outcome. Each of these objects offer access to the raw xml response and the Hpricot::Doc object built from parsing it in addtion to the parsed results hash. Further, the <code>[]</code> method has been defined to provide easy access to the parsed results as seen in the example above. Calling <code>to_s</code> on a Failure object will provide a helpful concatenation of the error messages returned by Amazon.
+  </p>
+<h3>Redirect Action</h3>
+<p>
+  For a redirect action, the Thumbnail::Client will simply compose and return the image url like so:
+<pre>
+require 'thumbnail'
+
+t = Thumbnail::Client.new :access_key_id =&gt; YOUR_ACCESS_KEY_ID, 
+                          :secret_access_key =&gt; YOUR_SECRET_ACCESS_KEY,
+                          :action =&gt; :redirect
+url = t.get(&quot;www.twitter.com&quot;)
+
+#=&gt; http://ast.amazonaws.com/?Action=Redirect&amp;AWSAccessKeyId=YOUR_ACCESS_KEY_ID
+&amp;Signature=sdhfiawrkjw3h9bncoa8ue&amp;Timestamp=2007-06-14T09:09:18.000Z&amp;Url=www.tw
+itter.com&amp;Size=Large
+</pre> 
+The resulting url will redirect to the thumbnail image hosted on s3. This action is perfect for dynamic inclusion of AWS-AST-generated thumbnails in live web pages. <em>Note: this usage of the Thumbnail::Client does not go out over the wire and will not count as a paid api call until you actually request the resulting url with a browser or other user agent.</em>
+</p>
+<h3>Default Images</h3>
+<p>
+  In either action, if you request a thumbnail that is not available, it will be queued for creation within 24 hours and you will not be charged for the request. In the redirect action, you can indicate a Default Image to be returned in this eventuality by including <code>:default_image => 'http://me.com/path/to/my_image.jpg'</code> in the options hash when initializing your Thumbnail::Client. If you don't indicate a default image (or if you're doing a thumbnail action), you'll get the following Alexa "coming soon" default image:<br />
+  <img src="soon.jpg">
+</p>
+<h3>Image Size Options</h3>
+
+<p>In both actions, you have a choice between large (201x147 pixels, ~8k) and small (111x82 pixels, ~3k) thumbnails. The Thumbnail::Client defaults to the large size, so if you want the smaller images, you should include <code>:size => :small</code> in your options hash when calling <code>Thumbnail::Client.new</code> (<em>note: there's also an attribute accessor for doing this after initialization</em>). Here are both sizes next to each other for comparison:<br />
+  <img src="craphound.jpg">
+  <img src="small_crap.jpg" /> 
+  </p>
+  
+  <h2>Documentation</h2>
+  <p>
+    For more details about using Thumbnail, see <a href="http://thumbnail.rubyforge.org/rdoc">the RDoc documentation</a>. To learn more about AWS-AST, see <a href="http://developer.amazonwebservices.com/connect/kbcategory.jspa?categoryID=51">the Alexa Site Thumbnail Service Resource Center</a>.
+  </p>
+
+	<h2>How to submit patches</h2>
+
+
+	<p>Read the <a href="http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/">8 steps for fixing other people&#8217;s code</a> and then <a href="mailto:greg@mfdz.com">email me</a>.
+
+
+	<p>The trunk repository is <code>svn://rubyforge.org/var/svn/thumbnail/trunk</code> for anonymous access.</p>
+
+
+	<h2>License</h2>
+
+
+	<p>This code is free to use under the terms of the <span class="caps">MIT</span> license.</p>
+
+
+	<h2>Contact</h2>
+
+
+	<p>Comments are welcome. Send email to <a href="mailto:greg@mfdz.com">Greg Borenstein</a>. Visit my blog: <a href=http://www.urbanhonking.com/ideasfordozens>Ideas For Dozens</a>.</p>
+    <p class="coda">
+      This gem was packaged and released with the help of <a href="http://newgem.rubyforge.org/">newgem</a> by <a href="http://drnicwilliams.com/">Dr Nic</a>.<br />
+      Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
+    </p>
+</div>
+
+<!-- insert site tracking codes here, like Google Urchin -->
+
+</body>
+</html>