Hledger.Data.Journal

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 P directive amounts, posting amounts but not cost amounts, and maybe the last D amount, in that commodity. 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.

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.

Identify and tag (1) equity conversion postings and (2) postings which have (or could have ?) redundant costs. And if the addcosts flag is true, also add any costs which can be inferred from equity conversion postings. This is always called before transaction balancing to tag the redundant-cost postings so they can be ignored. With --infer-costs, it is called again after transaction balancing (when it has more information to work with) to infer costs from equity postings. See transactionTagCostsAndEquityAndMaybeInferCosts for more details, and hledger manual > Cost reporting for more background.

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.

To all postings in the journal, add any tags from their account (including those inherited from parent accounts). If a tag already exists on the posting, it is not changed (the account tag will be ignored).

Remove all tags from the journal's postings except those provided by their account. This is useful for the accounts report. It does not remove tag declarations from the posting comments.

To all postings in the journal, add any tags from their amount's commodities. If a tag already exists on the posting, it is not changed (the commodity tag will be ignored).

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.

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 ?

Get any tags declared for this commodity.

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.

All raw amounts appearing in this journal, with MixedAmounts flattened, in no particular order. (Including from posting amounts, cost amounts, P directives, and the last D directive.)

All posting amounts from this journal, in order.

All raw amounts used in this journal's postings and costs, with MixedAmounts flattened, in parse order.

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

Sorted unique commodity symbols used anywhere in this journal, including commodity directives, P directives, the last D directive, posting amounts and cost amounts.

Sorted unique commodity symbols mentioned anywhere in this journal. (Including commodity directives, P directives, the last D directive, posting amounts and cost amounts.)

Sorted unique commodity symbols mentioned in this journal's P directives.

Sorted unique commodity symbols used in transactions, in either posting or cost amounts.

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.

Show the journal posting 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.

The account name to use for conversion postings generated by --infer-equity. This is the first account declared with type V/Conversion, or otherwise the defaultBaseConversionAccount (equity:conversion).

All the accounts in this journal which are declared or inferred as V/Conversion type. This does not include new account names which might be generated by --infer-equity, currently.

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 7+).