rails--rails/activestorage/CHANGELOG.md

• Add ActiveStorage.routes_prefix for configuring generated routes.

  Chris Bisnett

• ActiveStorage::Service::AzureStorageService only handles specifically relevant types of Azure::Core::Http::HTTPError. It previously obscured other types of HTTPError, which is the azure-storage gem’s catch-all exception class.

  Cameron Bothner

• ActiveStorage::DiskController#show generates a 404 Not Found response when the requested file is missing from the disk service. It previously raised Errno::ENOENT.

  Cameron Bothner

• ActiveStorage::Blob#download and ActiveStorage::Blob#open raise ActiveStorage::FileNotFoundError when the corresponding file is missing from the storage service. Services translate service-specific missing object exceptions (e.g. Google::Cloud::NotFoundError for the GCS service and Errno::ENOENT for the disk service) into ActiveStorage::FileNotFoundError.

  Cameron Bothner

• Added the ActiveStorage::SetCurrent concern for custom Active Storage controllers that can't inherit from ActiveStorage::BaseController.

  George Claghorn

• Active Storage error classes like ActiveStorage::IntegrityError and ActiveStorage::UnrepresentableError now inherit from ActiveStorage::Error instead of StandardError. This permits rescuing ActiveStorage::Error to handle all Active Storage errors.

  Andrei Makarov, George Claghorn

• Uploaded files assigned to a record are persisted to storage when the record is saved instead of immediately.

  In Rails 5.2, the following causes an uploaded file in params[:avatar] to be stored:

  @user.avatar = params[:avatar]
  

  In Rails 6, the uploaded file is stored when @user is successfully saved.

  George Claghorn

• Add the ability to reflect on defined attachments using the existing ActiveRecord reflection mechanism.

  Kevin Deisz

• Variant arguments of false or nil will no longer be passed to the processor. For example, the following will not have the monochrome variation applied:

    avatar.variant(monochrome: false)
  

  Jacob Smith

• Generated attachment getter and setter methods are created within the model's GeneratedAssociationMethods module to allow overriding and composition using super.

  Josh Susser, Jamon Douglas

• Add ActiveStorage::Blob#open, which downloads a blob to a tempfile on disk and yields the tempfile. Deprecate ActiveStorage::Downloading.

  David Robertson, George Claghorn

• Pass in identify: false as an argument when providing a content_type for ActiveStorage::Attached::{One,Many}#attach to bypass automatic content type inference. For example:

    @message.image.attach(
      io: File.open('/path/to/file'),
      filename: 'file.pdf',
      content_type: 'application/pdf',
      identify: false
    )
  

  Ryan Davidson

• The Google Cloud Storage service properly supports streaming downloads. It now requires version 1.11 or newer of the google-cloud-storage gem.

  George Claghorn

• Use the ImageProcessing gem for Active Storage variants, and deprecate the MiniMagick backend.

  This means that variants are now automatically oriented if the original image was rotated. Also, in addition to the existing ImageMagick operations, variants can now use :resize_to_fit, :resize_to_fill, and other ImageProcessing macros. These are now recommended over raw :resize, as they also sharpen the thumbnail after resizing.

  The ImageProcessing gem also comes with a backend implemented on libvips, an alternative to ImageMagick which has significantly better performance than ImageMagick in most cases, both in terms of speed and memory usage. In Active Storage it's now possible to switch to the libvips backend by changing Rails.application.config.active_storage.variant_processor to :vips.

  Janko Marohnić

• Rails 6 requires Ruby 2.4.1 or newer.

  Jeremy Daer

Please check 5-2-stable for previous changes.