Ecto.Adapter.Storage behaviour

Specifies the adapter storage API.

Summary

Callbacks

storage_down(options)

Drops the storage given by options.

storage_status(options)

Returns the status of a storage given by options.

storage_up(options)

Creates the storage given by options.

Callbacks

storage_down(options)

Specs

storage_down(options :: Keyword.t()) ::
  :ok | {:error, :already_down} | {:error, term()}

Drops the storage given by options.

Returns :ok if it was dropped successfully.

Returns {:error, :already_down} if the storage has already been dropped or {:error, term} in case anything else goes wrong.

Examples

storage_down(username: "postgres",
             database: "ecto_test",
             hostname: "localhost")

storage_status(options)

Specs

storage_status(options :: Keyword.t()) :: :up | :down | {:error, term()}

Returns the status of a storage given by options.

Can return :up, :down or {:error, term} in case anything goes wrong.

Examples

storage_status(username: "postgres",
               database: "ecto_test",
               hostname: "localhost")

storage_up(options)

Specs

storage_up(options :: Keyword.t()) ::
  :ok | {:error, :already_up} | {:error, term()}

Creates the storage given by options.

Returns :ok if it was created successfully.

Returns {:error, :already_up} if the storage has already been created or {:error, term} in case anything else goes wrong.

Examples

storage_up(username: "postgres",
           database: "ecto_test",
           hostname: "localhost")

© 2013 Plataformatec
© 2020 Dashbit
Licensed under the Apache License, Version 2.0.
https://hexdocs.pm/ecto/Ecto.Adapter.Storage.html