attached 0.2.2 → 0.2.3

data/README.rdoc

@@ -1,6 +1,6 @@
 = Attached
 
-Attached is a Ruby on Rails file attachment tool that lets users upload to the cloud, then process in the cloud. The tool supports Amazon S3 by default. It surpasses Paperclip by providing built-in support for direct uploads to the cloud and by allowing integration with cloud based processing tools. However, in almost every other way Paperclip is better. The source code is inspired (and copied) from Paperclip. If you aren't working in the cloud exclusively then this isn't for you!
+Attached is a Ruby on Rails file attachment tool that lets users upload to the cloud, then process in the cloud. The gem supports AWS, Google and Rackspace for storage networks by default. It is influenced (and copied) from Paperclip.
 
 == Requirements
 
@@ -58,22 +58,47 @@ View:
   
 == Advanced
 
-=== Storage
+=== Validations
+
+  # app/models/person.rb
+  validates_attached_presence :avatar
+  validates_attached_size :avatar, :in => 2.kilobytes..2.megabytes
+
+==== Storage
   
-  has_attached :avatar, :provider => :aws, :credentials => {
-    :secret_access_key => "*****",
-    :access_key_id     => "*****",
-  }
+  # app/models/person.rb
+  has_attached :avatar, :medium => :aws, :credentials => "#{Rails.root}/config/aws.yml"
+  
+  # app/models/person.rb
+  has_attached :avatar, :medium => :google, "#{Rails.root}/config/google.yml"
+  
+  # app/models/person.rb
+  has_attached :avatar, :medium => :rackspace, "#{Rails.root}/config/rackspace.yml"
+  
+  # config/initializers/attached.rb
+  Attached::Attachment.options[:medium] = :aws
+  Attached::Attachment.options[:credentials] = "#{Rails.root}/config/aws.yml"
+  
+  # config/initializers/attached.rb
+  Attached::Attachment.options[:medium] = :google
+  Attached::Attachment.options[:credentials] = "#{Rails.root}/config/google.yml"
+  
+  # config/initializers/attached.rb
+  Attached::Attachment.options[:medium] = :rackspace
+  Attached::Attachment.options[:credentials] = "#{Rails.root}/config/rackspace.yml"
   
 === Processor
 
+  # app/models/person.rb
   has_attached :avatar, :processor => :image, :styles => {
-    :small => { :size => "200x200#" }
-    :large => { :size => "400x400#" }
+    :small => { :size => '200x200<', :extension => 'png' },
+    :large => { :size => '400x400>', :extension => 'png' },
+    :default => { :size => '300x300#' },
   }
   
-=== Alias
+=== Aliases
 
+  # app/initializer/attached.rb
   Attached::Attachment.options[:aliases] = %w(
     d1kf5um3mxa8kv.cloudfront.net
     d3d5wf186mp1rv.cloudfront.net

data/lib/attached.rb

@@ -31,17 +31,15 @@ module Attached
     #
     # Options:
     #
-    # * :styles    - 
-    # * :storage   - 
-    # * :processor -
+    # * :styles    - a hash containing style names followed by parameters passed to processor
+    # * :storage   - a symbol for a predefined storage or a custom storage class
+    # * :processor - a symbol for a predefined processor or a custom processor class
     #
     # Usage:
     #
     #   has_attached :video
     #   has_attached :video, :storage => :s3
-    #   has_attached :video, styles => [ :mp4, :ogv ]
-    #   has_attached :video, styles => { :main => { :size => "480p", :format => "mp4" } }
-    #   has_attached :thumbnail, :range => (1..4)
+    #   has_attached :video, styles => { :mov => { :size => "480p", :format => "mov" } }
     
     def has_attached(name, options = {})
       

data/lib/attached/storage.rb

@@ -10,11 +10,11 @@ module Attached
     #
     # Usage:
     #
-    #   Attached::Storage.storage(:aws)
-    #   Attached::Storage.storage(:google)
-    #   Attached::Storage.storage(:rackspace)
+    #   Attached::Storage.storage(:aws,       "#{Rails.root}/config/aws.yml"      )
+    #   Attached::Storage.storage(:google,    "#{Rails.root}/config/google.yml"   )
+    #   Attached::Storage.storage(:rackspace, "#{Rails.root}/config/rackspace.yml")
     
-    def self.storage(medium = :aws, credentials = nil)
+    def self.storage(medium, credentials)
       
       case medium
         when :aws       then return Attached::Storage::AWS.new       credentials

data/lib/attached/storage/aws.rb

@@ -48,7 +48,7 @@ module Attached
 			end
 			
 			
-      # Save a file to a given path on AWS S3.
+      # Save a file to a given path.
       #
       # Parameters:
       #
@@ -65,7 +65,7 @@ module Attached
       end
       
       
-      # Destroy a file at a given path on AWS S3.
+      # Destroy a file at a given path.
       #
       # Parameters:
       #

data/lib/attached/storage/google.rb

@@ -37,7 +37,7 @@ module Attached
 			end
 			
 			
-			# Access the host (e.g. bucket.s3.amazonaws.com) for a storage service.
+			# Access the host (e.g. https://attached.commondatastorage.googleapis.com/) for a storage service.
 			#
 			# Usage:
 			#
@@ -48,7 +48,7 @@ module Attached
 			end
 			
 			
-      # Save a file to a given path on AWS S3.
+      # Save a file to a given path.
       #
       # Parameters:
       #
@@ -65,7 +65,7 @@ module Attached
       end
       
       
-      # Destroy a file at a given path on AWS S3.
+      # Destroy a file at a given path.
       #
       # Parameters:
       #

data/lib/attached/storage/rackspace.rb

@@ -43,7 +43,7 @@ module Attached
 			#		storage.host
 			
 			def host()
-				"https://#{self.bucket}.s3.amazonaws.com/"
+			  "https://storage.clouddrive.com/#{self.container}/"
 			end
 			
 			

data/lib/attached/version.rb

@@ -1,3 +1,3 @@
 module Attached
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 2
-  - 2
-  version: 0.2.2
+  - 3
+  version: 0.2.3
 platform: ruby
 authors: 
 - Kevin Sylvestre
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-20 00:00:00 -04:00
+date: 2011-01-22 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency