@spec new(Bookk.AccountHead.t(), balance :: pos_integer()) :: t()

Creates a new account from a Bookk.AccountHead.

Examples

If no initial balance is provided in the second argument, then balance will be set to zero:

iex> head = fixture_account_head(:cash)
iex> Bookk.Account.new(head)
%Bookk.Account{
  head: fixture_account_head(:cash),
  balance: 0
}

If an initial balance is provided in the second argument, then balance will be set to it:

iex> head = fixture_account_head(:cash)
iex> Bookk.Account.new(head, 50_00)
%Bookk.Account{
  head: fixture_account_head(:cash),
  balance: 50_00
}

@spec post(t(), Bookk.Operation.t()) :: t()

Calculates de delta amount for the operation then adds it the account's balance. See Bookk.Operation.to_delta_amount/1 for more information on delta amount.

Examples

iex> class = %Bookk.AccountClass{natural_balance: :debit}
iex> head = %Bookk.AccountHead{class: class}
iex> account = Bookk.Account.new(head)
iex>
iex> op = debit(head, 25_00)
iex>
iex> Bookk.Account.post(account, op)
%Bookk.Account{
  head: %Bookk.AccountHead{class: %Bookk.AccountClass{natural_balance: :debit}},
  balance: 25_00
}

The account's head must match the head in the operation, otherwise an error is raised:

iex> head_a = %Bookk.AccountHead{name: "a"}
iex> head_b = %Bookk.AccountHead{name: "b"}
iex>
iex> account = Bookk.Account.new(head_a)
iex> op = debit(head_b, 25_00)
iex>
iex> Bookk.Account.post(account, op)
** (FunctionClauseError) no function clause matching in Bookk.Account.post/2