Image Validator, Converter, and Uploader

A library to validate, convert, and upload images.

Why another library?

This library serves as a replacement for waffle which leaves a lot to be desired.

1. Waffle abuses __using__ macro where it could use behaviours with defined interfaces.

2. It has too much levels of indirection where it doesn't need to (nested usings for example), making it harder to understend the codebase.

3. The lack or incorrectness of documentation only makes things worse.

Still this library mainly uses the same concepts as its predecessor, it just attempts to implement them differently.

ivcu_ecto when?

There is a package named waffle_ecto that attempts to integrate waffle into ecto changesets, which is a bad decision as changesets are supposed to be pure computations without side-effects. When we add effects to them, we only catch strange behaviour.

As an example, when we call Ecto.Changeset.apply_action/2 to do validations, we trigger storing action saving corresponding file when we only needed to cast and validate params.

Also, with waffle_ecto we tie the process, of saving an image, to a database action and yet don't handle image deletion on an update.

Your best bet is to manage the storing manually.

Installation and Usage

See Getting Started guide.

Documentation

Documentation can be found at https://hexdocs.pm/ivcu.