shrine 3.4.0 → 3.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c012576836f3a56efa91be436999395123342c4650f76f152ef64808ce82ddb
-  data.tar.gz: 5be0e63b923ba28f838b4f692758af3eb975c937c4b63453acc629aab0240eac
+  metadata.gz: 5601661d53737bf3290ec5897dc9d33cfe5edac60a7468e67de7191649671a14
+  data.tar.gz: bf2a26e2162a0c1805f2e8d174128e8ee5008060fdbbb9b8e358d41bfdf680a2
 SHA512:
-  metadata.gz: da5eb6be96c3cacb0575e124b4238c038709d44f33085a5bfb4ae6cb1702d079ba0c7f1ca775828812c6d8cacd1b75aa5979c564dbe0e1ea52fea0036c0f577e
-  data.tar.gz: fe12c86f5d826581e4ecb1b5e1951ca1330c8d6d288d19001badd79dab646013a2e57faf51d6cf7369669515636dda3058bf42a2128ea04934f7b611a53e97dd
+  metadata.gz: 7eb43ca8a78d4dedec0d24422ca4bc9f62eb6e454aa61ac7871760c4c398973a9787591295c39799f6b3250d4b3af9e80f7082c659fb6ed67435d775846ca5e2
+  data.tar.gz: 636a7343486f6baaa3fa841abcef8439eb0df5d7183d6ac39a756a508de544dd356bca2562a9e01ac76b871a29455d2a40601f8086e8050dcc793bd57fc568e0

data/CHANGELOG.md

