shrine 2.19.4 → 3.4.0

metadata

@@ -1,35 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: shrine
 version: !ruby/object:Gem::Version
-  version: 2.19.4
+  version: 3.4.0
 platform: ruby
 authors:
 - Janko Marohnić
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-01-16 00:00:00.000000000 Z
+date: 2021-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: down
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4.1'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '6'
+        version: '5.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4.1'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '6'
+        version: '5.1'
 - !ruby/object:Gem::Dependency
   name: content_disposition
   requirement: !ruby/object:Gem::Requirement
@@ -72,48 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.8'
-- !ruby/object:Gem::Dependency
-  name: minitest-hooks
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '1.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
-- !ruby/object:Gem::Dependency
-  name: shrine-memory
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.2.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: '1.11'
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
@@ -134,14 +100,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: rack-test_app
   requirement: !ruby/object:Gem::Requirement
@@ -274,14 +240,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.69'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.69'
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
   requirement: !ruby/object:Gem::Requirement
@@ -296,6 +262,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.23'
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: dry-monitor
   requirement: !ruby/object:Gem::Requirement
@@ -316,14 +296,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.0
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.0
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: sequel
   requirement: !ruby/object:Gem::Requirement
@@ -344,28 +324,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.0
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.0
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.6
+        version: '1.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.6
+        version: '1.4'
 description: |
   Shrine is a toolkit for file attachments in Ruby applications. It supports
   uploading, downloading, processing and deleting IO objects, backed by various
@@ -387,45 +367,48 @@ files:
 - doc/advantages.md
 - doc/attacher.md
 - doc/carrierwave.md
+- doc/changing_derivatives.md
 - doc/changing_location.md
+- doc/changing_storage.md
+- doc/creating_persistence_plugins.md
 - doc/creating_plugins.md
 - doc/creating_storages.md
 - doc/design.md
 - doc/direct_s3.md
+- doc/external/articles.md
+- doc/external/extensions.md
+- doc/external/misc.md
+- doc/getting_started.md
 - doc/metadata.md
-- doc/migrating_storage.md
 - doc/multiple_files.md
 - doc/paperclip.md
 - doc/plugins/activerecord.md
 - doc/plugins/add_metadata.md
+- doc/plugins/atomic_helpers.md
 - doc/plugins/backgrounding.md
-- doc/plugins/backup.md
 - doc/plugins/cached_attachment_data.md
-- doc/plugins/copy.md
+- doc/plugins/column.md
 - doc/plugins/data_uri.md
 - doc/plugins/default_storage.md
 - doc/plugins/default_url.md
-- doc/plugins/default_url_options.md
-- doc/plugins/delete_promoted.md
 - doc/plugins/delete_raw.md
 - doc/plugins/derivation_endpoint.md
+- doc/plugins/derivatives.md
 - doc/plugins/determine_mime_type.md
-- doc/plugins/direct_upload.md
 - doc/plugins/download_endpoint.md
 - doc/plugins/dynamic_storage.md
-- doc/plugins/hooks.md
+- doc/plugins/entity.md
+- doc/plugins/form_assign.md
 - doc/plugins/included.md
 - doc/plugins/infer_extension.md
 - doc/plugins/instrumentation.md
 - doc/plugins/keep_files.md
-- doc/plugins/logging.md
 - doc/plugins/metadata_attributes.md
-- doc/plugins/migration_helpers.md
+- doc/plugins/mirroring.md
+- doc/plugins/model.md
 - doc/plugins/module_include.md
-- doc/plugins/moving.md
-- doc/plugins/multi_delete.md
-- doc/plugins/parallelize.md
-- doc/plugins/parsed_json.md
+- doc/plugins/multi_cache.md
+- doc/plugins/persistence.md
 - doc/plugins/presign_endpoint.md
 - doc/plugins/pretty_location.md
 - doc/plugins/processing.md
@@ -441,13 +424,15 @@ files:
 - doc/plugins/signature.md
 - doc/plugins/store_dimensions.md
 - doc/plugins/tempfile.md
+- doc/plugins/type_predicates.md
 - doc/plugins/upload_endpoint.md
 - doc/plugins/upload_options.md
+- doc/plugins/url_options.md
+- doc/plugins/validation.md
 - doc/plugins/validation_helpers.md
 - doc/plugins/versions.md
 - doc/processing.md
 - doc/refile.md
-- doc/regenerating_versions.md
 - doc/release_notes/1.0.0.md
 - doc/release_notes/1.1.0.md
 - doc/release_notes/1.2.0.md
@@ -481,48 +466,55 @@ files:
 - doc/release_notes/2.7.0.md
 - doc/release_notes/2.8.0.md
 - doc/release_notes/2.9.0.md
