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, Java, Ledger and Taskwarrior.
Scripts included:
- accountsof - outputs the name of all accounts used in a Ledger journal file
- cljminimal - creates an ultra barebones deps.edn clj project for quick hacking
- depo - adds dependencies to Clojure projects. Supports
deps.edn,project.clj,shadow-cljs.edn. - jrun - single file Java runner
- keepbooks - simple transaction entry helper for Ledger CLI accounting. Supports interactive entry.
- on-modify-log - a Taskwarrior hook to log the latest modified task
- projectsof - finds directories of certain project types
- resumetask - resumes latest modified Taskwarrior task
- startnewtask - creates and starts a new Taskwarrior task
- stoptasks - stops all active Taskwarrior tasks
- taskinfo - prints the attribute of a Taskwarrior task
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.
To uninstall, simply call uninstall-some-scripts and all the scripts will be deleted from ~/.local/bin.
Outputs the names of all the accounts used in a Ledger journal file. Example: accountsof LEDGERFILE.
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.
Adds dependencies to Clojure projects. To use, run the script at the root of a project containing a deps.edn, project.clj or shadow-cljs.edn file. If multiple config files are present, the first config file in the order of deps,project,shadow-cljs will be selected.
depo add reagent
# Added [reagent "1.2.0"]If multiple config files are present, you can use -f to specify which file to add a dependency to.
depo add reagent -f deps.edn
# Added {reagent/reagent {:mvn/version 1.2.0}}You can also specify a version.
depo add reagent 1.1.0
# Added [reagent "1.1.0"]Depo can currently only search for dependencies from Clojars. For a more powerful alternative, checkout neil.
Compiles and runs a single java file. Mainly used for quick iteration of ideas. For example, you can run it in Vim with :!jrun App.java and see the output in a Vim buffer without leaving your current buffer.
jrun JAVAFILEThe JAVAFILE argument is glob-searched, so you can use App.java or App and it will still run.
A helper script to enter a simple transaction into a Ledger file.
The script has the following format in single entry mode:
keepbooks -f LEDGERFILE -d DATE PAYEE? ACCOUNT_TO_DEBIT ACCOUNT_TO_CREDIT AMOUNT CURRENCYThe -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:Bankkeepbooks also supports interactive entry. Simply call keepbooks -f LEDGERFILE without any arguments and you will be prompted to enter your transaction.
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.
Searches the current working directory for project directories of a certain type. For example, calling projectsof java will return all the directories which are java projects. Requires rg to run.
-n- displays numbered rows-i NUMBER- outputs directory with line number-i
- Clojure/Clj
- Java
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.
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 taskStops 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 descriptionThe resumetask script depends on this script.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent