simonmichael/hledger 1.24.99.1

1.24.99.1 (1.25 preview 1)

on GitHub

This is not a full hledger release, just an early preview of the 1.25 release for testers and early adopters. Your testing and feedback will help make the final release better! Preview releases are new in 2022, RELEASING has more details.

Changelog

hledger 1.24.99.1 2022-01-06

Features

• The new --infer-equity flag replaces @/@@ prices in commodity
  conversion transactions with equity postings, making them fully
  balanced and preserving the accounting equation. (When not doing
  cost reporting; --cost/-B overrides and disables --infer-equity.)
  For example, hledger print --infer-equity will show:

  2000-01-01
    a   1 AAA @@ 2 BBB
    b  -2 BBB
  

  as:

  2000-01-01
    a                               1 AAA
    equity:conversion:AAA-BBB:AAA  -1 AAA
    equity:conversion:AAA-BBB:BBB   2 BBB
    b                              -2 BBB
  

  The equity:conversion account name is used by default. You can use
  another account by declaring it with the new Conversion/V
  account type (a subtype of Equity/E), eg:

  account Equity:Currency Conversions   ; type: V
  

• Normalised, easy-to-process "tidy" CSV data can now be generated with --layout tidy -O csv.
  In tidy data, every variable is a column and each row represents a single data point
  (cf https://vita.had.co.nz/papers/tidy-data.html).
  (#1768, #1773, #1775) (Stephen Morgan)

Improvements

• CSV output now always disables digit group marks (eg, thousands separators),
  making it more machine readable by default.
  (#1771) (Stephen Morgan)

Fixes

• ;roi: fixes #1791 (fix TWR when investment=0, several pnls per day) (Dmitry Astapov)

Documentation

• Account aliases' ability to cause malformed account names is noted. (#1788)

• There is a new CONVERSION & COST section, replacing COSTING. (#1554)

hledger-ui 1.24.99.1 2022-01-06

• Use hledger 1.24.99.1

hledger-web 1.24.99.1 2022-01-06

• Use hledger 1.24.99.1

hledger-lib 1.24.99.1 2022-01-06

Improvements

• Costing has been changed to ConversionOp with three options:
  NoConversionOp, ToCost, and InferEquity.
  The first correspond to the previous NoCost and Cost options, while the
  third corresponds to the --infer-equity flag. This converts transactions with costs
  (one or more transaction prices) to transactions with equity:conversion postings.
  It is in ConversionOp because converting to cost with -B/--cost and inferring conversion
  equity postings with --infer-equity are mutually exclusive.
  The cost_ record of ReportOpts has been changed to conversionop_.

• hledger-lib now builds with GHC 9.2 and newer libs (#1774).

• Renamed: CommodityLayout to Layout.
  (Stephen Morgan)

Installing

You can build this prerelease from source (tag 1.24.99.1).
Or, you can try the CI binaries below. Download the appropriate "hledger-PLATFORM.zip" file and unzip it to get 2 or 3 hledger binaries in the current directory. On GNU/Linux, you will need to chmod +x these files to make them executable. They should run on most GNU/Linux machines with x64 or (when provided) arm32v7 architecture. On mac machines, you will need to chmod +x them and then mark them as trusted: in Finder, right-click the file then option-click Open. On windows machines you'll need to do something similar. There is no hledger-ui binary for Windows.