@@ -1,3 +1,99 @@
+## 3.10.0 (2026-09-20)
+
+* Add `fallback_storage` plugin for reading files from a secondary storage when they're missing in the primary storage (@yegorov, @janko)
+
+* `data_uri` – Add `:max_size` option for limiting the size of the data URI content, checked before the content is decoded (@jalrax, @janko)
+
+* `data_uri` – Pass the error to the `:error_message` proc as an optional second argument (@jalrax, @janko)
+
+## 3.9.0 (2026-07-13)
+
+* `Shrine.find_storage` now raises `Shrine::MissingStorage` (subclass of `Shrine::Error`) when the storage isn't registered, so it can be rescued separately (@janko)
+
+* `url_options` – Allow regular expression storage keys for compatibility with `dynamic_storage` plugin (@janko)
+
+* `upload_options` – Allow regular expression storage keys for compatibility with `dynamic_storage` plugin (@janko)
+
+* `remove_invalid` – Fix model attribute not being cleared/reverted after deassigning invalid file (@janko)
+
+* `activerecord`/`sequel` – Skip deleting the previous attachment when the record being saved was just created, to avoid deleting the original attachment of a duplicated record (@janko)
+
+* `tempfile` – Allow `UploadedFile#tempfile` to be called without opening the uploaded file first (@janko)
+
+* `activerecord` – Add `:attribute_types` option for skipping serialization of JSON/JSONB attributes declared via the Attributes API, not just database columns (@vojtad, @janko)
+
+## 3.8.0 (2026-06-24)
+
+* `s3` – Use single-request uploads for smaller files again instead of always using multipart uploads (@janko)
+
+* `derivatives` – Forward `Attacher#promote` options to `Attacher#upload_derivatives` (@milkcocoa)
+
+* `file_system` – Prevent path traversal outside of the storage directory (@janko)
+
+## 3.7.1 (2026-06-03)
+
+* Update method signatures of some plugins to work around a Bootsnap bug causing a `wrong number of arguments` error (@janko)
+
+* `derivation_endpoint` – Add `:format` argument to `UploadedFile#derivation_url` for path extension (@janko)
+
+* `rack_response` – Add `:etag` argument for setting a custom `ETag` (@camilohollanda)
+
+## 3.7.0 (2026-05-27)
+
+* `rack_response` - Add `:etag` option for setting a custom `ETag` header (@janko)
+
+* `download_endpoint` - Add support for expiring URLs (@davidwessman)
+
+* `s3` - Use `TransferManager` where available instead of deprecated `upload_steam` (@danieldevlewis)
+
+* `column` - Don't attempt to deserialize empty string as JSON (@adam12)
+
+* `derivatives` - Add `:keep_derivatives` plugin option to keep existing derivatives when a new file is attached (@fnordfish)
+
+* `refresh_metadata` - Add `replace:` keyword argument to `refresh_metadata!` for replacing instead of merging existing metadata (@JacobGalati)
+
+* `backgrounding` - Fix options not being forwarded from `promote_cached` to `promote_block` (@4ndypanda)
+
+* Fix URI default parser warnings in `UploadedFile` (@adam12)
+
+* Drop support for Ruby < 3.2
+
+## 3.6.0 (2024-04-29)
+
+* Add Rack 3 support (@tomasc, @janko)
+
+* Make a copy of attacher context hash when duplicating the attacher (@reidab)
+
+* An uploaded file can be implicitly re-opened after it has been closed (@jrochkind)
+
+* Add new `:copy_options` for initializing the S3 storage (@hkdahal)
+
+## 3.5.0 (2023-07-06)
+
+* Migrate website to Docusaurus v2 (@janko)
+
+* `download_endpoint` – Return `400 Bad Request` response when serialized file component is invalid (@janko)
+
+* `base` – Stop using obsolete `URI.regexp` in `UploadedFile#extension` (@y-yagi)
+
+* `s3` – Add `:encoding` option to `S3#open` to be passed to `Down::ChunkedIO#initialize` (@pond)
+
+* `s3` – Add `:max_multipart_parts` option for changing default limit of 10,000 parts (@jpl)
+
+* `s3` – Don't inherit S3 object tags when copying from temporary to permanent storage (@jrochkind)
+
+* `infer_extension` – Add `infer_extension` instance method to the uploader for convenience (@aried3r)
+
+* `derivation_endpoint` – Add `:signer` plugin option for providing a custom URL signer (@thibaudgg)
+
+* `derivatives` – Don't leak `versions_compatibility: true` setting into other uploaders (@janko)
+
+* `derivatives` – Add `:mutex` plugin option for skipping mutex and making attacher marshallable (@janko)
+
+* `remove_attachment` – Fix passing boolean values being broken in Ruby 3.2 (@janko)
+
+* `model` – When duplicating a record, make the duplicated attacher reference the duplicated record (@janko)
+
 ## 3.4.0 (2021-06-14)
 
 * `base` – Fix passing options to `Shrine.Attachment` on Ruby 3.0 (@lucianghinda)

data/README.md

@@ -20,20 +20,20 @@ guide]**.
 
 ## Links
 
