sonaveeb-cli

CLI for querying Estonian word forms from the Ekilex API.

Installation

go install github.com/lars/sonaveeb-cli@latest

Or build from source:

go build -o sonaveeb-cli .

Configuration

Get an API key from your Ekilex profile page.

Precedence (highest to lowest):

1. Environment variable
2. Local config file (./config)
3. User config file (~/.config/sonaveeb/config)

Environment variable

export EKILEX_API_KEY="your-key-here"

Config file

Just the API key on a single line (no formatting):

echo "your-key-here" > config                       # local
echo "your-key-here" > ~/.config/sonaveeb/config    # user

Usage

sonaveeb-cli [flags] <word>

Flags

• -json - Output raw JSON from API
• -all - Show all forms (not just key forms)
• -homonym=N - Select which homonym to show (when multiple exist)
• -q, -quiet - Minimal output (forms only)
• -version - Print version
• -h - Show help

Examples

# Noun - shows key forms
sonaveeb-cli puu
# puu (noun, type 26)
#   ainsuse nimetav:                    puu
#   ainsuse omastav:                    puu
#   ainsuse osastav:                    puud
#   mitmuse osastav:                    puusid

# Verb - shows key forms
sonaveeb-cli tegema
# tegema (verb, type 28)
#   ma-tegevusnimi:                     tegema
#   da-tegevusnimi:                     teha
#   kindel kõneviis olevikus 3.p:       teeb
#   mineviku kesksõna umbisikuline:     tehtud

# Word with multiple homonyms
sonaveeb-cli pank
# pank (noun, type 22)  [1 of 3 — use --homonym=N for others]
#   ainsuse nimetav:                    pank
#   ...

# Select specific homonym
sonaveeb-cli --homonym=2 pank

# All forms
sonaveeb-cli -all puu

# JSON output
sonaveeb-cli -json puu