python3Packages.beancount: 2.3.6 -> 3.1.0

[alapshin]

Add package for beancount v3
Add package for beangulp as a replacement for beancount.ingest
Update package for beanquery to use snapshot version that using TatSu-LTS dependency: beancount/beanquery#226
Update fava to version 1.30.1 which supports both beancount2 and beancount3.

Things done

• Built on platform(s)
  • x86_64-linux
  • aarch64-linux
  • x86_64-darwin
  • aarch64-darwin
• For non-Linux: Is sandboxing enabled in nix.conf? (See Nix manual)
  • sandbox = relaxed
  • sandbox = true
• Tested, as applicable:
  • NixOS test(s) (look inside nixos/tests)
  • and/or package tests
  • or, for functions and "core" functionality, tests in lib/tests or pkgs/test
  • made sure NixOS tests are linked to the relevant packages
• Tested compilation of all packages that depend on this change using nix-shell -p nixpkgs-review --run "nixpkgs-review rev HEAD". Note: all changes have to be committed, also see nixpkgs-review usage
• Tested basic functionality of all binary files (usually in ./result/bin/)
• 25.05 Release Notes (or backporting 24.11 and 25.05 Release notes)
  • (Package updates) Added a release notes entry if the change is major or breaking
  • (Module updates) Added a release notes entry if the change is significant
  • (Module addition) Added a release notes entry if adding a new NixOS module
• Fits CONTRIBUTING.md.

---

Add a 👍 reaction to pull requests you find important.

[SharzyL]

I am not using v3 currently. How is it working with existing tools now?

[alapshin]

I am not using v3 currently. How is it working with existing tools now?

I used v3 for the last 6 months, and it works ok for me. However, I don't use any custom importers based on beancount.ingest which is the main breaking change, and input my expenses by hand. Until recently, Fava didn't support v3, but now it does: beancount/fava#1831

Overall, I think it is in good enough shape for everyday use, but it depends on your setup.

[SharzyL]

It would be nice to have v3 in nixpkgs. But since there are major incompatibilities between v2 and v3, and v2 is still widely used, I would like to keep both v2 and v3 in nixpkgs, i.e. beancount and beancount3. Otherwise users may find their tools broken after an upgrade. When v2 is marked as deprecated, we can add warnings in nixpkgs and later replace beancount with beancount3.

[alapshin]

Ok, makes sense. I reworked PR: added separate package for beancount3 and support for building fava with either version. This way user can specify beancount = beancount3 via overlay and use it everywhere.

[dotlambda]

The commit message needs to be adapted. I suggest

• python313Packages.beancount: 2.3.6 -> 3.1.0
• python313Packages.beancount_2: init at 2.3.6

[dotlambda]

Also updated beanprice 2.0 which require beancount >= 3, but because v3 is default now it works.

It might make sense to set meta.broken = lib.versionOlder beancount.version "3"

[alapshin]

Added comment in beanquery package explaining choice of snapshot version.

addressed

[dotlambda]

nixpkgs-review result

Generated using nixpkgs-review.

Command: nixpkgs-review pr 371541

---

x86_64-linux

⏩ 1 package blacklisted:

• nixos-install-tools

✅ 37 packages built:

• beancount (python312Packages.beancount)
• beancount.dist (python312Packages.beancount.dist)
• beancount_2 (python312Packages.beancount_2)
• beancount_2.dist (python312Packages.beancount_2.dist)
• beanprice
• beanprice.dist
• beanquery (python312Packages.beanquery)
• beanquery.dist (python312Packages.beanquery.dist)
• fava
• fava.dist
• ledger2beancount
• python312Packages.beancount-docverif
• python312Packages.beancount-docverif.dist
• python312Packages.beancount-plugin-utils
• python312Packages.beancount-plugin-utils.dist
• python312Packages.beangulp
• python312Packages.beangulp.dist
• python312Packages.petl
• python312Packages.petl.dist
• python312Packages.tatsu-lts
• python312Packages.tatsu-lts.dist
• python313Packages.beancount
• python313Packages.beancount-docverif
• python313Packages.beancount-docverif.dist
• python313Packages.beancount-plugin-utils
• python313Packages.beancount-plugin-utils.dist
• python313Packages.beancount.dist
• python313Packages.beancount_2
• python313Packages.beancount_2.dist
• python313Packages.beangulp
• python313Packages.beangulp.dist
• python313Packages.beanquery
• python313Packages.beanquery.dist
• python313Packages.petl
• python313Packages.petl.dist
• python313Packages.tatsu-lts
• python313Packages.tatsu-lts.dist

[alapshin]

@dotlambda Thanks for your patience and feedback while moving this PR forward.