LESANA(1)

📦
version 0.10.1 · 5 versions
, in debian trixie, ubuntu questing

💖 LESANA(1) — the lesana manual, but make it a group chat 💖

okay so bestie, welcome to lesana, section 1 of the manual. she's a whole vibe and she manages collection inventories. let's get into it ✨

🌸 NAME 🌸

lesana — manages collection inventories 🫶

✨ SYNOPSIS ✨

lesana [–help] <command>

🦋 DESCRIPTION 🦋

so. lesana is a tool for organizing collections of, like, any kind. and the way she's built? it's giving data storage / serialization format that is friendly to git and other VCSs, but also decent performances. both. she said why not both 💅

to pull that off she uses yaml as her serialization format, because yaml is easy to store in a VCS, easy to share between people, and easy to synchronize between different computers. no cap. but she also keeps an index of all that data in a local xapian database, and that's the whole point: it's what lets her do fast searches 🔥

lesana supports collections of any kind, as long as their entries can be described with a mostly flat dictionary of fields — of the types described in the documentation file field_types. that's the requirement. that's it. iconic honestly.

some example collection schemas are provided 🎀 but like, one big strength of lesana is being able to customize your collection with custom fields, either by simply writing a personalized settings.yaml. yes bestie, just a settings file. she's lowkey so flexible it's unreal.

💅 OPTIONS 💅

  • -h, --help — prints a help message and exits. that's it, that's the option. she said one (1) option and it's the polite one 🙈

👑 COMMANDS 👑

  • new(1) — creates a new entry.
  • edit(1) — edits an existing entry.
  • show(1) — shows an existing entry.
  • index(1) — index some entries in the xapian cache.
  • search(1) — searches for entries in the xapian cache.
  • export(1) — exports entries from one lesana collection to another.
  • init(1) — initialize a new lesana collection.
  • rm(1) — removes an entry.

🧚 TEXT EDITOR 🧚

bestie listen, a bunch of lesana subcommands are gonna try to open files in a text editor, and the way she picks which editor is a whole little priority list. here's the order she goes in:

  • first, the value of $EDITOR is tried 👀
  • then the command sensible-editor, as available under e.g. Debian and its derivatives
  • lastly, she'll try to fallback to vi, which should be available under any posix system. so worst case, you're still covered 💜

🌈 AUTHOR 🌈

valhalla@trueelena.org

2020-2021, Elena Grandi

and that's the page, periodt ✨ this was version 0.10, dated Jan 29, 2025, and yeah — lesana(1), she ate and left no crumbs 🎀💅🫶

📦 where this page comes from