activestorage 6.1.5 → 7.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b2462e448311467354ce83df7050f5d221d7403bb790759217200fd759f5f9b
-  data.tar.gz: 98445c8675caf09e3b557c41a2b7007243fa959e5226ef5f7ea8135e0202d13e
+  metadata.gz: cb27c3976b612802226ea7343ba6bd9483eb635f1785a0255d8048f936c77fc0
+  data.tar.gz: f4bea0eb4dad8afe87aa78185cb3a9eaa92e7c4eb4bd50a28f5505dba4574a6a
 SHA512:
-  metadata.gz: 6ab412d9d5860b0c5779ac817942500d03977321ec127314c466118b8409605b8a2090b23417809522de227e10469e6026ced9745775954d3da0c3ff4604c91a
-  data.tar.gz: d93756508b38ba7ec8189461698973eb01c033281477934dfe321f7c3ec270aa5ad52744bb7ee7a202de1f4cf1472995a3ba8ec0ec508616b093c963d68e892e
+  metadata.gz: 24ef173da37fd9a08160b3ca83e78633a2f54699c6043ac7c21bf111226c1d94e6f7971acb3c2be035320cbfd6dfae9dd91c85abaaf0f97c922c33e1f5b26043
+  data.tar.gz: 640a260bf6d6bc690491fe365e810117232c3be9c96112ddc9a5d8e68d8d8f680930f3ae065fcaedadb43490de63a3226e8f5cbde1279419d9f23a019e692b7f

data/CHANGELOG.md

@@ -1,13 +1,21 @@
-## Rails 6.1.5 (March 09, 2022) ##
+## Rails 7.0.3 (May 09, 2022) ##
 
-*   Attachments can be deleted after their association is no longer defined.
+*   Don't stream responses in redirect mode
 
-    Fixes #42514
+    Previously, both redirect mode and proxy mode streamed their
+    responses which caused a new thread to be created, and could end
+    up leaking connections in the connection pool. But since redirect
+    mode doesn't actually send any data, it doesn't need to be
+    streamed.
 
-    *Don Sisco*
+    *Luke Lau*
+
+## Rails 7.0.2.4 (April 26, 2022) ##
+
+*   No changes.
 
 
-## Rails 6.1.4.7 (March 08, 2022) ##
+## Rails 7.0.2.3 (March 08, 2022) ##
 
 *   Added image transformation validation via configurable allow-list.
     
@@ -17,339 +25,304 @@
     [CVE-2022-21831]
 
 
-## Rails 6.1.4.6 (February 11, 2022) ##
+## Rails 7.0.2.2 (February 11, 2022) ##
 
 *   No changes.
 
-
-## Rails 6.1.4.5 (February 11, 2022) ##
+## Rails 7.0.2.1 (February 11, 2022) ##
 
 *   No changes.
 
 
-## Rails 6.1.4.4 (December 15, 2021) ##
-
-*   No changes.
+## Rails 7.0.2 (February 08, 2022) ##
 
+*   Revert the ability to pass `service_name` param to `DirectUploadsController` which was introduced
+    in 7.0.0.
 
-## Rails 6.1.4.3 (December 14, 2021) ##
-
-*   No changes.
+    That change caused a lot of problems to upgrade Rails applications so we decided to remove it
+    while in work in a more backwards compatible implementation.
 
+    *Gannon McGibbon*
 
-## Rails 6.1.4.2 (December 14, 2021) ##
+*   Allow applications to opt out of precompiling Active Storage JavaScript assets.
 
-*   No changes.
+    *jlestavel*
 
 
-## Rails 6.1.4.1 (August 19, 2021) ##
+## Rails 7.0.1 (January 06, 2022) ##
 
 *   No changes.
 
 
-## Rails 6.1.4 (June 24, 2021) ##
-
-*   The parameters sent to `ffmpeg` for generating a video preview image are now
-    configurable under `config.active_storage.video_preview_arguments`.
+## Rails 7.0.0 (December 15, 2021) ##
 
-    *Brendon Muir*
+*   Support transforming empty-ish `has_many_attached` value into `[]` (e.g. `[""]`).
 
-*   Fix Active Storage update task when running in an engine.
-
-    *Justin Malčić*
-
-*   Don't raise an error if the mime type is not recognized.
-
-    Fixes #41777.
-
-    *Alex Ghiculescu*
-
-*   `ActiveStorage::PreviewError` is raised when a previewer is unable to generate a preview image.
-
-    *Alex Robbin*
-
-*   respond with 404 given invalid variation key when asking for representations.
-
-    *George Claghorn*
-
-*   `Blob` creation shouldn't crash if no service selected.
-
-    *Alex Ghiculescu*
-
-
-## Rails 6.1.3.2 (May 05, 2021) ##
-
-*   No changes.
-
-
-## Rails 6.1.3.1 (March 26, 2021) ##
-
-*  Marcel is upgraded to version 1.0.0 to avoid a dependency on GPL-licensed
-   mime types data.
+    ```ruby
+    @user.highlights = [""]
+    @user.highlights # => []
+    ```
 
-   *George Claghorn*
+    *Sean Doyle*
 
 
-## Rails 6.1.3 (February 17, 2021) ##
+## Rails 7.0.0.rc3 (December 14, 2021) ##
 
 *   No changes.
 
 
-## Rails 6.1.2.1 (February 10, 2021) ##
+## Rails 7.0.0.rc2 (December 14, 2021) ##
 
 *   No changes.
 
+## Rails 7.0.0.rc1 (December 06, 2021) ##
 
-## Rails 6.1.2 (February 09, 2021) ##
+*   `Add ActiveStorage::Blob.compose` to concatenate multiple blobs.
 
-*   No changes.
+    *Gannon McGibbon*
 
+*   Setting custom metadata on blobs are now persisted to remote storage.
 
-## Rails 6.1.1 (January 07, 2021) ##
+    *joshuamsager*
 
-*   Fix S3 multipart uploads when threshold is larger than file.
+*   Support direct uploads to multiple services.
 
-    *Matt Muller*
+    *Dmitry Tsepelev*
 
+*   Invalid default content types are deprecated
 
-## Rails 6.1.0 (December 09, 2020) ##
+    Blobs created with content_type `image/jpg`, `image/pjpeg`, `image/bmp`, `text/javascript` will now produce
+    a deprecation warning, since these are not valid content types.
 
-*   Change default queue name of the analysis (`:active_storage_analysis`) and
-    purge (`:active_storage_purge`) jobs to be the job adapter's default (`:default`).
+    These content types will be removed from the defaults in Rails 7.1.
 
-    *Rafael Mendonça França*
+    You can set `config.active_storage.silence_invalid_content_types_warning = true` to dismiss the warning.
 
-*   Implement `strict_loading` on ActiveStorage associations.
+    *Alex Ghiculescu*
 
-    *David Angulo*
+## Rails 7.0.0.alpha2 (September 15, 2021) ##
 
-*   Remove deprecated support to pass `:combine_options` operations to `ActiveStorage::Transformers::ImageProcessing`.
+*   No changes.
 
-    *Rafael Mendonça França*
 
-*   Remove deprecated `ActiveStorage::Transformers::MiniMagickTransformer`.
+## Rails 7.0.0.alpha1 (September 15, 2021) ##
 
-    *Rafael Mendonça França*
+*   Emit Active Support instrumentation events from Active Storage analyzers.
 
-*   Remove deprecated `config.active_storage.queue`.
+    Fixes #42930
 
-    *Rafael Mendonça França*
+    *Shouichi Kamiya*
 
-*   Remove deprecated `ActiveStorage::Downloading`.
+*   Add support for byte range requests
 
-    *Rafael Mendonça França*
+    *Tom Prats*
 
-*   Add per-environment configuration support
+*   Attachments can be deleted after their association is no longer defined.
 
-    *Pietro Moro*
+    Fixes #42514
 
