3 príspevky so štítkom „Software Update“

Beancount verzia 3, vydaná v polovici roka 2024, predstavuje významnú architektonickú evolúciu populárneho nástroja na účtovníctvo v obyčajnom texte. Hoci si zachováva spätnú kompatibilitu pre používateľské účtovné súbory, základná štruktúra a sprievodné nástroje prešli podstatnými zmenami. Tu je prehľad noviniek v Beancount v3.

Modulárnejšia a zjednodušená architektúra​

Najvýznamnejšou zmenou v Beancount v3 je prechod na modulárnejší ekosystém. Niekoľko kľúčových funkcionalít, ktoré boli predtým súčasťou jadra, bolo vyčlenených do samostatných, nezávislých projektov. Vďaka tomu je jadro Beancount štíhlejšie a umožňuje sústredenejší vývoj jednotlivých komponentov.

Kľúčové komponenty, ktoré sú teraz samostatnými balíkmi, zahŕňajú:

• beanquery: Výkonný nástroj na dopytovanie podobný SQL pre vaše účtovné súbory je teraz vo vlastnom balíku.
• beangulp: Toto je nový domov pre framework na import dát, nahrádzajúci bývalý modul beancount.ingest.
• beanprice: Vyhradený nástroj na získavanie cien komodít a akcií.

Toto oddelenie znamená, že používatelia si budú musieť nainštalovať tieto balíky okrem samotného beancount, aby si zachovali plnú funkcionalitu, na ktorú boli zvyknutí vo verzii 2.

Zmeny v nástrojoch príkazového riadka a pracovných postupoch​

V súlade s novou modulárnou architektúrou došlo k niekoľkým významným zmenám v nástrojoch príkazového riadka:

• bean-report bol odstránený: Tento nástroj bol odstránený. Používateľom sa teraz odporúča používať bean-query (z balíka beanquery) pre ich potreby reportingu.
• Nový pracovný postup importéra: Príkazy bean-extract a bean-identify boli odstránené z jadra. Nový prístup s beangulp je založený na skriptoch. Používatelia si teraz budú vytvárať vlastné Python skripty na spracovanie importu dát z externých zdrojov, ako sú bankové výpisy.

Vylepšenia syntaxe a funkcií​

Hoci základné účtovné princípy zostávajú rovnaké, Beancount v3 prináša vítanú flexibilitu do svojej syntaxe:

• Flexibilnejšie kódy mien: Predchádzajúce obmedzenia dĺžky a znakov pre názvy mien boli uvoľnené. Teraz sú podporované aj jednoznakovné symboly mien.
• Rozšírené príznaky transakcií: Používatelia môžu teraz použiť akékoľvek veľké písmeno od A po Z ako príznak pre transakcie, čo umožňuje podrobnejšiu kategorizáciu.

Dôležité je, že tieto zmeny sú spätne kompatibilné, takže vaše existujúce účtovné súbory Beancount v2 budú fungovať bez akýchkoľvek úprav.

Prepísanie v C++ a výkon​

Jedným z dlhodobých cieľov pre Beancount bolo prepísanie jeho výkonovo kritických komponentov v C++. Hoci táto práca prebieha, počiatočné vydanie Beancount v3 neobsahuje jadro založené na C++. To znamená, že zatiaľ je výkon v3 porovnateľný s v2. Kód v C++ zostáva v samostatnej vývojovej vetve pre budúcu integráciu.

Migrácia z v2 na v3​

Pre väčšinu používateľov je migrácia z Beancount v2 na v3 pomerne jednoduchá:

1. Účtovné súbory: Pre vaše súbory .beancount nie sú potrebné žiadne zmeny.
2. Inštalácia: Budete si musieť nainštalovať nové, samostatné balíky ako beanquery a beangulp pomocou pip.
3. Skripty importéra: Ak máte vlastné importéry, budete ich musieť aktualizovať, aby používali nové API beangulp. To zahŕňa hlavne zmenu základnej triedy, z ktorej vaši importéri dedia, a úpravu niektorých podpisov metód.
4. Fava: Populárne webové rozhranie pre Beancount, Fava, bolo aktualizované, aby bolo kompatibilné s v3. Uistite sa, že máte najnovšiu verziu Fava pre bezproblémový zážitok.

V podstate je Beancount v3 základným vydaním, ktoré zefektívňuje architektúru projektu, čím ho robí modulárnejším a ľahšie udržiavateľným a rozšíriteľným z dlhodobého hľadiska. Hoci si vyžaduje určité úpravy používateľských pracovných postupov, najmä v oblasti importu dát, pripravuje pôdu pre budúci vývoj tohto výkonného účtovného nástroja.

Mnoho našich zákazníkov sa nás od februára pýtalo, ako pridať viacero súborov do jednej účtovnej knihy. Potrebujú štruktúru súborov na archiváciu alebo kategorizáciu transakcií. Takže, konečne, po niekoľkých mesiacoch práce s radosťou oznamujeme, že táto funkcia je vydaná zadarmo.

Tu je návod, ako ju použiť:

Súbor > vytvoriť nový súbor​

Prejdite na kartu editora súborov na ľavom navigačnom bočnom paneli. Potom v rozbaľovacej ponuke "Súbor" kliknite na "Vytvoriť nový súbor".

Pomenujte svoj nový súbor​

Dajte svojmu súboru platný názov a uložte ho. Všetky názvy súborov musia končiť na ".bean".

Zahrňte súbor​

Tu je kľúčový krok, musíte zahrnúť novo vytvorený súbor do main.bean.

Napríklad, ak ste pridali stock.bean, potom v main.bean uveďte include "stock.bean".

Obnovte a prejdite na súbor​

Obnovte stránku a uvidíte, že súbor sa objaví v rozbaľovacej ponuke "Súbor".

Premenujte alebo odstráňte súbor​

Keď prejdete na súbor, môžete ho premenovať alebo odstrániť v rozbaľovacej ponuke "Upraviť".

Máte problémy?​

Pýtajte sa na https://t.me/beancount.

Aktualizovali sme open-source softvér Fava s licenciou MIT na verziu 1.19. Tu sú zmeny od našej poslednej aktualizácie:

• v1.19 (2021-05-18)
  • migrácia z možností conversion a interval na možnosť default-page
  • pridanie možnosti invert-income-liabilities-equity
  • aktualizácia na CodeMirror 6
  • pridáva bulharský preklad
  • ďalšie drobné vylepšenia a opravy chýb
• v1.18 (2021-01-16)
  • niekoľko drobných vylepšení a rôznych opráv chýb.

Cítite sa nadšene? Vyskúšajte to teraz na https://beancount.io/ledger/

Máte otázky? Sme tu pre vás na https://t.me/beancount :)