-| Resource                | URL                                                                            |
-| :----------------       | :----------------------------------------------------------------------------- |
-| Website & Documentation | [shrinerb.com](https://shrinerb.com)                                           |
-| Demo code               | [Roda][roda demo] / [Rails][rails demo]                                        |
-| Wiki                    | [github.com/shrinerb/shrine/wiki](https://github.com/shrinerb/shrine/wiki)     |
-| Help & Discussion       | [discourse.shrinerb.com](https://discourse.shrinerb.com)                       |
+| Resource                   | URL                                                                                      |
+| :----------------          | :-----------------------------------------------------------------------------           |
+| Website & Documentation    | [shrinerb.com](https://shrinerb.com)                                                     |
+| Demo code                  | [Roda][roda demo] / [Rails][rails demo]                                                  |
+| Wiki                       | [github.com/shrinerb/shrine/wiki](https://github.com/shrinerb/shrine/wiki)               |
+| Discussion forum           | [github.com/shrinerb/shrine/discussions](https://github.com/shrinerb/shrine/discussions) |
+| Alternate Discussion forum | [discourse.shrinerb.com](https://discourse.shrinerb.com)                                 |
 
 ## Setup
 
-Add the gem to your Gemfile:
+Run:
 
-```rb
-# Gemfile
-gem "shrine", "~> 3.0"
+```sh
+bundle add shrine
 ```
 
 Then add `config/initializers/shrine.rb` which sets up the storage and loads
@@ -80,7 +80,7 @@ allow users to upload files:
 
 ```erb
 <%= form_for @photo do |f| %>
-  <%= f.hidden_field :image, value: @photo.cached_image_data %>
+  <%= f.hidden_field :image, value: @photo.cached_image_data, id: nil %>
   <%= f.file_field :image %>
   <%= f.submit %>
 <% end %>

data/doc/advantages.md

@@ -412,7 +412,7 @@ on top of Rack, so that they can be used with any Ruby web framework.
 [Sequel]: http://sequel.jeremyevans.net
 [ROM]: http://rom-rb.org
 [Hanami::Model]: https://github.com/hanami/model
-[plugin system]: https://twin.github.io/the-plugin-system-of-sequel-and-roda/
+[plugin system]: https://janko.io/the-plugin-system-of-sequel-and-roda/
 [Down]: https://github.com/janko/down
 [ContentDisposition]: https://github.com/shrinerb/content_disposition
 [`file`]: http://linux.die.net/man/1/file

data/doc/attacher.md

@@ -189,7 +189,7 @@ attacher.upload(file, location: "path/to/file")           # setting upload locat
 
 ### Changes
 
-When a new file is attached, calling [`Attacher#finalize`](#finalization) will
+When a new file is attached, calling [`Attacher#finalize`](#finalizing) will
 perform additional actions such as promotion and deleting any previous file.
 It will also trigger [validation].
 

data/doc/carrierwave.md

@@ -368,7 +368,7 @@ Now you should be able to rewrite your application so that it uses Shrine
 instead of CarrierWave (you can consult the reference in the next section). You
 can remove the `CarrierwaveShrineSynchronization` module as well.
 
-### 5. Backill metadata
+### 5. Backfill metadata
 
 You'll notice that Shrine metadata will be absent from the migrated files'
 data. You can run a script that will fill in any missing metadata defined in
@@ -646,7 +646,7 @@ Shrine.plugin :cached_attachment_data
 ```
 ```rb
 form_for @photo do |f|
-  f.hidden_field :image, value: @photo.cached_image_data
+  f.hidden_field :image, value: @photo.cached_image_data, id: nil
   f.file_field :image
 end
 ```

data/doc/changing_derivatives.md

@@ -36,7 +36,8 @@ derivatives generated). Let's assume you're generating image thumbnails:
 
 ```rb
 # Gemfile
-gem "image_processing", "~> 1.8"
+gem "image_processing", "~> 2.0"
+gem "mini_magick", "~> 5.0"
 ```
 ```rb
 require "image_processing/mini_magick"

data/doc/changing_location.md

@@ -3,7 +3,7 @@ id: changing-location
 title: Migrating File Locations
 ---
 
-This guide shows how to migrate the location of uploaded files on the same 
+This guide shows how to migrate the location of uploaded files on the same
 storage in production, with zero downtime.
 
 Let's assume we have a `Photo` model with an `image` file attachment:
@@ -31,20 +31,32 @@ to work with the previously stored urls because the files have not been migrated
 ```rb
 class ImageUploader < Shrine
   def generate_location(io, **options)
-    # change location generation
+    # change location generation, eg....
+    [
+      options[:record] && options[:record].class.name.underscore,
+      option[:record] && options[:record].id,
+      super
+    ].compact.join("/")
   end
 end
 ```
 
-We can now deploy this change to production so new file uploads will be stored in 
+We can now deploy this change to production so new file uploads will be stored in
 the new location.
 
+As seen above, we can call `super` to get the include the default location, which uses ruby
+`SecureRandom.hex` to have a unique immutable storage location. While it isn't
+strictly required to have a unique immutable storage location, it makes many
+things work smoother when different content will get a different storage location,
+and is recommended. One approach is using fixed directory/prefix as above.
+
+
 ## 2. Move existing files
 
 To move existing files to new location, run the following script. It fetches
 the photos in batches, downloads the image, and re-uploads it to the new location.
-We only need to migrate the files in `:store` storage need to be migrated as the files
-in `:cache` storage will be uploaded to the new location on promotion.
+Only the files in `:store` storage need to be migrated as the files in `:cache`
+storage will be uploaded to the new location on promotion.
 
 ```rb
 Photo.find_each do |photo|
@@ -99,11 +111,12 @@ class MoveFilesJob
 
     attacher     = attacher_class.retrieve(model: record, name: name, file: file_data)
     old_attacher = attacher.dup
+    current_file = old_attacher.file
 
     attacher.set             attacher.upload(attacher.file)
     attacher.set_derivatives attacher.upload_derivatives(attacher.derivatives)
 
-    attacher.atomic_persist
+    attacher.atomic_persist(current_file)
     old_attacher.destroy_attached
   rescue Shrine::AttachmentChanged, ActiveRecord::RecordNotFound
     attacher&.destroy_attached

data/doc/design.md

@@ -9,8 +9,8 @@ There are five main types of classes that you deal with in Shrine:
 
 | Class | Description |
 | :---- | :---------- |
-| [`Shrine::Storage::*`](#Storage) | Manages files on a particular storage service |
-| [`Shrine`](#Shrine) | Wraps uploads and handles loading plugins |
+| [`Shrine::Storage::*`](#storage) | Manages files on a particular storage service |
+| [`Shrine`](#shrine) | Wraps uploads and handles loading plugins |
 | [`Shrine::UploadedFile`](#shrineuploadedfile) | Represents a file uploaded to a storage |
 | [`Shrine::Attacher`](#shrineattacher) | Handles file attachment logic |
 | [`Shrine::Attachment`](#shrineattachment) | Provides convenience model attachment interface |
@@ -60,7 +60,7 @@ end
 ```
 
 Storages are typically not used directly, but through [`Shrine`](#shrine) and
-[`Shrine::UploadedFile`](#shrine-uploadedfile) classes.
+[`Shrine::UploadedFile`](#shrineuploadedfile) classes.
 
 ## `Shrine`
 
@@ -264,7 +264,7 @@ When a persistence plugin is loaded ([`activerecord`][activerecord],
 [Using Attacher]: https://shrinerb.com/docs/attacher
 [Notes on study of shrine implementation]: https://bibwild.wordpress.com/2018/09/12/notes-on-study-of-shrine-implementation/
 [Creating a New Plugin]: https://shrinerb.com/docs/creating-plugins
-[Plugin system of Sequel and Roda]: https://twin.github.io/the-plugin-system-of-sequel-and-roda/
+[Plugin system of Sequel and Roda]: https://janko.io/the-plugin-system-of-sequel-and-roda/
 [entity]: https://shrinerb.com/docs/plugins/entity
 [model]: https://shrinerb.com/docs/plugins/model
 [activerecord]: https://shrinerb.com/docs/plugins/activerecord

data/doc/external/articles.md

@@ -4,22 +4,22 @@ title: Articles
 
 ## Official articles
 
-| Article                                                                                                                      | Published             |
-| :-------                                                                                                                     | --------:             |
-| [Better File Uploads with Shrine: Eager Processing](https://twin.github.io/better-file-uploads-with-shrine-eager-processing) | 12 Dec 2019 |
-| [Shrine 3.0 Released](https://twin.github.io/shrine-3-0-released/)                                                           | 14 Oct 2019 |
-| [Upcoming Features in Shrine 3.0](https://twin.github.io/upcoming-features-in-shrine-3-0/)                                   | 29 Aug 2019 |
-| [Better File Uploads with Shrine: Direct Uploads](https://twin.github.io/better-file-uploads-with-shrine-direct-uploads/)    | 08 Jan 2018 |
-| [Better File Uploads with Shrine: Metadata](https://twin.github.io/better-file-uploads-with-shrine-metadata/)                | 07 Nov 2016 |
-| [Better File Uploads with Shrine: Processing](https://twin.github.io/better-file-uploads-with-shrine-processing/)            | 31 Oct 2016 |
-| [Better File Uploads with Shrine: Attachment](https://twin.github.io/better-file-uploads-with-shrine-attachment/)            | 17 Sep 2016 |
-| [Better File Uploads with Shrine: Uploader](https://twin.github.io/better-file-uploads-with-shrine-uploader/)                | 16 Sep 2016 |
-| [Better File Uploads with Shrine: Motivation](https://twin.github.io/better-file-uploads-with-shrine-motivation/)            | 11 Sep 2016 |
-| [Resumable File Uploads in Ruby](https://twin.github.io/resumable-file-uploads-in-ruby/)                                     | 04 Sep 2016 |
-| [Shrine meets Transloadit](https://twin.github.io/shrine-meets-transloadit/)                                                 | 11 Jul 2016 |
-| [Shrine 2.0 Released](https://twin.github.io/shrine-2-0-released/)                                                           | 20 May 2016 |
-| [Asynchronous File Uploads](http://twin.github.io/file-uploads-asynchronous-world)                                           | 18 Jan 2016 |
-| [Introducing Shrine](http://twin.github.io/introducing-shrine)                                                               | 04 Oct 2015 |
+| Article                                                                                                                 | Published             |
+| :-------                                                                                                                | --------:             |
+| [Better File Uploads with Shrine: Eager Processing](https://janko.io/better-file-uploads-with-shrine-eager-processing/) | 12 Dec 2019 |
+| [Shrine 3.0 Released](https://janko.io/shrine-3-0-released/)                                                            | 14 Oct 2019 |
+| [Upcoming Features in Shrine 3.0](https://janko.io/upcoming-features-in-shrine-3-0/)                                    | 29 Aug 2019 |
+| [Better File Uploads with Shrine: Direct Uploads](https://janko.io/better-file-uploads-with-shrine-direct-uploads/)     | 08 Jan 2018 |
+| [Better File Uploads with Shrine: Metadata](https://janko.io/better-file-uploads-with-shrine-metadata/)                 | 07 Nov 2016 |
+| [Better File Uploads with Shrine: Processing](https://janko.io/better-file-uploads-with-shrine-processing/)             | 31 Oct 2016 |
+| [Better File Uploads with Shrine: Attachment](https://janko.io/better-file-uploads-with-shrine-attachment/)             | 17 Sep 2016 |
+| [Better File Uploads with Shrine: Uploader](https://janko.io/better-file-uploads-with-shrine-uploader/)                 | 16 Sep 2016 |
+| [Better File Uploads with Shrine: Motivation](https://janko.io/better-file-uploads-with-shrine-motivation/)             | 11 Sep 2016 |
+| [Resumable File Uploads in Ruby](https://janko.io/resumable-file-uploads-in-ruby/)                                      | 04 Sep 2016 |
+| [Shrine meets Transloadit](https://janko.io/shrine-meets-transloadit/)                                                  | 11 Jul 2016 |
+| [Shrine 2.0 Released](https://janko.io/shrine-2-0-released/)                                                            | 20 May 2016 |
+| [Asynchronous File Uploads](http://janko.io/file-uploads-asynchronous-world)                                            | 18 Jan 2016 |
+| [Introducing Shrine](http://janko.io/introducing-shrine)                                                                | 04 Oct 2015 |
 
 ## Community articles
 

data/doc/external/extensions.md

@@ -35,7 +35,7 @@ title: Extensions
 | [shrine-content_addressable](https://github.com/SleeplessByte/shrine-content_addressable)   | Plugin for generating content addressable locations                   |
 | [shrine-imgix](https://github.com/shrinerb/shrine-imgix)                                    | Plugin for [Imgix](https://www.imgix.com/)                            |
 | [shrine-transloadit](https://github.com/shrinerb/shrine-transloadit)                        | Plugin for [Transloadit](https://transloadit.com/)                    |
-| [shrine-lambda](https://github.com/texpert/shrine-lambda)                                   | Plugin for [AWS Lambda](https://aws.amazon.com/lambda/)               |
+| [shrine-aws-lambda](https://github.com/texpert/shrine-aws-lambda)                           | Plugin for [AWS Lambda](https://aws.amazon.com/lambda/)               |
 | [hanami-shrine](https://github.com/katafrakt/hanami-shrine)                                 | Plugin for [Hanami](https://hanamirb.org/)                            |
 | [shrine-mongoid](https://github.com/shrinerb/shrine-mongoid)                                | Plugin for [Mongoid](https://mongoid.org)                             |
 | [shrine-rails](https://github.com/abepetrillo/shrine-rails)                                 | Plugin for [Rails](https://rubyonrails.org/)                          |

data/doc/getting_started.md

@@ -3,6 +3,9 @@ id: getting-started
 title: Getting Started
 ---
 
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
 ## Quick start
 
 Add Shrine to the Gemfile and write an initializer which sets up the storage
@@ -32,32 +35,39 @@ Next decide how you will name the attachment attribute on your model, and run a
 migration that adds an `<attachment>_data` text or JSON column, which Shrine
 will use to store all information about the attachment:
 
-<!--DOCUSAURUS_CODE_TABS-->
-<!--Sequel-->
+<Tabs>
+<TabItem value="sequel" label="Sequel">
+
 ```rb
 Sequel.migration do
   change do
-    add_column :photos, :image_data, :text # or :jsonb   
+    add_column :photos, :image_data, :text # or :jsonb
   end
 end
 ```
 
-<!--ActiveRecord-->
+</TabItem>
+<TabItem value="activerecord" label="Active Record">
+
 ```rb
 class AddImageDataToPhotos < ActiveRecord::Migration
   def change
-    add_column :photos, :image_data, :text # or :jsonb   
+    add_column :photos, :image_data, :text # or :jsonb
   end
 end
 ```
 
-<!--Rails-->
+</TabItem>
+<TabItem value="rails" label="Rails">
+
 ```rb
-$ rails generate migration add_image_data_to_photos image_data:text  # or image_data:jsonb 
+$ rails generate migration add_image_data_to_photos image_data:text # or image_data:jsonb
 ```
-If using `jsonb` consider adding a [gin index] for fast key-value pair searchability within `image_data`.
 
-<!--END_DOCUSAURUS_CODE_TABS-->
+</TabItem>
+</Tabs>
+
+If using `jsonb` consider adding a [gin index] for fast key-value pair searchability within `image_data`.
 
 Now you can create an uploader class for the type of files you want to upload,
 and add a virtual attribute for handling attachments using this uploader to
@@ -69,36 +79,47 @@ class ImageUploader < Shrine
   # plugins and uploading logic
 end
 ```
-<!--DOCUSAURUS_CODE_TABS-->
-<!--Sequel-->
+
+<Tabs>
+<TabItem value="sequel" label="Sequel">
+
 ```rb
 class Photo < Sequel::Model
   include ImageUploader::Attachment(:image) # adds an `image` virtual attribute
 end
 ```
-<!--ActiveRecord-->
+
+</TabItem>
+<TabItem value="activerecord" label="Active Record">
+
 ```rb
 class Photo < ActiveRecord::Base
   include ImageUploader::Attachment(:image) # adds an `image` virtual attribute
 end
 ```
-<!--END_DOCUSAURUS_CODE_TABS-->
+
+</TabItem>
+</Tabs>
 
 Let's now add the form fields which will use this virtual attribute (NOT the
 `<attachment>_data` column attribute). We need (1) a file field for choosing
 files, and (2) a hidden field for retaining the uploaded file in case of
 validation errors and for potential [direct uploads].
 
-<!--DOCUSAURUS_CODE_TABS-->
-<!--Rails form builder-->
+<Tabs>
+<TabItem value="rails" label="Rails form builder">
+
 ```rb
 form_for @photo do |f|
-  f.hidden_field :image, value: @photo.cached_image_data
+  f.hidden_field :image, value: @photo.cached_image_data, id: nil
   f.file_field :image
   f.submit
 end
 ```
-<!--Simple Form-->
+
+</TabItem>
+<TabItem value="simple_form" label="Simple Form">
+
 ```rb
 simple_form_for @photo do |f|
   f.input :image, as: :hidden, input_html: { value: @photo.cached_image_data }
@@ -106,7 +127,10 @@ simple_form_for @photo do |f|
   f.button :submit
 end
 ```
-<!--Forme-->
+
+</TabItem>
+<TabItem value="form" label="Forme">
+
 ```rb
 form @photo, action: "/photos", enctype: "multipart/form-data" do |f|
   f.input :image, type: :hidden, value: @photo.cached_image_data
@@ -114,7 +138,10 @@ form @photo, action: "/photos", enctype: "multipart/form-data" do |f|
   f.button "Create"
 end
 ```
-<!--HTML-->
+
+</TabItem>
+<TabItem value="html" label="HTML">
+
 ```erb
 <form action="/photos" method="post" enctype="multipart/form-data">
   <input name="photo[image]" type="hidden" value="<%= @photo.cached_image_data %>" />
@@ -122,7 +149,9 @@ end
   <input type="submit" value="Create" />
 </form>
 ```
-<!--END_DOCUSAURUS_CODE_TABS-->
+
+</TabItem>
+</Tabs>
 
 Note that the file field needs to go *after* the hidden field, so that
 selecting a new file can always override the cached file in the hidden field.
@@ -133,8 +162,9 @@ will automatically generate this for you).
 When the form is submitted, in your router/controller you can assign the file
 from request params to the attachment attribute on the model.
 
-<!--DOCUSAURUS_CODE_TABS-->
-<!--Rails-->
+<Tabs>
+<TabItem value="rails" label="Rails">
+
 ```rb
 class PhotosController < ApplicationController
   def create
@@ -149,28 +179,39 @@ class PhotosController < ApplicationController
   end
 end
 ```
-<!--Sinatra-->
+
+</TabItem>
+<TabItem value="sinatra" label="Sinatra">
+
 ```rb
 post "/photos" do
   Photo.create(params[:photo])
   # ...
 end
 ```
-<!--END_DOCUSAURUS_CODE_TABS-->
+
+</TabItem>
+</Tabs>
 
 Once a file is uploaded and attached to the record, you can retrieve a URL to
 the uploaded file with `#<attachment>_url` and display it on the page:
 
-<!--DOCUSAURUS_CODE_TABS-->
-<!--Rails-->
+<Tabs>
+<TabItem value="rails" label="Rails">
+
 ```erb
 <%= image_tag @photo.image_url %>
 ```
-<!--HTML-->
+
+</TabItem>
+<TabItem value="html" label="HTML">
+
 ```erb
 <img src="<%= @photo.image_url %>" />
 ```
-<!--END_DOCUSAURUS_CODE_TABS-->
+
+</TabItem>
+</Tabs>
 
 ## Storage
 
@@ -561,7 +602,8 @@ creation:
 
 ```rb
 # Gemfile
-gem "image_processing", "~> 1.8"
+gem "image_processing", "~> 2.0"
+gem "mini_magick", "~> 5.0"
 ```
 ```rb
 Shrine.plugin :derivatives, create_on_promote: true
@@ -615,7 +657,8 @@ processing we want to perform:
 
 ```rb
 # Gemfile
-gem "image_processing", "~> 1.8"
+gem "image_processing", "~> 2.0"
+gem "mini_magick", "~> 5.0"
 ```
 ```rb
 # config/initializers/rails.rb (Rails)