activestorage 6.1.4 → 7.0.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef0dd54811cf8da51cb50eca56d076d8749b980ae3db31226b265a151192328d
-  data.tar.gz: c22c17de56c93fd065162900525f3a5f52704c32ed74b7b457347dee1aff2673
+  metadata.gz: f08091492d077c28be3b94de7fb3e4f02b6cd95c8c1d9bb987d620e2839e1208
+  data.tar.gz: 4fe88a44de6de535c2167bf10917b08111eb77ea4afc40cbce753f19482d9292
 SHA512:
-  metadata.gz: '0792f0c459775a2a6356e5e41bb0bfc310b1cd3c0200f05fde47de567fab433d7ee7d5ccee87644c6bf2d3413605fc31d43e66894af55f0c93a7b05aa0872ec2'
-  data.tar.gz: 48d843ff08c3eaf85f69dbe9d4938d7f9413cc98800af3e2bc96de66f661542aa275cda824e88394b7e49755a65a7fc79697550e619da5db7b336f011a2a31be
+  metadata.gz: e5558429f5f6e1d268ca1adc7cf553bbd1cb211aa6f3cb3a5d306c14b55256e95d88f012386a6e1597c2a79a9679687c2ef86bd6caf1bf3b8bf95dd8f85b25c3
+  data.tar.gz: ec71d2715da6cc32f7f40f231c6e482f5d3984bb97d90bcb3634e65589e0430b5383452c7a71ddb551b0ee652116168b49c3a38bd3bdc3d8b87620aa408f6910

data/CHANGELOG.md

@@ -1,306 +1,249 @@
-## Rails 6.1.4 (June 24, 2021) ##
+*   `Add ActiveStorage::Blob.compose` to concatenate multiple blobs.
 
-*   The parameters sent to `ffmpeg` for generating a video preview image are now
-    configurable under `config.active_storage.video_preview_arguments`.
-
-    *Brendon Muir*
-
-*   Fix Active Storage update task when running in an engine.
-
-    Justin Malčić*
+    *Gannon McGibbon*
 
-*   Don't raise an error if the mime type is not recognized.
+*   Setting custom metadata on blobs are now persisted to remote storage.
 
-    Fixes #41777.
+    *joshuamsager*
 
-    *Alex Ghiculescu*
+*   Support direct uploads to multiple services.
 
-*   `ActiveStorage::PreviewError` is raised when a previewer is unable to generate a preview image.
+    *Dmitry Tsepelev*
 
-    *Alex Robbin*
+*   Invalid default content types are deprecated
 
-*   respond with 404 given invalid variation key when asking for representations.
+    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.
 
-    *George Claghorn*
+    These content types will be removed from the defaults in Rails 7.1.
 
-*   `Blob` creation shouldn't crash if no service selected.
+    You can set `config.active_storage.silence_invalid_content_types_warning = true` to dismiss the warning.
 
     *Alex Ghiculescu*
 
-
-## Rails 6.1.3.2 (May 05, 2021) ##
+## Rails 7.0.0.alpha2 (September 15, 2021) ##
 
 *   No changes.
 
 
-## Rails 6.1.3.1 (March 26, 2021) ##
+## Rails 7.0.0.alpha1 (September 15, 2021) ##
 
-*  Marcel is upgraded to version 1.0.0 to avoid a dependency on GPL-licensed
-   mime types data.
+*   Emit Active Support instrumentation events from Active Storage analyzers.
 
-   *George Claghorn*
+    Fixes #42930
 
+    *Shouichi Kamiya*
 
-## Rails 6.1.3 (February 17, 2021) ##
+*   Add support for byte range requests
 
-*   No changes.
+    *Tom Prats*
 
+*   Attachments can be deleted after their association is no longer defined.
 
-## Rails 6.1.2.1 (February 10, 2021) ##
+    Fixes #42514
 
-*   No changes.
+    *Don Sisco*
 
+*   Make `vips` the default variant processor for new apps.
 
-## Rails 6.1.2 (February 09, 2021) ##
+    See the upgrade guide for instructions on converting from `mini_magick` to `vips`. `mini_magick` is
+    not deprecated, existing apps can keep using it.
 
-*   No changes.
+    *Breno Gazzola*
 
+*   Deprecate `ActiveStorage::Current.host` in favor of `ActiveStorage::Current.url_options` which accepts
+    a host, protocol and port.
 
-## Rails 6.1.1 (January 07, 2021) ##
+    *Santiago Bartesaghi*
 
