Module: Shrine::Plugins::KitheStorageLocation

Defined in:

lib/shrine/plugins/kithe_storage_location.rb

Overview

Set custom storage locations/paths for both the original file which is the main file in the shrine attachment at Asset#file, and any shrine derivatives.

Shrine’s default is to just put both of these at top-level ‘[randomID].suffix`. We instead:

## Original file

Stored at ‘asset/#asset_uuid_id/#unique_file_id.suffix` – regardless of asset sub-class, since they all have unique ids, just all under asset/. (In retrospect, maybe shoudl have left `asset/` off, and let consumer specify a prefix when configuring storage).

If no Asset pk is available (direct upload or unsaved Asset), will be stored just under “asset/#unique_file_id.#suffix”

We are choosing to store under Asset UUID PK instead of friendlier_id, friendlier_id is good for public URLs and UI, but actual PK is more reliable/immutable.

## Derivatives

Stored at ‘#asset_uuid_id/derivative_key/#unique_file_id.suffix`.

If asset uuid pk is not available, will raise a TypeError and refuse to store derivative. (This may have to be thought through more.)

If you want an additional prefix, supply it hwen configuring kithe_derivatives storage.

Defined Under Namespace

Modules: InstanceMethods