carrierwave 0.5.6 → 0.5.7

data/README.md

@@ -59,15 +59,14 @@ uploader.retrieve_from_store!('my_file.png')
 ```
 
 CarrierWave gives you a `store` for permanent storage, and a `cache` for
-temporary storage. You can use different stores, at the moment a filesystem
-store, an Amazon S3 store, a Rackspace Cloud Files store, and a store for
-MongoDB's GridFS are bundled.
+temporary storage. You can use different stores, including filesystem
+and cloud storage.
 
 Most of the time you are going to want to use CarrierWave together with an ORM.
 It is quite simple to mount uploaders on columns in your model, so you can
 simply assign files and get going:
 
-### ActiveRecord, Mongoid
+### ActiveRecord
 
 Make sure you are loading CarrierWave after loading your ORM, otherwise you'll
 need to require the relevant extension manually, e.g.:
@@ -90,8 +89,6 @@ class User
 end
 ```
 
-This works the same with all supported ORMs.
-
 Now you can cache files by assigning them to the attribute, they will
 automatically be stored when the record is saved.
 
@@ -102,17 +99,15 @@ u.avatar = File.open('somewhere')
 u.save!
 u.avatar.url # => '/url/to/file.png'
 u.avatar.current_path # => 'path/to/file.png'
+u.avatar_identifier # => 'file.png'
 ```
 
-If using Mongoid, note that embedded documents files aren't saved when parent documents are saved.
-You must explicitly call save on embedded documents in order to save their attached files.
-You can read more about this [here](https://github.com/jnicklas/carrierwave/issues#issue/81)
-
-### DataMapper, Sequel
+### DataMapper, Mongoid, Sequel
 
-Other ORM support has been extracted into separate gems. Learn more:
+Other ORM support has been extracted into separate gems:
 
 * [carrierwave-datamapper](https://github.com/jnicklas/carrierwave-datamapper)
+* [carrierwave-mongoid](https://github.com/jnicklas/carrierwave-mongoid)
 * [carrierwave-sequel](https://github.com/jnicklas/carrierwave-sequel)
 
 There are more extensions listed in [the wiki](https://github.com/jnicklas/carrierwave/wiki)
@@ -478,6 +473,13 @@ of this information.
 config.fog_host = "c000000.cdn.rackspacecloud.com"
 ```
 
+The UK Rackspace Cloud doesn’t have the same auth server as the US Cloud.
+In case you are using Rackspace UK, you have to adjust the Auth URL:
+
+``` ruby
+config.rackspace_auth_url = 'lon.auth.api.rackspacecloud.com'
+```
+
 In your uploader, set the storage to :fog
 
 ``` ruby
@@ -520,38 +522,6 @@ end
 That's it! You can still use the `CarrierWave::Uploader#url` method to return
 the url to the file on Google.
 
-## Using MongoDB's GridFS store
-
-You'll need to configure the database and host to use:
-
-``` ruby
-CarrierWave.configure do |config|
-  config.grid_fs_database = 'my_mongo_database'
-  config.grid_fs_host = 'mongo.example.com'
-end
-```
-
-The defaults are 'carrierwave' and 'localhost'.
-
-And then in your uploader, set the storage to `:grid_fs`:
-
-``` ruby
-class AvatarUploader < CarrierWave::Uploader::Base
-  storage :grid_fs
-end
-```
-
-Since GridFS doesn't make the files available via HTTP, you'll need to stream
-them yourself. In Rails for example, you could use the `send_data` method. You
-can tell CarrierWave the URL you will serve your images from, allowing it to
-generate the correct URL, by setting eg:
-
-``` ruby
-CarrierWave.configure do |config|
-  config.grid_fs_access_url = "/image/show"
-end
-```
-
 ## Using RMagick
 
 If you're uploading images, you'll probably want to manipulate them in some way,

data/lib/carrierwave.rb

@@ -107,5 +107,3 @@ elsif defined?(Sinatra)
   CarrierWave.root = Sinatra::Application.public
 
 end
-
-require 'carrierwave/orm/mongoid' if defined?(Mongoid)

data/lib/carrierwave/mount.rb

@@ -21,15 +21,13 @@ module CarrierWave
     #
     def uploaders
       @uploaders ||= {}
-      @uploaders = superclass.uploaders.merge(@uploaders)
-    rescue NoMethodError
+      @uploaders = superclass.uploaders.merge(@uploaders) if superclass.respond_to?(:uploaders)
       @uploaders
     end
 
     def uploader_options
       @uploader_options ||= {}
-      @uploader_options = superclass.uploader_options.merge(@uploader_options)
-    rescue NoMethodError
+      @uploader_options = superclass.uploader_options.merge(@uploader_options) if superclass.respond_to?(:uploader_options)
       @uploader_options
     end
 
@@ -337,10 +335,8 @@ module CarrierWave
       end
 
       def remote_url=(url)
-        unless uploader.cached?
-          @remote_url = url
-          uploader.download!(url)
-        end
+        @remote_url = url
+        uploader.download!(url)
       end
 
       def store!

data/lib/carrierwave/uploader/cache.rb

@@ -130,16 +130,7 @@ module CarrierWave
         with_callbacks(:retrieve_from_cache, cache_name) do
           self.cache_id, self.original_filename = cache_name.to_s.split('/', 2)
           @filename = original_filename
-
-          if File.exist?(cache_path) && defined?(MIME::Types)
-            @file = SanitizedFile.new(
-              :tempfile => cache_path,
-              :filename => @filename,
-              :content_type => MIME::Types.of(File.basename(cache_path))[0].content_type
-            )
-          else
-            @file = CarrierWave::SanitizedFile.new(cache_path)
-          end
+          @file = CarrierWave::SanitizedFile.new(cache_path)
         end
       end
 

data/lib/carrierwave/uploader/configuration.rb

@@ -37,7 +37,6 @@ module CarrierWave
         add_config :enable_processing
         add_config :ensure_multipart_form
         add_config :delete_tmp_file_after_storage
-        add_config :delete_cache_id_after_storage
         add_config :remove_previously_stored_files_after_update
 
         # fog
@@ -145,7 +144,6 @@ module CarrierWave
             config.store_dir = 'uploads'
             config.cache_dir = 'uploads/tmp'
             config.delete_tmp_file_after_storage = true
-            config.delete_cache_id_after_storage = true
             config.remove_previously_stored_files_after_update = true
             config.ignore_integrity_errors = true
             config.ignore_processing_errors = true

data/lib/carrierwave/uploader/store.rb

@@ -53,18 +53,18 @@ module CarrierWave
       # [new_file (File, IOString, Tempfile)] any kind of file object
       #
       def store!(new_file=nil)
-        cache!(new_file) if new_file
+        cache!(new_file) if new_file && ((@cache_id != parent_cache_id) || @cache_id.nil?)
         if @file and @cache_id
           with_callbacks(:store, new_file) do
             new_file = storage.store!(@file)
             @file.delete if delete_tmp_file_after_storage
-            delete_cache_id if delete_cache_id_after_storage
+            delete_cache_id
             @file = new_file
             @cache_id = nil
           end
         end
       end
-      
+
       ##
       # Deletes a cache id (tmp dir in cache)
       #

data/lib/carrierwave/uploader/url.rb

@@ -22,13 +22,24 @@ module CarrierWave
       ##
       # === Returns
       #
-      # [String] A JSON serialization containing this uploader's URL(s)
+      # [Hash] the locations where this file and versions are accessible via a url
       #
       def as_json(options = nil)
         h = { :url => url }
         h.merge Hash[versions.map { |name, version| [name, { :url => version.url }] }]
       end
 
+      ##
+      # FIXME to_xml should work like to_json, but this is the best we've been able to do so far.
+      # This hack fixes issue #337.
+      #
+      # === Returns
+      #
+      # [nil]
+      #
+      def to_xml(options = nil)
+      end
+
     end # Url
   end # Uploader
 end # CarrierWave

data/lib/carrierwave/uploader/versions.rb

@@ -26,6 +26,9 @@ module CarrierWave
         self.versions = {}
         self.version_names = []
 
+        attr_accessor :parent_cache_id
+
+        after :cache, :assign_parent_cache_id
         after :cache, :cache_versions!
         after :store, :store_versions!
         after :remove, :remove_versions!
@@ -179,6 +182,11 @@ module CarrierWave
       end
 
     private
+      def assign_parent_cache_id(file)
+        active_versions.each do |name, uploader|
+          uploader.parent_cache_id = @cache_id
+        end
+      end
 
       def active_versions
         versions.select do |name, uploader|

data/lib/carrierwave/version.rb

@@ -1,3 +1,3 @@
 module CarrierWave
-  VERSION = "0.5.6"
+  VERSION = "0.5.7"
 end

data/lib/generators/templates/uploader.rb

@@ -4,6 +4,7 @@ class <%= class_name %>Uploader < CarrierWave::Uploader::Base
 
   # Include RMagick or ImageScience support:
   # include CarrierWave::RMagick
+  # include CarrierWave::MiniMagick
   # include CarrierWave::ImageScience
 
   # Choose what kind of storage to use for this uploader:

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: carrierwave
 version: !ruby/object:Gem::Version 
-  hash: 7
+  hash: 5
   prerelease: 
   segments: 
   - 0
   - 5
-  - 6
-  version: 0.5.6
+  - 7
+  version: 0.5.7
 platform: ruby
 authors: 
 - Jonas Nicklas
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-12 00:00:00 -05:00
+date: 2011-08-12 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -52,17 +52,16 @@ dependencies:
   version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         hash: 3
         segments: 
-        - 2
         - 0
-        version: "2.0"
+        version: "0"
   prerelease: false
   type: :development
   requirement: *id003
-  name: rspec
+  name: sqlite3
 - !ruby/object:Gem::Dependency 
   version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
@@ -76,7 +75,7 @@ dependencies:
   prerelease: false
   type: :development
   requirement: *id004
-  name: excon
+  name: cucumber
 - !ruby/object:Gem::Dependency 
   version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
@@ -90,21 +89,22 @@ dependencies:
   prerelease: false
   type: :development
   requirement: *id005
-  name: fog
+  name: json
 - !ruby/object:Gem::Dependency 
   version_requirements: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
         hash: 3
         segments: 
+        - 2
         - 0
-        version: "0"
+        version: "2.0"
   prerelease: false
   type: :development
   requirement: *id006
-  name: cucumber
+  name: rspec
 - !ruby/object:Gem::Dependency 
   version_requirements: &id007 !ruby/object:Gem::Requirement 
     none: false
@@ -118,7 +118,7 @@ dependencies:
   prerelease: false
   type: :development
   requirement: *id007
-  name: sqlite3
+  name: sham_rack
 - !ruby/object:Gem::Dependency 
   version_requirements: &id008 !ruby/object:Gem::Requirement 
     none: false
@@ -132,7 +132,7 @@ dependencies:
   prerelease: false
   type: :development
   requirement: *id008
-  name: rmagick
+  name: timecop
 - !ruby/object:Gem::Dependency 
   version_requirements: &id009 !ruby/object:Gem::Requirement 
     none: false
@@ -146,7 +146,7 @@ dependencies:
   prerelease: false
   type: :development
   requirement: *id009
-  name: RubyInline
+  name: cloudfiles
 - !ruby/object:Gem::Dependency 
   version_requirements: &id010 !ruby/object:Gem::Requirement 
     none: false
@@ -160,7 +160,7 @@ dependencies:
   prerelease: false
   type: :development
   requirement: *id010
-  name: image_science
+  name: fog
 - !ruby/object:Gem::Dependency 
   version_requirements: &id011 !ruby/object:Gem::Requirement 
     none: false
