ledger: Fix --output-format default help.

This was accidentally carried over from accrual-report.

reports: Add PeriodPostings class.

This is AccountPostings from the ledger report, cleaned up to be more
general.

reports: Add sort_and_filter_accounts() function.

Extracted from the ledger report.

tests: Add tests for Balance.copy() tolerance handling.

I wrote the changes to Balance.format() before the dependent changes to
Balance.copy(), so I was sort of counting on them to be implicitly
tested. But they should be explicit.

reports: Balance.format() accepts zero argument.

This change has the same motivation as the recent change to
BaseODS.balance_cell(): try to preserve currency information when it's
available.

ledger: Remove obsoleted hack.

This is no longer necessary now that the plugin enforces proper project
metadata on Equity accounts.

ledger: Correct period totals. RT#11661.

The period totals were reporting the balance of all the loaded postings, not
just the ones in the reporting date range.

Like the accrual report, introduce a RelatedPostings subclass that records
and saves all the information we need at group definition time, to help us
get it consistently right rather than redoing the same math over and over.

accrual: Change args.since default.

This default makes more since with the way we're going to stop having
opening balances in open books.

accrual: Generate an aging report in more cases.

Default to generating an aging report unless the user searched for a
specific RT ticket or invoice.

meta_project: Force the default project on Equity accounts.

See rationale in comments.

reports: Add BaseODS.column_style() method.

Use this to provide more consistent column styles throughout the reports.

config: Get repository directory from config file.

One less thing users have to fiddle with to get set up.

ledger: Change default report dates.

The old defaults were optimized for the audit report.
The new defaults provide more helpful ad hoc reports.
The latter will be run more often and more quickly, so it's
worth optimizing the defaults for them.

cliutil: Add date_arg() function.

Meant to be used as an argument type.

data: bank-statement and tax-statement are link metadata.

Not including them earlier was an oversight.

data: Add Metadata.report_links() method.

This is just a variant of get_links() that eats TypeError.
Higher-level reporting code often wants it.

reports: BaseODS.currency_cell() sets default style.

It'll be rare we don't want this.

ranges: Start module.

The ledger report wants to use this functionality, so make it available in a
higher-level module.

I took the opportunity to clean up a lot of the surrounding type
declarations. It is less flexible, since it relies on the static list of
types in RangeT, but I don't think the other method actually worked at all
except by cheating with generic Any.

accrual: Aging report is written to repository path by default.

Opening it here is necessary for repository links to work anyway.

accrual: Aging report uses RT short links for all RT link text.

Per user request. This is better than saying "Display.html" everywhere.

cliutil: Add make_entry_point() function.

This provides better logging setup, reduces the amount of boilerplate in
main, and replaces is_main_script().

accrual: Clean up types and imports.

Mostly I wanted to write the documentation about groups, and then
I kept pulling the thread.

accrual: Actually use RT caching as intended.

Basically none of the reports were reading or writing the RT link cache
because they didn't instantiate an rtutil.RT properly to do that.

accrual: Add AccrualPostings.rt_id property.

This is like the existing attributes, but it only supports the outgoings
report, so don't build it at __init__ time.

reports: Add RelatedPostings.first_meta_links() method.

Basically moving this from AccrualPostings into the superclass.

reports: RelatedPostings.all_meta_links() returns an iterator.

This preserves order.

accrual: Remove the consistency checker.

Everything it said was a problem has been done legitimately in our books at
one point or another.

* Variation in contract can happen in different line items of an invoice or
"group of contractor" situations.

* Variation in cost can happen because one invoice spans a period of time,
like donation matching programs. There is probably still value in a tool
that checks to make sure we use consistent rates each day, but that
affects all kinds of transactions, not just accruals, so it would be
done better in a separate tool.

* Variation in account happens because invoices legitimately span accrual
accounts, like donation matching programs with fees payable.

So: it's gone, good riddance.

accrual: Add columns to the aging report. RT#11439.

This adds almost all the metadata that's relevant to accruals.
I considered adding statement, but that cuased rows to get spaced out a lot,
and statement's kind of a low-value column, so I decided against it.

Ultimately I would like to make this configurable but that's for the
future.

accrual: More detailed text for "total aged" lines in aging report.

Per bkuhn's request.

accrual: Aging report uses group since last nonzero. RT#11600.

This makes it consistent with our other reports. The fact that it wasn't
already was basically an oversight.

reports: Balance.__init__ better handles multiple amounts of same currency.

This is something that should've happened with 3d704e286
but I didn't think of it at the time.

reports: Add Balance.__pos__() method.

I did this while I was working on normalize_amount_func.
It turns out it's not immediately needed, but it's still nice to have.

cliutil: Add generalized SearchTerm class.

This makes the same filtering easily available to other reporting tools for
consistency.

accrual: Outgoing report uses first rt-id as primary ticket number.

This makes it consistent with the reporting and our general rule
that the first link is primary.

accrual: Make accruals consistent by entity on the accrual side.

It is more common than I realized that we split an invoice by
entity on the accrual side, so this supports that better.

It still disregards inconsistency between accrual entity and payment entity
for reporting purposes, to help keep reporting clean around automatic
imports.

The changes to BaseReport._report shook out because at this point, the group
key is effectively arbitrary and shouldn't be used for any reporting
purposes.

accrual: Load all books since args.since.

This lets the tool find and report accruals in the future.

accruals: AccrualPostings only reports inconsistent cost per currency.

Of course if an accrual has multiple currencies, it'll probably have
different costs, and that's fine.

reports: Balance is initialized with just amounts.

This works fine with how we're currently using it, makes transformation
methods easier to implement, and avoids potential bugs where a balance is
initialized with a bad mapping.

accrual: Filter opening balance txn before main reporting.

So far we've been implicitly relying on this by the user passing search
terms that filter out the opening balance transaction. That will stop
happening with the aging report, so we need to do it ourselves.

accrual: Add AccrualPostings.make_consistent() method.

This will help the aging report better render dirty data.

reports: Make RelatedPostings an immutable data structure.

This was an early mistake, it makes data consistency mistakes too
easy, and I only used it once so far in actual code. Going to fix
this now so I can more safely build on top of this data structure.

cliutil: Better implementation of is_main_script.

The old one could return True if you called accrual.main()
directly from one-off test scripts.