Shrine 2.9.0
New Plugins
- The
infer_extension
plugin has been added, which automatically infers the upload location extension from the MIME type if it's unknown. This is useful when using thedata_uri
plugin (where the extension is always unknown), or theremote_url
plugin (where the extension might not be known).
Shrine.plugin :infer_extension
New Features
- The
determine_mime_type
plugin has gained built-in support for the Marcel gem, Basecamp's wrapper around the existing MimeMagic.
Shrine.plugin :determine_mime_type, analyzer: :marcel
- The
versions
plugin now supports saving arrays of files, as well as nested structures of arrays and hashes.
class PdfUploader < Shrine
plugin :versions
plugin :processing
process(:store) do |io, context|
[ file1, file2, ... ]
# or
{ name1: [ file1, file2, ... ], ... }
# or
[ { name1: file1 }, ... ]
end
end
UploadedFile#open
can now be called without passing a block. This is useful if you want to make it explicit when the uploaded file is opened, instead of it happening automatically when#read
is called.
uploaded_file.open # opens the local or remote file
uploaded_file.read # read content
uploaded_file.close # close the file
- The
Model#<attachment>_attacher
now accepts options which are forwarded toShrine::Attacher.new
.
photo.image_attacher(store: :other_store)
photo.update(image: file) # uploads to :other_store
Other improvements
Fixed
backgrounding
plugin not detecting options passed toShrine::Attachment.new
.Fixed S3 storage replacing whitespace with
+
symbols in original filename when assigning object's:content_disposition
on upload.If an error occurs when downloading the file in
UploadedFile#download
andStorage::S3#download
, the tempfile with partially downloaded content will now automatically be deleted.Shrine now uses the
frozen-string-literal
feature, which will reduce the number of string allocations.
Backwards compatibility
The
:filename
option of thedata_uri
plugin has been deprecated in favour of the newinfer_extension
plugin.The
multi_delete
plugin has been deprecated, and theversions
plugin isn't loading it by default anymore.