This is the entry point to hledger's reading system, which can read
Journals from various data formats. Use this module if you want to parse
journal data or read journal files. Generally it should not be necessary
to import modules below this one.

Journal reading API

Get the default journal file path specified by the environment.
Like ledger, we look first for the LEDGER_FILE environment
variable, and if that does not exist, for the legacy LEDGER
environment variable. If neither is set, or the value is blank,
return the hard-coded default, which is .hledger.journal in the
users's home directory (or in the current directory, if we cannot
determine a home directory).

Read a Journal from this file (or stdin if the filename is -) or give
an error message, using the specified data format or trying all known
formats. A CSV conversion rules file may be specified for better
conversion of that format.

Parsers used elsewhere

Parse an account name. Account names may have single spaces inside
them, and are terminated by two or more spaces. They should have one or
more components of at least one character, separated by the account
separator char.