diff options
Diffstat (limited to 'examples/tools')
| -rwxr-xr-x | examples/tools/finance.sh | 30 | ||||
| -rw-r--r-- | examples/tools/finance.toml | 12 | ||||
| -rwxr-xr-x | examples/tools/mail.sh | 11 |
3 files changed, 36 insertions, 17 deletions
diff --git a/examples/tools/finance.sh b/examples/tools/finance.sh index 3c6f768..0656b66 100755 --- a/examples/tools/finance.sh +++ b/examples/tools/finance.sh @@ -15,10 +15,11 @@ # with this program; if not, write to the Free Software Foundation, Inc., # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. # -# finance.sh WHAT [DAYS]: WHAT is balances (active asset accounts), -# budgets (this month, spent against the limit) or spending (withdrawals in -# the last DAYS days, default 30: total and the 10 largest). Only firefly's -# list commands run here: nothing is recorded or edited. +# finance.sh WHAT [SINCE] [ACCOUNT]: WHAT is balances (active asset +# accounts), budgets (this month, spent against the limit) or spending +# (withdrawals from SINCE, YYYY-MM-DD, default the first of this month, +# optionally only from ACCOUNT: total and the 10 largest). Only firefly's list commands run here: nothing is recorded +# or edited. set -uo pipefail @@ -36,13 +37,24 @@ budgets) + " \(.currency_code // "")"' ;; spending) - days="${2:-30}" - since=$(date -d "$days days ago" +%F) || exit 1 - ff tx list --since "$since" --all --flat 2>/dev/null | jq -r --arg since "$since" ' + since="${2:-$(date +%Y-%m-01)}" + date -d "$since" >/dev/null 2>&1 || { echo "since must be YYYY-MM-DD" >&2; exit 1; } + account=() + if [ -n "${3:-}" ]; then + # firefly's own "no such account" lists every expense account too; + # the model only needs the user's own accounts to retry. + names=$(ff account list --type asset | jq -r '.[] | select(.active) | .name') + grep -qixF -- "$3" <<<"$names" \ + || { echo "no account named $3; accounts: $(paste -sd, <<<"$names")" >&2; exit 1; } + # The per-account listing needs an end date, or the API rejects it. + account=(--account "$3" --until "$(date +%F)") + fi + json=$(firefly tx list --since "$since" "${account[@]}" --all --flat) || exit 1 + jq -r --arg since "$since" --arg acct "${3:-all accounts}" ' [.[] | select(.type == "withdrawal") | .amount |= tonumber] - | "spent since \($since): \(map(.amount) | add // 0 | . * 100 | round / 100) in \(length) payments", + | "spent from \($acct) since \($since): \(map(.amount) | add // 0 | . * 100 | round / 100) in \(length) payments", (sort_by(-.amount)[:10][] - | "\(.date[:10]) \(.amount * 100 | round / 100) \(.destination_name): \(.description)")' + | "\(.date[:10]) \(.amount * 100 | round / 100) \(.destination_name): \(.description)")' <<<"$json" ;; *) echo "what must be balances, budgets or spending" >&2 diff --git a/examples/tools/finance.toml b/examples/tools/finance.toml index b05031c..1cfdc4a 100644 --- a/examples/tools/finance.toml +++ b/examples/tools/finance.toml @@ -1,5 +1,5 @@ description = "The user's money, from Firefly III: account balances, this month's budgets, or recent spending. Read-only." -command = ["finance.sh", "{what}", "{days}"] +command = ["finance.sh", "{what}", "{since}", "{account}"] timeout = 20 announce.it = ["Controllo i conti."] announce.en = ["Checking your accounts."] @@ -8,6 +8,10 @@ announce.en = ["Checking your accounts."] type = "string" description = "balances, budgets or spending" -[params.days] -type = "integer" -description = "For spending: how many days back. Empty for 30." +[params.since] +type = "string" +description = "For spending: first day, YYYY-MM-DD. Empty for the first of this month." + +[params.account] +type = "string" +description = "For spending: only this account, by name as balances lists it. Empty for all accounts." diff --git a/examples/tools/mail.sh b/examples/tools/mail.sh index 4e0e9c1..bd7219d 100755 --- a/examples/tools/mail.sh +++ b/examples/tools/mail.sh @@ -23,8 +23,11 @@ set -uo pipefail query="${1:-tag:unread and tag:inbox}" -json=$("${MAILCTL:-mailctl.py}" search "$query" --json) || { echo "mail search failed" >&2; exit 1; } -jq -r 'length as $n - | if $n == 0 then "no threads match" - else "\($n) threads", (.[:10][] | "\(.date_relative), \(.authors): \(.subject)") +mailctl="${MAILCTL:-mailctl.py}" +json=$("$mailctl" search "$query" --json) || { echo "mail search failed" >&2; exit 1; } +# Messages and threads both: the model otherwise calls threads "emails". +msgs=$("$mailctl" count "$query" | awk '{print $1}') || { echo "mail count failed" >&2; exit 1; } +jq -r --arg msgs "$msgs" 'length as $n + | if $n == 0 then "no messages match" + else "\($msgs) messages in \($n) threads", (.[:10][] | "\(.date_relative), \(.authors): \(.subject)") end' <<<"$json" |