amazon-hacks 0.1.0

data/History.txt

@@ -0,0 +1,5 @@
+== 1.0.0 / 2006-12-04
+
+* Initial Release
+  * Some URL hacks
+  * Image transformation tools

data/Manifest.txt

@@ -0,0 +1,6 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/amazon-hacks.rb
+test/test_amazon-hacks.rb

data/README.txt

@@ -0,0 +1,105 @@
+AmazonHacks
+by Jacob Harris
+harrisj@schizopolis.net
+http://www.nimblecode.com/
+
+NYC.rb
+http://www.nycruby.org/
+
+== DESCRIPTION:
+
+Mainly the product of messing around, this gem comprises Ruby code for a few
+useful "Amazon Hacks" -- common techniques for manipulating Amazon product URLs
+and Images. This is mainly useful if you find yourself creating a site where you
+might link to Amazon product pages and display images for them. Examples of this
+might include:
+
+* Social consumption sites like http://www.allconsuming.net/ 
+* Blogs or tumbleblogs with book/music/etc. reviews 
+* Normalizing Amazon links or create associate IDs
+
+This GEM is NOT related to using the Amazon Web Services and there is already an
+excellent gem for that if you need more heavy-duty use of the Amazon website
+(this gem does not even communicate with Amazon at all). Also, note this gem is
+meant in the spirit of fun hackery. You can use it to create interesting images
+from Amazon on demand, but if you are going to use it on a serious website,
+please consider caching and attributing that image to Amazon (I also have no
+idea what the official legal policy for using Amazon's book images is).
+
+And of course, do not even consider using this for fraud. It is possible to
+generate "20% off" or "Look Inside!" badges on Amazon images, but this gem does
+not support that since I can not think of any reason why outside sites would use
+that.
+
+== FEATURES/PROBLEMS:
+
+There are two main classes within the Amazon::Hacks namespace with the following
+functionality:
+
+=== Link (product URL)
+
+* Extract country of site
+* Extract ASIN (Amazon identifier)
+* Normalize (reduce to most basic URL for matching)
+* Associate URL (create a normalized URL with your Amazon Associate ID)
+	
+=== Image
+
+- Derive a corresponding image URL from a product URL
+- Sizes (small, medium, large)
+- Shadow
+- Border
+- Crop
+- Scale
+- Tilt
+- Blur
+- Sharpen
+- Highlight
+- Text overlay
+
+This is still a work in development, and while I have tested against some
+generic Amazon rules, it is possible that certain countries might deviate from
+Amazon's practices (for instance, China seems to not use the image generation
+code and instead just links to static URLs). Let me know if you find any issues
+for a given product link/image. Thank you.
+
+== SYNOPSIS:
+
+To use, simply +require 'amazon_hacks'+
+
+=== LINKS
+
+This gem is inspired by the {Abusing Amazon Images}[http://aaugh.com/imageabuse.html] page.
+
+== REQUIREMENTS:
+
+* Requires the 'color-tools' gem
+
+== INSTALL:
+
+* sudo gem install amazon-hacks
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2006 FIX
+
+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,17 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/amazon-hacks'
+
+Hoe.new('amazon-hacks', AmazonHacks::VERSION) do |p|
+  p.rubyforge_name = 'amazon-hacks'
+  p.summary = 'A collection of useful snippets against the Amazon website'
+  p.author = 'Jacob Harris'
+  p.email = 'harrisj@schizopolis.net'
+  p.url = 'http://www.nimblecode.com/code/AmazonHacks'
+  p.description = p.paragraphs_of('README.txt', 2..6).join("\n\n")
+  # p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.extra_deps = "color-tools"
+end

data/lib/amazon-hacks.rb

@@ -0,0 +1,411 @@
+require 'rubygems'
+require 'uri'
+require 'color'
+
+class AmazonHacks
+  VERSION = '0.1.0'
+end
+
+module Amazon
+  module Hacks
+    Country = Struct.new("Country", :country, :host, :img_code, :img_host)
+    
+    ##
+    # COUNTRIES is nice generic structure for storing information specific to
+    # each country Amazon has a store for (China seems special though, so I have
+    # deferred supporting it for now)
+    COUNTRIES = {
+        :ca => Country.new(:ca, "www.amazon.ca", "01", "images.amazon.ca"),
+      #        :cn => new Location("www.amazon.cn", ) 
+        :de => Country.new(:de, "www.amazon.de", "03", "images.amazon.de"),
+        :fr => Country.new(:fr, "www.amazon.fr", "08", "images.amazon.fr"),
+        :jp => Country.new(:jp, "www.amazon.co.jp", "09", "images.amazon.co.jp"),
+        :uk => Country.new(:uk, "www.amazon.co.uk", "02", "images.amazon.co.uk"),
+        :us => Country.new(:us, "www.amazon.com", "01", "images.amazon.com")
+    }
+    
+    ##
+    # The countries module is a convenience mixin to retrieve the correct
+    # server, etc. for an Image or Link. This module requires the class to
+    # include a +@country+ instance variable.
+    module Countries
+      
+      ##
+      # Returns a hostname for the Amazon store for that country
+      def country_host 
+        COUNTRIES[@country].host
+      end
+      
+      ##
+      # Each country in Amazon seems to use a different image code number in its
+      # images (eg, "01" for the US, "08" for France). This method returns the
+      # image code for the country
+      def country_imgcode
+        COUNTRIES[@country].img_code
+      end
+      
+      ##
+      # Each country also has a different server for its images. This returns
+      # the correct server.
+      def country_imghost
+        COUNTRIES[@country].img_host
+      end
+    end
+
+    class Link
+      include Countries
+      attr_reader :asin, :country      
+      
+      def initialize(url=nil, country=nil, asin=nil)
+        if url.nil?
+          @url = @country = @asin = nil
+        else
+          @url = URI.parse(url)
+          @country = country ? country : Amazon::Hacks::Link.extract_country(url)
+          @asin = asin ? asin : Amazon::Hacks::Link.extract_asin(url)
+        end
+      end
+
+      ##
+      # Sets the internal url of the link to be +url+. Also parses the values of
+      # the +asin+ and +country+ from the URL
+      def url=(url)
+        @url = URI.parse(url)
+        @country = Amazon::Hacks::Link.extract_country(url)
+        @asin = Amazon::Hacks::Link.extract_asin(url)
+      end
+
+      ##
+      # Returns a normalized form of the Link's URL. This is the shortest valid
+      # URL that links to the product on Amazon
+      #
+      # For example, the normalized form of a URL like:
+      #
+      # http://www.amazon.com/Refactoring-Improving-Design-Existing-Code/dp/0201485672/sr=8-1/qid=1165273301/ref=pd_bbs_sr_1/002-2410048-1716806?ie=UTF8&s=books
+      #
+      # would be:
+      #
+      # http://www.amazon.com/o/asin/0201485672
+      #
+      # Since it removes the session and other variables from the URL, 
+      # normalization is very useful for comparing two Amazon links directly.
+      # The Link== method does NOT normalize, but you might want to consider
+      # that if you need it.
+      def normalize
+        "http://#{country_host}/o/asin/#{asin}"
+      end
+
+      ##
+      # Extracts the Amazon Standard Identification Number (ASIN) from a string +url+. 
+      # Each product on an Amazon store has a unique ASIN used to identify it. 
+      # As Amazon's help documents describe it:
+      #
+      # "For books, the ASIN is the same as the ISBN number, but for all other 
+      # products a new ASIN is created when the item is uploaded to our catalog"
+      #
+      # ASIN values are specific to the store they're applied to and can not be
+      # used against another store nor are they guaranteed to be globally unique.
+      # Put another way, the ASIN for the US edition of a book will not return
+      # the UK edition when used with the UK store and might return nothing or
+      # something completely different. Also, ASINs are alphanumeric strings, not
+      # numbers.
+      #
+      # Amazon has used several different major URL formats interchangeably and
+      # this function extracts the ASIN from the following URL paths:
+      #
+      # /o/asin/<ASIN VALUE>[/...]
+      #
+      # /exec/obidos/ASIN/<ASIN VALUE>[/...]
+      #
+      # /exec/obidos/tg/detail/-/<ASIN VALUE>[/...]
+      #
+      # /long-title-goes-here/dp/<ASIN VALUE>[/...]
+      #
+      # This is only an informally gathered list. If you find a case where 
+      # +extract_asin+ fails, please send me the URL. If the ASIN is not matched,
+      # returns +nil+
+      def Link.extract_asin(url)  
+        u = URI.parse(url)
+        asin = nil
+
+        asin_regexps = [ /^\/o\/asin\/([^\/]+)/, 
+          /^\/exec\/obidos\/ASIN\/([^\/]+)/, 
+          /^\/exec\/obidos\/tg\/detail\/-\/([^\/]+)/, 
+          /^\/[^\/]+\/dp\/([^\/]+)/ 
+        ]
+        
+        asin_regexps.each do |re|
+          md = re.match(u.path)
+          if md
+          then
+            asin = md[1]
+            break
+          end
+        end
+        
+        asin
+      end
+
+      ##
+      # This method analyzes the +url+ string and returns a symbol representing
+      # the country (eg, +:us+). If the host is not recognized, returns +nil+
+      def Link.extract_country(url)
+        u = URI.parse(url)
+        c = COUNTRIES.find { |key, value| value.host == u.host }
+        c[0] unless c.nil? #.country unless c.nil? 
+      end
+
+      def associate_url(assoc_id)
+       normalize + "/#{assoc_id}"
+      end
+
+      def normalize!
+        u = normalize
+        @url = URI.parse(u)
+        self
+      end
+
+      def url
+        @url.to_s
+      end
+      
+      alias :to_s :url
+    end
+ end
+end
+
+module Amazon
+  module Hacks
+    
+    ##
+    # Class for manipulating Amazon's image URLs. These images are generated
+    # on demand at Amazon, so please don't abuse this feature against their
+    # site (save the image locally or link to them so they can get some sales
+    # out of it). I also do not have transformations that apply Amazon-specific
+    # decorations like "20% off" badges or "Look Inside" to hinder spoofing an
+    # Amazon site somewhat.
+    #
+    # Amazon images require an ASIN and country. These can either be specified
+    # manually or imported from a URL. In addition, each image can be modified
+    # with zero or more transformations (all specified in the URL), although the
+    # using more than two transformations is not necessarily guaranteed to be 
+    # honored by Amazon's rendering engine (only the first will generally be 
+    # applied, but [size + transform] seems to work usually).
+    #
+    # {Abusing Amazon Images}[http://aaugh.com/imageabuse.html], a site to whom
+    # I am most indebted here, notes the following about transform chaining:
+    #
+    # "The cool thing (if you want to generate unlikely Amazon images) is that 
+    # you're not limited to one use of any of these commands. You can have 
+    # multiple discounts, multiple shadows, multiple bullets, generating images 
+    # that Amazon would never have on its site. However, every additional command 
+    # you add generates another 10% to the image dimensions, adding white space 
+    # around the image. And that 10% compounds; add a lot of bullets, and you'll
+    # find that you have a small image in a large blank space. (You can use the 
+    # #crop! command to cut away the excess, however.) Note also that the commands 
+    # are interpreted in order, which can have an impact on what overlaps what."
+    class Image
+      include Countries
+      attr :asin, :country
+      
+      SIZES = { :small => "SCTZZZZZZZ", 
+                :medium => "SCMZZZZZZZ", 
+                :large => "SCLZZZZZZZ" }
+                
+      SHADOW_POSITIONS = [ :left, :right, :custom ]      
+      
+      SCALE_TYPES = { :proportion => "AA", 
+                      :square => "SS", 
+                      :width => "SX", 
+                      :height => "SY" }
+      
+      TEXT_FONTS = [ :times, :arial, :arialbi, :verdanab, :advc128d ]
+      TEXT_ALIGNS = [ :left, :center ]
+      
+      ##
+      # Creates an Image object from a +url+  
+      def Image.build_from_url(url)
+        u = Amazon::Hacks::Link.new(url)
+        i = Image.new(u.asin, u.country)        
+      end
+      
+      ##
+      # Initializes an Image object, requires both a valid asin as well as
+      # a country symbol (eg, +:us+ or +:uk+)
+      def initialize(asin, country)
+        @asin = asin
+        @country = country
+        reset_transforms!
+      end
+      
+      ##
+      # Add a size transform to the image. The following sizes are allowed:
+      # * small
+      # * medium
+      # * large
+      #
+      # These sizes are not guaranteed to particular dimensions. If you need
+      # exact sizing, use the #scale! transformation. These sizes are a lot
+      # friendlier to Amazon's image servers though, so I would recommend them
+      # if you can handle some variation.
+      def set_size!(size) 
+        @transforms << SIZES[size]
+      end  
+      
+      ##
+      # Add a simple shadow to the left or right; takes arguments +:left+ or
+      # +:right+. 
+      def add_shadow! (side)
+        case 
+        when side == :left then @transforms << "PB" 
+        when side == :right then @transforms << "PC"
+        end       
+      end
+      
+      ##
+      # Add a custom shadow to the image. Takes 4 parameters:
+      #
+      # * +size+ - padding around the image (pixels)
+      # * +xoff+ - distance from the shadow's edge to the item's edge horizontally. 
+      #   Positive values go to the right, negative to the left (pixels)
+      # * +yoff+ - like xoff but vertically.
+      # * +fuzz+ - fuzziness of shadow; 0 is perfectly square while higher values
+      #   blur the sharpness of the shadow's edge
+      def add_custom_shadow! (size, xoff, yoff, fuzz)
+        @transforms << "PA#{size},#{xoff},#{yoff},#{fuzz}"
+      end
+      
+      ##
+      # Add a border around the image. Takes the following arguments
+      #
+      # * +width+ - size of the border (pixels)
+      # * +color+ - color of the border in HTML format (eg, "#CCCCCC") [defaults
+      #   black if not specified]
+      def add_border! (width, html_color="\#000000")
+        color = Color::RGB.from_html(html_color)
+        cmd = "BO#{width}," 
+        cmd << [color.r, color.g, color.b].map {|c| (c*255).to_i }.join(",")
+        @transforms << cmd
+      end
+      
+      ##
+      # Rotate the image. Takes a single argument of degrees to rotate. Positive 
+      # values rotate to the right, negative to the left.
+      #
+      # According to auugh: "The values seem to range as high as 135. Positive 
+      # values rotate to the right, negative numbers rotate to the left. Negative
+      # numbers go... well, I stopped testing in the hundreds of millions, but 
+      # there's not much need to go beyond -360, which takes it full circle. 
+      # Positive rotations in some values seem to cause severe image shrinkage, 
+      # so you should consider using a size adjustment after rotation."
+      def tilt! (degrees)
+        @transforms << "PT#{degrees}"
+      end
+      
+      ##
+      # Blur the image. The input argument seems to represent a radius, but the
+      # essential thing to know is the higher the value, the blurrier it gets.
+      def blur! (radius)
+        @transforms << "BL#{radius}"
+      end
+      
+      ##
+      # Sharpen the image. The value can range from 0 - 99. Larger values may
+      # affect color and increase noise significantly.
+      def sharpen! (percent)
+        @transforms << "SH#{percent}"
+      end
+      
+      ##
+      # Scale the image to exact dimensions. Takes a scaling type and dimension
+      # in pixels. There are four types of scaling possible:
+      #
+      # * +:proportion+ - preserve the image's proportions
+      # * +:square+ - make the image square
+      # * +:width+ - the size represents the width of image. Height is 
+      #   proportionally scaled.
+      # * +:height+ - the size represents the height of the image. Width is 
+      #   proportionally scaled.
+      def scale!(type, size)
+        @transforms << "#{SCALE_TYPES[type]}#{size}"
+      end
+      
+      ##
+      # Crops the image. This can be used to generate Flickr-like square windows 
+      # into the image (although there is no method to figure out programmatically
+      # the dimensions of a particular size, so this might be hard [maybe scale
+      # then crop?]). Takes four arguments to set the crop square:
+      #
+      # * +xoff+ - x offset from top left corner of image to tlc of box (pixels)
+      # * +yoff+ - y offset from top left corner of image to tlc of (pixels)
+      # * +width+ - width of crop square
+      # * +height+ - height of crop square
+      def crop! (xoff, yoff, width, height)
+        @transforms << "CR#{xoff},#{yoff},#{width},#{height}"
+      end
+      
+      ##
+      # Overlay text on the image. This is easily the most complicated transformation
+      # you can apply in terms of sheer argument heft. The text is placed in a square
+      # area you must set the dimensions of first. Takes the following options:
+      #
+      # * +text+ - the text you want to overlay
+      # * +xoff+ - x offset from the top left corner to tlc of box (pixels)
+      # * +yoff+ - y offset from the top left corner to tlc of box (pixels)
+      # * +width+ - width of the text box
+      # * +height+ - height of the text box in pixels
+      # * +font+ - four options are allowed:
+      #   * +:times+ - Times Roman
+      #   * +:arial+ - Arial
+      #   * +:arialbi+ - Arial Bold Italic
+      #   * +:verdanab+ - Verdana Bold
+      #   * +:advc128d+ - barcode font
+      # * +size+ - font size (points?)
+      # * +color+ - a color specified in HTML style (eg, "#CCEECC")
+      # * +align+ - may be +:left+ or +:center+ only, defaults to +:left+
+      def add_text! (text, xoff, yoff, width, height, font, size, html_color, align=:left)
+        color = Color::RGB.from_html(html_color)
+        cmd = (align == :center) ? "ZC" : "ZA"
+        parts = [URI.escape(text), xoff, yoff, width, height, font, size].map {|x| x.to_s} +
+                [color.r, color.g, color.b].map {|c| (c*255).to_i }
+        cmd << parts.join(",")
+        @transforms << cmd
+      end
+              
+      ##
+      # Highlight the image. I'm still not sure what this means, but here it is. 
+      # You specify an square highlight area of the image with the following 
+      # parameters:
+      #
+      # * +xoff+ - x offset from the top left corner to tlc of box (pixels)
+      # * +yoff+ - y offset from the top left corner to tlc of box (pixels)
+      # * +width+ - width of the text box
+      # * +height+ - height of the text box in pixels
+      # * +intensity+ - I really don't know what this means, but more is bigger
+      def highlight!(xoff, yoff, width, height, intensity)
+        @transforms << "HL#{xoff},#{yoff},#{width},#{height},#{intensity}"
+      end
+
+      ##
+      # Transformations like #crop! and #add_shadow!, etc. can be chained and
+      # are potentially applied in the order specified. Should you need to clear
+      # the transforms and revert to the original image, this command does that.
+      def reset_transforms!
+        @transforms = []
+      end
+      
+      ##
+      # Returns a URL for the image from Amazon's servers.
+      def url
+        url = "http://#{country_imghost}/images/P/#{asin}"
+        url << "." << country_imgcode << "."
+    
+        url << "_" << @transforms.join(",") << "_" << ".jpg"
+      end
+      
+      ##
+      # This method is an alias for #url
+      alias :to_s :url
+    end
+  end
+end

data/test/test_amazon-hacks.rb

@@ -0,0 +1,238 @@
+# Code Generated by ZenTest v. 3.4.2
+#                 classname: asrt / meth =  ratio%
+#      Amazon::Hacks::Image:    0 /   15 =   0.00%
+#       Amazon::Hacks::Link:    0 /    8 =   0.00%
+#                 Countries:    0 /    3 =   0.00%
+
+require 'test/unit' unless defined? $ZENTEST and $ZENTEST
+require './lib/amazon-hacks'
+
+module TestAmazon
+  module TestHacks
+    class TestCountries
+      include Amazon::Hacks::Countries
+      
+      def setup
+        @country = :uk
+      end
+      
+      def test_country_host
+        assert_equal("www.amazon.co.uk", country_host)
+      end
+      
+      def test_country_imgcode
+        assert_equal("02", country_imgcode)
+      end
+      
+      def test_country_imghost
+        assert_equal("images.amazon.co.uk", country_imghost)
+      end
+    end
+  end
+end
+
+module TestAmazon
+  module TestHacks
+    class TestImage < Test::Unit::TestCase
+      URL_PREFIX = "http://images.amazon.com/images/P/0201485672.01."
+      
+      def setup
+        @img = Amazon::Hacks::Image.new("0201485672", :us)
+      end
+      
+      def test_build_from_url
+        i = Amazon::Hacks::Image.build_from_url("http://www.amazon.com/Refactoring-Improving-Design-Existing-Code/dp/0201485672/sr=8-1/qid=1165273301/ref=pd_bbs_sr_1/002-2410048-1716806?ie=UTF8&s=books")
+        assert_equal("#{URL_PREFIX}__.jpg", i.url)
+      end
+
+      def test_add_border_bang
+        @img.add_border! 12, "\#CC2244"
+        assert_equal("#{URL_PREFIX}_BO12,204,34,68_.jpg", @img.url)
+      end
+
+      def test_add_custom_shadow_bang
+        @img.add_custom_shadow! 2, 23, 45, 30
+        assert_equal("#{URL_PREFIX}_PA2,23,45,30_.jpg", @img.url)
+      end
+
+      def test_add_shadow_bang_left
+        @img.add_shadow! :left
+        assert_equal("#{URL_PREFIX}_PB_.jpg", @img.url)
+      end
+
+      def test_add_shadow_bang_right
+        @img.add_shadow! :right
+        assert_equal("#{URL_PREFIX}_PC_.jpg", @img.url)
+      end
+
+      def test_blur_bang
+        @img.blur! 23
+        assert_equal("#{URL_PREFIX}_BL23_.jpg", @img.url)
+      end
+
+      def test_crop_bang
+        @img.crop! 0, 10, 20, 20
+        assert_equal("#{URL_PREFIX}_CR0,10,20,20_.jpg", @img.url)
+      end
+
+      def test_highlight_bang
+        @img.highlight! 0, 10, 20, 15, 75
+        assert_equal("#{URL_PREFIX}_HL0,10,20,15,75_.jpg", @img.url)
+      end
+
+      def test_reset_transforms_bang
+        @img.add_border! 33, "\#CCCCCC"
+        @img.blur! 23
+        @img.add_shadow! :right
+        @img.reset_transforms!
+        
+        assert_equal("#{URL_PREFIX}__.jpg", @img.url)
+      end
+
+      def test_scale_bang_proportion
+        @img.scale! :proportion, 23
+        assert_equal("#{URL_PREFIX}_AA23_.jpg", @img.url)
+      end
+
+      def test_scale_bang_square
+        @img.scale! :square, 23
+        assert_equal("#{URL_PREFIX}_SS23_.jpg", @img.url)
+      end
+
+      def test_scale_bang_width
+        @img.scale! :width, 23
+        assert_equal("#{URL_PREFIX}_SX23_.jpg", @img.url)
+      end
+
+      def test_scale_bang_height
+        @img.scale! :height, 23
+        assert_equal("#{URL_PREFIX}_SY23_.jpg", @img.url)
+      end
+
+      def test_set_size_bang_small
+        @img.set_size! :small
+        assert_equal("#{URL_PREFIX}_SCTZZZZZZZ_.jpg", @img.url)
+      end
+
+      def test_set_size_bang_medium
+        @img.set_size! :medium
+        assert_equal("#{URL_PREFIX}_SCMZZZZZZZ_.jpg", @img.url)
+      end
+
+      def test_set_size_bang_large
+        @img.set_size! :large
+        assert_equal("#{URL_PREFIX}_SCLZZZZZZZ_.jpg", @img.url)
+      end
+            
+      def test_sharpen_bang
+        @img.sharpen! 83
+        assert_equal("#{URL_PREFIX}_SH83_.jpg", @img.url)
+      end
+
+      def test_add_text_bang
+        @img.add_text! "hello world", 5, 15, 100, 100, :times, 20, "\#CC2244", :left
+        assert_equal("#{URL_PREFIX}_ZAhello%20world,5,15,100,100,times,20,204,34,68_.jpg", @img.url)
+      end
+
+      def test_text_bang_center
+        @img.add_text! "hello world", 5, 15, 100, 100, :times, 20, "\#CC2244", :center
+        assert_equal("#{URL_PREFIX}_ZChello%20world,5,15,100,100,times,20,204,34,68_.jpg", @img.url)
+      end
+      
+      def test_tilt_bang
+        @img.tilt! 45
+        assert_equal("#{URL_PREFIX}_PT45_.jpg", @img.url)
+      end
+
+      def test_url
+        assert_equal("#{URL_PREFIX}__.jpg", @img.url)
+        assert_equal("#{URL_PREFIX}__.jpg", @img.to_s)
+      end
+      
+      def test_chain_transforms
+        @img.set_size! :small
+        @img.blur! 87
+        assert_equal("#{URL_PREFIX}_SCTZZZZZZZ,BL87_.jpg", @img.url)
+      end
+    end
+  end
+end
+
+module TestAmazon
+  module TestHacks
+    class TestLink < Test::Unit::TestCase
+      def setup
+        @us_link = Amazon::Hacks::Link.new("http://www.amazon.com/Refactoring-Improving-Design-Existing-Code/dp/0201485672/sr=8-1/qid=1165273301/ref=pd_bbs_sr_1/002-2410048-1716806?ie=UTF8&s=books")
+        @uk_link = Amazon::Hacks::Link.new("http://www.amazon.co.uk/The-IT-Crowd/dp/B000EU1OYC/sr=8-1/qid=1165274239/ref=pd_ka_1/026-4633332-4150855?ie=UTF8&s=dvd")      
+      end
+      
+      def test_class_extract_asin_1
+        asin = Amazon::Hacks::Link.extract_asin("http://www.amazon.com/o/asin/0201485672")
+        assert_equal("0201485672", asin)
+
+        asin = Amazon::Hacks::Link.extract_asin("http://www.amazon.co.uk/o/asin/B000EU1OYC")
+        assert_equal("B000EU1OYC", asin)
+      end
+      
+      def test_class_extract_asin_2
+        asin = Amazon::Hacks::Link.extract_asin("http://www.amazon.com/exec/obidos/ASIN/0201485672")
+        assert_equal("0201485672", asin)
+
+        asin = Amazon::Hacks::Link.extract_asin("http://www.amazon.co.uk/exec/obidos/ASIN/B000EU1OYC")
+        assert_equal("B000EU1OYC", asin)      
+      end
+      
+      def test_class_extract_asin_3
+        asin = Amazon::Hacks::Link.extract_asin("http://www.amazon.com/exec/obidos/tg/detail/-/0201485672")
+        assert_equal("0201485672", asin)
+
+        asin = Amazon::Hacks::Link.extract_asin("http://www.amazon.co.uk/exec/obidos/tg/detail/-/B000EU1OYC")
+        assert_equal("B000EU1OYC", asin)      
+      end
+      
+      def test_class_extract_asin_4
+        asin = Amazon::Hacks::Link.extract_asin("http://www.amazon.com/Refactoring-Improving-Design-Existing-Code/dp/0201485672/sr=8-1/qid=1165273301/ref=pd_bbs_sr_1/002-2410048-1716806?ie=UTF8&s=books")
+        assert_equal("0201485672", asin)
+        
+        asin = Amazon::Hacks::Link.extract_asin("http://www.amazon.co.uk/The-IT-Crowd/dp/B000EU1OYC/sr=8-1/qid=1165274239/ref=pd_ka_1/026-4633332-4150855?ie=UTF8&s=dvd")
+        assert_equal("B000EU1OYC", asin)
+      end
+        
+      def test_class_extract_country
+        assert_equal(:us, Amazon::Hacks::Link.extract_country("http://www.amazon.com/foo"))
+        assert_equal(:uk, Amazon::Hacks::Link.extract_country("http://www.amazon.co.uk/foo"))
+        assert_equal(:de, Amazon::Hacks::Link.extract_country("http://www.amazon.de/foo"))
+        assert_equal(:fr, Amazon::Hacks::Link.extract_country("http://www.amazon.fr/foo"))
+        assert_equal(:jp, Amazon::Hacks::Link.extract_country("http://www.amazon.co.jp/foo"))
+      end
+
+      def test_asin
+        assert_equal("0201485672", @us_link.asin)
+        assert_equal("B000EU1OYC", @uk_link.asin)
+      end
+
+      def test_associate_url
+        assert_equal("http://www.amazon.com/o/asin/0201485672/testassoc", @us_link.associate_url("testassoc"))
+        assert_equal("http://www.amazon.co.uk/o/asin/B000EU1OYC/testassoc", @uk_link.associate_url("testassoc"))
+      end
+
+      def test_normalize
+        assert_equal("http://www.amazon.com/o/asin/0201485672", @us_link.normalize)
+      end
+      
+      def test_normalize_bang
+        @us_link.normalize!
+        assert_equal("http://www.amazon.com/o/asin/0201485672", @us_link.to_s)
+      end
+      
+      def test_url_equals
+        link = Amazon::Hacks::Link.new
+        link.url = "http://www.amazon.co.uk/The-IT-Crowd/dp/B000EU1OYC/sr=8-1/qid=1165274239/ref=pd_ka_1/026-4633332-4150855?ie=UTF8&s=dvd"
+        assert_equal("http://www.amazon.co.uk/The-IT-Crowd/dp/B000EU1OYC/sr=8-1/qid=1165274239/ref=pd_ka_1/026-4633332-4150855?ie=UTF8&s=dvd", link.to_s)
+        assert_equal(:uk, link.country)
+        assert_equal("B000EU1OYC", link.asin)
+      end
+    end    
+  end
+end
+

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: amazon-hacks
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+date: 2006-12-12 00:00:00 -05:00
+summary: A collection of useful snippets against the Amazon website
+require_paths: 
+- lib
+email: harrisj@schizopolis.net
+homepage: http://www.nimblecode.com/code/AmazonHacks
+rubyforge_project: amazon-hacks
+description: "== DESCRIPTION:  Mainly the product of messing around, this gem comprises Ruby code for a few useful \"Amazon Hacks\" -- common techniques for manipulating Amazon product URLs and Images. This is mainly useful if you find yourself creating a site where you might link to Amazon product pages and display images for them. Examples of this might include:  * Social consumption sites like http://www.allconsuming.net/  * Blogs or tumbleblogs with book/music/etc. reviews  * Normalizing Amazon links or create associate IDs  This GEM is NOT related to using the Amazon Web Services and there is already an excellent gem for that if you need more heavy-duty use of the Amazon website (this gem does not even communicate with Amazon at all). Also, note this gem is meant in the spirit of fun hackery. You can use it to create interesting images from Amazon on demand, but if you are going to use it on a serious website, please consider caching and attributing that image to Amazon (I also have no idea what the official legal policy for using Amazon's book images is).  And of course, do not even consider using this for fraud. It is possible to generate \"20% off\" or \"Look Inside!\" badges on Amazon images, but this gem does not support that since I can not think of any reason why outside sites would use that."
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Jacob Harris
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/amazon-hacks.rb
+- test/test_amazon-hacks.rb
+test_files: 
+- test/test_amazon-hacks.rb
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: color-tools
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+    version: