View Source ExFiskal.Config (ExFiskal v1.2.0)

Configuration management for ExFiskal OTP application.

This module provides utilities for managing application-wide configuration such as certificate data, fiscalization endpoints, and other settings.

Configuration Options

You can configure ExFiskal in your config.exs:

config :ex_fiskal,
  environment: :production,
  timeout: 30_000,
  endpoint_url: "https://cis.porezna-uprava.hr:8449/FiskalizacijaService"

Available Settings

:environment - Either :production or :demo. Defaults to :production.
:timeout - Request timeout in milliseconds. Defaults to 30_000 (30 seconds).
:endpoint_url - The fiscalization service endpoint URL.
:certificate_path - Optional path to certificate file.
:certificate_password - Optional certificate password.

Runtime Configuration

You can also configure settings at runtime:

ExFiskal.Config.put(:timeout, 60_000)
ExFiskal.Config.get(:timeout)

Summary

Functions

certificate_password()

Returns the certificate password if configured.

certificate_path()

Returns the certificate path if configured.

demo?()

Returns whether the application is running in demo mode.

endpoint_url()

Returns the endpoint URL based on the configured environment.

environment()

Returns the configured environment (:production or :demo).

get(key, default \\ nil)

Gets a configuration value for the given key.

get!(key)

Gets a configuration value for the given key, raising if not found.

production?()

Returns whether the application is running in production mode.

put(key, value)

Puts a configuration value for the given key at runtime.

timeout()

Returns the timeout value in milliseconds.

Functions

certificate_password()

@spec certificate_password() :: String.t() | nil

Returns the certificate password if configured.

Examples

iex> ExFiskal.Config.certificate_password()
"my_password"

certificate_path()

@spec certificate_path() :: String.t() | nil

Returns the certificate path if configured.

Examples

iex> ExFiskal.Config.certificate_path()
"/path/to/certificate.p12"

demo?()

@spec demo?() :: boolean()

Returns whether the application is running in demo mode.

Examples

iex> ExFiskal.Config.demo?()
false

endpoint_url()

@spec endpoint_url() :: String.t()

Returns the endpoint URL based on the configured environment.

Examples

iex> ExFiskal.Config.endpoint_url()
"https://cis.porezna-uprava.hr:8449/FiskalizacijaService"

environment()

@spec environment() :: :production | :demo

Returns the configured environment (:production or :demo).

Defaults to :production if not configured.

Examples

iex> ExFiskal.Config.environment()
:production

get(key, default \\ nil)

@spec get(atom(), any()) :: any()

Gets a configuration value for the given key.

Examples

iex> ExFiskal.Config.get(:timeout)
30_000

iex> ExFiskal.Config.get(:timeout, 5_000)
30_000

iex> ExFiskal.Config.get(:unknown_key, :default_value)
:default_value

get!(key)

@spec get!(atom()) :: any()

Gets a configuration value for the given key, raising if not found.

Examples

iex> ExFiskal.Config.get!(:timeout)
30_000

production?()

@spec production?() :: boolean()

Returns whether the application is running in production mode.

Examples

iex> ExFiskal.Config.production?()
true

put(key, value)

@spec put(atom(), any()) :: :ok

Puts a configuration value for the given key at runtime.

Examples

iex> ExFiskal.Config.put(:timeout, 60_000)
:ok

timeout()

@spec timeout() :: non_neg_integer()

Returns the timeout value in milliseconds.

Defaults to 30 seconds if not configured.

Examples

iex> ExFiskal.Config.timeout()
30_000