A simple async budgeting app to manage expenses and budgets in google spreadsheets
Project description
Budget CLI
A simple terminal app written in Python to manage budgets and expenses in Google Sheet.
Features
- Ability to track incomes and expenses as transactions
- Ability to list transactions by month
Installation
pip install budgetcli
In order to use the app you need first to enable Google Spreadsheet API and to generate app credentials with a
client_id
and a client_secret
.
Please follow the following link for more details: Authorize credentials for a desktop application
Configuration
Before start adding transactions and data, you need to do the following steps:
Provide the google spreadsheet id
budgetcli config spreadsheet-id ID
Copy the client_secret_XXX.json to app config
budgetcli config credentials-file-path /path/to/client_secret.json
Authorize the app access to spreadsheet data
budgetcli auth
Init sheet tables headers
budgetcli init
Usage
The commands follow the below structure.
budgetcli <VERB> <OBJECT> <OPTIONS>
Incomes
To add an income you need to provide only an amount and a category. By default, all the income transactions are added with default today date and without no description.
Add an income
budgetcli add income 5000 Salary
Add an income with description
budgetcli add income 500 projects --description "Project A"
Add an income with date and description
budgetcli add income 500 projects --description "Project A" --date 2023-04-01
Outcomes
Same for outcome transactions, you need to provide only an amount and a category. By default, all the outcome transactions are added with default today date and without no description.
Add an outcome
budgetcli add outcome 400 Rent
budgetcli add outcome 400 Rent --date 2023-05-01 --description "Rent for April"
List transactions
List transactions. Default first 100 rows
budgetcli list transactions
List only first 10 transactions
budgetcli list transactions --rows 10
List transactions for a specific month
budgetcli list transactions --month April
Project details
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 budgetcli-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e241ac39f9f9ceb4f3fac711fd4740df462a65c2e48c7eebb6f7acc2efdfa25c |
|
MD5 | bc5d513c45fa7f5361f8bdfb7341ccb7 |
|
BLAKE2b-256 | e1dc02b0c87036ff7e66be9e463abd274846e4fdae9d6e0314a6b0f2ff31f447 |