defmodule PTAX do
@moduledoc """
Agrega funções de listagem e conversão de moedas suportadas
"""
alias PTAX.{Conversor, Error, Moeda}
@type converter_opts :: [
de: Conversor.moeda(),
para: Conversor.moeda(),
data: Date.t() | nil,
operacao: Conversor.operacao() | nil
]
@spec moedas :: list(Moeda.t()) | {:error, term}
defdelegate moedas, to: Moeda, as: :list
@doc """
Converte um valor de uma moeda para outra
## Exemplo
iex> PTAX.converter(5, de: :USD, para: :BRL, data: ~D[2021-12-24], operacao: :compra)
{:ok, #Decimal<28.2705>}
"""
@spec converter(
valor :: Conversor.valor(),
opts :: converter_opts | Conversor.opts()
) :: {:ok, Decimal.t()} | {:error, Error.t()}
def converter(valor, opts) when is_list(opts) do
today = "America/Sao_Paulo" |> Timex.now() |> Timex.to_date()
opts = Enum.into(opts, %{data: today, operacao: :venda})
converter(valor, opts)
end
def converter(valor, opts) do
Conversor.run(valor, opts)
end
@doc """
Semelhante a `converter/2`, mas gera um erro se o valor não puder ser convertido.
## Exemplo
iex> PTAX.converter!(5, de: :USD, para: :BRL, data: ~D[2021-12-24], operacao: :compra)
#Decimal<28.2705>
"""
@spec converter!(
valor :: Conversor.valor(),
opts :: converter_opts | Conversor.opts()
) :: Decimal.t()
def converter!(valor, opts) do
case converter(valor, opts) do
{:ok, result} -> result
{:error, error} -> raise error
end
end
end