bepasty-object(1)

📦
version 1.2.2 · 6 versions
, in ubuntu stonking

✨ NAME ✨

bepasty-object — the little tool that manages the objects your bepasty storage is holding 💖

(it lives in the General Commands Manual section, if you were wondering, bestie 👑)

🌸 SYNOPSIS 🌸

bepasty-object [-h] [--config CONFIG]
{    migrate,purge,consistency,info,set} ... NAME [NAME ...]

okay so that {migrate,purge,consistency,info,set} thing is your subcommand menu, and then you hand it one or more NAMEs. That's it, that's the shape of it 💅

🦋 DESCRIPTION 🦋

bepasty-object does stuff to the objects stored in the bepasty storage. Migrating them, purging them, checking them, peeking at them, flagging them — it's giving caretaker energy fr fr 🧚

Every single command needs one of two things:

  • a --config <configfilename> argument, or
  • the BEPASTY_CONFIG environment variable pointing at your configuration file ✨

Like, it cannot read your mind, it needs to know where the config lives. No config, no vibes. periodt.

💅 OPTIONS 💅

  • -h, --help — show this help message and exit. iconic behaviour, honestly 🙈
  • --config CONFIG — the bepasty configuration file 🌈

🎀 COMMANDS 🎀

migrate

Migrate an object to the current metadata schema — this is your bestie for when you've done a bepasty upgrade. 👑

Run it like:

bepasty-object migrate '*'
Note: the '*' needs to be quoted with single-quotes so the shell does not expand it. It's the thing that tells the command to operate on all names in the storage. (You could also give some specific names instead of '*', if you're feeling selective 💖)

purge

Purge objects from the database. Multiple conditions are ANDed together — so yeah, they all gotta be true at once, no cap.

  • -D, --dry-run — do not remove anything, just display what would happen. a lil sneak peek, a rehearsal, zero consequences 🌸
  • -A PURGE_AGE, --age PURGE_AGE — only remove if upload is older than PURGE_AGE days
  • -I PURGE_INACTIVITY, --inactivity PURGE_INACTIVITY — only remove if the latest download is older than PURGE_INACTIVITY days
  • -S PURGE_SIZE, --size PURGE_SIZE — only remove if file size is > PURGE_SIZE MiB
  • -T PURGE_TYPE, --type PURGE_TYPE — only remove if the file mimetype starts with PURGE_TYPE

consistency

Run consistency checks. the vibe check for your files, basically 🔥

  • -C, --compute — compute missing hashes and write them into the metadata
  • -F, --fix — write computed hash/size into the metadata
  • -R, --remove — remove files with inconsistent hash/size ⚠️

info

Display information about objects. just, like, looking at them. respectfully 💜

set

Set flags on objects.

  • -L, --lock
  • -l, --unlock
  • -C, --incomplete
  • -c, --complete

🌈 ENVIRONMENT 🌈

  • BEPASTY_CONFIG — absolute path to a bepasty configuration file ✨

💖 SEE ALSO 💖

and that's the whole page, bestie 🫶 it's bepasty-object(1) from the General Commands Manual, and that footer 💌 — it's just that same bepasty-object(1) tag signing off at the bottom, cute little bow on the box 🎀 mwah, go forth and manage your objects ✨

📦 where this page comes from