# Exfile
[](https://travis-ci.org/keichan34/exfile)
File upload handling in Elixir and Plug. Inspired heavily by [Refile](https://github.com/refile/refile).
If you use Ruby, check Refile out. I like it. A lot. 👍
Requires Elixir `~> 1.2.0`. At this point, it is only tested against the most
recent version of Elixir.
In very heavy development. Expect things to break. I'll release 1.0 when it's
ready and I have it in a production environment.
## Storage Adapters
Exfile, like Refile, supports pluggable storage adapters. Exfile ships with a
filesystem-backed storage adapter.
* [exfile-memory](https://github.com/keichan34/exfile-memory) -- a memory-backed
(ETS) storage adapter. This is usually only useful as a cache.
* [exfile-b2](https://github.com/keichan34/exfile-b2) -- storage adapter for
Backblaze B2.
## File Processors
Exfile supports pluggable file processors / filters. If you're working with
images, `exfile-imagemagick` is recommended.
* [exfile-imagemagick](https://github.com/keichan34/exfile-imagemagick)
## Installation
1. Add exfile to your list of dependencies in `mix.exs`:
```elixir
def deps do
[{:exfile, "~> 0.1.1"}]
end
```
2. Ensure exfile is started before your application:
```elixir
def application do
[applications: [:exfile]]
end
```
3. Mount the Exfile routes in your router.
### Phoenix
```elixir
defmodule MyApp.Router do
use MyApp.Web, :router
foward "/attachments", Exfile.Router
...
```
### Plug
```elixir
defmodule MyApp.Router do
use Plug.Router
forward "/attachments", to: Exfile.Router
...
```
## Configuration
In `config.exs`:
```elixir
config :exfile, Exfile,
secret: "secret string to generate the token used to authenticate requests",
backends: %{
"store" => configuration for a persistent store,
"cache" => configuration for an ephemeral cache
}
```
See `lib/exfile/config.ex` for defaults.
