Beancount v3: Wat is er nieuw?

Bijgewerkt per 2026-09-15.

Beancount versie 3, uitgebracht medio 2024, markeert een significante architecturale evolutie voor de populaire boekhoudtool voor platte tekst. Hoewel het achterwaartse compatibiliteit behoudt voor gebruikersboekbestanden, zijn de onderliggende structuur en bijbehorende tools aanzienlijk gewijzigd. Hier is een overzicht van wat er nieuw is in Beancount v3 — en wat er in de 3.1–3.2-lijn is toegevoegd sinds deze gids voor het eerst werd gepubliceerd.

Voor syntaxis en eerste boekingen, zie de Beancount syntaxisreferentie en Aan de slag. Voor de gehoste CLI die check, query, import en rapporten omvat, zie de Beancount CLI-referentie.

Een meer modulaire en gestroomlijnde architectuur​

De meest significante wijziging in Beancount v3 is de overgang naar een meer modulair ecosysteem. Verschillende belangrijke functionaliteiten die voorheen bij de kern waren gebundeld, zijn nu afgesplitst in afzonderlijke, onafhankelijke projecten. Dit maakt de kern van Beancount slanker en maakt gerichtere ontwikkeling op individuele componenten mogelijk.

De belangrijkste componenten die nu afzonderlijke pakketten zijn, omvatten:

• beanquery: De krachtige SQL-achtige querytool voor uw boekbestanden bevindt zich nu in een eigen pakket.
• beangulp: Dit is de nieuwe thuisbasis voor het data-importframework, ter vervanging van de voormalige beancount.ingest-module.
• beanprice: Een speciale tool voor het ophalen van prijzen van grondstoffen en aandelen.

Deze scheiding betekent dat gebruikers deze pakketten naast beancount zelf moeten installeren om de volledige functionaliteit te behouden die ze in versie 2 gewend waren.

Wijzigingen aan commandoregel-tools en workflows​

Als weerspiegeling van de nieuwe modulaire architectuur zijn er enkele opmerkelijke wijzigingen aan de commandoregel-tools:

• bean-report is verdwenen: Deze tool is verwijderd. Gebruikers worden nu aangemoedigd om bean-query (uit het beanquery-pakket) te gebruiken voor hun rapportagebehoeften.
• Nieuwe importer-workflow: De bean-extract en bean-identify commando's zijn uit de kern verwijderd. De nieuwe aanpak met beangulp is scriptgebaseerd. Gebruikers maken nu hun eigen Python-scripts om het importeren van gegevens uit externe bronnen zoals bankafschriften te beheren.

Syntaxis- en functieverbeteringen​

Hoewel de kernboekhoudprincipes hetzelfde blijven, introduceert Beancount v3 enkele welkome flexibiliteit in de syntaxis:

• Meer flexibele valutacodes: De eerdere beperkingen op de lengte en tekens voor valutanaam zijn versoepeld. Valutasymbolen van één teken worden nu ondersteund.
• Uitgebreide transactievlaggen: Gebruikers kunnen nu elke hoofdletter van A tot Z als vlag voor transacties gebruiken, wat meer gedetailleerde categorisering mogelijk maakt.

Belangrijk is dat deze wijzigingen achterwaarts compatibel zijn, dus uw bestaande Beancount v2-boekbestanden werken zonder aanpassingen.

De C++-herschrijving en prestaties​

Een van de langetermijndoelen voor Beancount is een herschrijving van de prestatiekritische componenten in C++. De initiële release van Beancount v3 bevatte geen C++-kern, en per 2026-09-15 blijft dat het geval: de gepubliceerde PyPI-lijn (via 3.2.3) is nog steeds de modulaire Python v3-tak. Het historische C++/Bazel-werk bevindt zich op een afzonderlijke cpp-tak en maakt geen deel uit van de pakketten die gebruikers installeren vanaf PyPI. De dagelijkse prestaties van de huidige v3-releases vallen daarom in dezelfde klasse als laat v2, met incrementele parser- en toolverbeteringen in plaats van een orde-van-grootte C++-herschrijving.

Sinds dit is geschreven (v3.1 → v3.2.x)​

Primaire bronnen: het projectbestand CHANGES, GitHub-vergelijkingsweergaven voor 3.1.0…3.2.0, en PyPI beancount (laatste 3.2.3 per 2026-09-15).

• 3.1.x-lijn — Voortgezette pakket- en API-opschoning na de 3.0-modulaire splitsing (beanquery, beangulp, beanprice blijven afzonderlijke installaties).
• 3.2.0 (2025-09-14) — Release-commit op beancount/beancount; opmerkelijk gebruikersgericht werk in dit venster omvat multi-bestand bean-format, tolerantie/precisieverfijningen, en wheel/CI-onderhoud (zie de vergelijkingslink hierboven).
• 3.2.1–3.2.3 (2026) — Vervolg-binaire en pakketreleases (inclusief Python 3.14-testdekking en docsscaffolding vermeld in de 3.2.1-samenvatting op de mailinglijst). Installeer met pip install -U beancount en pin metgezellen (beanquery, beangulp) op overeenkomende hoofdmajors bij upgraden.

Fava: Fava 1.30 voegde Beancount 3-ondersteuning toe (2024-12-29). Fava 1.30.13 (2026-05-19) liet Beancount 2-ondersteuning vallen en verwacht beangulp voor importers. Huidige PyPI-lijn per 2026-09-15 is 1.30.16. Combineer Fava-upgrades met een Beancount 3-boekbestand.

Migreren van v2 naar v3​

Voor de meeste gebruikers is de migratie van Beancount v2 naar v3 relatief eenvoudig:

1. Boekbestanden: Geen wijzigingen nodig aan uw .beancount-bestanden.
2. Installatie: U moet de nieuwe, afzonderlijke pakketten zoals beanquery en beangulp installeren met pip.
3. Importer-scripts: Als u aangepaste importers hebt, moet u deze bijwerken om de nieuwe beangulp-API te gebruiken. Dit omvat voornamelijk het wijzigen van de basisklasse waarvan uw importers overerven en het aanpassen van enkele methodesignaturen.
4. Fava: De populaire webinterface voor Beancount, Fava, is bijgewerkt om compatibel te zijn met v3. Zorg ervoor dat u de nieuwste versie van Fava hebt voor een naadloze ervaring.

In essentie is Beancount v3 een fundamentele release die de architectuur van het project stroomlijnt, het modulairder maakt en op de lange termijn gemakkelijker te onderhouden en uit te breiden is. Hoewel het enkele aanpassingen vereist in de workflows van gebruikers, vooral rond gegevensimport, legt het de basis voor de toekomstige ontwikkeling van deze krachtige boekhoudtool.

Verder lezen​

• Aan de slag met Beancount
• Beancount syntaxisreferentie
• Beancount CLI-referentie (bea)
• Community-opstellingen, plug-ins en workflows