Skip to content

A collection of helper scripts for Clojure, Java, Ledger and Taskwarrior. Written in Clojure.

License

Notifications You must be signed in to change notification settings

somecho/utility-scripts

Repository files navigation

Somē's utility scripts

Here are some utility scripts I wrote for myself. At first I wrote the scripts in a shell scripting language. But then I discovered Babashka and I love Clojure. I decided to port all the scripts to Clojure instead. You will need Babashka to run these scripts. These are helper tools for Clj, Ledger and Taskwarrior.

Scripts included:

  1. cljminimal - creates an ultra barebones deps.edn clj project for quick hacking
  2. keepbooks - simple transaction entry helper for Ledger CLI accounting
  3. on-modify-log - a Taskwarrior hook to log the latest modified task
  4. resumetask - resumes latest modified Taskwarrior task
  5. startnewtask - creates and starts a new Taskwarrior task
  6. stoptasks - stops all active Taskwarrior tasks
  7. taskinfo - prints the attribute of a Taskwarrior task

Installation

You need to first install Babashka.

git clone https://github.com/somecho/utility-scripts
cd utility-scripts
./install.clj 

This will copy all the scripts into ~/.local/bin. Make sure ~/.local/bin is in your path to call the scripts globally.

Uninstalling

To uninstall, simply call uninstall-some-scripts and all the scripts will be deleted from ~/.local/bin.

Scripts

A script to create an ultraminimal clj project with an empty deps.edn and a singular hello world main function. To use, simply call cljminimal my-minimal-clj-project and a project called my-minimal-clj-project will be created for you. Mainly used for quick hacking and throwaway prototyping.

A helper script to enter a simple transaction into a Ledger file. The script has the following format:

keepbooks -f LEDGERFILE -d DATE PAYEE? ACCOUNT_TO_DEBIT ACCOUNT_TO_CREDIT AMOUNT CURRENCY

The -d DATE field is optional. If this flag is ommitted, the current date will be used. The PAYEE field is also optional. If the PAYEE is ommitted, no payee will be entered in the transaction. The other fields ACCOUNT_TO_DEBIT, ACCOUNT_TO_CREDIT, AMOUNT and CURRENCY are required fields. The ordering is strict. Upon entering a successful command, the ledger entry will be written into the ledger file provided and also printed out in the commandline.

keepbooks -f 2023.ledger -d 2023/07/20 Sushi Bar Expenses:Restaurant Assets:Bank 30.00 EUR
# prints out:
# 2023/07/20 Sushi Bar
#   Expenses:Restaurant                       30.00 EUR
#   Assets:Bank

A Taskwarrior hook to log latest modified task. This script is not installed in ~/.local/bin. Instead, it requires you to copy it to your Taskwarrior's hooks folder. This is usually ~/.task/hooks. Every time a task is modified, it writed the UUID of the task in a file called last-modified.data in your Taskwarrior's data.location. This hook is required for the resumetask script to work.

Ever wanted to just restart the Taskwarrior task you stopped right before a break? With this script, you can just pick up where you left off by calling resumetask. No more trying to figure what ID your task has! This script requires the on-modify-log hook to work and the taskinfo script to work.

Why use hooks?

Some people suggest having a shell alias that starts a task and exports it as an environment variable. But since I use Syncthing to sync my tasks across devices, this will not work if I stopped a task on one device and want to resume it on another. By saving the last modified task's UUID in Taskwarrior's data.location, I can have the UUID synced as well.

Creates and immediately starts a Taskwarrior task. Use this as you would task add.

task add +admin +bookkeeping track finance # adds a task to Taskwarrior
startnewtask +admin +bookkeeping track finance # adds and starts task

Stops all active Taskwarrior tasks. Every tried task stop and gotten an error? Yeah, me too. Now you can stop all active tasks with a single stoptasks.

Prints the attribute of a Taskwarrior task. Commands follow this format:

taskinfo TASKID TASKATTRIBUTE
# example: taskinfo 40 description

The resumetask script depends on this script.

Change log

About

A collection of helper scripts for Clojure, Java, Ledger and Taskwarrior. Written in Clojure.

Topics

Resources

License

Stars

Watchers

Forks