-*   The Poppler PDF previewer renders a preview image using the original
-    document's crop box rather than its media box, hiding print margins. This
-    matches the behavior of the MuPDF previewer.
+    *Don Sisco*
 
-    *Vincent Robert*
+*   Make `vips` the default variant processor for new apps.
 
-*   Touch parent model when an attachment is purged.
+    See the upgrade guide for instructions on converting from `mini_magick` to `vips`. `mini_magick` is
+    not deprecated, existing apps can keep using it.
 
-    *Víctor Pérez Rodríguez*
+    *Breno Gazzola*
 
-*   Files can now be served by proxying them from the underlying storage service
-    instead of redirecting to a signed service URL. Use the
-    `rails_storage_proxy_path` and `_url` helpers to proxy an attached file:
+*   Deprecate `ActiveStorage::Current.host` in favor of `ActiveStorage::Current.url_options` which accepts
+    a host, protocol and port.
 
-    ```erb
-    <%= image_tag rails_storage_proxy_path(@user.avatar) %>
-    ```
+    *Santiago Bartesaghi*
 
-    To proxy by default, set `config.active_storage.resolve_model_to_route`:
+*   Allow using [IAM](https://cloud.google.com/storage/docs/access-control/signed-urls) when signing URLs with GCS.
 
-    ```ruby
-    # Proxy attached files instead.
-    config.active_storage.resolve_model_to_route = :rails_storage_proxy
+    ```yaml
+    gcs:
+      service: GCS
+      ...
+      iam: true
     ```
 
-    ```erb
-    <%= image_tag @user.avatar %>
-    ```
+    *RRethy*
 
-    To redirect to a signed service URL when the default file serving strategy
-    is set to proxying, use the `rails_storage_redirect_path` and `_url` helpers:
+*   OpenSSL constants are now used for Digest computations.
 
-    ```erb
-    <%= image_tag rails_storage_redirect_path(@user.avatar) %>
-    ```
+    *Dirkjan Bussink*
 
-    *Jonathan Fleckenstein*
+*   Deprecate `config.active_storage.replace_on_assign_to_many`. Future versions of Rails
+    will behave the same way as when the config is set to `true`.
 
-*   Add `config.active_storage.web_image_content_types` to allow applications
-    to add content types (like `image/webp`) in which variants can be processed,
-    instead of letting those images be converted to the fallback PNG format.
+    *Santiago Bartesaghi*
 
-    *Jeroen van Haperen*
+*   Remove deprecated methods: `build_after_upload`, `create_after_upload!` in favor of `create_and_upload!`,
+    and `service_url` in favor of `url`.
 
-*   Add support for creating variants of `WebP` images out of the box.
+    *Santiago Bartesaghi*
 
-    *Dino Maric*
+*   Add support of `strict_loading_by_default` to `ActiveStorage::Representations` controllers.
 
-*   Only enqueue analysis jobs for blobs with non-null analyzer classes.
+    *Anton Topchii*, *Andrew White*
 
-    *Gannon McGibbon*
+*   Allow to detach an attachment when record is not persisted.
 
-*   Previews are created on the same service as the original blob.
+    *Jacopo Beschi*
 
-    *Peter Zhu*
+*   Use libvips instead of ImageMagick to analyze images when `active_storage.variant_processor = vips`.
 
-*   Remove unused `disposition` and `content_type` query parameters for `DiskService`.
+    *Breno Gazzola*
 
-    *Peter Zhu*
+*   Add metadata value for presence of video channel in video blobs.
 
-*   Use `DiskController` for both public and private files.
+    The `metadata` attribute of video blobs has a new boolean key named `video` that is set to
+    `true` if the file has an video channel and `false` if it doesn't.
 
-    `DiskController` is able to handle multiple services by adding a
-    `service_name` field in the generated URL in `DiskService`.
+    *Breno Gazzola*
 
-    *Peter Zhu*
+*   Deprecate usage of `purge` and `purge_later` from the association extension.
 
-*   Variants are tracked in the database to avoid existence checks in the storage service.
+    *Jacopo Beschi*
 
-    *George Claghorn*
+*   Passing extra parameters in `ActiveStorage::Blob#url` to S3 Client.
 
-*   Deprecate `service_url` methods in favour of `url`.
+    This allows calls of `ActiveStorage::Blob#url` to have more interaction with
+    the S3 Presigner, enabling, amongst other options, custom S3 domain URL
+    Generation.
 
-    Deprecate `Variant#service_url` and `Preview#service_url` to instead use
-    `#url` method to be consistent with `Blob`.
+    ```ruby
+    blob = ActiveStorage::Blob.last
 
-    *Peter Zhu*
+    blob.url # => https://<bucket-name>.s3.<region>.amazonaws.com/<key>
+    blob.url(virtual_host: true) # => # => https://<bucket-name>/<key>
+    ```
 
-*   Permanent URLs for public storage blobs.
+    *josegomezr*
 
-    Services can be configured in `config/storage.yml` with a new key
-    `public: true | false` to indicate whether a service holds public
-    blobs or private blobs. Public services will always return a permanent URL.
+*   Allow setting a `Cache-Control` on files uploaded to GCS.
 
-    Deprecates `Blob#service_url` in favor of `Blob#url`.
+    ```yaml
+    gcs:
+      service: GCS
+      ...
+      cache_control: "public, max-age=3600"
+    ```
 
-    *Peter Zhu*
+    *maleblond*
 
-*   Make services aware of configuration names.
+*   The parameters sent to `ffmpeg` for generating a video preview image are now
+    configurable under `config.active_storage.video_preview_arguments`.
 
-    *Gannon McGibbon*
+    *Brendon Muir*
 
-*   The `Content-Type` header is set on image variants when they're uploaded to third-party storage services.
+*   The ActiveStorage video previewer will now use scene change detection to generate
+    better preview images (rather than the previous default of using the first frame
+    of the video). This change requires FFmpeg v3.4+.
 
-    *Kyle Ribordy*
+    *Jonathan Hefner*
 
-*   Allow storage services to be configured per attachment.
+*   Add support for ActiveStorage expiring URLs.
 
     ```ruby
-    class User < ActiveRecord::Base
-      has_one_attached :avatar, service: :s3
-    end
+    rails_blob_path(user.avatar, disposition: "attachment", expires_in: 30.minutes)
 
-    class Gallery < ActiveRecord::Base
-      has_many_attached :photos, service: :s3
-    end
+    <%= image_tag rails_blob_path(user.avatar.variant(resize: "100x100"), expires_in: 30.minutes) %>
     ```
 
-    *Dmitry Tsepelev*
+    If you want to set default expiration time for ActiveStorage URLs throughout your application, set `config.active_storage.urls_expire_in`.
 
-*   You can optionally provide a custom blob key when attaching a new file:
+    *aki77*
 
-    ```ruby
-    user.avatar.attach key: "avatars/#{user.id}.jpg",
-      io: io, content_type: "image/jpeg", filename: "avatar.jpg"
-    ```
+*   Allow to purge an attachment when record is not persisted for `has_many_attached`.
 
-    Active Storage will store the blob's data on the configured service at the provided key.
+    *Jacopo Beschi*
 
-    *George Claghorn*
+*   Add `with_all_variant_records` method to eager load all variant records on an attachment at once.
+    `with_attached_image` scope now eager loads variant records if using variant tracking.
 
-*   Replace `Blob.create_after_upload!` with `Blob.create_and_upload!` and deprecate the former.
+    *Alex Ghiculescu*
 
-    `create_after_upload!` has been removed since it could lead to data
-    corruption by uploading to a key on the storage service which happened to
-    be already taken. Creating the record would then correctly raise a
-    database uniqueness exception but the stored object would already have
-    overwritten another. `create_and_upload!` swaps the order of operations
-    so that the key gets reserved up-front or the uniqueness error gets raised,
-    before the upload to a key takes place.
+*   Add metadata value for presence of audio channel in video blobs.
 
-    *Julik Tarkhanov*
+    The `metadata` attribute of video blobs has a new boolean key named `audio` that is set to
+    `true` if the file has an audio channel and `false` if it doesn't.
 
-*   Set content disposition in direct upload using `filename` and `disposition` parameters to `ActiveStorage::Service#headers_for_direct_upload`.
+    *Breno Gazzola*
 
-    *Peter Zhu*
+*   Adds analyzer for audio files.
 
-*   Allow record to be optionally passed to blob finders to make sharding
-    easier.
+    *Breno Gazzola*
 
-    *Gannon McGibbon*
+*   Respect Active Record's primary_key_type in Active Storage migrations.
 
-*   Switch from `azure-storage` gem to `azure-storage-blob` gem for Azure service.
+    *fatkodima*
 
-    *Peter Zhu*
+*   Allow `expires_in` for ActiveStorage signed ids.
 
-*   Add `config.active_storage.draw_routes` to disable Active Storage routes.
+    *aki77*
 
-    *Gannon McGibbon*
+*   Allow to purge an attachment when record is not persisted for `has_one_attached`.
 
-*   Image analysis is skipped if ImageMagick returns an error.
+    *Jacopo Beschi*
 
-    `ActiveStorage::Analyzer::ImageAnalyzer#metadata` would previously raise a
-    `MiniMagick::Error`, which caused persistent `ActiveStorage::AnalyzeJob`
-    failures. It now logs the error and returns `{}`, resulting in no metadata
-    being added to the offending image blob.
+*   Add a load hook called `active_storage_variant_record` (providing `ActiveStorage::VariantRecord`)
+    to allow for overriding aspects of the `ActiveStorage::VariantRecord` class. This makes
+    `ActiveStorage::VariantRecord` consistent with `ActiveStorage::Blob` and `ActiveStorage::Attachment`
+    that already have load hooks.
 
-    *George Claghorn*
+    *Brendon Muir*
 
-*   Method calls on singular attachments return `nil` when no file is attached.
+*   `ActiveStorage::PreviewError` is raised when a previewer is unable to generate a preview image.
 
-    Previously, assuming the following User model, `user.avatar.filename` would
-    raise a `Module::DelegationError` if no avatar was attached:
+    *Alex Robbin*
+
+*   Add `ActiveStorage::Streaming` module that can be included in a controller to get access to `#send_blob_stream`,
+    which wraps the new `ActionController::Base#send_stream` method to stream a blob from cloud storage:
 
     ```ruby
-    class User < ApplicationRecord
-      has_one_attached :avatar
+    class MyPublicBlobsController < ApplicationController
+      include ActiveStorage::SetBlob, ActiveStorage::Streaming
+
+      def show
+        http_cache_forever(public: true) do
+          send_blob_stream @blob, disposition: params[:disposition]
+        end
+      end
     end
     ```
 
-    They now return `nil`.
-
-    *Matthew Tanous*
+    *DHH*
 
-*   The mirror service supports direct uploads.
+*   Add ability to use pre-defined variants.
 
-    New files are directly uploaded to the primary service. When a
-    directly-uploaded file is attached to a record, a background job is enqueued
-    to copy it to each secondary service.
+    ```ruby
+    class User < ActiveRecord::Base
+      has_one_attached :avatar do |attachable|
+        attachable.variant :thumb, resize: "100x100"
+        attachable.variant :medium, resize: "300x300", monochrome: true
+      end
+    end
 
-    Configure the queue used to process mirroring jobs by setting
-    `config.active_storage.queues.mirror`. The default is `:active_storage_mirror`.
+    class Gallery < ActiveRecord::Base
+      has_many_attached :photos do |attachable|
+        attachable.variant :thumb, resize: "100x100"
+        attachable.variant :medium, resize: "300x300", monochrome: true
+      end
+    end
 
-    *George Claghorn*
+    <%= image_tag user.avatar.variant(:thumb) %>
+    ```
 
-*   The S3 service now permits uploading files larger than 5 gigabytes.
+    *fatkodima*
 
-    When uploading a file greater than 100 megabytes in size, the service
-    transparently switches to [multipart uploads](https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html)
-    using a part size computed from the file's total size and S3's part count limit.
+*   After setting `config.active_storage.resolve_model_to_route = :rails_storage_proxy`
+    `rails_blob_path` and `rails_representation_path` will generate proxy URLs by default.
 
-    No application changes are necessary to take advantage of this feature. You
-    can customize the default 100 MB multipart upload threshold in your S3
-    service's configuration:
+    *Ali Ismayilov*
 
-    ```yaml
-    production:
-      service: s3
-      access_key_id: <%= Rails.application.credentials.dig(:aws, :access_key_id) %>
-      secret_access_key: <%= Rails.application.credentials.dig(:aws, :secret_access_key) %>
-      region: us-east-1
-      bucket: my-bucket
-      upload:
-        multipart_threshold: <%= 250.megabytes %>
-    ```
+*   Declare `ActiveStorage::FixtureSet` and `ActiveStorage::FixtureSet.blob` to
+    improve fixture integration.
 
-    *George Claghorn*
+    *Sean Doyle*
 
 
-Please check [6-0-stable](https://github.com/rails/rails/blob/6-0-stable/activestorage/CHANGELOG.md) for previous changes.
+Please check [6-1-stable](https://github.com/rails/rails/blob/6-1-stable/activestorage/CHANGELOG.md) for previous changes.

data/README.md

@@ -32,7 +32,7 @@ class User < ApplicationRecord
 end
 
 # Attach an avatar to the user.
-user.avatar.attach(io: File.open("/path/to/face.jpg"), filename: "face.jpg", content_type: "image/jpg")
+user.avatar.attach(io: File.open("/path/to/face.jpg"), filename: "face.jpg", content_type: "image/jpeg")
 
 # Does the user have an avatar?
 user.avatar.attached? # => true
@@ -88,8 +88,7 @@ class MessagesController < ApplicationController
   end
 
   def create
-    message = Message.create! params.require(:message).permit(:title, :content)
-    message.images.attach(params[:message][:images])
+    message = Message.create! params.require(:message).permit(:title, :content, images: [])
     redirect_to message
   end
 
@@ -124,27 +123,42 @@ When the application is configured to proxy files by default, use the `rails_sto
 
 Optionally, files can be proxied instead. This means that your application servers will download file data from the storage service in response to requests. This can be useful for serving files from a CDN.
 
-Explicitly proxy attachments using the `rails_storage_proxy_path` and `_url` route helpers:
-
-```erb
-<%= image_tag rails_storage_proxy_path(@user.avatar) %>
-```
-
-Or configure Active Storage to use proxying by default:
+You can configure Active Storage to use proxying by default:
 
 ```ruby
 # config/initializers/active_storage.rb
 Rails.application.config.active_storage.resolve_model_to_route = :rails_storage_proxy
 ```
 
+Or if you want to explicitly proxy specific attachments there are URL helpers you can use in the form of `rails_storage_proxy_path` and `rails_storage_proxy_url`.
+
+```erb
+<%= image_tag rails_storage_proxy_path(@user.avatar) %>
+```
+
 ## Direct uploads
 
 Active Storage, with its included JavaScript library, supports uploading directly from the client to the cloud.
 
 ### Direct upload installation
 
-1. Include `activestorage.js` in your application's JavaScript bundle.
+1. Include the Active Storage JavaScript in your application's JavaScript bundle or reference it directly.
 
+    Requiring directly without bundling through the asset pipeline in the application html with autostart:
+    ```html
+    <%= javascript_include_tag "activestorage" %>
+    ```
+    Requiring via importmap-rails without bundling through the asset pipeline in the application html without autostart as ESM:
+    ```ruby
+    # config/importmap.rb
+    pin "@rails/activestorage", to: "activestorage.esm.js"
+    ```
+    ```html
+    <script type="module-shim">
+      import * as ActiveStorage from "@rails/activestorage"
+      ActiveStorage.start()
+    </script>
+    ```
     Using the asset pipeline:
     ```js
     //= require activestorage