Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

blossom

Double entry plain text accounting for traders

Blossom is a yet another plain text acount application cli similar to Ledger-cli, Hledger and Beancount. As with the other similar implementations:

  • blossom works locally, without interacting with webs servers, banks or the like, your data stays with you.
  • As it's plain text, you can store your files in whatever source control repository or document management system you like. I don't recommend storing them on github.com!
  • blossom only reads your data, it doesn't know how to write and won't smash up your data.
  • a small eco-system of helper utilities is in the planning (pretty-print, price import, etc - rather custom)

Does it work yet?

Yes and no. It works, but it doesn't do a whole lot and is not overly optimised. For "toy" inputs, it works fine, and I have successfully converted a ~2500 line input into the tool. But on the flip side, not all the features are there and the outputs are rather basic.

Can I contribute?

There's not much to contribute to right now, star the project and come back later.

Why is there another clone of ledger?

  1. I find that the other systems don't cater well for more advanced trading strategies such as options or futures, which large numbers of trading assets (100+ can soon accrue).
  2. My use of MS Money for the last 15 years didn't really cut it for trading and multicurrency handling; it's long dead and I needed another solution.
  3. I want to customize reports inside the app rather than have to write on top of results from others.
  4. I felt like a challenge!

Differences to others

After the initial accounting portions which are fairly standard across pta software (balance checking, validations, reporting etc), there is a focus on trading support:

  • Enhanced PnL reporting taking into account expenses, transfers, cross currency impact
  • Support for non-nav assets such as mtm futures
  • Possible future support for risk, stress reports (option evaluation, derivatives linkage to underlyings, volatility surfaces etc) for OTC products.

Most of the "standard" formatting works in blossom, although there some extra helpers and formatting supported to cut down on boilerplate and monotonous copy/paste. You can see some of the format ideas at https://github.com/simonjpascoe/blossom/blob/master/JournalFormat.md.

Plans

I'm currently migrating a bigger codebase from my initial implementation into this repository and upgrading several features.

  1. Migrate existing infrastructure
  2. Code up and improve original accouting
  3. Add more checks / validation
  4. Focus trading expanding features
  5. Add a VSCode extension for both editing and processing the data.

Releases

No releases published

Packages

No packages published

Languages

You can’t perform that action at this time.