Tay.Config (tay_core v1.6.1)

Copy Markdown View Source

Loads and validates Tay's foundation configuration without storage I/O.

Supported options:

  • :data_dir — a nonblank UTF-8 path without NUL bytes, or nil when unconfigured. Relative paths are expanded against the current working directory when configuration is loaded. Expansion is lexical: it does not resolve symlinks, create directories, or verify permissions.
  • :queues — a keyword list of unique atom names and positive integer concurrency limits, defaulting to [default: 10]. [] is allowed.
  • :durability — default job durability, :persistent (the default) or :volatile.
  • :journal — global persistent-journal batching configuration.

This module has no default storage path. This repository supplies provisional dev/test paths in config/config.exs; these are not production storage-location semantics. An unconfigured path is accepted by development/test application startup only. Production startup requires an explicitly configured path.

Unknown and duplicate options are rejected. Queue strings are not converted to atoms. Storage-session durability (:sync or development-only :write) remains an Engine/Storage option and is distinct from job durability.

Summary

Types

error()
t()

Functions

load()

Reads the current :tay_core application environment and validates it.

new(options)

Validates options and normalizes a configured path without changing the application environment or touching storage.

validate_startup(config, environment \\ :dev)

Enforces the production storage-location requirement without filesystem I/O.

Types

error()

@type error() :: {:invalid_config, atom(), String.t()}

t()

@type t() :: %Tay.Config{
  data_dir: String.t() | nil,
  durability: :persistent | :volatile,
  journal: keyword(),
  queues: [{atom(), pos_integer()}]
}

Functions

load()

@spec load() :: {:ok, t()} | {:error, error()}

Reads the current :tay_core application environment and validates it.

Values are read on each call, rather than captured at compile time.

new(options)

@spec new(keyword()) :: {:ok, t()} | {:error, error()}

Validates options and normalizes a configured path without changing the application environment or touching storage.

validate_startup(config, environment \\ :dev)

Enforces the production storage-location requirement without filesystem I/O.