-*   Fix S3 multipart uploads when threshold is larger than file.
+*   Allow using [IAM](https://cloud.google.com/storage/docs/access-control/signed-urls) when signing URLs with GCS.
 
-    *Matt Muller*
+    ```yaml
+    gcs:
+      service: GCS
+      ...
+      iam: true
+    ```
 
+    *RRethy*
 
-## Rails 6.1.0 (December 09, 2020) ##
+*   OpenSSL constants are now used for Digest computations.
 
-*   Change default queue name of the analysis (`:active_storage_analysis`) and
-    purge (`:active_storage_purge`) jobs to be the job adapter's default (`:default`).
+    *Dirkjan Bussink*
 
-    *Rafael Mendonça França*
+*   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`.
 
-*   Implement `strict_loading` on ActiveStorage associations.
+    *Santiago Bartesaghi*
 
-    *David Angulo*
+*   Remove deprecated methods: `build_after_upload`, `create_after_upload!` in favor of `create_and_upload!`,
+    and `service_url` in favor of `url`.
 
-*   Remove deprecated support to pass `:combine_options` operations to `ActiveStorage::Transformers::ImageProcessing`.
+    *Santiago Bartesaghi*
 
-    *Rafael Mendonça França*
+*   Add support of `strict_loading_by_default` to `ActiveStorage::Representations` controllers.
 
-*   Remove deprecated `ActiveStorage::Transformers::MiniMagickTransformer`.
+    *Anton Topchii*, *Andrew White*
 
-    *Rafael Mendonça França*
+*   Allow to detach an attachment when record is not persisted.
 
-*   Remove deprecated `config.active_storage.queue`.
+    *Jacopo Beschi*
 
-    *Rafael Mendonça França*
+*   Use libvips instead of ImageMagick to analyze images when `active_storage.variant_processor = vips`.
 
-*   Remove deprecated `ActiveStorage::Downloading`.
+    *Breno Gazzola*
 
-    *Rafael Mendonça França*
+*   Add metadata value for presence of video channel in video blobs.
 
-*   Add per-environment configuration support
+    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.
 
-    *Pietro Moro*
+    *Breno Gazzola*
 
-*   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.
+*   Deprecate usage of `purge` and `purge_later` from the association extension.
 
-    *Vincent Robert*
+    *Jacopo Beschi*
 
-*   Touch parent model when an attachment is purged.
+*   Passing extra parameters in `ActiveStorage::Blob#url` to S3 Client.
 
-    *Víctor Pérez Rodríguez*
+    This allows calls of `ActiveStorage::Blob#url` to have more interaction with
+    the S3 Presigner, enabling, amongst other options, custom S3 domain URL
+    Generation.
 
-*   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:
+    ```ruby
+    blob = ActiveStorage::Blob.last
 
-    ```erb
-    <%= image_tag rails_storage_proxy_path(@user.avatar) %>
+    blob.url # => https://<bucket-name>.s3.<region>.amazonaws.com/<key>
+    blob.url(virtual_host: true) # => # => https://<bucket-name>/<key>
     ```
 
-    To proxy by default, set `config.active_storage.resolve_model_to_route`:
+    *josegomezr*
 
-    ```ruby
-    # Proxy attached files instead.
-    config.active_storage.resolve_model_to_route = :rails_storage_proxy
-    ```
+*   Allow setting a `Cache-Control` on files uploaded to GCS.
 
-    ```erb
-    <%= image_tag @user.avatar %>
+    ```yaml
+    gcs:
+      service: GCS
+      ...
+      cache_control: "public, max-age=3600"
     ```
 
-    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:
+    *maleblond*
 
-    ```erb
-    <%= image_tag rails_storage_redirect_path(@user.avatar) %>
-    ```
+*   The parameters sent to `ffmpeg` for generating a video preview image are now
+    configurable under `config.active_storage.video_preview_arguments`.
 
-    *Jonathan Fleckenstein*
+    *Brendon Muir*
 
-*   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.
+*   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+.
 
-    *Jeroen van Haperen*
+    *Jonathan Hefner*
 
-*   Add support for creating variants of `WebP` images out of the box.
+*   Add support for ActiveStorage expiring URLs.
 
-    *Dino Maric*
+    ```ruby
+    rails_blob_path(user.avatar, disposition: "attachment", expires_in: 30.minutes)
 
-*   Only enqueue analysis jobs for blobs with non-null analyzer classes.
+    <%= image_tag rails_blob_path(user.avatar.variant(resize: "100x100"), expires_in: 30.minutes) %>
+    ```
 
-    *Gannon McGibbon*
+    If you want to set default expiration time for ActiveStorage URLs throughout your application, set `config.active_storage.urls_expire_in`.
 
-*   Previews are created on the same service as the original blob.
+    *aki77*
 
-    *Peter Zhu*
+*   Allow to purge an attachment when record is not persisted for `has_many_attached`.
 
-*   Remove unused `disposition` and `content_type` query parameters for `DiskService`.
+    *Jacopo Beschi*
 
-    *Peter Zhu*
+*   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.
 
-*   Use `DiskController` for both public and private files.
+    *Alex Ghiculescu*
 
-    `DiskController` is able to handle multiple services by adding a
-    `service_name` field in the generated URL in `DiskService`.
+*   Add metadata value for presence of audio channel in video blobs.
 
-    *Peter Zhu*
+    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.
 
-*   Variants are tracked in the database to avoid existence checks in the storage service.
+    *Breno Gazzola*
 
-    *George Claghorn*
+*   Adds analyzer for audio files.
 
-*   Deprecate `service_url` methods in favour of `url`.
+    *Breno Gazzola*
 
-    Deprecate `Variant#service_url` and `Preview#service_url` to instead use
-    `#url` method to be consistent with `Blob`.
+*   Respect Active Record's primary_key_type in Active Storage migrations.
 
-    *Peter Zhu*
+    *fatkodima*
 
-*   Permanent URLs for public storage blobs.
+*   Allow `expires_in` for ActiveStorage signed ids.
 
-    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.
+    *aki77*
 
-    Deprecates `Blob#service_url` in favor of `Blob#url`.
+*   Allow to purge an attachment when record is not persisted for `has_one_attached`.
 
-    *Peter Zhu*
+    *Jacopo Beschi*
 
-*   Make services aware of configuration names.
+*   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.
 
-    *Gannon McGibbon*
+    *Brendon Muir*
 
-*   The `Content-Type` header is set on image variants when they're uploaded to third-party storage services.
+*   `ActiveStorage::PreviewError` is raised when a previewer is unable to generate a preview image.
 
-    *Kyle Ribordy*
+    *Alex Robbin*
 
-*   Allow storage services to be configured per attachment.
+*   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 < ActiveRecord::Base
-      has_one_attached :avatar, service: :s3
-    end
-
-    class Gallery < ActiveRecord::Base
-      has_many_attached :photos, service: :s3
+    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
     ```
 
-    *Dmitry Tsepelev*
-
-*   You can optionally provide a custom blob key when attaching a new file:
-
-    ```ruby
-    user.avatar.attach key: "avatars/#{user.id}.jpg",
-      io: io, content_type: "image/jpeg", filename: "avatar.jpg"
-    ```
-
-    Active Storage will store the blob's data on the configured service at the provided key.
-
-    *George Claghorn*
-
-*   Replace `Blob.create_after_upload!` with `Blob.create_and_upload!` and deprecate the former.
-
-    `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.
-
-    *Julik Tarkhanov*
-
-*   Set content disposition in direct upload using `filename` and `disposition` parameters to `ActiveStorage::Service#headers_for_direct_upload`.
-
-    *Peter Zhu*
-
-*   Allow record to be optionally passed to blob finders to make sharding
-    easier.
-
-    *Gannon McGibbon*
-
-*   Switch from `azure-storage` gem to `azure-storage-blob` gem for Azure service.
-
-    *Peter Zhu*
+    *DHH*
 
-*   Add `config.active_storage.draw_routes` to disable Active Storage routes.
-
-    *Gannon McGibbon*
-
-*   Image analysis is skipped if ImageMagick returns an error.
-
-    `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.
-
-    *George Claghorn*
-
-*   Method calls on singular attachments return `nil` when no file is attached.
-
-    Previously, assuming the following User model, `user.avatar.filename` would
-    raise a `Module::DelegationError` if no avatar was attached:
+*   Add ability to use pre-defined variants.
 
     ```ruby
-    class User < ApplicationRecord
-      has_one_attached :avatar
+    class User < ActiveRecord::Base
+      has_one_attached :avatar do |attachable|
+        attachable.variant :thumb, resize: "100x100"
+        attachable.variant :medium, resize: "300x300", monochrome: true
+      end
     end
-    ```
 
-    They now return `nil`.
-
-    *Matthew Tanous*
-
-*   The mirror service supports direct uploads.
-
-    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.
-
-    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/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2017-2020 David Heinemeier Hansson, Basecamp
+Copyright (c) 2017-2021 David Heinemeier Hansson, Basecamp
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

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