Skip to content

1.42.2

Compare
Choose a tag to compare
@simonmichael simonmichael released this 16 May 23:48
· 540 commits to master since this release
1.42.2

Release notes

hledger 1.42.2

Fixes

  • The test command can pass options to tasty again (this broke in 1.42).
    Also, any arguments before -- are now passed to tasty as test-selecting -p options.
    #2386

  • Require extra >= 1.7.11, fixing the stack8.10.yaml build. (Thomas Miedema)

Docs

  • CSV encoding: fix inaccurate list of encoding names. #2354
  • Fix broken links to "Commodity display style". (Simon Michael, J.B. Rainsberger hledger_site#132)
  • Misc. edits/fixes: beancount output, commands list, balance command, hledger-iadd link, csv tutorial link

hledger-ui 1.42.2

Fixes

  • Require fsnotify-0.4.2.0+/hfsevents-0.1.8+, which fixes some events
    being ignored on mac (see luite/hfsevents#19),
    which should help hledger-ui --watch a little.

  • Require extra >= 1.7.11, fixing the stack8.10.yaml build. (Thomas Miedema)

Docs

  • Update --watch notes
  • Drop obsolete Windows non-support note

hledger-web 1.42.2

Fixes

  • Don't hang when saving a large file (this broke in 1.42). #2389

  • Require extra >= 1.7.11, fixing the stack8.10.yaml build. (Thomas Miedema)

project changes 1.42.2

Docs

  • relnotes: fix links to hackage changelogs

credits 1.42.2

Simon Michael (@simonmichael),
Thomas Miedema (@thomie).

Install

For all install options, see hledger.org: Install.
You can install hledger from most package managers (but check for a green badge indicating it's up to date).
Or you can build it from source yourself.

Or you can install up to date binaries from this page, by following the appropriate instructions below.
If you find problems with these instructions, please let us know.

All platforms

If you have eget, that's a convenient way to download the right binaries for your machine:

eget simonmichael/hledger --all

Otherwise:

GNU/Linux, 64-bit Intel

At the command line:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.2/hledger-linux-x64.tar.gz
tar xzf hledger-linux-x64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version    # should show 1.42.2

Mac, 64-bit ARM or Intel

In a terminal window (don't use your web browser to download, it won't authorise the binaries):

On ARM macs:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.2/hledger-mac-arm64.tar.gz
tar xzf hledger-mac-arm64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version    # should show 1.42.2

On Intel macs:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.2/hledger-mac-x64.tar.gz
tar xzf hledger-mac-x64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version    # should show 1.42.2

Windows, 64-bit ARM or Intel

In a powershell window (press WINDOWS-R, powershell, ENTER):

  1. Make a place to keep installed binaries. You only need to do this once, not for every release:

    mkdir -force $HOME\bin >$null
    $ENV:PATH += ";"+$HOME+"\bin"
    [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)
    
  2. Download and install the release binaries:

    cd $HOME\bin
    curl https://github.com/simonmichael/hledger/releases/download/1.42.2/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
    Expand-Archive hledger-windows-x64.zip -DestinationPath . -Force
    cd $HOME
    hledger --version; hledger-ui --version; hledger-web --version    # should show 1.42.2; if not, check why: where.exe hledger
    
  3. Ensure a default journal file exists, and without a problematic encoding.
    This will allow you to start hledger-web by double-clicking on its icon if you wish.

    out-file -append -encoding ascii $HOME/.hledger.journal
    

    (I'm not sure why "ascii" is needed here - hledger likes utf8 and understands utf8 BOM headers,
    but the state of our unicode support on Windows
    is really unknown, your feedback is welcome.)

Windows 7, 64-bit Intel

These instructions have not been tested recently, please let us know if they work for you:

  • click hledger-windows-x64.zip below
  • choose Open with Windows Explorer, OK
  • click Extract all files
  • choose a destination folder - ideally one that appears in echo %PATH%, like C:\Windows (though that one will require administrator permission); otherwise, your home directory (C:\Users\YOURNAME)
  • check "Show extracted files when complete"
  • click Extract, wait for the destination folder to open
  • find the hledger, hledger-web icons (if you extracted to \Windows, you'll need to scroll down)
  • for each icon: double-click, uncheck "Always ask before opening this file", click Run
  • close those Explorer windows
  • open a command window (press Windows-r, type CMD, press enter)
  • hledger --version; hledger-ui --version; hledger-web --version should show 1.42.2
  • echo # >> .hledger.journal to ensure a default journal file exists. (Important: the doubled >> is needed to avoid overwriting existing data.)

Problems:

  • Starting hledger by double-clicking its icon won't work because it needs arguments; run it from the command window instead.
  • Starting hledger-web by double-clicking its icon may fail eg because Explorer's command window is too small;
    configure that to be larger, or run hledger-web from a command window instead.
  • hledger or hledger-web may fail to run if there is not enough memory available.

Next steps

Once installed, run hledger, and perhaps read hledger.org: Quick start.