View Source Ecto.Adapter.Storage behaviour (Ecto v3.11.0)

Specifies the adapter storage API.

Summary

Callbacks

Drops the storage given by options.

Returns the status of a storage given by options.

Creates the storage given by options.

Callbacks

@callback 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")
@callback 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")
@callback 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")