- (Enhancement) Allow returning a list of arguments for transformations to preserve desired groupings.
- (Enhancement) Raise a more helpful error message when attempting a transformation with an executable which cannot be found.
- (Enhancement) Allow transforms via arbitrary system executables.
- (Enhancement) Allow transforms to supply a function to define the transformation args.
- (Deprecation) Deprecate usage of {:noaction} in favor of :noaction for transformation responses.
Upgrade instructions from 0.4.x to 0.5.x:
Arc now favors explicitness in file extension changes rather than scanning with a Regex. If you have a convert
transformation which changes the file extension (through the parameter -format png
argument), you must explicitly add a third tuple argument in the conversion noting the final extension.
Example:
# Change this:
def transform(:thumb, _) do
{:convert, "-strip -thumbnail 250x250^ -gravity center -extent 250x250 -format png"}
end
# To this:
def transform(:thumb, _) do
{:convert, "-strip -thumbnail 250x250^ -gravity center -extent 250x250 -format png", :png} #<--- Note the third tuple argument with the output file extension
end
- (Bugfix) Fix regression using the local filesystem introduced via v0.4.0.
- (Bugfix) Surface errors from ExAws put operations. Parse ExAws errors and return tuple of form
{:error, List.t}
when an error is encountered.
To upgrade and properly support parsing aws errors, add :poison
to your list of dependencies.
Optional dependency added, prompting a minor version bump. While not a strict backwards incompatibility, Arc users should take note of the change as more than an internal change.
- (Enhancement) Introduce
Definition.delete/2
While there is no strict backwards incompatibility with the public API, a number of users have been using
Arc.Storage.S3.delete/3
as a public API due to a lack of a fully supported delete method. This internal method has now changed slightly, thus prompting more than a patch release.
- (Enhancement) Allow specifying custom s3 object headers through the definition module via
s3_object_headers/2
.
- (Enhancement) Allow the version transformation and storage timeout to be specified in configuration
config :arc, version_timeout: 15_000
.
- (Bugfix) Raise
Arc.ConvertError
if ImageMagick'sconvert
tool exits unsuccessfully.
- (Breaking Change) Erlcloud has been removed in favor of ExAws.
- (Enhancement) Added a configuration parameter to generate urls in the
virtual_host
style.
Since erlcloud
has been removed from arc
, you must also remove it from your dependency graph as well as your application list. In its place, add ex_aws
and httpoison
to your dependencies as well as application list. Next, remove the aws credential configuration from arc:
# BEFORE
config :arc,
access_key_id: "###",
secret_access_key: "###",
bucket: "uploads"
#AFTER
config :arc,
bucket: "uploads"
# (this is the default ex_aws config... if your keys are not in environment variables you can override it here)
config :ex_aws,
access_key_id: [{:system, "AWS_ACCESS_KEY_ID"}, :instance_role],
secret_access_key: [{:system, "AWS_SECRET_ACCESS_KEY"}, :instance_role]
Read more about how ExAws manages configuration here.
- (Enhancement: Local Storage) Filenames which contain path separators will flatten out as expected prior to moving copying the file to its destination.
- (Enhancement: Url Generation)
default_url/2
introduced to definition module which passes the given scope as the second parameter. Backwards compatibility is maintained fordefault_url/1
.
- (Bugfix: Storage) Bugfix for referencing atoms in the file name.
- (Enhancement: Storage) Add the local filesystem as a storage option.