Command line tools for BeanHub
Project description
beanhub-cli ![CircleCI](https://pypi-camo.freetls.fastly.net/6a031bbcf2c57aa1af277e3d92c7eb4800688ae3/68747470733a2f2f646c2e636972636c6563692e636f6d2f7374617475732d62616467652f696d672f67682f4c61756e6368506c6174666f726d2f6265616e6875622d636c692f747265652f6d61737465722e7376673f7374796c653d737667)
Command line tools for BeanHub.
Features
- Local BeanHub Form web app - You can run a BeanHub Form web app locally to try out your forms
- Formatter - Advanced Beancount file formatter based on top of beancount-black
- Basic Beancount file manipulations - Effortless Beancount account name renaming and other basic manipulations (coming soon)
- Doesn't require a BeanHub account - While some features in the future will require a BeanHub repository to operate, but we make most of them usable even without a BeanHub account
Screenshots
Sponsor
A modern accounting book service based on the most popular open source version control system Git and text-based double entry accounting book software Beancount.
Install
pip install beanhub-cli
Usage
BeanHub Forms web app
To make it much easier for BeanHub users to test their BeanHub Forms locally, we added a simple local web app for that in beanhub-cli. You can run it by
bh form server
It should open the BeanHub Forms web page locally at http://localhost:8080 by default.
It reads the .beanhub/forms.yaml
file from the current directory and will modify beancount files in the directory, so make sure you cd to your beancount directory before running the command.
To learn more about BeanHub Forms, please read our blog post Automating Beancount data input with custom forms makes your life 10 times easier!.
List BeanHub Forms
To list BeanHub Forms, simply run
bh form list
Validate BeanHub Forms doc
To validate BeanHub Forms doc, simply run
bh form validate
Format beancount files
You can run beancount-black formatter against given files by the following command
bh format main.bean
Currently, the formatter works mostly the same as beancount-black, except it doesn't create a backup file by default. We are working on adding new features, such as making it possible to follow Beancount include statements to format all Beancount files.
More features to come
We are working on basic beancount file manipulation features, such as renaming account names. We will also add new features only for BeanHub users as well. But in general, if possible, we would like to make the features added to beancount-cli work locally without a BeanHub account as much as possible so that the beancount community can benefit from it.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for beanhub_cli-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8acef1ab019d472f34383a70282e91ec5f1ad162ed5c86e6df17819c3c10df60 |
|
MD5 | 65f24206001190a8659daded0b72ce02 |
|
BLAKE2b-256 | 0f5362695195a62bcb2b0a50dd5a9b555e8ea64d86caf8db3748fc6c1e885c44 |