simonmichael/hledger 1.42.1

on GitHub

hledger 1.42.1

Fixes

• Fix a regression in the parsing of single ampersands (&) in csv rules.
  (Thomas Miedema, #2352)

• The run and repl commands no longer cache data wrongly when using the --forecast option.
  (Dmitry Astapov, #2345)

• The run and repl commands no longer miss a caching opportunity when using --forecast with a period argument.
  (Stephen Morgan)

• run, repl: doc fixes (Pranesh Prakash, Simon Michael)

hledger-ui 1.42.1

• Allow vty 6.4.

hledger-web 1.42.1

project changes 1.42.1

Infrastructure/Misc

• Tools updates

• Fix cabalfilestest: test all cabal files before any hackage upload.

credits 1.42.1

Simon Michael (@simonmichael),
Dmitry Astapov (@adept),
Pranesh Prakash (@the-solipsist),
Stephen Morgan (@Xitian9),
Thomas Miedema (@thomie).

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.

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

eget simonmichael/hledger --all

Otherwise:

At the command line:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.1/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.1

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.1/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.1

On Intel macs:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.1/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.1

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.1/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.1; 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.)

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.1
• 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.