v0.6.0
Home GitHub

Database Commands

Register, list, rename, and remove KuraDB databases with kura add, kura list, kura edit, and kura remove.

Add a database

kura add my_docs

The first argument is used as the name. Runs of whitespace are converted to underscores; an empty result is rejected with status 2. The command refuses a name already in the registry or a target directory that already exists.

On success it creates:

~/.config/kuradb/my_docs/inbox/
~/Kura_my_docs -> ~/.config/kuradb/my_docs/inbox/

It then appends an entry with a UTC creation time to db.json and prints the directory and link paths. The running daemon does not hot-load the new database, so restart it before searching.

List databases

kura list

Each line contains a database name and its UTC RFC 3339 creation time, separated by a tab. An empty registry prints (no registered db).

kura list reads only the registry. To see which databases the running daemon actually loaded, use GET /api/list, which returns both registered and loaded collections.

Rename a database

kura edit my_docs my_archive

The command sanitizes both names the same way as add, then:

  1. Prints noop and exits when the old and new names are identical.
  2. Rejects an old name that is not registered, a new name that is already registered, or an existing target directory.
  3. Renames the database directory.
  4. Removes the old ~/Kura_<old> symlink and creates ~/Kura_<new>; a symlink failure is reported but does not stop the rename.
  5. Updates the registry entry.

Because the daemon keeps its startup-time database map, stop it before a rename and start it again afterwards.

Remove a database

kura remove my_archive

Removal prints the database directory and symlink, then requires the exact response yes. Any other response prints aborted and changes nothing. Confirmation permanently removes the database directory, removes the home path only when it is a symlink (a regular file or directory there is skipped with a warning), and deletes the registry entry.

This operation deletes the authoritative SQLite database. Back up required data before confirming.

中文