+- doc/release_notes/3.0.0.md
+- doc/release_notes/3.0.1.md
+- doc/release_notes/3.1.0.md
+- doc/release_notes/3.2.0.md
+- doc/release_notes/3.2.1.md
+- doc/release_notes/3.2.2.md
+- doc/release_notes/3.3.0.md
+- doc/release_notes/3.4.0.md
 - doc/retrieving_uploads.md
 - doc/securing_uploads.md
 - doc/storage/file_system.md
+- doc/storage/memory.md
 - doc/storage/s3.md
 - doc/testing.md
+- doc/upgrading_to_3.md
 - doc/validation.md
 - lib/shrine.rb
 - lib/shrine/attacher.rb
 - lib/shrine/attachment.rb
 - lib/shrine/plugins.rb
+- lib/shrine/plugins/_persistence.rb
 - lib/shrine/plugins/_urlsafe_serialization.rb
 - lib/shrine/plugins/activerecord.rb
 - lib/shrine/plugins/add_metadata.rb
-- lib/shrine/plugins/background_helpers.rb
+- lib/shrine/plugins/atomic_helpers.rb
 - lib/shrine/plugins/backgrounding.rb
-- lib/shrine/plugins/backup.rb
 - lib/shrine/plugins/cached_attachment_data.rb
-- lib/shrine/plugins/copy.rb
+- lib/shrine/plugins/column.rb
 - lib/shrine/plugins/data_uri.rb
 - lib/shrine/plugins/default_storage.rb
 - lib/shrine/plugins/default_url.rb
 - lib/shrine/plugins/default_url_options.rb
-- lib/shrine/plugins/delete_promoted.rb
 - lib/shrine/plugins/delete_raw.rb
 - lib/shrine/plugins/derivation_endpoint.rb
+- lib/shrine/plugins/derivatives.rb
 - lib/shrine/plugins/determine_mime_type.rb
-- lib/shrine/plugins/direct_upload.rb
 - lib/shrine/plugins/download_endpoint.rb
 - lib/shrine/plugins/dynamic_storage.rb
-- lib/shrine/plugins/hooks.rb
+- lib/shrine/plugins/entity.rb
+- lib/shrine/plugins/form_assign.rb
 - lib/shrine/plugins/included.rb
 - lib/shrine/plugins/infer_extension.rb
 - lib/shrine/plugins/instrumentation.rb
 - lib/shrine/plugins/keep_files.rb
-- lib/shrine/plugins/logging.rb
 - lib/shrine/plugins/metadata_attributes.rb
-- lib/shrine/plugins/migration_helpers.rb
+- lib/shrine/plugins/mirroring.rb
+- lib/shrine/plugins/model.rb
 - lib/shrine/plugins/module_include.rb
-- lib/shrine/plugins/moving.rb
-- lib/shrine/plugins/multi_delete.rb
-- lib/shrine/plugins/parallelize.rb
-- lib/shrine/plugins/parsed_json.rb
+- lib/shrine/plugins/multi_cache.rb
 - lib/shrine/plugins/presign_endpoint.rb
 - lib/shrine/plugins/pretty_location.rb
 - lib/shrine/plugins/processing.rb
@@ -538,12 +530,16 @@ files:
 - lib/shrine/plugins/signature.rb
 - lib/shrine/plugins/store_dimensions.rb
 - lib/shrine/plugins/tempfile.rb
+- lib/shrine/plugins/type_predicates.rb
 - lib/shrine/plugins/upload_endpoint.rb
 - lib/shrine/plugins/upload_options.rb
+- lib/shrine/plugins/url_options.rb
+- lib/shrine/plugins/validation.rb
 - lib/shrine/plugins/validation_helpers.rb
 - lib/shrine/plugins/versions.rb
 - lib/shrine/storage/file_system.rb
 - lib/shrine/storage/linter.rb
+- lib/shrine/storage/memory.rb
 - lib/shrine/storage/s3.rb
 - lib/shrine/uploaded_file.rb
 - lib/shrine/version.rb
@@ -555,9 +551,9 @@ metadata:
   bug_tracker_uri: https://github.com/shrinerb/shrine/issues
   changelog_uri: https://github.com/shrinerb/shrine/blob/master/CHANGELOG.md
   documentation_uri: https://shrinerb.com
-  mailing_list_uri: https://groups.google.com/forum/#!forum/ruby-shrine
+  mailing_list_uri: https://discourse.shrinerb.com
   source_code_uri: https://github.com/shrinerb/shrine
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -572,8 +568,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: Toolkit for file attachments in Ruby applications
 test_files: []

data/doc/migrating_storage.md

