Tackler 25.05.1 released

release
10 May 2025
Quickstart with 25.05.1
cargo install --locked tackler
tackler new journal
tackler --config journal/conf/tackler.toml

See Journal Format, tackler.toml, accounts.toml, commodities.toml and tags.toml for full documentation.

Release Highlights

Semantic change with input.git.dir and input.git.ext

This releases fixes the functionality of input.git.dir and input.git.ext so that it is identical how input.fs.dir and input.fs.ext work.

+ With previous releases of tackler, input.git.dir and input.git.ext acted as a glob pattern (prefix and suffix). Now input.git.dir will match the full directory name (no glob at the end) and input.git.ext will match the full extension of the filename (no prefix glob).

New features

  • New output format JSON

    • Optional configuration key report.formats to specify output formats.

    • New optional CLI argument --formats to select report formats

Changes

  • Git SCM Storage

    • Enforce that input.git.dir is matched as a directory (not as a glob)

    • Enforce that input.git.ext is matched as a file extension (not as a glob)

  • Add account selectors as text into Account Selector Checksum metadata

  • Change and Add more information to the "Git Storage" metadata

    • New fields: "author", "date"

    • Fix name of "message" to "subject" (the content of that field has been git subject all the time)

    • Change field "suffix" to "extension", don’t print the '.'

    • Change the order of fields (move commit after extension)

  • Change default allocator

    • Replace tikv-jemallocator with mimalloc

      • Mimalloc is available on Linux, Windows and MacOS

      • It’s about 20% faster on Linux and Windows, but on MacOS difference is only about 5%

      • Memory usage increases about 30% an all platforms

  • Reject unknown configuration keys

  • Add new default configuration key ext for suffix (for both fs and git storage). Old config wiht suffix key is still supported.

  • Add new CLI option --input.fs.path

    • Change the semantics of --input.fs.dir, it’s now path inside journal (under --input.fs.path) This is now symmetrical how --input.git.repo and --input.git.dir behave

  • Allow overriding storage options from CLI without full storage configuration

Test coverage

Tackler-ng is tested with 436 of tracked test vectors at the moment.

Published artifacts

Tackler-ng artifacts are published in crates.io.

Component Version

Tackler CLI

25.5.1

tackler-core

0.11.0

tackler-api

0.10.0

tackler-rs

0.10.0

Changelog

For full changelog, see Tackler-ng CHANGELOG

Tackler-ng 25.04.2 released

release
08 Apr 2025

Tackler-ng is new implementation of tackler, done in Rust.

Quickstart with 25.04.2
cargo install --locked tackler
tackler new journal
tackler --config journal/conf/tackler.toml

See Journal Format, tackler.toml, accounts.toml, commodities.toml and tags.toml for full documentation.

Release Highlights

Tackler’s Balance family reports produce more information than what you find in other PTA tools.

The default Balance and Balance Group calculate sums for all accounts which have postings, but also for all children (aka account tree balance). In some cases this information of children balances is not needed.

This release introduce a new Flat Balance report type, which calculates simpler balance report just for accounts.

New features

Changes

  • New optional configuration key report.balance.type and report.balance-group.type, default is tackler’s original balance report type tree.

Test coverage

Tackler-ng is tested with 417 of tracked test vectors at the moment.

Published artifacts

Tackler-ng artifacts are published in crates.io.

Component Version

Tackler CLI

25.4.2

tackler-core

0.10.0

tackler-api

0.9.1

tackler-rs

0.9.0

Changelog

For full changelog, see Tackler-ng CHANGELOG

Tackler-ng 25.04.1 released

release
04 Apr 2025

Tackler-ng is new implementation of tackler, done in Rust.

Quickstart with 25.04.1
cargo install --locked tackler
tackler new journal
tackler --config journal/conf/tackler.toml

# New Commodity Price Support feature
tackler \
    --config journal/conf/tackler.toml \
    --reports balance \
    --price.lookup-type last-price

See Journal Format, tackler.toml, accounts.toml, commodities.toml and tags.toml for full documentation.

Release Highlights

New features

Fixes and Changes

  • Improved error messages when invalid journal syntax is used

  • Don’t accept invalid CLI input arg combinations

  • Warn if exports are used without CLI output arguments

  • Enforce blank line between transactions (Tackler-Mk1 / ANTLR)

  • Print error message if repository contains links (Tackler-Mk1)

  • Print error message if transaction set is empty (Tackler-Mk1)

  • Equity Export: Check equity account name when strict mode is on (Tackler-Mk1)

Test coverage

Tackler-ng is tested with 408 of tracked test vectors at the moment.

Published artifacts

Tackler-ng artifacts are published in crates.io.

Component Version

Tackler CLI

25.4.1

tackler-core

0.9.0

tackler-api

0.9.0

tackler-rs

0.9.0

Changelog

For full changelog, see Tackler-ng CHANGELOG

Special Mention

Thank you RagibHasin for contributing and helping with Commodity Price Support feature (#36 and TEP-1015))!

Tackler-ng 25.01.1 released

release
19 Jan 2025

Tackler-ng is new implementation of tackler, done in Rust.

Quickstart with 25.01.1
cargo install --locked tackler
tackler new journal
tackler --config journal/conf/tackler.toml

See Journal Format, tackler.toml, accounts.toml, commodities.toml and tags.toml for full documentation.

Release Highlights

New features:

  • New tackler commands new and init

    • Command new <name> will create a new journal setup name

    • Command init will initialize a new journal under the current location

  • This release is 2-3x faster, now tackler can process 120_000 - 250_000 txn/s on modern laptop

Changed functionality:

  • Replaced ANTLR based Txn parser with winnow parser combinator

    • This is affecting how invalid journal syntax is reported

    • This has no changes to journal syntax

  • Replaced time and time-tz with jiff

    • This have some user visible changes, e.g. 'Z' is replaced with '+00:00'

    • Txn Filters, Txn Timestamp: Begin and End are displayed with report timezone

Test coverage

Tackler-ng is tested with 310 of tracked test vectors at the moment

Published artifacts

Tackler-ng artifacts are published in crates.io.

Component Version

Tackler CLI

25.1.1

tackler-core

0.8.0

tackler-api

0.8.0

tackler-rs

0.8.0

Changelog

All current and future development is based on Tackler-ng code base.

For full changelog, see Tackler-ng CHANGELOG

Tackler-ng 24.12.2 released

release
26 Dec 2024

Tackler-ng is new version of tackler, reimplemented in Rust. Tackler-ng will be the basis of all future development of Tackler.

Release Highlights

New features:

  • Git Backend: Add support for revspecs with --input.git.ref

  • Add support for new storage keys

    • input.fs.path, path to top level fs-storage location

    • input.git.repo, alias for input.git.repository

Fixes in this release:

  • Git Backend: When opening the repo, use exact location, and don’t search upwards on the directory tree

  • Implement Tackler-Mk1 and JDK compatible full string (haystack) regex matcher. This change is affecting Account Selectors which use regex.

Test coverage

Tackler-NG is tested with 306 of tackler’s test vectors at the moment

  • by 112 Tackler test vectors

  • by 194 tracked unit tests

See Journal Format, tackler.toml, accounts.toml, commodities.toml and tags.toml for tackler-ng configuration.

Published artifacts

Tackler-ng artifacts are published in crates.io.

Component Version

Tackler CLI

24.12.2

tackler-core

0.7.0

tackler-api

0.7.0

tackler-rs

0.7.0

Changelog

For full changelog, see CHANGELOG in Tackler-ng repository.

Tackler-ng 24.12.1 released

release
10 Dec 2024

Tackler-ng is new version of tackler, reimplemented in Rust. Tackler-ng will be the basis of all future development of Tackler.

Release Highlights

New features:

  • Add CLI option

    • --input.git.commit

Fixes in this release:

  • Register report: Use Tackler-MkI compatible output

  • Fix broken --group-by cli option (clap definition)

  • Print location with full precision (with trailing zeros)

Test coverage

Tackler-NG is tested with 284 of tackler’s test vectors at the moment

  • by 100 Tackler test vectors

  • by 184 tracked unit tests

See Journal Format, tackler.toml, accounts.toml, commodities.toml and tags.toml for tackler-ng configuration.

Published artifacts

Tackler-ng artifacts are published in crates.io.

Component Version

Tackler CLI

24.12.1

tackler-core

0.6.0

tackler-api

0.6.0

tackler-rs

0.6.0

Changelog

For full changelog, see CHANGELOG in Tackler-ng repository.

Tackler-ng 24.11.2 released

release
24 Nov 2024

Tackler-NG is rusty version of tackler, e.g. tackler reimplemented in Rust. This will be the basis of all future development of Tackler.

Release Highlights

This is the first official release of Tacker-NG.

  • Add more CLI options

    • --output.dir

    • --output.prefix

    • --strict.mode

  • Add support for export.targets in configuration.

Test coverage

  • 36 of the most essential Tackler test vectors are converted to the new code base

  • 119 of tracked (T3DB) Unit tests have been implemented for the new code base

See Journal Format, tackler.toml, accounts.toml, commodities.toml and tags.toml for tackler-ng configuration.

Published artifacts

Tackler-ng artifacts are published in crates.io.

Component Version

Tackler CLI

24.11.2

tackler-core

0.5.0

tackler-api

0.5.0

tackler-rs

0.5.0

Changelog

For full changelog, see CHANGELOG in Tackler-ng repository.

Tackler-ng 24.11.1 released

release
17 Nov 2024

Tackler-NG is rusty version of tackler, e.g. tackler reimplemented in Rust.

Release Highlights

Tackler-NG has rough feature parity with the old Scala based codebase with this 24.11.1 release.

New features

How to test Tackler-NG

Building tackler

At the moment, there isn’t any precompiled binaries available, so:

If you don’t have Rust installed in your system, get it:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then get the source code and test vectors:

git clone --recurse-submodules https://github.com/tackler-ng/tackler

cd tackler

# select the release
git checkout v24.11.1

# Build tackler
cargo build --release --locked --bin tackler
# Quick verification of the compiled binary
target/release/tackler --version

Testing tackler

# Simple example with Filesystem storage
target/release/tackler --config examples/simple.toml

# Complex example with Git storage and Audit mode
target/release/tackler --config examples/audit.toml

Published artifacts

Tackler-ng artifacts are published in crates.io.

Component Version

Tackler CLI

24.11.1

tackler-core

0.4.0

tackler-api

0.4.0

tackler-rs

0.4.0

Changelog

For full changelog, see CHANGELOG in Tackler-ng repository.

Tackler 22.12.2 released

release
29 Dec 2022

New features and changes in this release:

This is a re-release of Tackler CLI 22.12.1 with correct assembly packaging. No other changes.

Fixes

22.12.1 had broken logger functionality for tackler-cli. The broken functionality is manifested by following error message:

SLF4J: No SLF4J providers were found.
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See https://www.slf4j.org/codes.html#noProviders for further details.

This release (22.12.2) fixes that.

Component Version

Tackler CLI

22.12.2

tackler-core

no changes

tackler-api

no changes

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-22.12.2.jar.asc

3ac13c3a93d2299a8c134b0e3518c49da5997de479a89a8c05b77dcff45083f3  tackler-cli-22.12.2.jar

Tackler 22.12.1 released

release
28 Dec 2022

New features and changes in this release:

This is a re-release of Tackler 22.12.0 with JDK 11. No other changes.

Fixes

Tackler 22.12.0 was released accidentally with JDK 17 (Bytecode Version 61.0), instead of JDK 11 (Bytecode Version 55.0). Hence this re-release with JDK 11.

Component Version (JDK 11) Version (JDK 17)

Tackler CLI

22.12.1

22.12.0

tackler-core

1.0.1

1.0.0

tackler-api

1.0.1

1.0.0

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-22.12.1.jar.asc

87480c243f635ed475e63862a5089be1b7e95adf2ed94371bba778ae58fe9e01  tackler-cli-22.12.1.jar

Tackler 22.12.0 released

release
27 Dec 2022

New features and changes in this release:

There is new versioning scheme (YY.MM.PATCH) for Tackler CLI, where YY and MM are release year and month. Also tackler-core and tackler-api has been released as versions 1.0.0.

Other changes in this release:

  • Tackler requires at least Java 11 to run

  • Upgrade JGit to 6.4.0

  • Deprecations

    • Drop support for Scala 2.12

    • Drop support for Java 8

Fixes

None

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-22.12.0.jar.asc

fb387c75ad6b295f22aaa087fa91595e5f0cea79b850a8ad347c2d239d68b785  tackler-cli-22.12.0.jar

Tackler 0.35.0 released

release
07 Mar 2021

New features and changes in this release:

New features and changes in this release:

  • TEP-1014: Equity Export Enhancements

    • Cfg key to set equity transaction’s target account

    • Print out actual value for equity posting - don’t use implicit (last posting’s empty) value for it

    • Print out warning, if equity transaction zeros out without equity posting

    • Indent equity transaction same amount as identity export (3 spaces)

Fixes

None

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.35.0.jar.asc

91cf23dee0c59c9f42db7fb39a84fdfe6cbd4d07204b4eb62b5ea4bb3de56f83  tackler-cli-0.35.0.jar

Tackler 0.34.0 released

release
02 Jan 2021

New features and changes in this release:

New features and changes in this release:

Fixes

None

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.34.0.jar.asc

e8c1cb57e9f7f00bc35e39f1076193156c4f8a03714fdcb9d72bf16635e7d43d  tackler-cli-0.34.0.jar

Tackler 0.33.0 released

release
20 Dec 2020

New features and changes in this release:

New features and changes in this release:

Noteworthy build and dependency upgrades:

  • Scala-JS: 1.x (1.3.1)

  • jgit: 5.10.0.202012080955-r

  • slf4j-api: 1.7.30

Fixes

None

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.33.0.jar.asc

6e310865c99a8d1d82e1f426ab56470b93d092bdaeffe77c49814c4235155f7b  tackler-cli-0.33.0.jar

Tackler 0.32.0 released

release
22 Sep 2019

New features and changes in this release:

New features and changes in this release:

  • Support for Scala 2.12 and 2.13

  • CLI: Raport Git commit id and working copy state with version info for --help and --version commands

Fixes

  • Reject semantically wrong negative unit costs (e.g. { -2 € }) and unit prices (e.g. @ -2 €)

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.32.0.jar.asc

cd3edf5b53852865c610daaaa0adf7fc9be9bf1c60c408fe8d960ed2648409ef  tackler-cli-0.32.0.jar

Tackler 0.31.0 released

release
07 May 2019

New features and changes in this release:

New features and changes in this release:

Fixes

  • Reject "identity" (e.g. 1 € @ 2 €) value positions as invalid construct

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.31.0.jar.asc

8145ef5e1a7bbf0a790375e3d2c2f86bc38482cecef4f4c406ebc08bedb3a05e  tackler-cli-0.31.0.jar

Tackler 0.30.0 released

release
22 Apr 2019
Phase 2 (full) support for Journal Format Version v2
Transaction description

description must start with ' -prefix
Transaction code

code can not contain ' ( ) [ ] { } < > characters
Transaction metadata (uuid)

metadata must start by # character with space

New features and changes in this release:

Fixes

  • Account and Commodity Names: Accept signs which were left unintentionally outside in the cold

    • Currency symbols $, ¢, £, ¤, ¥ from Latin-1 Base and Supplement blocks

    • Micro and Degree (µ, °) from Latin-1 Supplement block

    • Vulgar Fractions (¼, ½, ¾) from Latin-1 Supplement block

    • Superscripts (¹, ², ³) from Latin-1 Supplement block

See Charset document for full list of supported language, scripts and signs as account name characters (there are over 130 supported Unicode code blocks).

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.30.0.jar.asc

d658cdd710add125806e8cfe6afbe28fba129f12f7af47127ad7b451542f6fb3  tackler-cli-0.30.0.jar

Tackler 0.24.0 released

release
23 Mar 2019
Phase 1 support for new Journal Format Version v2
Transaction description

in v2, description must start with ' -prefix
Transaction code

in v2, code can not contain ' ( ) [ ] { } < > characters
Transaction metadata (uuid)

in v2, metadata must start by # character with space

This release has Phase 1 support for new Journal Format Version v2. This means that it will accept both old deprecated version v1 and new version v2 of journal format. All exports (Equity and Identity) are in new v2 format.

Support for old Journal Format Version v1 will be dropped in future release of Tackler.

New features and changes in this release are:

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.24.0.jar.asc

960bd089235cece7bd63dc0c476f86460b96314dd03cb8007389eae78e2506ad  tackler-cli-0.24.0.jar

Tackler 0.23.0 released

release
24 Feb 2019

New features

Generator:

  • Versions v0.4.0 and v0.4.1

  • Add uuid to test corpus transactions

  • Add 1E1 and 1E2 test sets

  • Update build and deps

Fixes

Reject invalid UUIDs which were permitted in the past. There are certain way invalid and malformed UUIDs, which are accepted by JDK.

This could change old valid journal to invalid, if journal contains these specially way invalid UUIDs.

See following openjdk bugs for details:

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature

tackler-cli-0.23.0.jar.asc

Tackler 0.22.0 released

release
28 Jan 2019

New features

  • Strict validation of commodities and currencies. This is turned on by default, if accounts.strict = true. See accounts.conf for how to configure this.

  • Improve error messages in case of parse and logic errors (filename, lines, etc.)

  • Reports

    • Register report: Add separator between txn entries

Fixes

Force UTF-8 always on console, regardless of console settings. This is needed for Windows/MinGW/MSYS2.

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.22.0.jar.asc

d37824fa0edb7fe87a186bcefb12f9aa967ade75a3a3318b941ab1102ec90da0  tackler-cli-0.22.0.jar

Tackler 0.21.0 released

release
20 Jan 2019

New features

Fixes

  • Fix failing test: e257/accounting/tackler#1

Full Changelog

For full changelog, see CHANGELOG in tackler’s repository.

Signature & SHA-256

tackler-cli-0.21.0.jar.asc

21012aed3a7e98d8496660f83da3e2fdb8d4006acc625da2c2704f2d60e04a92  tackler-cli-0.21.0.jar

Tackler 0.9.0 released

release
22 Jan 2018

Release of version v0.9.0

  • New Client API

    • tackler-cli.jar is published on Maven Central Repository

Tackler 0.8.0 released

release
07 Dec 2017

Release of version v0.8.0

  • New Server API

    • tackler-core.jar is published on Maven Central Repository