On 27/10/24 06:25, Martin Michlmayr wrote:
I haven't found any good Beancount v3 upgrade documentation, so I
start collecting some notes. Maybe this can be put into Google Docs
and improved upon.
# Changes in v3
* Several tools were split into separate projects:
* [beanquery](https://github.com/beancount/beanquery/): lightweight SQL
query tool.
* [beangulp](https://github.com/beancount/beangulp): import framework for
beancount. This is the evolution of beancount's `beancount.ingest`.
* [beancount2ledger](https://github.com/beancount/beancount2ledger):
converter from beancount to ledger.
also beanprice https://github.com/beancount/beanprice
* bean-report was deprecated in beancount v2 and has been removed in beancount
v3.
* [beanquery](https://github.com/beancount/beanquery/) is the preferred way
to query beancount data.
* [Fava](https://github.com/beancount/fava) is a web UI to interact with
beancount journals.
bean-web has been removed too.
[...]
## beanquery
* beanquery is compatible with beancount v2 and v3
* beanquery has a lot of improvements over the older bean-query in beancount v2.
Documentation is being worked on (Daniele, is there something to link to; or "look
at source code" for now?)
The documentation will be living here
https://beancount.github.io/beanquery/ but so far there isn't much to
look at. I haven't done much more than preparing the infrastructure to
publish the documentation. Any contribution is very welcome.
Looking at the source code is always a good way to learn, but
extrapolating the SQL dialect understood by beanquery looking at the
source code may require more effort than the average reader is willing
to invest. The test cases are maybe the best starting point but, because
of its history, the code organization is not the most obvious, and the
relevant tests are a bit scattered around. Refactoring is in progress
but, it not being the most fun thing to do, the progress is slow.
Another good way to grasp what has changed is to look at the merged PRs
https://github.com/beancount/beanquery/pulls?q=is%3Apr+is%3Aclosed
Cheers,
Dan
--
You received this message because you are subscribed to the Google Groups
"Beancount" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/beancount/d42a926d-9047-4bba-a9b4-c39b1f882a56%40grinta.net.
