Yggdrasil for PostgreSQL

v5.0.2

Yggdrasil for PostgreSQL v5.0.2 Yggdrasil.Settings.Postgres View Source

This module defines the available settings for PostgreSQL in Yggdrasil.

Link to this section Summary

Functions

database(namespace \\ nil)

Postgres database. Defaults to "postgres".

database!(namespace \\ nil)

Postgres database. Defaults to "postgres".

hostname(namespace \\ nil)

Postgres hostname. Defaults to "localhost".

hostname!(namespace \\ nil)

Postgres hostname. Defaults to "localhost".

max_retries(namespace \\ nil)

Postgres max retries for the backoff algorithm. Defaults to 3.

max_retries!(namespace \\ nil)

Postgres max retries for the backoff algorithm. Defaults to 3.

password(namespace \\ nil)

Postgres password. Defaults to "postgres".

password!(namespace \\ nil)

Postgres password. Defaults to "postgres".

port(namespace \\ nil)

Postgres port. Defaults to 5432.

port!(namespace \\ nil)

Postgres port. Defaults to 5432.

publisher_connections(namespace \\ nil)

PostgreSQL amount of publisher connections.

publisher_connections!(namespace \\ nil)

PostgreSQL amount of publisher connections.

put_database(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.database/0. Optionally, receives the namespace.

put_hostname(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.hostname/0. Optionally, receives the namespace.

put_max_retries(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.max_retries/0. Optionally, receives the namespace.

put_password(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.password/0. Optionally, receives the namespace.

put_port(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.port/0. Optionally, receives the namespace.

put_publisher_connections(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.publisher_connections/0. Optionally, receives the namespace.

put_slot_size(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.slot_size/0. Optionally, receives the namespace.

put_subscriber_connections(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.subscriber_connections/0. Optionally, receives the namespace.

put_username(value, namespace \\ nil)

Puts the value to Yggdrasil.Settings.Postgres.username/0. Optionally, receives the namespace.

reload_database(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.database/0. Optionally, receives the namespace for the variable.

reload_hostname(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.hostname/0. Optionally, receives the namespace for the variable.

reload_max_retries(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.max_retries/0. Optionally, receives the namespace for the variable.

reload_password(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.password/0. Optionally, receives the namespace for the variable.

reload_port(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.port/0. Optionally, receives the namespace for the variable.

reload_publisher_connections(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.publisher_connections/0. Optionally, receives the namespace for the variable.

reload_slot_size(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.slot_size/0. Optionally, receives the namespace for the variable.

reload_subscriber_connections(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.subscriber_connections/0. Optionally, receives the namespace for the variable.

reload_username(namespace \\ nil)

Reloads the value for Yggdrasil.Settings.Postgres.username/0. Optionally, receives the namespace for the variable.

slot_size(namespace \\ nil)

Postgres slot size for the backoff algorithm. Defaults to 100.

slot_size!(namespace \\ nil)

Postgres slot size for the backoff algorithm. Defaults to 100.

subscriber_connections(namespace \\ nil)

PostgreSQL amount of subscriber connections.

subscriber_connections!(namespace \\ nil)

PostgreSQL amount of subscriber connections.

template(filename, options \\ [])

Creates a template for OS environment variables given a filename. Additionally, it can receive a list of options

username(namespace \\ nil)

Postgres username. Defaults to "postgres".

username!(namespace \\ nil)

Postgres username. Defaults to "postgres".

Link to this section Functions

Link to this function

database(namespace \\ nil)

View Source 
database(Skogsra.Env.namespace()) :: {:ok, binary()} | {:error, binary()}

Postgres database. Defaults to "postgres".

iex> Yggdrasil.Settings.Postgres.database()
{:ok, "postgres"}

Calling Yggdrasil.Settings.Postgres.database() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_DATABASE"
  • Type: :binary
  • Default: "postgres"
  • Required: false
  • Cached: true
Link to this function

database!(namespace \\ nil)

View Source 
database!(Skogsra.Env.namespace()) :: binary() | no_return()

Postgres database. Defaults to "postgres".

iex> Yggdrasil.Settings.Postgres.database()
{:ok, "postgres"}

Bang version of Yggdrasil.Settings.Postgres.database/0 (fails on error). Optionally, receives the namespace for the variable.

Link to this function

hostname(namespace \\ nil)

View Source 
hostname(Skogsra.Env.namespace()) :: {:ok, binary()} | {:error, binary()}

Postgres hostname. Defaults to "localhost".

Calling Yggdrasil.Settings.Postgres.hostname() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_HOSTNAME"
  • Type: :binary
  • Default: "localhost"
  • Required: false
  • Cached: true
Link to this function

hostname!(namespace \\ nil)

View Source 
hostname!(Skogsra.Env.namespace()) :: binary() | no_return()

Postgres hostname. Defaults to "localhost".

Bang version of Yggdrasil.Settings.Postgres.hostname/0 (fails on error). Optionally, receives the namespace for the variable.

Link to this function

max_retries(namespace \\ nil)

View Source 
max_retries(Skogsra.Env.namespace()) :: {:ok, integer()} | {:error, binary()}

Postgres max retries for the backoff algorithm. Defaults to 3.

The backoff algorithm is exponential:

backoff_time = pow(2, retries) * random(1, slot) * 1_000 ms

when retries <= MAX_RETRIES and slot is given by the configuration variable Elixir.Yggdrasil.Settings.Postgres.slot_size/0 (defaults to 10 secs).

iex> Yggdrasil.Settings.Postgres.max_retries()
{:ok, 3}

Calling Yggdrasil.Settings.Postgres.max_retries() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_MAX_RETRIES"
  • Type: :integer
  • Default: 3
  • Required: false
  • Cached: true
Link to this function

max_retries!(namespace \\ nil)

View Source 
max_retries!(Skogsra.Env.namespace()) :: integer() | no_return()

Postgres max retries for the backoff algorithm. Defaults to 3.

The backoff algorithm is exponential:

backoff_time = pow(2, retries) * random(1, slot) * 1_000 ms

when retries <= MAX_RETRIES and slot is given by the configuration variable Elixir.Yggdrasil.Settings.Postgres.slot_size/0 (defaults to 10 secs).

iex> Yggdrasil.Settings.Postgres.max_retries()
{:ok, 3}

Bang version of Yggdrasil.Settings.Postgres.max_retries/0 (fails on error). Optionally, receives the namespace for the variable.

Link to this function

password(namespace \\ nil)

View Source 
password(Skogsra.Env.namespace()) :: {:ok, binary()} | {:error, binary()}

Postgres password. Defaults to "postgres".

iex> Yggdrasil.Settings.Postgres.password()
{:ok, "postgres"}

Calling Yggdrasil.Settings.Postgres.password() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_PASSWORD"
  • Type: :binary
  • Default: "postgres"
  • Required: false
  • Cached: true
Link to this function

password!(namespace \\ nil)

View Source 
password!(Skogsra.Env.namespace()) :: binary() | no_return()

Postgres password. Defaults to "postgres".

iex> Yggdrasil.Settings.Postgres.password()
{:ok, "postgres"}

Bang version of Yggdrasil.Settings.Postgres.password/0 (fails on error). Optionally, receives the namespace for the variable.

Link to this function

port(namespace \\ nil)

View Source 
port(Skogsra.Env.namespace()) :: {:ok, integer()} | {:error, binary()}

Postgres port. Defaults to 5432.

iex> Yggdrasil.Settings.Postgres.port()
{:ok, 5432}

Calling Yggdrasil.Settings.Postgres.port() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_PORT"
  • Type: :integer
  • Default: 5432
  • Required: false
  • Cached: true
Link to this function

port!(namespace \\ nil)

View Source 
port!(Skogsra.Env.namespace()) :: integer() | no_return()

Postgres port. Defaults to 5432.

iex> Yggdrasil.Settings.Postgres.port()
{:ok, 5432}

Bang version of Yggdrasil.Settings.Postgres.port/0 (fails on error). Optionally, receives the namespace for the variable.

Link to this function

publisher_connections(namespace \\ nil)

View Source 
publisher_connections(Skogsra.Env.namespace()) ::
  {:ok, integer()} | {:error, binary()}

PostgreSQL amount of publisher connections.

iex> Yggdrasil.Settings.Postgres.publisher_connections()
{:ok, 1}

Calling Yggdrasil.Settings.Postgres.publisher_connections() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_PUBLISHER_CONNECTIONS"
  • Type: :integer
  • Default: 1
  • Required: false
  • Cached: true
Link to this function

publisher_connections!(namespace \\ nil)

View Source 
publisher_connections!(Skogsra.Env.namespace()) :: integer() | no_return()

PostgreSQL amount of publisher connections.

iex> Yggdrasil.Settings.Postgres.publisher_connections()
{:ok, 1}

Bang version of Yggdrasil.Settings.Postgres.publisher_connections/0 (fails on error). Optionally, receives the namespace for the variable.

Link to this function

put_database(value, namespace \\ nil)

View Source 
put_database(binary(), Skogsra.Env.namespace()) :: :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.database/0. Optionally, receives the namespace.

Link to this function

put_hostname(value, namespace \\ nil)

View Source 
put_hostname(binary(), Skogsra.Env.namespace()) :: :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.hostname/0. Optionally, receives the namespace.

Link to this function

put_max_retries(value, namespace \\ nil)

View Source 
put_max_retries(integer(), Skogsra.Env.namespace()) :: :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.max_retries/0. Optionally, receives the namespace.

Link to this function

put_password(value, namespace \\ nil)

View Source 
put_password(binary(), Skogsra.Env.namespace()) :: :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.password/0. Optionally, receives the namespace.

Link to this function

put_port(value, namespace \\ nil)

View Source 
put_port(integer(), Skogsra.Env.namespace()) :: :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.port/0. Optionally, receives the namespace.

Link to this function

put_publisher_connections(value, namespace \\ nil)

View Source 
put_publisher_connections(integer(), Skogsra.Env.namespace()) ::
  :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.publisher_connections/0. Optionally, receives the namespace.

Link to this function

put_slot_size(value, namespace \\ nil)

View Source 
put_slot_size(integer(), Skogsra.Env.namespace()) :: :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.slot_size/0. Optionally, receives the namespace.

Link to this function

put_subscriber_connections(value, namespace \\ nil)

View Source 
put_subscriber_connections(integer(), Skogsra.Env.namespace()) ::
  :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.subscriber_connections/0. Optionally, receives the namespace.

Link to this function

put_username(value, namespace \\ nil)

View Source 
put_username(binary(), Skogsra.Env.namespace()) :: :ok | {:error, binary()}

Puts the value to Yggdrasil.Settings.Postgres.username/0. Optionally, receives the namespace.

Link to this function

reload_database(namespace \\ nil)

View Source 
reload_database(Skogsra.Env.namespace()) :: {:ok, binary()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.database/0. Optionally, receives the namespace for the variable.

Link to this function

reload_hostname(namespace \\ nil)

View Source 
reload_hostname(Skogsra.Env.namespace()) :: {:ok, binary()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.hostname/0. Optionally, receives the namespace for the variable.

Link to this function

reload_max_retries(namespace \\ nil)

View Source 
reload_max_retries(Skogsra.Env.namespace()) ::
  {:ok, integer()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.max_retries/0. Optionally, receives the namespace for the variable.

Link to this function

reload_password(namespace \\ nil)

View Source 
reload_password(Skogsra.Env.namespace()) :: {:ok, binary()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.password/0. Optionally, receives the namespace for the variable.

Link to this function

reload_port(namespace \\ nil)

View Source 
reload_port(Skogsra.Env.namespace()) :: {:ok, integer()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.port/0. Optionally, receives the namespace for the variable.

Link to this function

reload_publisher_connections(namespace \\ nil)

View Source 
reload_publisher_connections(Skogsra.Env.namespace()) ::
  {:ok, integer()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.publisher_connections/0. Optionally, receives the namespace for the variable.

Link to this function

reload_slot_size(namespace \\ nil)

View Source 
reload_slot_size(Skogsra.Env.namespace()) ::
  {:ok, integer()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.slot_size/0. Optionally, receives the namespace for the variable.

Link to this function

reload_subscriber_connections(namespace \\ nil)

View Source 
reload_subscriber_connections(Skogsra.Env.namespace()) ::
  {:ok, integer()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.subscriber_connections/0. Optionally, receives the namespace for the variable.

Link to this function

reload_username(namespace \\ nil)

View Source 
reload_username(Skogsra.Env.namespace()) :: {:ok, binary()} | {:error, binary()}

Reloads the value for Yggdrasil.Settings.Postgres.username/0. Optionally, receives the namespace for the variable.

Link to this function

slot_size(namespace \\ nil)

View Source 
slot_size(Skogsra.Env.namespace()) :: {:ok, integer()} | {:error, binary()}

Postgres slot size for the backoff algorithm. Defaults to 100.

iex> Yggdrasil.Settings.Postgres.slot_size()
{:ok, 10}

Calling Yggdrasil.Settings.Postgres.slot_size() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_SLOT_SIZE"
  • Type: :integer
  • Default: 10
  • Required: false
  • Cached: true
Link to this function

slot_size!(namespace \\ nil)

View Source 
slot_size!(Skogsra.Env.namespace()) :: integer() | no_return()

Postgres slot size for the backoff algorithm. Defaults to 100.

iex> Yggdrasil.Settings.Postgres.slot_size()
{:ok, 10}

Bang version of Yggdrasil.Settings.Postgres.slot_size/0 (fails on error). Optionally, receives the namespace for the variable.

Link to this function

subscriber_connections(namespace \\ nil)

View Source 
subscriber_connections(Skogsra.Env.namespace()) ::
  {:ok, integer()} | {:error, binary()}

PostgreSQL amount of subscriber connections.

iex> Yggdrasil.Settings.Postgres.subscriber_connections()
{:ok, 1}

Calling Yggdrasil.Settings.Postgres.subscriber_connections() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_SUBSCRIBER_CONNECTIONS"
  • Type: :integer
  • Default: 1
  • Required: false
  • Cached: true
Link to this function

subscriber_connections!(namespace \\ nil)

View Source 
subscriber_connections!(Skogsra.Env.namespace()) :: integer() | no_return()

PostgreSQL amount of subscriber connections.

iex> Yggdrasil.Settings.Postgres.subscriber_connections()
{:ok, 1}

Bang version of Yggdrasil.Settings.Postgres.subscriber_connections/0 (fails on error). Optionally, receives the namespace for the variable.

Link to this function

template(filename, options \\ [])

View Source 
template(Path.t(), keyword()) :: :ok | {:error, File.posix()}

Creates a template for OS environment variables given a filename. Additionally, it can receive a list of options:

  • type: What kind of file it will generate (:elixir, :unix, :windows).
  • namespace: Namespace for the variables.
Link to this function

username(namespace \\ nil)

View Source 
username(Skogsra.Env.namespace()) :: {:ok, binary()} | {:error, binary()}

Postgres username. Defaults to "postgres".

iex> Yggdrasil.Settings.Postgres.username()
{:ok, "postgres"}

Calling Yggdrasil.Settings.Postgres.username() will ensure the following:

  • Binding order: [:system, :config]
  • OS environment variable: "YGGDRASIL_POSTGRES_USERNAME"
  • Type: :binary
  • Default: "postgres"
  • Required: false
  • Cached: true
Link to this function

username!(namespace \\ nil)

View Source 
username!(Skogsra.Env.namespace()) :: binary() | no_return()

Postgres username. Defaults to "postgres".

iex> Yggdrasil.Settings.Postgres.username()
{:ok, "postgres"}

Bang version of Yggdrasil.Settings.Postgres.username/0 (fails on error). Optionally, receives the namespace for the variable.