I thought at first that we'd want to stop supporting them, but people
might be using FileSystem ...

Now that we can rely on Aws::S3::Object#upload_stream existing, we can
always use that. We also ...

The presign_endpoint now requires Hashes or something that's convertable
to a Hash, so we don't ...

Users should use :response_content_disposition instead.

Users should use the ContentDisposition gem for generating properly
encoded Content-Disposition ...

That's the version that introduced Aws::S3::Object#upload_stream, which
we need for uploading la...

The instrumentation plugin overrides Shrine#get_metadata method to add
instrumentation, so calli...

The moving plugin has been deprecated, and storages are now encouraged
to implement moving as pa...

This class is public-facing, especially when the instrumentation plugin
is used, so we move it t...

This class is public-facing, especially when the instrumentation plugin
is used, so we move it t...

The backup plugin relies heavily on the Attacher implementation, which
will change in Shrine 3.0...

This is now the recommended analyzer.

This works with moving & delete_raw plugins, as well as the new :move
option for FileSystem#uplo...

Users should now pass the `move: true` to FileSystem#upload. FileSystem
storage was the only one...

Users of the moving plugin should now switch to that option. This will
make it easier to reason ...

We've recently removed similar logic from the S3 storage, because it
wasn't worth the added cost...

The new instrumentation plugin provides much more visibility into Shrine
operations than the log...

When having metadata for which there aren't any file methods, you'd
retrieve them like this:

...

I like that when I require `lib/shrine/uploaded_file.rb`, that file is
in charge of providing me...

While I decided that Shrine 3.0 will continue to not use an MIME type
analyzer by default, we ca...

People should be able to have Shrine log anything into the Rails logger
when using Shrine inside...

The copy plugin has had some undesired behaviour, mostly around its
`#initialize_copy` override ...

If metadata extraction is heavy, in tests people might want to skip it.
So we add support for th...

We can use lazy enumerators to do lazy selection, which is less verbose
than creating our own En...

This was possible before Shrine 2.18.0, although unintentionally. In
https://github.com/shrinerb...

I feel they are too technical for someone not familiar with Uppy, and
it's kind of out of the bl...

It would rarely be obvious how to use it, as people are in different
contexts for different feat...

This gives people more flexibility in what they want to delete, and
makes the API consistent wit...

It makes it stand out nicely when reading, which is desired as it's the
most important part of d...

This was removed with the simplification of the README, but it's very
important in understanding...

This test fails randomly on JRuby and I don't know why.

https://travis-ci.org/shrinerb/shrine/j...

This aliases

Shrine.determine_mime_type(io)
Shrine.extract_dimensions(io)
Shrine.calculat...

The validation_helpers plugin docs isn't the place for describing how
validation works, this is ...

validate_max_dimensions [5000, 5000]
validate_min_dimensions [100, 100]

# OR

validate_...

This way the user knows what exists and doesn't have to guess by the
name of the validation method.

larger/smaller is about physical size, while greater/less is about
values, which is what we have...

If users want to provide both upper and lower constraints for a metadata
value, they can now do ...

In RDocs we want to be speaking in a precise low-level language, so that
there is no misinterpre...

In the vast majority of cases the user will only use a whitelist, so we
add shorthands for these...

Parentheses split the message into two parts, and it's not needed, we
can say everything at once...

It's not needed anymore now that upload_endpoint handles the default
`files[]` array.

This is required on web servers other than Falcon.

According to article [1], the README is trying to be a "tutorial" type
of documentation. However...

Accidentally copy pasted this without noticing the mistake and ran into configuration issues.

Fixes #388

* better linkage
* more Rails examples

This is needed when using :content_disposition presign option for PUT
presigns.

Now we can write

uploader = Shrine.new(:cache)
uploader.upload(file)

as

Shrine.upload(f...