amazon-hacks 0.1.0 → 0.5.0

data/History.txt

@@ -1,4 +1,11 @@
-== 1.0.0 / 2006-12-04
+== 0.5.0 / 2007-01-02
+
+* More bugs fixed
+	* Major error where chaining transforms didn't work (wrong join char)
+	* Some minor formatting fixes in docs
+	* Changed all bang methods to return self
+
+== 0.3.0 / 2006-12-04
 
 * Initial Release
   * Some URL hacks

data/README.txt

@@ -1,10 +1,8 @@
 AmazonHacks
-by Jacob Harris
-harrisj@schizopolis.net
-http://www.nimblecode.com/
-
-NYC.rb
-http://www.nycruby.org/
+    by Jacob Harris
+    harrisj@schizopolis.net
+    Blog: http://www.nimblecode.com/
+    NYC.rb: http://www.nycruby.org/
 
 == DESCRIPTION:
 
@@ -14,7 +12,7 @@ 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/ 
+* Social consumption sites like {All Consuming}[http://www.allconsuming.net/]
 * Blogs or tumbleblogs with book/music/etc. reviews 
 * Normalizing Amazon links or create associate IDs
 

data/lib/amazon-hacks.rb

@@ -3,7 +3,7 @@ require 'uri'
 require 'color'
 
 class AmazonHacks
-  VERSION = '0.1.0'
+  VERSION = '0.5.0'
 end
 
 module Amazon
@@ -27,7 +27,7 @@ module Amazon
     ##
     # 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.
+    # include a @country instance variable.
     module Countries
       
       ##
@@ -155,20 +155,29 @@ module Amazon
         c[0] unless c.nil? #.country unless c.nil? 
       end
 
+      ##
+      # Returns a normalized URL for the product with an Amazon Associate ID
+      # appended to it.
       def associate_url(assoc_id)
        normalize + "/#{assoc_id}"
       end
 
+      ##
+      # Like #normalize, but changes the internal url
       def normalize!
         u = normalize
         @url = URI.parse(u)
         self
       end
 
+      ##
+      # Returns the saved URL
       def url
         @url.to_s
       end
       
+      ##
+      # The to_s method returns the internal URL.
       alias :to_s :url
     end
  end
@@ -250,16 +259,18 @@ module Amazon
       # if you can handle some variation.
       def set_size!(size) 
         @transforms << SIZES[size]
+        self        
       end  
       
       ##
-      # Add a simple shadow to the left or right; takes arguments +:left+ or
-      # +:right+. 
+      # 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       
+        self
       end
       
       ##
@@ -273,6 +284,7 @@ module Amazon
       #   blur the sharpness of the shadow's edge
       def add_custom_shadow! (size, xoff, yoff, fuzz)
         @transforms << "PA#{size},#{xoff},#{yoff},#{fuzz}"
+        self
       end
       
       ##
@@ -286,6 +298,7 @@ module Amazon
         cmd = "BO#{width}," 
         cmd << [color.r, color.g, color.b].map {|c| (c*255).to_i }.join(",")
         @transforms << cmd
+        self
       end
       
       ##
@@ -300,6 +313,7 @@ module Amazon
       # so you should consider using a size adjustment after rotation."
       def tilt! (degrees)
         @transforms << "PT#{degrees}"
+        self
       end
       
       ##
@@ -307,6 +321,7 @@ module Amazon
       # essential thing to know is the higher the value, the blurrier it gets.
       def blur! (radius)
         @transforms << "BL#{radius}"
+        self
       end
       
       ##
@@ -314,6 +329,7 @@ module Amazon
       # affect color and increase noise significantly.
       def sharpen! (percent)
         @transforms << "SH#{percent}"
+        self
       end
       
       ##
@@ -328,6 +344,7 @@ module Amazon
       #   proportionally scaled.
       def scale!(type, size)
         @transforms << "#{SCALE_TYPES[type]}#{size}"
+        self
       end
       
       ##
@@ -342,6 +359,7 @@ module Amazon
       # * +height+ - height of crop square
       def crop! (xoff, yoff, width, height)
         @transforms << "CR#{xoff},#{yoff},#{width},#{height}"
+        self
       end
       
       ##
@@ -355,14 +373,14 @@ module Amazon
       # * +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
+      #   * :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+
+      # * +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"
@@ -370,6 +388,7 @@ module Amazon
                 [color.r, color.g, color.b].map {|c| (c*255).to_i }
         cmd << parts.join(",")
         @transforms << cmd
+        self
       end
               
       ##
@@ -384,6 +403,7 @@ module Amazon
       # * +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}"
+        self
       end
 
       ##
@@ -392,6 +412,7 @@ module Amazon
       # the transforms and revert to the original image, this command does that.
       def reset_transforms!
         @transforms = []
+        self
       end
       
       ##
@@ -400,7 +421,7 @@ module Amazon
         url = "http://#{country_imghost}/images/P/#{asin}"
         url << "." << country_imgcode << "."
     
-        url << "_" << @transforms.join(",") << "_" << ".jpg"
+        url << "_" << @transforms.join("_") << "_" << ".jpg"
       end
       
       ##

data/test/test_amazon-hacks.rb

@@ -152,7 +152,8 @@ module TestAmazon
       def test_chain_transforms
         @img.set_size! :small
         @img.blur! 87
-        assert_equal("#{URL_PREFIX}_SCTZZZZZZZ,BL87_.jpg", @img.url)
+        @img.tilt! 23
+        assert_equal("#{URL_PREFIX}_SCTZZZZZZZ_BL87_PT23_.jpg", @img.url)
       end
     end
   end

metadata

@@ -3,15 +3,15 @@ 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
+  version: 0.5.0
+date: 2007-01-02 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."
+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 {All Consuming}[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:"
 autorequire: 
 default_executable: 
 bindir: bin