paperclip-cloudinary 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6c8792c1595abc2f240fbe22966f157101d7d5bf
-  data.tar.gz: 733ce9504493f5839e79bc3f72d7fc59a066f63b
+  metadata.gz: 26170d304fef36a6ea287a5f1bef2559cf029c7e
+  data.tar.gz: 6b16e4ae21c1d61cc6f30e491ddc9e6911f6ed92
 SHA512:
-  metadata.gz: ea993ac4ab0e85e6c7ae6eacf6cff001618ceed0fb58f4a42ab2ea6d9d1eeeb09b9a612728c469693014379bfe569a5f2cd8e05b20b21dfbc014992f01d97475
-  data.tar.gz: ccdcdb29d4948f411d47746321b97704004454bb7d30c02e831e297f0daa1d518d33ab93fa0328ff2f94cc64d1d2359f5f34b0a9f11e56705b85aec924543a8b
+  metadata.gz: 23d63a198657b36b713021d3e01ab6be53b7f99f192a5293d10ccdd630e9663ea9bbc08033811035431d21bce6a2615aa255f7b920947d43d08c744edd23a3cf
+  data.tar.gz: eb40b01ba53f7660f4671c8d9f07ce93374887c24b7d0f4331d38cbb33c115189034b7f44c867602b15a82eb836544708caeb28ed7f648ff6c4f086d74fc66d3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    paperclip-cloudinary (1.0.0)
+    paperclip-cloudinary (1.1.0)
       cloudinary (~> 1.1)
 
 GEM

data/README.md

@@ -1,7 +1,9 @@
 # paperclip-cloudinary
 
-paperclip-cloudinary allows simple storage of image assets to a
-Cloudinary instance.
+[![Gem
+Version](https://badge.fury.io/rb/paperclip-cloudinary.svg)](https://badge.fury.io/rb/paperclip-cloudinary)
+
+`paperclip-cloudinary` allows Rails models managed via [Paperclip](http://github.com/thoughtbot/paperclip) to store image and file assets on a Cloudinary instance.
 
 [Cloudinary](http://cloudinary.com) is an image, file and video hosting service that allows for
 dynamic, on-the-fly transformations of images with fast results. There
@@ -13,11 +15,12 @@ credentials, use paperclip-cloudinary to manage your attachments.
 
 At this stage, not all of the API has been exposed for Cloudinary, so if
 it seems you can't quite leverage all of Cloudinary's functionality yet,
-that's why.
+that's why. But much Cloudinary's best offerings, like dynamic image transformation, 
+are readily available.
 
-Note: Cloudinary also supports CarrierWave, and will probably be more
+Note: Cloudinary also supports CarrierWave and Attachinary, and will probably be more
 consistently maintained going forward. But if you are distinctively
-looking for a paperclip-based solution, this gem is for you.
+looking for a Paperclip-based solution, this gem is for you.
 
 ## Installation
 
@@ -67,6 +70,62 @@ has_attached_file :image,
 The `cloudinary_credentials` can be a file location, a file, or a Hash
 of options.
 
+### Upload Options
+
+Cloudinary supports a host of [upload
+options](http://cloudinary.com/documentation/image_upload_api_reference#upload)
+that can be run at the time an image or file is uploaded.
+
+This gem specifies a few of these options for you:
+
+* `public_id`: Defines the name of this file
+* `use_filename`: set to true to use the filename
+* `unique_filename`: set to false
+* `overwrite`: set to true to overwrite existing files with each re-upload
+* `invalidate`: set to true to invalidate CDN cache with each re-upload
+
+You can specify additional options by supplying a Hash to `:cloudinary_upload_options` 
+in your `has_attached_file` declaration.  The following options are supported here:
+
+* `default`: Default options applied to all styles of this upload
+* `styles`: A Hash of style names to the upload options for that
+  particular style.
+
+See Cloudinary documentation for list of keys and expected value options and data types. 
+The value can also be a `lambda` function that returns the appropriate value.  The 
+`style_name` and Paperclip `attachment` object will be passed to your function.
+
+```ruby
+has_attached_file :image,
+    :storage => :cloudinary,
+    :styles => { :avatar => '200x200>' },
+    :cloudinary_upload_options => {
+        :default => {
+            :tags => [ 'Web' ],
+            :context => {
+                :caption => lambda { |style_name, attachment| attachment.instance.caption }
+            }
+        },
+        :styles => {
+            :avatar => {
+                :tags => [ 'Web', 'Avatar' ],
+                :transformation => [
+                    { :crop => 'thumb', :gravity => 'face' }
+                ]
+            }
+        }
+      }
+  }
+```
+
+Here, all image versions would be uploaded with a caption taken from the model's caption parameter and 
+a tag "Web."  For the avatar style, the tags would be overridden to be both "Web" and "Avatar," and 
+an [incoming transformation](http://cloudinary.com/documentation/rails_image_upload#incoming_transformations) would 
+be run to crop the photo to a thumbnail and gravitate the center toward the user's face using Cloudinary's 
+facial recognition features.
+
+The gem-provided default options can not be overridden.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/GoGoCarl/paperclip-cloudinary.

data/lib/paperclip/cloudinary/version.rb

@@ -1,5 +1,5 @@
 module Paperclip
   module Cloudinary
-    VERSION = "1.0.0"
+    VERSION = "1.1.0"
   end
 end

data/lib/paperclip/storage/cloudinary.rb

@@ -21,9 +21,19 @@ module Paperclip
             public_id: public_id(style_name),
             use_filename: true,
             unique_filename: false,
-            overwrite: true
+            overwrite: true,
+            invalidate: true
           }
-          options = @options[:cloudinary_upload_options] || {}
+          upload_opts  = @options[:cloudinary_upload_options] || {}
+          default_opts = upload_opts[:default] || {}
+          style_opts   = upload_opts[:styles].try(:[], style_name) || {}
+
+          options = {}
+          [default_opts, style_opts].each do |opts|
+            options.deep_merge!(opts) do |key, existing_value, new_value|
+              new_value.try(:call, style_name, self) || new_value
+            end
+          end
           options.merge! defaults
           ::Cloudinary::Uploader.upload file, options
         end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: paperclip-cloudinary
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Carl Scott
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-04-08 00:00:00.000000000 Z
+date: 2016-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cloudinary