couch_photo 0.0.2 → 0.0.3

data/README.markdown

@@ -78,3 +78,47 @@ The previous variations were all simple image resizings. What if we wanted to do
     end
 
 The `original_image` variable in the blocks is simply the MiniMagick::Image instance of your original image.
+
+### Accessing Variations
+
+So, now that you've got some variations, how do you access them? Simple!
+
+Let's go back to our original image example: 
+
+    class Image < CouchRest::Model::Base
+      use_database IMAGE_DB
+      include CouchPhoto
+
+      override_id! # the id of the document will be the basename of the original image file
+
+      variations do
+        small "20x20"
+        medium "100x100"
+        large "500x500"
+      end
+    end
+
+    i = Image.new
+    i.original "avatar.jpg"
+    i.save
+
+We can access our variations in one of three ways: 
+- the `variations` method, which returns an array of all of our variations
+- the `variation.<variation_name>` method, which returns a specific variation
+- the `variation("<variation_name>")`, which also returns a specific variation
+
+For example: 
+  
+    i.variations
+    i.variation.small
+    i.variation "large"
+
+Once you've got a variation, you can call several methods on it: 
+
+    i.variation.small.name # ==> "small"
+    i.variation.small.path # ==> "http://your_couch_server/your_image_database/avatar.jpg/variations/small.jpg"
+    i.variation.small.filename # ==> "variations/small.jpg"
+    i.variation.small.basename # ==> "small.jpg"
+    i.variation.small.filetype # ==> "jpg"
+    i.variation.small.mimetype # ==> "image/jpg"
+    i.variation.small.data # ==> BINARY BLOB

data/lib/couch_photo/couch_photo.rb

@@ -3,6 +3,23 @@ module CouchPhoto
     base.extend ClassMethods
   end
 
+  def update_or_create_attachment(attachment)
+    if self.has_attachment? attachment[:name]
+      self.update_attachment attachment
+    else
+      self.create_attachment attachment
+    end
+  end
+
+  def variations
+    @variations ||= Variations.new self 
+    @variations.variations.values
+  end
+
+  def variation(variation_name=nil)
+    variation_name ? @variations.send(variation_name) : @variations
+  end
+
   def original(filepath, blob=nil)
     self["_id"] = File.basename filepath if self.class.override_id?
     blob ||= File.read filepath
@@ -14,24 +31,12 @@ module CouchPhoto
       update_or_create_attachment :name => "variations/#{variation_name}.#{image_format}", :file => Attachment.new(variation_blob, attachment_name) 
     end
   end
-  
-  def update_or_create_attachment(attachment)
-    if self.has_attachment? attachment[:name]
-      self.update_attachment attachment
-    else
-      self.create_attachment attachment
-    end
-  end
 
   module ClassMethods
     def variations(&block)
       raise "You must pass a block to the `variations' method." unless block
       variation_definitions.instance_eval(&block)
     end
-
-    def variation_definitions
-      @variation_definitions ||= Variations.new
-    end
     
     def override_id!
       @override_id = true
@@ -40,5 +45,9 @@ module CouchPhoto
     def override_id?
       @override_id
     end
+
+    def variation_definitions
+      @variation_definitions ||= VariationDefinitions.new
+    end
   end
 end

data/lib/couch_photo/variations.rb

@@ -1,14 +1,14 @@
 module CouchPhoto
-  class Variations
+  class VariationDefinitions
     def initialize
       @variations = {}
     end
 
     def method_missing(method_name, *args, &block)
       if block
-        @variations[method_name.to_sym] = Variation.new method_name, *args, &block
+        @variations[method_name.to_sym] = VariationDefinition.new method_name, *args, &block
       else
-        @variations[method_name.to_sym] = Variation.new method_name, *args
+        @variations[method_name.to_sym] = VariationDefinition.new method_name, *args
       end
     end
 
@@ -21,7 +21,7 @@ module CouchPhoto
     end
   end
 
-  class Variation
+  class VariationDefinition
     def initialize(name, format=nil, &block)
       raise "A variation can not have both a format and a block. Choose one." if format and block
       raise "A variation must have either a format (e.g., '20x20>') or a block." if !format and !block
@@ -36,4 +36,41 @@ module CouchPhoto
       image.to_blob
     end
   end
+
+  class Variations
+    attr_reader :variations
+
+    def initialize(document)
+      @variations = {}
+      attachments = document["_attachments"] || {}
+      attachments.keys.select {|name| name.match /variations\//}.each do |variation_name|
+        variation_short_name = variation_name.gsub(/variations\/(.+)\.[^\.]+/) {$1}
+        @variations[variation_short_name] = Variation.new document, variation_name
+      end
+    end
+
+    def method_missing(method_name, *args, &block)
+      raise "Unknown variation '#{method_name}'" unless @variations[method_name.to_s]
+      @variations[method_name.to_s]
+    end
+  end
+
+  class Variation
+    attr_reader :name, :path, :filename, :basename, :filetype, :mimetype
+
+    def initialize(document, attachment_name)
+      @path = [document.database.to_s, document.id, attachment_name].join "/"
+      @attachment_name = attachment_name
+      @name = attachment_name.gsub(/variations\/(.+)\.[^\.]+/) {$1}
+      @filename = attachment_name
+      @basename = File.basename attachment_name 
+      @document = document
+      @filetype = attachment_name.gsub(/variations\/.+\.([^\.]+)/) {$1}
+      @mimetype = document["_attachments"][attachment_name]["content_type"]
+    end
+
+    def data
+      @document.read_attachment @attachment_name
+    end
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: couch_photo
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: false
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Matt Parker
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-27 00:00:00 -05:00
+date: 2010-11-29 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency