3 дописи з тегом "відкритий вихідний код"

Beancount версії 3, випущений в середині 2024 року, знаменує собою значну архітектурну еволюцію для популярного інструменту обліку у текстовому форматі. Хоча він зберігає зворотну сумісність для файлів облікових книг користувачів, базова структура та супутні інструменти зазнали суттєвих змін. Ось огляд того, що нового в Beancount v3.

Більш модульна та оптимізована архітектура​

Найбільш значною зміною в Beancount v3 є перехід до більш модульної екосистеми. Кілька ключових функціональних можливостей, які раніше були об'єднані з ядром, були виділені в окремі, незалежні проєкти. Це робить ядро Beancount більш компактним і дозволяє зосередитися на розробці окремих компонентів.

Ключові компоненти, які тепер є окремими пакетами, включають:

• beanquery: Потужний інструмент запитів, схожий на SQL, для ваших файлів облікових книг тепер знаходиться в окремому пакеті.
• beangulp: Це нове місце для фреймворку імпорту даних, що замінює колишній модуль beancount.ingest.
• beanprice: Спеціалізований інструмент для отримання цін на товари та акції.

Ця сепарація означає, що користувачам потрібно буде встановлювати ці пакети на додаток до самого beancount, щоб зберегти повну функціональність, до якої вони звикли у версії 2.

Зміни в інструментах командного рядка та робочих процесах​

Відображаючи нову модульну архітектуру, є деякі помітні зміни в інструментах командного рядка:

• bean-report видалено: Цей інструмент було видалено. Користувачам тепер рекомендується використовувати bean-query (з пакета beanquery) для своїх потреб у звітності.
• Новий робочий процес імпортера: Команди bean-extract та bean-identify були видалені з ядра. Новий підхід з beangulp базується на скриптах. Користувачі тепер створюватимуть власні скрипти Python для обробки імпорту даних із зовнішніх джерел, таких як банківські виписки.

Покращення синтаксису та функцій​

Хоча основні принципи обліку залишаються незмінними, Beancount v3 вносить деяку бажану гнучкість у свій синтаксис:

• Більш гнучкі коди валют: Попередні обмеження на довжину та символи для назв валют були послаблені. Тепер підтримуються односимвольні позначення валют.
• Розширені прапорці транзакцій: Користувачі тепер можуть використовувати будь-яку велику літеру від A до Z як прапорець для транзакцій, що дозволяє більш детально категоризувати їх.

Важливо, що ці зміни є зворотно сумісними, тому ваші існуючі файли облікових книг Beancount v2 працюватимуть без будь-яких модифікацій.

Переписування на C++ та продуктивність​

Однією з довгострокових цілей для Beancount було переписування його критично важливих для продуктивності компонентів на C++. Хоча ця робота триває, початковий випуск Beancount v3 не включає ядро на базі C++. Це означає, що наразі продуктивність v3 порівнянна з v2. Код C++ залишається в окремій гілці розробки для майбутньої інтеграції.

Міграція з v2 на v3​

Для більшості користувачів міграція з Beancount v2 на v3 є відносно простою:

1. Файли облікових книг: Жодних змін для ваших файлів .beancount не потрібно.
2. Встановлення: Вам потрібно буде встановити нові, окремі пакети, такі як beanquery та beangulp, використовуючи pip.
3. Скрипти імпортера: Якщо у вас є власні імпортери, вам потрібно буде оновити їх для використання нового API beangulp. Це в основному передбачає зміну базового класу, від якого успадковуються ваші імпортери, та коригування деяких сигнатур методів.
4. Fava: Популярний веб-інтерфейс для Beancount, Fava, був оновлений для сумісності з v3. Переконайтеся, що у вас встановлена остання версія Fava для безперебійної роботи.

По суті, Beancount v3 є фундаментальним випуском, який оптимізує архітектуру проєкту, роблячи її більш модульною та легшою для підтримки та розширення в довгостроковій перспективі. Хоча він вимагає деяких коригувань у робочих процесах користувачів, особливо щодо імпорту даних, він закладає основу для майбутнього розвитку цього потужного інструменту обліку.

Основна функціональність та філософія Beancount​

Beancount — це система бухгалтерського обліку подвійного запису з відкритим вихідним кодом, яка використовує текстові файли для запису транзакцій. По суті, Beancount розглядає вашу бухгалтерську книгу як набір даних, визначений простою, суворою граматикою. Кожна фінансова подія (транзакції, відкриття рахунків, ціни на товари тощо) є директивою в текстовому файлі, яку Beancount аналізує та перетворює на базу даних записів у пам'яті. Ця архітектура забезпечує дотримання принципу подвійного запису: кожна транзакція повинна балансувати дебети та кредити між рахунками. Результатом є високопрозора та аудитована бухгалтерська книга, яку можна легко контролювати за версіями, перевіряти та запитувати.

Філософія – коректність та мінімалізм: Дизайн Beancount надає пріоритет цілісності даних та простоті. Його творець, Мартін Блейс, описує Beancount як "песимістичний", припускаючи, що користувач робитиме помилки, і тому накладає додаткові перевірки та обмеження. Наприклад, Beancount не дозволить вам видалити активи, які ніколи не були додані (запобігаючи від'ємним залишкам запасів або готівки), і може вимагати, щоб кожен рахунок був відкритий перед використанням. Йому бракує концепції "віртуальних" або автоматично збалансованих проводок Ledger – це свідомий вибір, щоб змусити використовувати повністю збалансовані записи. Beancount ефективно "йде напролом" у коректності, надаючи більше перехресних перевірок, ніж забезпечує базовий подвійний запис. Цей обережний підхід приваблює користувачів, які "не надто довіряють собі" і хочуть, щоб програмне забезпечення виявляло їхні помилки.

Мінімальні опції, максимальна послідовність: На відміну від безлічі прапорців командного рядка та параметрів налаштування Ledger, Beancount обирає мінімалізм. Існує дуже мало глобальних опцій, і жодна з них не змінює семантику транзакцій за межами файлу бухгалтерської книги. Всі конфігурації, що впливають на облік (наприклад, методи обліку собівартості товарів або припущення щодо обліку), виконуються у файлі за допомогою директив або плагінів, що гарантує, що завантаження одного й того ж файлу завжди дає однакові результати, незалежно від того, як генеруються звіти. Цей дизайн дозволяє уникнути складності численних налаштувань Ledger та тонких взаємодій між ними. Філософія Beancount полягає в тому, що інструмент обліку повинен бути стабільним, детермінованим конвеєром від вхідного файлу до звітів. Він досягає цього, розглядаючи бухгалтерську книгу як впорядкований потік директив, які можуть бути програмно оброблені послідовно. Навіть те, що Ledger розглядає як спеціальний синтаксис (наприклад, початкові залишки або заяви про ціни), є першокласними директивами в моделі даних Beancount, що робить систему дуже розширюваною.

Розширюваність за допомогою плагінів та мови запитів: Beancount реалізовано на Python і надає хуки для впровадження власної логіки в конвеєр обробки. Користувачі можуть писати плагіни на Python, які працюють з потоком транзакцій (наприклад, для застосування власного правила або генерації автоматичних записів). Ці плагіни запускаються під час обробки файлу, ефективно розширюючи основну функціональність Beancount без необхідності модифікації вихідного коду. Beancount також включає потужну мову запитів (на основі SQL) для аналізу та деталізації бухгалтерської книги. Інструмент bean-query розглядає проаналізовану бухгалтерську книгу як базу даних і дозволяє виконувати на ній аналітичні запити – наприклад, підсумовувати витрати за категоріями або витягувати всі транзакції для певного одержувача. У Beancount 3.x ця можливість запитів була перенесена в окремий пакет beanquery, але з точки зору користувача вона все ще забезпечує гнучку звітність за допомогою SQL-подібних запитів.

Простий текст та контроль версій: Як інструмент обліку на основі простого тексту, Beancount наголошує на контролі користувача та довговічності даних. Бухгалтерська книга – це просто текстовий файл .beancount, який можна редагувати в будь-якому текстовому редакторі. Це означає, що вся ваша фінансова історія зберігається в людиночитаному форматі, і ви можете розмістити її в Git або іншій VCS для відстеження змін з часом. Користувачі часто зберігають свій файл Beancount під контролем версій, щоб підтримувати аудиторський слід кожної зміни (з повідомленнями комітів, що описують зміни). Цей підхід відповідає філософії Beancount, згідно з якою облікові дані, особливо особисті фінанси або фінанси малого бізнесу, повинні бути прозорими та "стійкими до майбутніх змін" – не заблокованими у власницькій базі даних. За словами самого Мартіна Блейса, Beancount – це "плід праці", створений бути простим, довговічним та безкоштовним для спільноти. Він був вперше розроблений близько 2007 року і еволюціонував через значні переробки (з v1 до v2, а тепер v3 у 2024 році), щоб удосконалити свій дизайн, зберігаючи при цьому свою основну філософію мінімалізму та коректності.

Інструменти, Плагіни та Розширення в Екосистемі Beancount​

Екосистема Beancount розвинула багатий набір інструментів, плагінів та розширень, що покращують основну функціональність бухгалтерської книги. Вони охоплюють імпорт даних, редагування бухгалтерських книг, перегляд звітів та додавання спеціалізованих бухгалтерських функцій. Нижче наведено огляд ключових компонентів та додатків у світі Beancount:

Утиліти для імпорту даних (Імпортери)​

Однією з найважливіших потреб для практичного використання є імпортування транзакцій з банків, кредитних карток та інших фінансових установ. Beancount надає фреймворк для імпорту та скрипти для імпорту, надані спільнотою, для цієї мети. У Beancount 2.x вбудований модуль beancount.ingest (з командами, такими як bean-extract та bean-identify) використовувався для визначення плагінів імпортерів на Python та їх застосування до завантажених виписок. У Beancount 3.x це було замінено зовнішнім проєктом під назвою Beangulp. Beangulp — це спеціалізований фреймворк для імпортерів, який еволюціонував з beancount.ingest і тепер є рекомендованим способом автоматизації імпорту транзакцій для Beancount 3.0. Він дозволяє писати скрипти Python або інструменти командного рядка, які читають зовнішні файли (такі як виписки CSV або PDF) та виводять записи Beancount. Цей новий підхід відокремлює логіку імпорту від ядра Beancount – наприклад, стара команда bean-extract була видалена у версії 3, і натомість ваші скрипти імпорту самі генерують транзакції через інтерфейс командного рядка Beangulp.

Десятки готових імпортерів існують для різних банків та форматів, надані спільнотою. Існують скрипти імпортерів для установ по всьому світу – від Alipay та WeChat Pay у Китаї, до різних європейських банків (Commerzbank, ING, ABN AMRO тощо), до американських банків, таких як Chase та Amex. Багато з них зібрані у публічних репозиторіях (часто на GitHub) або в пакетах, таких як beancount-importers. Наприклад, проєкт Tarioch Beancount Tools (tariochbctools) надає імпортери для швейцарських та британських банків і навіть обробляє імпорт криптотранзакцій. Іншим прикладом є Lazy Beancount, який містить набір поширених імпортерів (для Wise, Monzo, Revolut, IBKR тощо) та надає налаштування на основі Docker для легкої автоматизації. Незалежно від того, який банк чи фінансовий сервіс ви використовуєте, ймовірно, хтось вже написав імпортер Beancount для нього – або ви можете написати свій власний, використовуючи фреймворк Beangulp. Гнучкість Python означає, що імпортери можуть обробляти парсинг файлів CSV/Excel, завантаження OFX/QIF або навіть скрапінг API, а потім генерувати транзакції у стандартизованому форматі Beancount.

Редагування та інтеграція з редакторами​

Оскільки бухгалтерські книги Beancount — це просто текст, користувачі часто використовують свої улюблені текстові редактори або IDE для їх ведення. Екосистема пропонує плагіни підтримки редакторів, щоб зробити цей досвід зручнішим. Існують розширення для багатьох популярних редакторів, які додають підсвічування синтаксису, автозаповнення назв рахунків та перевірку помилок у реальному часі:

• Режим Beancount для Emacs: Доступний основний режим Emacs (beancount-mode) для редагування файлів .beancount, що пропонує такі функції, як підсвічування синтаксису та інтеграцію з перевіркою Beancount. Він може навіть запускати bean-check у фоновому режимі, щоб помилки в бухгалтерській книзі (наприклад, незбалансована транзакція) позначалися під час редагування.
• Розширення VS Code: Розширення Beancount на VSCode Marketplace надає подібні зручності для користувачів Visual Studio Code. Воно підтримує підсвічування синтаксису, вирівнювання сум, автозаповнення для рахунків/одержувачів і навіть перевірку балансу на льоту при збереженні файлу. Воно також може інтегруватися з Fava, дозволяючи запускати веб-інтерфейс Fava з VSCode.
• Плагіни або режими також існують для Vim, Atom та інших редакторів. Наприклад, існує граматика Tree-sitter для Beancount, яка забезпечує підсвічування синтаксису в сучасних редакторах і навіть була прийнята у веб-компоненті редактора Fava. Коротко кажучи, незалежно від вашого середовища редагування, спільнота, ймовірно, надала плагін, щоб зробити редагування файлів Beancount зручним і безпомилковим.

Для швидкого введення транзакцій поза традиційними редакторами також існують такі інструменти, як Bean-add та мобільні додатки. Bean-add — це інструмент командного рядка, який дозволяє додавати нову транзакцію через запит або в один рядок, обробляючи пропозиції щодо дати та рахунку. На мобільних пристроях проєкт під назвою Beancount Mobile надає простий інтерфейс для введення транзакцій на ходу (наприклад, запис готівкової покупки з вашого телефону). Крім того, існує Telegram-бот Beancount для фіксації транзакцій через повідомлення — ви можете надіслати повідомлення з деталями транзакції, і бот відформатує його у файл вашої бухгалтерської книги.

Веб-інтерфейси та інструменти візуалізації​

(Fava) Веб-інтерфейс Fava надає інтерактивну панель інструментів для Beancount, що містить такі звіти, як звіт про прибутки та збитки з візуалізаціями (тут показано як деревоподібну діаграму витрат за категоріями) разом з таблицями рахунків та залишків.

Флагманським фронтендом для Beancount є Fava, сучасний веб-інтерфейс. Fava працює як локальний веб-додаток, який читає ваш файл Beancount і створює насичений інтерактивний досвід у вашому браузері. Він пропонує повний набір звітів: баланс, звіт про прибутки та збитки, чиста вартість з часом, склад портфеля, графіки ефективності, бюджети та багато іншого – все готове до використання. Користувачі часто називають Fava головною причиною вибору Beancount серед інших інструментів текстового обліку. За допомогою однієї команди (fava ledger.beancount) ви можете переглядати свої фінанси за допомогою графіків та таблиць замість тексту. Fava підтримує такі функції, як: деталізація рахунків, фільтрація транзакцій за отримувачем або тегом, редактор запитів (щоб ви могли виконувати запити Beancount та бачити результати в браузері), і навіть інтегрований веб-редактор для вашої книги обліку. Він дуже зручний у використанні, що робить текстовий облік доступним для тих, хто віддає перевагу візуальним інтерфейсам.

Під капотом Fava написана на Python (Flask на бекенді) та JavaScript (Svelte на фронтенді). Вона має власний цикл випуску та активно підтримується. Зокрема, Fava йшла в ногу з розробкою Beancount – наприклад, Fava 1.30 додала підтримку Beancount v3, перейшовши на використання нових пакетів beanquery та beangulp всередині. (Вона все ще підтримує Beancount 2 для старіших книг обліку.) Зосередженість Fava на зручності використання включає приємні дрібниці, такі як автозавершення у веб-редакторі, та елегантний інтерфейс користувача з темним режимом та адаптивними діаграмами. Існує також відгалуження під назвою Fava-GTK, яке пакує Fava в настільний додаток для користувачів GNOME/Linux, які віддають перевагу відчуттю нативного додатку.

Крім Fava, існують інші варіанти візуалізації та аналізу. Оскільки дані Beancount можуть бути експортовані або запитувані як таблиці, користувачі часто використовують такі інструменти, як Jupyter notebooks або Pandas для власного аналізу. Наприклад, один користувач описує витягування даних з Beancount через інтерфейс запитів у Pandas DataFrame для підготовки власного звіту. Існують також скрипти, надані спільнотою, для конкретних звітів – наприклад, інструмент аналізу розподілу портфеля або контрольна карта процесу для витрат порівняно з чистою вартістю. Однак, для більшості людей Fava надає більш ніж достатньо можливостей звітності без необхідності писати код. Вона навіть підтримує розширення: ви можете просто додати файли Python, які додають нові сторінки звітів або діаграми до Fava. Помітним розширенням є fava-envelope для конвертного бюджетування всередині Fava. Загалом, Fava слугує центральним вузлом візуалізації екосистеми Beancount.

Інструменти командного рядка та скрипти​

Beancount постачається з різноманітними інструментами командного рядка (особливо в старішій гілці v2, деякі з яких були скорочені у v3). Ці інструменти працюють з вашим файлом облікової книги для його перевірки або генерації певних звітів у текстовому форматі або HTML:

• bean-check: валідатор, який перевіряє файл на синтаксичні або бухгалтерські помилки. Запуск bean-check myfile.beancount повідомить вас про будь-який дисбаланс, відсутній рахунок або інші проблеми, і не виведе нічого, якщо файл не містить помилок.
• bean-format: форматувальник, який впорядковує вашу облікову книгу, вирівнюючи числа в акуратні стовпці, подібно до запуску форматувальника коду для вихідного коду. Це допомагає підтримувати файл чистим і читабельним.
• bean-query: інтерактивна оболонка або пакетний інструмент для виконання мови запитів Beancount у вашій обліковій книзі. Ви можете використовувати його для створення власних табличних звітів (наприклад, bean-query myfile.beancount "SELECT account, sum(amount) WHERE ...").
• bean-report: універсальний генератор звітів (у v2), який може виводити попередньо визначені звіти (баланс, звіт про прибутки та збитки, пробний баланс тощо) на консоль або у файли. Наприклад, bean-report file.beancount balances виведе залишки на рахунках. (На практиці, багато з цих текстових звітів були замінені більш приємним представленням Fava.)
• bean-web / bean-bake: старіший веб-інтерфейс, який обслуговував звіти на localhost або "запікав" їх як статичні HTML-файли. Вони переважно використовувалися до того, як Fava стала популярною; bean-web надавав базовий веб-перегляд тих самих звітів, які міг генерувати bean-report. У Beancount 3 bean-web було видалено (оскільки Fava тепер є рекомендованим веб-інтерфейсом, що пропонує чудовий досвід).
• bean-example: утиліта для генерації прикладу файлу облікової книги (корисна для новачків, щоб побачити шаблон записів Beancount).
• bean-doctor: інструмент налагодження, який може діагностувати проблеми у вашій обліковій книзі або середовищі.

Варто зазначити, що станом на Beancount v3, багато з цих інструментів були винесені з основного проєкту. Основний пакет Beancount був оптимізований, а такі інструменти, як механізм запитів та імпортери, були розділені на окремі пакети (beanquery, beangulp тощо) для полегшення обслуговування. Наприклад, функціональність bean-query тепер надається інструментом beanquery, який встановлюється окремо. З точки зору користувача, функціональність залишається доступною; її просто було модулізовано. Спільнота Arch Linux відзначила цю зміну під час оновлення Fava: пакет Fava додав залежності від beanquery та beangulp для підтримки Beancount 3.x. Цей модульний підхід також дозволяє іншим членам спільноти робити внесок у ці допоміжні інструменти більш незалежно від циклу випуску Beancount.

Плагіни та розширення Beancount​

Однією з визначних переваг екосистеми Beancount є система плагінів. Додавши рядок plugin "module.name" до вашого файлу Beancount, ви можете інтегрувати власну логіку Python, яка виконується під час обробки книги. Спільнота створила багато плагінів для розширення можливостей Beancount:

• Якість даних та правила: Приклади включають beancount-balexpr, який дозволяє стверджувати рівняння за участю кількох рахунків (наприклад, Актив А + Актив Б = Зобов'язання X), та beancount-checkclosed, який автоматично вставляє твердження про баланс, коли ви закриваєте рахунок, щоб переконатися, що він дорівнює нулю. Існує навіть плагін для забезпечення сортування транзакцій у файлі за датою (autobean.sorted) для виявлення записів не за порядком.
• Автоматизація: Плагін beancount-asset-transfer може генерувати записи про перекази в натуральній формі між рахунками (корисно для переміщення акцій між брокерами зі збереженням бази витрат). Інший, autobean.xcheck, перевіряє вашу книгу Beancount на відповідність зовнішнім випискам щодо розбіжностей.
• Повторювані транзакції та бюджети: Плагін «repeat» або interpolate від Akuukis дозволяє визначати повторювані транзакції або розподіляти річні витрати на місяці. Для бюджетування розширення fava-envelope (використовується через Fava) підтримує методологію конвертного бюджетування у вигляді простого тексту. Існує також MiniBudget від Френка Девіса – невеликий автономний інструмент, натхненний Beancount, що допомагає з бюджетуванням для особистого використання або малого бізнесу.
• Податки та звітність: Деякі плагіни допомагають з податковим обліком, наприклад, той, що автоматично класифікує приріст капіталу на короткостроковий та довгостроковий. Інший (fincen_114 від Джастуса Пендлтона) генерує звіт FBAR для платників податків США з іноземними рахунками, ілюструючи, як дані Beancount можуть бути використані для регуляторної звітності.
• Репозиторії плагінів спільноти: Існують підібрані набори плагінів, такі як beancount-plugins (від Дейва Стівенса), що зосереджені на таких речах, як записи про амортизацію, та beancount-plugins-zack (від Стефано Заккіролі), які включають різноманітні допоміжні засоби, такі як сортування директив.

На додаток до плагінів, інші службові інструменти, що оточують Beancount, вирішують специфічні потреби. Наприклад, beancount-black – це автоматичний форматувальник, схожий на форматувальник коду Black, але для файлів книги Beancount. Існує Beancount Bot (Telegram/Mattermost) для додавання транзакцій через чат, як згадувалося, та робочий процес Alfred для macOS для швидкого додавання транзакцій до вашого файлу. Інструмент під назвою Pinto пропонує «потужний» інтерфейс командного рядка з інтерактивним введенням (як покращений bean-add). Для тих, хто мігрує з інших систем, існують конвертери (YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount), які допомагають імпортувати дані з інших джерел.

Підсумовуючи, екосистема Beancount є досить розгалуженою. Таблиця 1 нижче перелічує деякі основні інструменти та розширення з їхніми ролями:

Інструмент/Розширення	Опис
Fava (веб-інтерфейс)	Повнофункціональний веб-додаток для перегляду та редагування книг Beancount. Надає інтерактивні звіти (баланс, доходи тощо), діаграми та можливості запитів. Значно підвищує зручність використання Beancount.
Beangulp (фреймворк імпорту)	Незалежний фреймворк імпорту для Beancount v3, що замінює старий модуль ingest. Допомагає конвертувати банківські виписки (CSV, PDF тощо) у записи Beancount за допомогою скриптів плагінів.
Beanquery (інструмент запитів)	Незалежний SQL-подібний механізм запитів для даних Beancount. Замінює bean-query у v3, дозволяючи розширені запити транзакцій та балансів за допомогою знайомого синтаксису SELECT-FROM-WHERE.
Bean-check / Bean-format	Основні інструменти командного рядка для перевірки файлу Beancount (на наявність помилок) та його автоматичного форматування для забезпечення послідовності. Корисні для підтримки правильної та чистої книги.
Плагіни редакторів (Emacs, VSCode, Vim тощо)	Плагіни/режими, що додають підтримку синтаксису Beancount та лінтинг у текстових редакторах. Покращують досвід ручного редагування файлів .beancount за допомогою таких функцій, як автозавершення та підсвічування помилок у реальному часі.
Імпортери спільноти	Колекції скриптів імпорту банківських даних (багато на GitHub), що охоплюють банки в США, ЄС, Азії та інших регіонах. Дозволяють користувачам автоматично імпортувати транзакції зі своїх фінансових установ у Beancount.
Плагіни (розширення Ledger)	Необов'язкові вбудовані плагіни для застосування правил або додавання функціональності (наприклад, розподіл витрат, повторювані записи, власні твердження про баланс). Написані на Python і виконуються під час обробки файлу для налаштування.
Конвертери (інструменти міграції)	Утиліти для конвертації даних з інших форматів у Beancount, наприклад, з GnuCash або Ledger CLI у формат Beancount. Сприяють впровадженню Beancount без необхідності починати з нуля.

Порівняння з Ledger, hledger та подібними системами​

Beancount належить до сімейства інструментів обліку подвійного запису в текстовому форматі, серед яких виділяються Ledger CLI (Ledger Джона Віглі) та hledger. Хоча всі ці системи поділяють основну ідею текстових файлів обліку та подвійного запису, вони відрізняються синтаксисом, філософією та зрілістю екосистеми. Наступна таблиця висвітлює ключові відмінності між Beancount, Ledger та hledger:

Аспект	Beancount (Python)	Ledger CLI (C++)	hledger (Haskell)
Синтаксис та структура файлу	Суворий, структурований синтаксис, визначений

Сценарії використання Beancount​

Beancount є достатньо універсальним, щоб використовувати його як для відстеження особистих фінансів, так і (в деяких випадках) для бухгалтерського обліку малого бізнесу. Його основний підхід подвійного запису є однаковим в обох сценаріях, але масштаб і конкретні практики можуть відрізнятися.

Особисті фінанси​

Багато користувачів Beancount використовують його для управління своїми особистими або сімейними фінансами. Типова конфігурація особистих фінансів у Beancount може включати рахунки для поточних та ощадних рахунків, кредитних карток, інвестицій, позик, категорій доходів (зарплата, відсотки тощо) та категорій витрат (оренда, продукти, розваги тощо). Користувачі записують щоденні транзакції або вручну (вводячи квитанції, рахунки тощо), або імпортуючи з банківських виписок за допомогою раніше обговорених інструментів імпорту. Переваги, які Beancount надає особистим фінансам, включають:

• Консолідація та аналіз: Усі ваші транзакції можуть зберігатися в одному текстовому файлі (або наборі файлів), що представляє роки фінансової історії. Це полегшує аналіз довгострокових тенденцій. За допомогою мови запитів Beancount або Fava ви можете за лічені секунди відповісти на запитання на кшталт «Скільки я витратив на подорожі за останні 5 років?» або «Який мій середній щомісячний рахунок за продукти?». Один користувач зазначив, що після переходу на Beancount, «аналіз фінансових даних (витрат, пожертвувань, податків тощо) є тривіальним» як через Fava, так і шляхом запитів до даних та використання таких інструментів, як Pandas. По суті, ваша бухгалтерська книга стає особистою фінансовою базою даних, яку ви можете запитувати за бажанням.
• Бюджетування та планування: Хоча Beancount не нав'язує систему бюджетування, ви можете її реалізувати. Деякі користувачі використовують конвертне бюджетування, створюючи бюджетні рахунки або використовуючи плагін fava-envelope. Інші просто використовують періодичні звіти для порівняння витрат із цільовими показниками. Оскільки це простий текст, інтеграція Beancount із зовнішніми інструментами бюджетування або електронними таблицями є простою (експорт даних або використання виводів CSV із запитів).
• Відстеження інвестицій та чистої вартості: Beancount чудово відстежує інвестиції завдяки надійній обробці собівартості та ринкових цін. Ви можете записувати купівлі/продажі акцій, криптовалюти тощо з деталями собівартості, а потім використовувати директиви Prices для відстеження ринкової вартості. Fava може відображати графік чистої вартості з часом та розбивку портфеля за класами активів. Це надзвичайно корисно для управління особистим капіталом – ви отримуєте інформацію, подібну до тієї, що надають комерційні інструменти, такі як Mint або Personal Capital, але повністю під вашим контролем. Обробка кількох валют також вбудована, тому, якщо ви тримаєте іноземні валюти або криптовалюту, Beancount може відстежувати їх та конвертувати для звітності.
• Звірка та точність: Особисті фінанси часто передбачають звірку з банківськими виписками. За допомогою Beancount можна регулярно звіряти рахунки, використовуючи твердження балансу або функцію документів. Наприклад, щомісяця ви можете додавати запис balance Assets:Bank:Checking <date> <balance>, щоб підтвердити, що ваша бухгалтерська книга відповідає банківській виписці на кінець місяця. Інструмент bean-check (або відображення помилок Fava) попередить вас, якщо щось не збігається. Один користувач згадує про щомісячну звірку всіх рахунків, що «допомагає виявити будь-яку незвичайну активність» – хороша практика гігієни особистих фінансів, яку полегшує Beancount.
• Автоматизація: Технічно підковані особи автоматизували значну частину свого робочого процесу особистих фінансів за допомогою Beancount. Використовуючи імпортери, завдання cron та, можливо, трохи Python, ви можете налаштувати свою систему так, щоб, наприклад, щодня ваші банківські транзакції завантажувалися (деякі використовують OFX або API) та додавалися до вашого файлу Beancount, класифіковані за правилами. З часом ваша бухгалтерська книга здебільшого оновлюється автоматично, і вам залишається лише переглядати та коригувати за потреби. Учасник спільноти на Hacker News поділився, що через 3 роки їхні бухгалтерські книги Beancount були «на 95% автоматичними». Такий рівень автоматизації можливий завдяки відкритості Beancount у простому тексті та можливостям сценаріїв.

Користувачі особистих фінансів часто обирають Beancount замість електронних таблиць або додатків, оскільки він надає їм повне володіння даними (без залежності від хмарного сервісу, який може припинити роботу – наприклад, як це сталося з Mint) і тому, що глибина аналізу більша, коли всі ваші дані інтегровані. Крива навчання є нетривіальною – потрібно вивчити основи бухгалтерського обліку та синтаксис Beancount – але такі ресурси, як офіційна документація та навчальні посібники спільноти, допомагають новачкам розпочати роботу. Після налаштування багато хто виявляє, що це приносить спокій, маючи чітку, надійну картину своїх фінансів у будь-який час.

Облік малого бізнесу​

Використання Beancount для малого бізнесу (або неприбуткової організації, клубу тощо) є менш поширеним, ніж для особистого використання, але це, безумовно, можливо, і деякі користувачі успішно це робили. Система подвійного запису Beancount насправді є тією ж системою, що лежить в основі корпоративного обліку, лише без деяких функцій вищого рівня, які надає спеціалізоване бухгалтерське програмне забезпечення (наприклад, модулі виставлення рахунків або інтеграції з розрахунком заробітної плати). Ось як Beancount може вписатися в контекст малого бізнесу:

• Головна книга та фінансова звітність: Малий бізнес може розглядати файл Beancount як свою головну книгу. Ви матимете рахунки активів для банківських рахунків, дебіторської заборгованості, можливо, запасів; рахунки зобов’язань для кредитних карток, позик, кредиторської заборгованості; власний капітал для капіталу власника; рахунки доходів для продажів або послуг; та рахунки витрат для всіх ділових витрат. Ведучи цю книгу, ви можете в будь-який час скласти Звіт про прибутки та збитки (Звіт про фінансові результати) та Баланс (Звіт про фінансовий стан), використовуючи звіти або запити Beancount. Фактично, вбудовані звіти Beancount або Fava можуть генерувати баланс та Звіт про прибутки та збитки за лічені секунди, які ідеально відповідають принципам бухгалтерського обліку. Цього може бути достатньо для невеликої операції, щоб оцінити прибутковість, фінансовий стан та грошовий потік (з невеликим запитом для грошового потоку, оскільки прямі звіти про рух грошових коштів не вбудовані, але можуть бути виведені).
• Рахунки-фактури та дебіторська/кредиторська заборгованість: Beancount не має вбудованої системи виставлення рахунків; користувачі зазвичай обробляють виставлення рахунків поза системою (наприклад, створюють рахунки-фактури в Word або додатку для рахунків-фактур), а потім записують результати в Beancount. Наприклад, коли ви виставляєте рахунок-фактуру, ви робите запис, дебетуючи рахунок дебіторської заборгованості та кредитуючи рахунок доходів. Коли надходить платіж, ви дебетуєте рахунок Готівка/Банк та кредитуєте рахунок дебіторської заборгованості. Таким чином, ви можете відстежувати непогашену дебіторську заборгованість, переглядаючи залишок на рахунку дебіторської заборгованості. Те саме стосується рахунків до сплати (кредиторської заборгованості). Хоча це більш ручний процес, ніж у спеціалізованому бухгалтерському програмному забезпеченні (яке може надсилати нагадування або інтегруватися з електронною поштою), це цілком можливо. Деякі користувачі ділилися шаблонами або робочими процесами щодо того, як вони керують рахунками-фактурами за допомогою Beancount та забезпечують, щоб вони не пропускали відкриті рахунки-фактури (наприклад, використовуючи метадані або користувацькі запити для переліку неоплачених рахунків-фактур).
• Запаси або собівартість реалізованої продукції: Для підприємств, що продають продукцію, Beancount може відстежувати закупівлі та продажі запасів, але це вимагає дисциплінованих записів. Ви можете використовувати функції Inventory (Запаси) та обліку витрат: купівля запасів збільшує рахунок активів (з вартістю, прив'язаною до товарів), продаж переміщує вартість у витрати (СОГС) та реєструє дохід. Оскільки Beancount наполягає на відповідності партій, він забезпечить належне зменшення запасів за правильною вартістю, що може фактично гарантувати точність ваших розрахунків валового прибутку, якщо все зроблено правильно. Однак, немає автоматичного відстеження SKU або чогось подібного – все відбувається на фінансовому рівні (кількість та вартість).
• Розрахунок заробітної плати та складні операції: Beancount може реєструвати операції з розрахунку заробітної плати (витрати на заробітну плату, утримання податків тощо), але розрахунок цих сум може здійснюватися зовнішньо або за допомогою іншого інструменту, а потім просто заноситися до

Спільнота та діяльність з розробки​

Beancount має віддану спільноту та історію розробки, що відображає його відкритий, нішевий, але пристрасний характер. Нижче наведено ключові моменти щодо його спільноти, мейнтейнерів та пов'язаних проєктів:

• Підтримка Проєкту: Основним автором Beancount є Мартін Блейс, який розпочав проєкт близько 2007 року і провів його через численні версії. Розробка протягом тривалого часу була переважно зусиллям однієї людини (окрім внесків спільноти у вигляді патчів). Філософія Мартіна полягала в створенні інструменту обліку, "корисного насамперед для мене, а також для інших, у найпростіший та найдовговічніший спосіб". Ця особиста мотивація підтримувала проєкт як працю з любові. Станом на 2025 рік Мартін Блейс все ще є провідним мейнтейнером (його ім'я з'являється в комітах, і він відповідає на запитання у списку розсилки/трекері проблем), але екосистема навколо Beancount має багато інших учасників у їхніх відповідних проєктах.

• GitHub та Репозиторії: Вихідний код розміщено на GitHub у репозиторії beancount/beancount. Проєкт ліцензований за GPL-2.0 і за роки залучив помірну кількість учасників. У середині 2024 року Beancount Версія 3 була офіційно випущена як нова стабільна гілка. Цей випуск передбачав розділення деяких компонентів: наприклад, репозиторій beangulp (для імпортерів) та репозиторій beanquery (для інструменту запитів) тепер є частиною організації beancount на GitHub, що підтримуються дещо незалежно. Основний репозиторій Beancount зосереджений на базовому обліковому двигуні та парсері файлів. Станом на 2025 рік GitHub Beancount показує активні обговорення проблем та деяку поточну розробку – хоча й невеликого обсягу, проблеми та запити на злиття надходять поступово, а періодичні оновлення вносяться для виправлення помилок або вдосконалення функцій.

• Розробка Fava: Fava, веб-інтерфейс, розпочався як окремий проєкт (створений Домініком Аумайром, який зареєстрував авторські права на нього у 2016 році). Він має власну спільноту учасників і також розміщений на GitHub під beancount/fava. Мейнтейнери та учасники Fava (наприклад, Якоб Шнец, Стефан Отте та інші в останні роки) активно вдосконалюють інтерфейс, випускаючи релізи кожні кілька місяців. Чат Fava на Gitter (посилання на документацію Fava) та трекер проблем GitHub – це місця, де користувачі та розробники обговорюють нові функції або помилки. Проєкт вітає внески, про що свідчить примітка в CHANGELOG, яка дякує численним членам спільноти за їхні PR. Тісне узгодження Fava з розробкою Beancount (таке як швидке додавання підтримки Beancount v3 та нового синтаксису beanquery) свідчить про хорошу співпрацю між двома проєктами.

• Списки Розсилки та Форуми: Beancount має офіційний список розсилки (раніше на Google Groups, під назвою "Beancount" або іноді обговорювався у загальному списку Ledger). Цей список розсилки є скарбницею знань – користувачі ставлять запитання про те, як моделювати певні сценарії, повідомляють про помилки та діляться порадами. Мартін Блейс відомий тим, що відповідає у списку розсилки з детальними поясненнями. Крім того, ширша спільнота Plain Text Accounting значно перетинається. Список розсилки Ledger CLI часто розглядає питання щодо Beancount, а також існує форум на plaintextaccounting.org та субреддіт r/plaintextaccounting, де часто з'являються теми Beancount. Користувачі на цих платформах обговорюють порівняння, діляться особистими налаштуваннями та допомагають новачкам. Загальний тон спільноти дуже співпрацюючий – користувачі Beancount часто допомагають користувачам Ledger і навпаки, визнаючи, що всі ці інструменти мають схожі цілі.

• Чат-групи: Окрім списків розсилки, існують чат-канали, такі як Plaintext Accounting Slack/Discord (організовані спільнотою) та Fava Gitter. Це менш формальні, більш оперативні способи отримати допомогу або обговорити функції. Наприклад, можна зайти в Slack, щоб запитати, чи є у когось імпортер для конкретного банку. Існує також канал Matrix/IRC (історично #ledger або #beancount на IRC), де перебувають деякі давні користувачі. Хоча ці канали не такі численні, як спільноти для масового програмного забезпечення, вони мають обізнаних людей, які часто можуть відповісти на незрозумілі бухгалтерські питання.

• Учасники та Ключові Члени Спільноти: Кілька імен виділяються у спільноті Beancount:

  • "Redstreet" (Red S): Плідний учасник, який написав багато плагінів (таких як beancount-balexpr, sellgains та інші) і часто надає підтримку. Він також підтримує набір скриптів-імпортерів та інструмент під назвою bean-download для отримання виписок.
  • Василь М (Evernight): Автор

Останні розробки та майбутні функції​

Станом на 2025 рік, екосистема Beancount зазнала значних розробок за останні кілька років, і тривають обговорення щодо майбутніх вдосконалень. Ось деякі важливі останні розробки та погляд на те, що може з'явитися:

• Випуск Beancount 3.0 (2024): Після тривалого періоду, коли Beancount 2.x був стандартом, версія 3 була офіційно випущена в середині 2024 року. Це була важлива віха, оскільки v3 представляє спрощення та модернізацію кодової бази. Мартін Блейс передбачав v3 як шанс "перегрупувати та спростити" систему далі. Хоча спочатку вважалося, що це буде велике переписування, на практиці оновлення для користувачів не було надто руйнівним. Основні зміни відбулися під капотом: новий парсер, деякі покращення продуктивності та виділення необов'язкових компонентів з ядра. Випуск впроваджувався поступово (v3 був у бета-версії з 2022 року, але до липня 2024 року він став рекомендованою стабільною версією). Користувачі, такі як Сіддхант Гоел, повідомили, що міграція з 2.x на 3.x була "переважно безпроблемною" лише з кількома змінами у робочому процесі.

• Модуляризація – інструменти переміщено в окремі пакети: Однією з великих змін у Beancount 3 є те, що багато інструментів, які раніше знаходилися в монолітному репозиторії, були виділені. Наприклад, bean-query тепер надається пакетом beanquery, а beancount.ingest було замінено пакетом beangulp. Команди, такі як bean-extract та bean-identify (для імпорту), були видалені з ядра Beancount. Натомість, філософія полягає у використанні окремих скриптів для імпорту. Це означає, що якщо ви оновитеся до v3, вам потрібно буде встановити beangulp та запускати скрипти імпорту (кожен імпортер – це, по суті, невелика програма), замість того, щоб мати центральний конфігураційний файл bean-extract. Аналогічно, запити виконуються через beanquery, який може встановлюватися та оновлюватися незалежно від ядра Beancount. Цей модульний підхід був розроблений для спрощення обслуговування та заохочення внесків спільноти. Він також зменшив ядро Beancount, тому ядро зосереджується виключно на логіці парсингу та обліку, тоді як допоміжна функціональність може розвиватися окремо. З точки зору користувача, після оновлення потрібно скоригувати команди (наприклад, використовувати bean-query з beanquery або використовувати Fava, яка все одно це абстрагує). Журнал змін Fava чітко зазначає ці зміни: Fava тепер залежить від beanquery та beangulp, і вона обробляє робочі процеси імпорту по-різному для Beancount 3 та 2.

• Покращення продуктивності: Продуктивність була однією з мотивацій для перегляду дизайну Beancount. План v3 (як викладено в документі Мартіна "Цілі V3") включав оптимізацію парсера та, можливо, прискорення процесу завантаження та зменшення споживання пам'яті. До 2025 року деякі з цих покращень були реалізовані. За словами користувачів, які мають дуже великі облікові книги (десятки тисяч транзакцій або багато операцій з акціями), вони повідомили про кращу продуктивність з останньою версією. Наприклад, користувач, який працює з "мікроінвестиційними транзакціями" і зіткнувся з проблемами продуктивності, зазначив ці занепокоєння в Google Group – такий зворотний зв'язок, ймовірно, вплинув на v3. Новий парсер є більш ефективним і написаний зрозуміліше, що може бути розширено в майбутньому. Крім того, Fava 1.29 перейшла на більш ефективний механізм відстеження файлів (використовуючи бібліотеку watchfiles) для покращення чуйності, коли змінюється облікова книга. Заглядаючи вперед, спільнота може дослідити інкрементальний парсинг (обробка лише змінених частин файлу замість всього) для швидшої обробки великих облікових книг – це було натякнуто в документації як ідея "сервера Beancount / інкрементального проведення операцій".

• Вдосконалення відстеження інвестицій: Триває робота над покращенням звітування про інвестиції та портфелі. Наприклад, детально обговорювалася обробка середньої собівартості проти FIFO. Хоча Beancount забезпечує відповідність партій, деякі користувачі віддають перевагу середній собівартості для певних юрисдикцій. Існує пропозиція та обговорення щодо того, щоб зробити проведення операцій за собівартістю більш гнучким (можливо, за допомогою плагіна або опції). До 2025 року вбудованого перемикача для середньої собівартості немає, але основа у v3 (переробка проведення операцій) полегшує реалізацію плагінами. Було випущено плагін спільноти "Gains Minimizer", який може пропонувати, які партії продати для мінімізації податків, показуючи тип розширених інструментів, що створюються навколо інвестицій. Fava також додала функції, такі як розширення зведення портфеля (з розрахунками норми прибутку). Щодо майбутніх функцій, можна очікувати більше в цій галузі: можливо, автоматичні пропозиції щодо ребалансування портфеля або аналіз ризиків, ймовірно, як зовнішні інструменти, які читають дані Beancount (оскільки всі дані є).

• Нові плагіни та розширення: Екосистема плагінів постійно зростає. Останні помітні доповнення включають:

  • Інструменти для звітування про бюджет – наприклад, простий CLI-звітник бюджету, якщо не використовується інтерфейс Fava.

  • Шифрування та безпека – було представлено налаштування fava-encrypt, що дозволяє розміщувати Fava онлайн із зашифрованою обліковою книгою в стані спокою, вирішуючи проблему самостійного розміщення ваших фінансів.

  • Плагіни для покращення якості життя – такі як autobean-format (новий форматер, який може обробляти більше особливих випадків шляхом парсингу та повторного друку файлу), та інтеграція beancheck в редакторах (flymake для Emacs).

    Заглядаючи вперед, спільнота, ймовірно, продовжить заповнювати прогалини за допомогою плагінів. Наприклад, ми можемо побачити більше плагінів, пов'язаних з податками (деякі користувачі поділилися скриптами для таких речей, як розрахунок фіктивних продажів або конкретних місцевих податкових звітів).

• Потенційні майбутні функції: На основі обговорень у трекері завдань та списку розсилки, на горизонті є кілька ідей (хоча не гарантовано):

  • Роздільна здатність часу: Наразі Beancount відстежує лише дати (без часових міток) для транзакцій. Були питання щодо додавання часу (для операцій з акціями або впорядкування транзакцій одного дня). Мартін Блейс чітко вирішив, що часові мітки в межах дня виходять за рамки, щоб зберегти простоту. Це навряд чи зміниться найближчим часом – тому майбутні версії, ймовірно, не додаватимуть роздільної здатності часу, дотримуючись позиції, що якщо вам потрібен час, ви включаєте його в опис або рахунок.
  • Покращене редагування графічного інтерфейсу: Fava постійно покращує свої можливості редагування. Можливим є більш повнофункціональний веб-редактор (з автозаповненням, можливо, введення нових транзакцій на основі форми). Було закладено основу для використання tree-sitter у редакторі Fava. Ми можемо побачити, як Fava стане не просто переглядачем, а більш потужним редактором, зменшуючи потребу взагалі відкривати текстовий редактор для багатьох завдань.
  • Краща підтримка кількох облікових книг: Деякі користувачі підтримують кілька файлів Beancount (для різних суб'єктів або для розділення особистих та ділових фінансів). Наразі включення файлів можливе, але мало обмеження (плагіни у включених файлах тощо). Нещодавно було створено плагін autobean.include для безпечного включення зовнішніх облікових книг. У майбутньому ми можемо побачити першокласну підтримку багатофайлових налаштувань – можливо, концепцію Beancount-«проєкту» з кількома файлами (на це натякають функції, такі як налаштування beancount.mainBeanFile розширення VSCode). Це допоможе тим, хто веде облік для кількох суб'єктів або хоче модуляризувати свою облікову книгу.
  • Обчислення в реальному часі або інкрементальне обчислення: Зі зростанням облікових книг здатність швидко перераховувати звіти стає важливою. Існує ідея сервера Beancount, який залишається запущеним і оновлює результати зі зміною транзакцій. Це може проявитися як оптимізація у Fava або демон, який плагіни редактора можуть запитувати. Можливо, майбутній випуск Fava використовуватиме безперервно працюючий процес Beancount, щоб зробити інтерфейс користувача більш чуйним для величезних облікових книг.
  • Облік фондів / функції для некомерційних організацій: Була пропозиція щодо вдосконалення обліку фондів у Beancount. Некомерційні організації мають облікові потреби (обмежені проти необмежених фондів), які потенційно можуть моделюватися за допомогою ієрархії тегів або рахунків Beancount. Обговорення ще не призвело до вбудованих функцій, але якщо більше некомерційних організацій почнуть використовувати Beancount, це може сприяти появі нових можливостей (можливо, просто задокументовані найкращі практики або плагіни для відстеження залишків фондів).

• Довгострокова перспектива: Мартін Блейс натякнув, що бачить майбутнє Beancount у перетворенні ядра на своєрідний двигун та перенесенні більшої функціональності до плагінів. Це відповідає тому, що ми бачимо (модуляризація у v3). Отже, "майбутня функція" у філософському сенсі – це більша розширюваність – можливо, навіть дозволяючи плагінам визначати нові типи директив або розширювати синтаксис контрольованими способами. Якщо це станеться, ядро Beancount може залишатися відносно невеликим і стабільним, тоді як екосистема надаватиме більшість нових функцій як доповнення. Це може призвести до маркетплейсу плагінів або більш централізованого списку плагінів, щоб користувачі могли вибирати (список Awesome Beancount є початком цього).

На завершення, екосистема Beancount у 2025 році є активною та розвивається. Випуск Beancount 3.0 став важливою останньою подією, що забезпечила міцну основу проєкту на майбутнє. Покращення продуктивності, інструментів та зручності використання (особливо через Fava) продовжували знижувати поріг входу. Хоча Beancount залишається інструментом, який вимагає певних знань, він набагато доступніший зараз, ніж кілька років тому, завдяки цим розробкам. Майбутні функції, ймовірно, зосереджуватимуться на удосконаленні досвіду – швидша продуктивність, кращі інтеграції та спеціалізовані розширення – а не на кардинальних змінах до основної філософії. Траєкторія розвитку спільноти св

Конфіденційність є основою нашої ДНК, нашої культури та наших цінностей. Ми зобов'язані захищати ваші дані в усіх наших системах.

І сьогодні ми раді відкрити вихідний код Beancount mobile. Це означає, що код є загальнодоступним і перевіряється людьми. Такий рівень прозорості забезпечує як безпеку Додатка, так і ваш спокій щодо того, що ми робимо з вашими даними.

Відкритий вихідний код надає нашим клієнтам більше вибору на ринку та кращі рішення в багатьох аспектах. Ми створюємо Beancount.io на основі чудових проєктів з відкритим вихідним кодом і сподіваємося відкрити вихідний код якомога більшої кількості модулів нашої системи в майбутньому. І Beancount mobile — це лише початок цього шляху :)