@@ -188,77 +188,7 @@ dependencies:
   prerelease: false
   type: :development
   requirement: *id012
-  name: bson_ext
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id013 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
-  type: :development
-  requirement: *id013
-  name: mongoid
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id014 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
-  type: :development
-  requirement: *id014
-  name: timecop
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id015 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
-  type: :development
-  requirement: *id015
-  name: json
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id016 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
-  type: :development
-  requirement: *id016
-  name: cloudfiles
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id017 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
-  type: :development
-  requirement: *id017
-  name: sham_rack
+  name: rmagick
 description: Upload files in your Ruby applications, map them to a range of ORMs, store them on different backends.
 email: 
 - jonas.nicklas@gmail.com
@@ -273,8 +203,6 @@ files:
 - lib/carrierwave/locale/en.yml
 - lib/carrierwave/mount.rb
 - lib/carrierwave/orm/activerecord.rb
-- lib/carrierwave/orm/mongoid.rb
-- lib/carrierwave/processing/image_science.rb
 - lib/carrierwave/processing/mime_types.rb
 - lib/carrierwave/processing/mini_magick.rb
 - lib/carrierwave/processing/rmagick.rb
@@ -283,7 +211,6 @@ files:
 - lib/carrierwave/storage/cloud_files.rb
 - lib/carrierwave/storage/file.rb
 - lib/carrierwave/storage/fog.rb
-- lib/carrierwave/storage/grid_fs.rb
 - lib/carrierwave/storage/right_s3.rb
 - lib/carrierwave/storage/s3.rb
 - lib/carrierwave/test/matchers.rb

data/lib/carrierwave/orm/mongoid.rb

