beangulp icon indicating copy to clipboard operation
beangulp copied to clipboard

idea: Tool to manipulate Beancount ledgers

Open dnicolodi opened this issue 4 years ago • 4 comments

We already discussed a bean-insert command to insert transactions (or better directives) replacing a marker in an existing ledger. I think that a bean-sort command that sorts entries in different ways would also be useful (for example, it would be a solution for #10). Each tool is really just a few lines of code and I don't want to have an unbound proliferation of little command line utilities.

What about introducing a "Beancount Swiss army knife" command line tool that has commands for all these operations? Where should it live? In the beancount or in the beangulp repository? How should it be named? I like bean-slice but I don't think there will ever be a slicing command and bean-slice sort and bean-slice insert do not seem very natural. Better ideas?

dnicolodi avatar Feb 19 '21 21:02 dnicolodi

More naming ideas. The obvious: bean-tool or bean-tools. Maybe simply beangulp or bean-gulp? bean-gulp sort or bean-gulp insert do not seems too bad. The short: beans. I like beans sort and beans insert but we break the tradition of naming the commands bean-something and it may collide with something else. My favorite is bean-gadget.

dnicolodi avatar Feb 19 '21 21:02 dnicolodi

I like bean-tool, though it's a bit too generic If it's specific to bean-gulp, yeah, I like "bean-gulp", we have no other binaries anymore anyway bean-sort is not really specific to gulp though, so maybe that should be part of bean-doctor? Also look in beanlabs, I have some stuff, e.g. bean-grep BTW that's what bean-doctor was intended for, but I think we should think about segregating the different functionalities logically Let's hash out lists before we commit

On Fri, Feb 19, 2021 at 4:23 PM Daniele Nicolodi [email protected] wrote:

More naming ideas. The obvious: bean-tool or bean-tools. Maybe simply beangulp or bean-gulp? bean-gulp sort or bean-gulp insert do not seems too bad. The short: beans. I like beans sort and beans insert but we break the tradition of naming the commands bean-something and it may collide with something else. My favorite is bean-gadget.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/beancount/beangulp/issues/42#issuecomment-782362618, or unsubscribe https://github.com/notifications/unsubscribe-auth/AACSBEZ7UBKQO6CSGGDJNG3S73JEHANCNFSM4X5BJQWA .

blais avatar Feb 19 '21 22:02 blais

I don't know what other tools could be generally useful beyond a sorting tool and a insert tool as we discussed.

I think a good criterion would be to distinguish tools that modify the ledger from tools that do not. I think bean-gadget could be the place for tools that modify the ledger and bean-doctor for tools that query the ledger.

dnicolodi avatar Feb 20 '21 15:02 dnicolodi

This is a useful distinction, I like it. I like the name bean-gadget too.

blais avatar Feb 20 '21 16:02 blais