We want to allow users to convert custom HTTP exceptions into validation
errors in their downloa...

We removed them when we wanted to simplify everything, but they're
actually useful, as they help...

This adds the API for calling the mirror upload/delete block:

file = Shrine.upload(io, :store...

With the recent backgrounding change, it's not possible anymore to use
attacher_options plugin t...

Previously Attacher#promote and Attacher#destroy would be synchronous or
asynchronous depending ...

This allows Rails uses who use an authentication framework that doesn't
support route-level auth...

In Active Record 6.0 this setting doesn't exist anymore, in 5.x it
defaults to true, and AFAIK i...

The discussion forum has moved from Google Groups to Discourse. The
reason is nicer UI and relia...

* Improve the derivatives guide

* Update derivatives documentation based on feedback

* Cla...

That makes testing easier, as well as playing on the console. It also
eliminates an additional i...

In ROM we don't have a way to determine whether an entity attribute will
return a Hash or not. S...

This simplifies Attacher's #inspect output, and our code as well.

The Shrine::Attacher rewrite broke support for JSON columns in
activerecord plugin. JSON column ...

The mirroring plugin adds the ability to replicate uploads and deletes
to other storages. This ...

JRuby has some obscure error on Travis that I don't have time to fix
right now, so we'll allow t...

Closes #401

* add back lost comments
* use fastimage for image extraction
* remove derivatives eversions com...

The `type: :entity` approach isn't very clean, because it implies that
we have multiple types, w...

We explain both Shrine::Attachment and Shrine::Attacher usage,
emphasizing that `#<name>_data` r...

What Active Record calls "callbacks", Sequel calls "hooks". We want to
respect Sequel's terminol...

If the user wants to use an UploadedFile object as the source file for
processing derivatives, I...

When we're using backgrounding, we pass current attached file data to
the background job, so tha...

The .<name>_attacher class method returns the Attacher instance without
the model/entity instanc...

The :name and :args values in the payload were redundant, it's enough to
send only :derivation.
...

Currently the dynamic storage block accepts record & name arguments. I
think this is limiting an...

For each of the Attacher#persist, Attacher#atomic_persist and
Attacher#atomic_promote methods, w...

When users are generating derivatives in their controller, this will be
the most common way:

...

The same can already be achieved with Attacher#assign_options from the
attacher_options plugin:
...

This removes some boilerplate around plugins defining methods only for
models. Now plugins can d...

To generate derivatives in the controller, the user currently needs to
call Attacher#create_deri...

I think it will be much more common for people to want to pass arguments
to the processor than t...

The user will likely want to find out very soon if they can configure
derivatives to be uploaded...

This is useful when you want to assign attachment from form params but
don't want to create a fo...

The method hierarchy is now as follows:

* Attacher#create_derivatives
* Attacher#process_deri...

There is no need to use strings, it was just for remembering that they
will be integers in the d...

We're deleting uploaded files in multiple places (derivatives,
derivation_endpoint), so we add t...

We want to return object's content length in S3#open, so that
UploadedFile#size can retrieve it ...

Now that Storage#open is required to raise Shrine::FileNotFound if file
is not found, we don't n...

When :upload is set but no :upload_redirect, we're always first checking
whether the derivation ...

Now that derivation block is evaluated in context of a
Shrine::Derivation instance, the source U...

It's not needed anymore now that derivation blocks are evaluated in
context of a Shrine::Derivat...

It is not useful at all to evaluate it in context of an uploader
instance, because this doesn't ...

Now that storages should raise Shrine::FileNotFound when file was not
found, we don't need the :...

In download_endpoint and derivation_endpoint it would be really useful
to know when Storage#open...

I've wanted to use it in migration scripts where I have access to the
attacher instance. It was ...

I've wanted the :metadata information on the top level for the
upload.shrine event. In addition ...

It recently added support for Shrine.

Any /:storage/:id file URLs will now return a 404.

Instead of Attacher#add_derivatives and Attacher#upload_derivatives
optionally accepting a proce...

Because derivatives plugin requires explicit triggering of processing,
we don't need to use two ...

The :derivative option will only be available for derivative uploads,
otherwise that option won'...

When Shrine::Attachment module is used on a model/entity,
Attacher.retrieve would fail with Shri...

Currently UploadedFile#== allows the uploader class of the file on the
right hand side to be a s...

We add the missing Attacher#merge_derivatives layer between
Attacher#add_derivatives and Attache...

There could be use cases where the user still wants to use the raw
file after it has been upload...

This doesn't get us to 100% yet, but the rest is not so important.