@@ -1,76 +0,0 @@
-# Migrating to Different Storage
-
-While your application is live in production and performing uploads, it may
-happen that you decide you want to change your storage (the `:store`). Shrine
-by design allows you to do that easily, with zero downtime, by deploying the
-change in 2 phases.
-
-## Phase 1: Changing the storage
-
-The first stage, add the desired storage to your registry, and make it your
-current store (let's say that you're migrating from FileSystem to S3):
-
-```rb
-Shrine.storages = {
-  cache: Shrine::Storage::FileSystem.new("public", prefix: "uploads/cache"),
-  store: Shrine::Storage::FileSystem.new("public", prefix: "uploads"),
-  new_store: Shrine::Storage::S3.new(**s3_options),
-}
-
-Shrine.plugin :default_storage, store: :new_store
-```
-
-This will make already uploaded files stay uploaded on `:store`, and all new
-files will be uploaded to `:new_store`.
-
-## Phase 2: Copying existing files
-
-After you've deployed the previous change, it's time to copy all the existing
-files to the new storage, and update the records. This is how you can do it
-if you're using Sequel:
-
-```rb
-User.paged_each do |user|
-  if (attacher = user.avatar_attacher).stored?
-    uploaded_file = attacher.store!(user.avatar)
-    attacher.swap(uploaded_file)
-  end
-end
-
-# Repeat for all other attachments and models
-```
-
-Now your uploaded files are successfully copied to the new storage, so you
-should be able to safely delete the old one.
-
-## Phase 3 and 4: Renaming new storage (optional)
-
-The uploads will now be happening on the right storage, but if you would rather
-rename `:new_store` back to `:store`, you can do two more phases. **First** you
-need to deploy aliasing `:new_store` to `:store` (and make the default storage
-be `:store` again):
-
-```rb
-Shrine.storages = {
-  cache: Shrine::Storage::FileSystem.new("public", prefix: "uploads/cache"),
-  store: Shrine::Storage::S3.new(**s3_options),
-}
-
-Shrine.storages[:new_store] = Shrine.storages[:store]
-```
-
-**Second**, you should rename the storage names on existing records. With
-Sequel it would be something like:
-
-```rb
-User.paged_each do |user|
-  if user.avatar_attacher.stored?
-    user.update(avatar_data: user.avatar_data.gsub('"new_store"', '"store"'))
-  end
-end
-
-# Repeat for all other attachments and models
-```
-
-Now everything should be in order and you should be able to remove the
-`:new_store` alias.

data/doc/plugins/backup.md

@@ -1,31 +0,0 @@
-# Backup
-
-The [`backup`][backup] plugin allows you to automatically back up stored files
-to an additional storage.
-
-```rb
-storages[:backup_store] = Shrine::Storage::S3.new(options)
-plugin :backup, storage: :backup_store
-```
-
-After a file is stored, it will be reuploaded from store to the provided backup
-storage.
-
-```rb
-user.update(avatar: file) # uploaded both to :store and :backup_store
-```
-
-By default whenever stored files are deleted backed up files are deleted as
-well, but you can keep files on the "backup" storage by passing `delete:
-false`:
-
-```rb
-plugin :backup, storage: :backup_store, delete: false
-```
-
-Note that when adding this plugin with already existing stored files, Shrine
-won't know whether a stored file is backed up or not, so attempting to delete
-the backup could result in an error. To avoid that you can set `delete: false`
-until you manually back up the existing stored files.
-
-[backup]: /lib/shrine/plugins/backup.rb

data/doc/plugins/copy.md

@@ -1,24 +0,0 @@
-# Copy
-
-The [`copy`][copy] plugin allows copying attachment from one record to another.
-
-```rb
-plugin :copy
-```
-
-It adds a `Attacher#copy` method, which accepts another attacher, and copies
-the attachment from it:
-
-```rb
-photo.image_attacher.copy(other_photo.image_attacher)
-```
-
-This method will automatically be called when the record is duplicated:
-
-```rb
-duplicated_photo = photo.dup
-duplicated_photo.image #=> #<Shrine::UploadedFile>
-duplicated_photo.image != photo.image
-```
-
-[copy]: /lib/shrine/plugins/copy.rb

data/doc/plugins/delete_promoted.md

@@ -1,12 +0,0 @@
-# Delete Promoted
-
-The [`delete_promoted`][delete_promoted] plugin deletes files that have been
-promoted, after the record is saved. This means that cached files handled by
-the attacher will automatically get deleted once they're uploaded to store.
-This also applies to any other uploaded file passed to `Attacher#promote`.
-
-```rb
-plugin :delete_promoted
-```
-
-[delete_promoted]: /lib/shrine/plugins/delete_promoted.rb