Bourse.Registry (bourse v0.1.0)

Copy Markdown View Source

Compile-time exchange lookup registry.

Maps exchange ID atoms and strings to their generated module names. Built from the spec manifest at compile time — recompiles automatically when the manifest changes.

Usage

Bourse.Registry.lookup(:bybit)
#=> {:ok, Bourse.Bybit}

Bourse.Registry.lookup!("binance")
#=> Bourse.Binance

Bourse.Registry.exchanges()
#=> ["alpaca", "binance", ..., "okx"]

Bourse.Registry.loaded?(:bybit)
#=> true  # if Bourse.Bybit module is compiled

Summary

Functions

exchanges()

Returns the closed runtime-support inventory as strings.

loaded?(id)

Checks if the exchange module is compiled and loaded.

lookup(id)

Looks up the module for an exchange ID.

lookup!(id)

Looks up the module for an exchange ID, raising on unknown.

module_for(id)

Returns the module for an exchange ID, or nil if unsupported.

registered?(id)

Checks if an exchange ID is registered.

Functions

exchanges()

@spec exchanges() :: [String.t()]

Returns the closed runtime-support inventory as strings.

Examples

Bourse.Registry.exchanges()
#=> ["alpaca", "binance", ..., "okx"]

loaded?(id)

@spec loaded?(String.t() | atom()) :: boolean()

Checks if the exchange module is compiled and loaded.

Returns true only if the exchange is registered AND its module is available in the BEAM. Useful for distinguishing "known exchange" from "exchange module exists."

Examples

Bourse.Registry.loaded?(:bybit)
#=> true  # if Bourse.Bybit is compiled

lookup(id)

@spec lookup(String.t() | atom()) ::
  {:ok, module()} | {:error, {:unsupported_exchange, String.t()}}

Looks up the module for an exchange ID.

Accepts both string and atom IDs.

Examples

Bourse.Registry.lookup("bybit")
#=> {:ok, Bourse.Bybit}

Bourse.Registry.lookup(:kraken)
#=> {:error, {:unsupported_exchange, "kraken"}}

lookup!(id)

@spec lookup!(String.t() | atom()) :: module()

Looks up the module for an exchange ID, raising on unknown.

Examples

Bourse.Registry.lookup!(:bybit)
#=> Bourse.Bybit

module_for(id)

@spec module_for(String.t() | atom()) :: module() | nil

Returns the module for an exchange ID, or nil if unsupported.

Examples

Bourse.Registry.module_for("bybit")
#=> Bourse.Bybit

Bourse.Registry.module_for("nope")
#=> nil

registered?(id)

@spec registered?(String.t() | atom()) :: boolean()

Checks if an exchange ID is registered.

Examples

Bourse.Registry.registered?(:bybit)
#=> true