A parser of text that runs in some monad, keeping a Journal as state.

A parser of text that runs in some monad, keeping a Journal as state, that can throw an exception to end parsing, preventing further parser backtracking.

Infer transaction-implied market prices from commodity-exchanging transactions, if any. It's best to call this after transactions have been balanced and posting amounts have appropriate prices attached.

Collect and save inferred amount styles for each commodity based on the posting amounts in that commodity (excluding price amounts), ie: "the format of the first amount, adjusted to the highest precision of all amounts". Can return an error message eg if inconsistent number formats are found.

Apply this journal's commodity display styles to all of its amounts. This does no display rounding, keeping decimal digits as they were; it is suitable for an early cleanup pass before calculations. Reports may want to do additional rounding/styling at render time. This can return an error message eg if inconsistent number formats are found.

Given a list of amounts, in parse order (roughly speaking; see journalStyleInfluencingAmounts), build a map from their commodity names to standard commodity display formats. Can return an error message eg if inconsistent number formats are found.

Though, these amounts may have come from multiple files, so we shouldn't assume they use consistent number formats. Currently we don't enforce that even within a single file, and this function never reports an error.

Get the canonical amount styles for this journal, whether (in order of precedence): set globally in InputOpts, declared by commodity directives, declared by a default commodity (D) directive, or inferred from posting amounts, as a map from symbol to style. Styles from directives are assumed to specify the decimal mark.

Like journalCommodityStyles, but attach a particular rounding strategy to the styles, affecting how they will affect display precisions when applied.

Convert all this journal's amounts to cost using their attached prices, if any.

Add equity postings inferred from costs, where needed and possible. See hledger manual > Cost reporting.

Add costs inferred from equity conversion postings, where needed and possible. See hledger manual > Cost reporting.

Do just the internal tagging that is normally done by journalInferCostsFromEquity, identifying equity conversion postings and, in particular, postings which have redundant costs. Tagging the latter is useful as it allows them to be ignored during transaction balancedness checking. And that allows journalInferCostsFromEquity to be postponed till after transaction balancing, when it will have more information (amounts) to work with.

Reverse all lists of parsed items, which during parsing were prepended to, so that the items are in parse order. Part of post-parse finalisation.

Set this journal's last read time, ie when its files were last read.

Renumber all the account declarations. This is useful to call when finalising or concatenating Journals, to give account declarations a total order across files.

Apply the pivot transformation to all postings in a journal, replacing their account name by their value for the given field or tag.

Keep only transactions matching the query expression.

Keep only postings matching the query expression. This can leave unbalanced transactions.

Keep only postings which do not match the query expression, but for which a related posting does. This can leave unbalanced transactions.

Within each posting's amount, keep only the parts matching the query, and remove any postings with all amounts removed. This can leave unbalanced transactions.

Filter out all parts of this transaction's amounts which do not match the query, and remove any postings with all amounts removed. This can leave the transaction unbalanced.

Filter out all parts of this posting's amount which do not match the query, and remove the posting if this removes all amounts.

Apply a transformation to a journal's transactions.

Apply a transformation to a journal's postings.

Apply a transformation to a journal's posting amounts.

Sorted unique account names posted to by this journal's transactions.

Sorted unique account names implied by this journal's transactions - accounts posted to and all their implied parent accounts.

Sorted unique account names declared by account directives in this journal.

Sorted unique account names declared by account directives or posted to by transactions in this journal.

Sorted unique account names declared by account directives, or posted to or implied as parents by transactions in this journal.

Sorted unique account names declared by account directives in this journal, which have no children.

Convenience/compatibility alias for journalAccountNamesDeclaredOrImplied.

Sorted unique account names declared or implied in this journal which have no children.

Which tags have been declared explicitly for this account, if any ?

Which tags are in effect for this account, including tags inherited from parent accounts ?

Sorted unique payees declared by payee directives in this journal.

Sorted unique payees used by transactions in this journal.

Sorted unique payees used in transactions or declared by payee directives in this journal.

Sorted unique tag names declared by tag directives in this journal.

Sorted unique tag names used in this journal (in account directives, transactions, postings..)

Sorted unique tag names used in transactions or declared by tag directives in this journal.

Sorted unique commodity symbols declared by commodity directives in this journal.

Sorted unique commodity symbols declared or inferred from this journal.

The fully specified exact date span enclosing the dates (primary or secondary) of all this journal's transactions and postings, or DateSpan Nothing Nothing if there are none.

The fully specified date span enclosing the dates (primary and secondary) of all this journal's transactions and postings, or DateSpan Nothing Nothing if there are none.

The earliest of this journal's transaction and posting dates, or Nothing if there are none.

The "exclusive end date" of this journal: the day following its latest transaction or posting date, or Nothing if there are none.

The latest of this journal's transaction and posting dates, or Nothing if there are none.

Unique transaction descriptions used in this journal.

Get the transaction with this index (its 1-based position in the input stream), if any.

Get the transaction that appeared immediately after this one in the input stream, if any.

Get the transaction that appeared immediately before this one in the input stream, if any.

All postings from this journal's transactions, in order.

All posting amounts from this journal, in order.

Show the journal amounts rendered, suitable for debug logging.

Find up to N most similar and most recent transactions matching the given transaction description and query and exceeding the given description similarity score (0 to 1, see compareDescriptions). Returns transactions along with their age in days compared to the latest transaction date, their description similarity score, and a heuristically date-weighted variant of this that favours more recent transactions.

Build a map of all known account types, explicitly declared or inferred from the account's parent or name.

Add a map of all known account types to the journal.

To all postings in the journal, add any tags from their account (including those inherited from parent accounts). If the same tag exists on posting and account, the latter is ignored.

The account to use for automatically generated conversion postings in this journal: the first of the journalConversionAccounts.

All the accounts declared or inferred as Conversion type in this journal.

Given a list of amount styles (assumed to be from parsed amounts in a single commodity), in parse order, choose a canonical style.

Merge two journals into one. Transaction counts are summed, map fields are combined, the second's list fields are appended to the first's, the second's parse state is kept.

Number (set the tindex field) this journal's transactions, counting upward from 1.

Untie all transaction-posting knots in this journal, so that eg recursiveSize and GHCI's :sprint can work on it.

Apply any transaction modifier rules in the journal (adding automated postings to transactions, eg). Or if a modifier rule fails to parse, return the error message. A reference date is provided to help interpret relative dates in transaction modifier queries. The first argument selects whether to add visible tags to generated postings & modified transactions.

Apply some account aliases to all posting account names in the journal, as described by accountNameApplyAliases. This can fail due to a bad replacement pattern in a regular expression alias.

Debug log the ordering of a journal's account declarations (at debug level 5+).