defmodule ExCnab240 do
@moduledoc """
Cnab keeps the contexts that define your domain
and business logic.
Contexts are also responsible for managing your data, regardless
if it comes from the database, an external API or others.
"""
defmacro __using__(_opts) do
quote do
@before_compile unquote(__MODULE__)
import CnabParser
def decode(filepath, attrs \\ %{}) do
ExCnab240.decode(filepath, attrs)
end
def decode!(filepath, attrs \\ %{}) do
ExCnab240.decode!(filepath, attrs)
end
def encode(params, attrs \\ %{}) do
ExCnab240.encode(params, attrs)
end
def encode!(params, attrs \\ %{}) do
ExCnab240.encode(params, attrs)
end
end
end
@doc """
Decode a single file.
This will decode the cnab file applying the correct format to each CNAB 240 template
### Example
import ExCnab240
decode("JVH1234.rem", %{})
{:ok, %{
header: %{
# Content
},
details: %{
# Content
},
footer: %{
# Content
},
additional_info: %{
# Content
}
}}
"""
@callback decode(filepath :: String.t()) :: any
@callback decode(filepath :: String.t(), attrs :: keyword | map) :: any
def decode(filepath, attrs \\ %{}) do
ExCnab.Cnab240.Services.Decode.run(filepath, attrs)
end
def decode!(filepath, attrs \\ %{}) do
ExCnab.Cnab240.Services.Decode.run!(filepath, attrs)
end
@doc """
Encode a single file.
This will encode your params to a one CNAB file applying the correct format to each CNAB 240 template
### Example
import ExCnab240
encode(%{cnab: cnab}, %{filename: "JVH1010101.ret"})
{:ok, %{contnet: "xxx...", filename: "JVH1010101.ret"}}
encode(%{cnab: cnab}, %{})
{:ok, %{contnet: "xxx...", filename: "default.ret"}}
encode!(%{cnab: cnab}, %{filename: "JVH1010101.ret"})
%{contnet: "xxx...", filename: "JVH1010101.ret"}
encode!(%{cnab: cnab}, %{})
%{contnet: "xxx...", filename: "default.ret"}
"""
@callback encode(params :: Map.t()) :: any
@callback encode(params :: Map.t(), attrs :: keyword | map) ::
{:ok, %{filename: String.t(), content: String.t()}}
def encode(params, attrs \\ %{}) do
ExCnab.Cnab240.Services.Encode.run(params, attrs)
end
@callback encode(params :: Map.t()) :: any
@callback encode(params :: Map.t(), attrs :: keyword | map) ::
%{filename: String.t(), content: String.t()}
def encode!(params, attrs \\ %{}) do
ExCnab.Cnab240.Services.Encode.run!(params, attrs)
end
end