Decline from the command line

Quick lookups and scripting, no code.

Install

# From a checkout (until published to a package channel — see ../DISTRIBUTION.md):
cargo install --path crates/keinontolibrary-cli
# or run in place:
cargo run -p keinontolibrary-cli -- <args>

The CLI reads the artifact at data/artifact/keinontolibrary.bin (override with --artifact or $KEINONTO_ARTIFACT) and an overlay at data/overlay.jsonl (--overlay / $KEINONTO_OVERLAY).

Decline one slot

keinontolibrary decline hevonen --number plural --case inessive
# hevonen (plural inessive): hevosissa  (Present, Lookup)

keinontolibrary decline kuka --number singular --case accusative
# kuka (singular accusative): kenet  (Present, Generated)

The whole paradigm

keinontolibrary paradigm talo
# talo (tn=1)
#   singular nominative   talo
#   singular genitive     talon
#   ...

Declension tables

table renders the full paradigm as a case-rows × singular/plural-columns grid, for one or more words at once. Defective slots show an em dash (—).

keinontolibrary table talo
# talo (tn 1)
# case         singular  plural
# nominative   talo      talot
# genitive     talon     talojen
# ...
# comitative   —         taloineen, taloinensa

Pick the output with --format (text default, markdown, csv, json):

keinontolibrary table aika --format markdown    # GitHub table, with a tn heading
keinontolibrary table parfait --format csv      # case,singular,plural (RFC-4180 quoting)
keinontolibrary table talo --format json        # the full Paradigm as JSON

# Several words; --tn/--hn disambiguate and apply to each:
keinontolibrary table talo koira kissa
keinontolibrary table kuusi --tn 27

Exit code 3 if any requested word could not be resolved.

Disambiguate homonyms

keinontolibrary decline kuusi --number singular --case inessive
# 'kuusi' is ambiguous; pass --tn (or --hn):
#   tn=24
#   tn=27
keinontolibrary decline kuusi --number singular --case inessive --tn 27
# kuusi (singular inessive): kuusessa

Add or correct a word (overlay)

keinontolibrary add --lemma uudissana --tn 9 \
    --number singular --case inessive --forms uudissanassa
# overlay: uudissana singular inessive = ["uudissanassa"]

override is an alias of add (the overlay is upsert-by-key — last write wins). New overlay entries are immediately declinable and persist to the overlay file.

JSON output

keinontolibrary decline talo --number plural --case adessive --json
# {"variants":["taloilla"],"status":"present","source":"lookup","coincides_with":null}

Exit codes (for scripts)

if keinontolibrary decline "$w" --number singular --case genitive --json >/tmp/out; then
    jq -r '.variants[0]' /tmp/out
else
    echo "no form for $w (exit $?)"
fi

validate — inspect the loaded artifact

keinontolibrary validate
# version, lemma count, form count, and the Kotus / reference-corpus provenance.

selftest — verify an install

selftest declines a built-in golden set through the rule engine and registry and checks each form. It needs no artifact or data file, so it’s the smoke test to run right after installing from any channel (cargo, brew, apt, the container, …). Exit 0 if every check passes, 1 on any mismatch.

keinontolibrary selftest
# ok   talo singular inessive: talossa (want talossa)
# ok   aika singular genitive: ajan (want ajan)
# ...
# selftest: 8 checks passed