@@ -1,68 +0,0 @@
-# encoding: utf-8
-
-require 'mongoid'
-require 'carrierwave/validations/active_model'
-
-module CarrierWave
-  module Mongoid
-    include CarrierWave::Mount
-    ##
-    # See +CarrierWave::Mount#mount_uploader+ for documentation
-    #
-    def mount_uploader(column, uploader=nil, options={}, &block)
-      options[:mount_on] ||= "#{column}_filename"
-      field options[:mount_on]
-
-      super
-
-      alias_method :read_uploader, :read_attribute
-      alias_method :write_uploader, :write_attribute
-
-      include CarrierWave::Validations::ActiveModel
-
-      validates_integrity_of  column if uploader_option(column.to_sym, :validate_integrity)
-      validates_processing_of column if uploader_option(column.to_sym, :validate_processing)
-
-      after_save      :"store_#{column}!"
-      before_save     :"write_#{column}_identifier"
-      after_destroy   :"remove_#{column}!"
-      before_update   :"store_previous_model_for_#{column}"
-      after_save      :"remove_previously_stored_#{column}"
-
-      class_eval <<-RUBY, __FILE__, __LINE__+1
-        def #{column}=(new_file)
-          column = _mounter(:#{column}).serialization_column
-
-          # Note (Didier L.): equivalent of the <column>_will_change! ActiveModel method
-          begin
-            value = __send__(column)
-            value = value.duplicable? ? value.clone : value
-          rescue TypeError, NoMethodError
-          end
-          setup_modifications
-
-          super.tap do
-            @modifications[column] = [value, __send__(column)]
-          end
-        end
-
-        def #{column}_changed?
-          column = _mounter(:#{column}).serialization_column
-          send(:"\#{column}_changed?")
-        end
-
-        def find_previous_model_for_#{column}
-          if self.embedded?
-            self._parent.reload.send(self.metadata.key).find(to_key.first)
-          else
-            self.class.find(to_key.first)
-          end
-        end
-
-      RUBY
-
-    end
-  end # Mongoid
-end # CarrierWave
-
-Mongoid::Document::ClassMethods.send(:include, CarrierWave::Mongoid)

data/lib/carrierwave/processing/image_science.rb

@@ -1,135 +0,0 @@
-# encoding: utf-8
-
-require 'image_science'
-
-module CarrierWave
-  module ImageScience
-    extend ActiveSupport::Concern
-
-    module ClassMethods
-      def resize_to_limit(width, height)
-        process :resize_to_limit => [width, height]
-      end
-
-      def resize_to_fit(width, height)
-        process :resize_to_fit => [width, height]
-      end
-
-      def resize_to_fill(width, height)
-        process :resize_to_fill => [width, height]
-      end
-    end
-
-    ##
-    # Resize the image to fit within the specified dimensions while retaining
-    # the original aspect ratio. The image may be shorter or narrower than
-    # specified in the smaller dimension but will not be larger than the
-    # specified values.
-    #
-    # === Parameters
-    #
-    # [width (Integer)] the width to scale the image to
-    # [height (Integer)] the height to scale the image to
-    #
-    def resize_to_fit(new_width, new_height)
-      cache_stored_file! if !cached?
-
-      ::ImageScience.with_image(self.current_path) do |img|
-        width, height = extract_dimensions(img.width, img.height, new_width, new_height)
-        img.resize( width, height ) do |file|
-          file.save( self.current_path )
-        end
-      end
-    end
-
-    ##
-    # Resize the image to fit within the specified dimensions while retaining
-    # the aspect ratio of the original image. If necessary, crop the image in
-    # the larger dimension.
-    #
-    # === Parameters
-    #
-    # [width (Integer)] the width to scale the image to
-    # [height (Integer)] the height to scale the image to
-    #
-    def resize_to_fill(new_width, new_height)
-      cache_stored_file! if !cached?
-
-      ::ImageScience.with_image(self.current_path) do |img|
-        width, height = extract_dimensions_for_crop(img.width, img.height, new_width, new_height)
-        x_offset, y_offset = extract_placement_for_crop(width, height, new_width, new_height)
-
-        # check if if new dimensions are too small for the new image
-        if width < new_width
-          width = new_width
-          height = (new_width.to_f*(img.height.to_f/img.width.to_f)).round
-        elsif height < new_height
-          height = new_height
-          width = (new_height.to_f*(img.width.to_f/img.height.to_f)).round
-        end
-
-        img.resize( width, height ) do |i2|
-
-          # check to make sure offset is not negative
-          if x_offset < 0
-            x_offset = 0
-          end
-          if y_offset < 0
-            y_offset = 0
-          end
-
-          i2.with_crop( x_offset, y_offset, new_width + x_offset, new_height + y_offset) do |file|
-            file.save( self.current_path )
-          end
-        end
-      end
-    end
-
-    ##
-    # Resize the image to fit within the specified dimensions while retaining
-    # the original aspect ratio. Will only resize the image if it is larger than the
-    # specified dimensions. The resulting image may be shorter or narrower than specified
-    # in the smaller dimension but will not be larger than the specified values.
-    #
-    # === Parameters
-    #
-    # [width (Integer)] the width to scale the image to
-    # [height (Integer)] the height to scale the image to
-    #
-    def resize_to_limit(new_width, new_height)
-      cache_stored_file! if !cached?
-
-      ::ImageScience.with_image(self.current_path) do |img|
-        if img.width > new_width or img.height > new_height
-          resize_to_fit(new_width, new_height)
-        end
-      end
-    end
-
-  private
-
-    def extract_dimensions(width, height, new_width, new_height, type = :resize)
-      aspect_ratio = width.to_f / height.to_f
-      new_aspect_ratio = new_width / new_height
-
-      if (new_aspect_ratio > aspect_ratio) ^ ( type == :crop )  # Image is too wide, the caret is the XOR operator
-        new_width, new_height = [ (new_height * aspect_ratio), new_height]
-      else #Image is too narrow
-        new_width, new_height = [ new_width, (new_width / aspect_ratio)]
-      end
-
-      [new_width, new_height].collect! { |v| v.round }
-    end
-
-    def extract_dimensions_for_crop(width, height, new_width, new_height)
-      extract_dimensions(width, height, new_width, new_height, :crop)
-    end
-
-    def extract_placement_for_crop(width, height, new_width, new_height)
-      x_offset = (width / 2.0) - (new_width / 2.0)
-      y_offset = (height / 2.0) - (new_height / 2.0)
-      [x_offset, y_offset].collect! { |v| v.round }
-    end
-
-  end # ImageScience
-end # CarrierWave

data/lib/carrierwave/storage/grid_fs.rb

@@ -1,136 +0,0 @@
-# encoding: utf-8
-require 'mongo'
-
-module CarrierWave
-  module Storage
-
-    ##
-    # The GridFS store uses MongoDB's GridStore file storage system to store files
-    #
-    # There are two ways of configuring the GridFS connection. Either you create a
-    # connection or you reuse an existing connection.
-    #
-    # Creating a connection looks something like this:
-    #
-    #     CarrierWave.configure do |config|
-    #       config.storage = :grid_fs
-    #       config.grid_fs_host = "your-host.com"
-    #       config.grid_fs_port = "27017"
-    #       config.grid_fs_database = "your_dbs_app_name"
-    #       config.grid_fs_username = "user"
-    #       config.grid_fs_password = "verysecret"
-    #       config.grid_fs_access_url = "/images"
-    #     end
-    #
-    #   In the above example your documents url will look like:
-    #
-    #      http://your-app.com/images/:document-identifier-here
-    #
-    # When you already have a Mongo connection object (for example through Mongoid)
-    # you can also reuse this connection:
-    #
-    #     CarrierWave.configure do |config|
-    #       config.storage = :grid_fs
-    #       config.grid_fs_connection = Mongoid.database
-    #       config.grid_fs_access_url = "/images"
-    #     end
-    #
-    class GridFS < Abstract
-
-      class File
-
-        def initialize(uploader, path)
-          @path = path
-          @uploader = uploader
-        end
-
-        def path
-          @path
-        end
-
-        def url
-          unless @uploader.grid_fs_access_url
-            nil
-          else
-            [@uploader.grid_fs_access_url, @path].join("/")
-          end
-        end
-
-        def read
-          grid.open(@path, 'r').data
-        end
-
-        def write(file)
-          grid.open(@uploader.store_path, 'w', :content_type => file.content_type) do |f|
-            f.write(file.read)
-          end
-        end
-
-        def delete
-          grid.delete(@path)
-        end
-
-        def content_type
-          grid.open(@path, 'r').content_type
-        end
-
-        def file_length
-          grid.open(@path, 'r').file_length
-        end
-
-      protected
-
-        def database
-          @connection ||= @uploader.grid_fs_connection || begin
-            host = @uploader.grid_fs_host
-            port = @uploader.grid_fs_port
-            database = @uploader.grid_fs_database
-            username = @uploader.grid_fs_username
-            password = @uploader.grid_fs_password
-            db = Mongo::Connection.new(host, port).db(database)
-            db.authenticate(username, password) if username && password
-            db
-          end
-        end
-
-        def grid
-          @grid ||= Mongo::GridFileSystem.new(database)
-        end
-
-      end
-
-      ##
-      # Store the file in MongoDB's GridFS GridStore
-      #
-      # === Parameters
-      #
-      # [file (CarrierWave::SanitizedFile)] the file to store
-      #
-      # === Returns
-      #
-      # [CarrierWave::SanitizedFile] a sanitized file
-      #
-      def store!(file)
-        stored = CarrierWave::Storage::GridFS::File.new(uploader, uploader.store_path)
-        stored.write(file)
-        stored
-      end
-
-      ##
-      # Retrieve the file from MongoDB's GridFS GridStore
-      #
-      # === Parameters
-      #
-      # [identifier (String)] the filename of the file
-      #
-      # === Returns
-      #
-      # [CarrierWave::Storage::GridFS::File] a sanitized file
-      #
-      def retrieve!(identifier)
-        CarrierWave::Storage::GridFS::File.new(uploader, uploader.store_path(identifier))
-      end
-
-    end # File
-  end # Storage
-end # CarrierWave