Depot

Hex Package | Online Documentation.

Depot is a filesystem abstraction for elixir providing a unified interface over many implementations. It allows you to swap out filesystems on the fly without needing to rewrite all of your application code in the process. It can eliminate vendor-lock in, reduce technical debt, and improve the testability of your code.

This library is based on the ideas of flysystem, which is a PHP library providing similar functionality.

Examples

defmodule LocalFileSystem do
  use Depot.Filesystem,
    adapter: Depot.Adapter.Local,
    prefix: prefix
end

LocalFileSystem.write("test.txt", "Hello World")
{:ok, "Hello World"} = LocalFileSystem.read("test.txt")

Visibility

Depot does by default only deal with a limited, but portable, set of visibility permissions:

• :public
• :private

For more details and how to apply custom visibility permissions take a look at Depot.Visibility

Options

The following write options apply to all adapters:

• :visibility - Set the visibility for files written
• :directory_visibility - Set the visibility for directories written (if applicable)

Installation

The package can be installed by adding depot to your list of dependencies in mix.exs:

def deps do
  [
    {:depot, "~> 0.1.0"}
  ]
end