KAPLA-SQLITE-IMPORT(1)

📦 version 0.4.0, in nixpkgs unstable

💅 KAPLA-SQLITE-IMPORT 💅

okay so bestie, welcome to the kapla-sqlite-import page from the Kapla Manual — yes that's the whole manual name, we're being fancy today 🎀 — and it's literally just one job: getting your blocks out of an SQLite database and into the block store. let's get into it ✨

🌸 NAME 🌸

kapla-sqlite-import — Import blocks from an SQLite database. that's it, that's the whole vibe 🦋

✨ SYNOPSIS ✨

kapla sqlite import [--socket=ERIS_UNIX_SOCKET] [OPTION]… SQLITE_DB

so you call kapla sqlite import, you can slip it a --socket=ERIS_UNIX_SOCKET if you want, you can throw as many [OPTION]… at it as your heart desires, and then you hand it the SQLITE_DB. periodt 💅

🫶 ARGUMENTS 🫶

  • SQLITE_DB (required) — the SQLite database that's holding all your ERIS blocks. required, so like… don't forget it, bestie. it's giving non-negotiable 🙈

👑 OPTIONS 👑

  • -s ERIS_UNIX_SOCKET, --socket=ERIS_UNIX_SOCKET — the Unix socket where the ERIS block store is listening. if you don't pass it, it gets picked up in this order (absent = first one that exists, basically): $XDG_STATE_HOME/kapla/eris.sock, then $HOME/.local/state/kapla/eris.sock, then /var/lib/kapla/eris.sock, or the ERIS_UNIX_SOCKET env var. iconic little fallback chain ngl 🔥

🌈 COMMON OPTIONS 🌈

  • --color=WHEN (absent=auto) — Colorize the output 💖 WHEN has to be one of auto, always or never. no other options, we don't do chaos here (affectionate).
  • --help[=FMT] (default=auto) — Show this help in format FMT. FMT must be one of auto, pager, groff or plain. with auto, the format is pager or plain whenever the TERM env var is dumb or undefined. iykyk 🧚
  • -q, --quiet — Be quiet 🤫. takes over -v and --verbosity. like, fully overrides them, no debate.
  • -v, --verbose — Increase verbosity. repeatable, but more than twice does not bring more. so -vv is the ceiling, -vvv is just you being extra for no reason 😭💀
  • --verbosity=LEVEL (absent=warning or KAPLA_LOG_LEVEL env) — Be more or less verbose. LEVEL must be one of quiet, error, warning, info or debug. takes over -v. yeah, they fight, and this one wins 🥊
  • --version — Show version information. slay ⭐

🦋 EXIT STATUS 🦋

kapla sqlite import exits with:

  1. 0 — on success. we love a happy ending 💜
  2. 123 — on indiscriminate errors reported on standard error. the generic "something went wrong" energy 🙈
  3. 124 — on command line parsing errors. you typed something sus, bestie 💀
  4. 125 — on unexpected internal errors (bugs). not me… 😭 that's a us problem, file it fr fr

🎀 ENVIRONMENT 🎀

these environment variables affect the execution of kapla sqlite import:

  • ERIS_UNIX_SOCKET — Unix socket where ERIS block store is listening. same socket as the -s/--socket option, just vibing in your env 🌸
  • KAPLA_LOG_LEVEL — Set the log level. (yes the original has that extra space before "Set", we're preserving the lore ✨)

💀 SEE ALSO 💀

  • kapla(1) — go read the main character's page, it's giving root of all things 👑
🫶 friendly reminder: every flag, every value, every fallback path above is exactly as written — don't go renaming stuff, the manpage is canon 💅

and that's the page, bestie!! brought to you by Kapla 0.4.0 — version 0.4.0 of the Kapla manual, page KAPLA-SQLITE-IMPORT(1), no cap ⭐🎀✨

📦 where this page comes from