USAGE:(1)

okay bestie, sit down, hydrate, because we're reading the manual page for usage: — yes the name literally has a colon in it, iconic, no notes 💅 — aka the database schema migration tool we all know and love. she handles your migrations, she's got nine little subcommands, and she's about to make your schema behave. let's go 🦋✨

🌸 NAME 🌸

usage: — Database schema migration tool 💖

---

✨ DESCRIPTION ✨

so the vibe is: you type yoyo and then some stuff, and it does migration things. here's the full shape of it, exactly how it shows up:

usage: yoyo [-h] [--config CONFIG] [-v] [-b] [--no-config-file]
              {init,apply,develop,list,rollback,reapply,mark,unmark,break-lock,new}
              ...

that's the whole menu, bestie. below it the page breaks everything into positional arguments and options, so let's take them one at a time 🫶

🎀 positional arguments 🎀

the group itself is described on the page as Commands help, and these are your choices:

{init,apply,develop,list,rollback,reapply,mark,unmark,break-lock,new}

• init — spins up a brand new project for you ✨
• apply — applies your migrations, that's it, that's the job 💅
• develop — applies migrations and does not prompt you at all. and if there's literally nothing unapplied sitting around? it reapplies the last migration instead. she's proactive like that 😭
• list — shows you every migration, available and applied both. each line gets a little prefix so you can tell them apart: A means applied, U means unapplied 👑
• rollback — rolls your migrations back, rewinding the timeline ⏪
• reapply — rolls back and then reapplies. a full little glow-up cycle 🦋
• mark — marks migrations as applied without actually running them. sneaky. we love her 🙈
• unmark — the opposite: unmarks applied migrations without rolling them back 🎀
• break-lock — breaks migration locks, for when something got stuck holding the door 🔓
• new — creates a new migration, fresh out the box ⭐

💅 options 💅

• -h, --help — shows this help message and exits. the classic escape hatch 🫶
• --config, -c CONFIG — tells her where the config file lives 📁
• -v — verbose output! and you can stack it — use it multiple times to crank the verbosity level up and up and up 🔥
• -b, --batch — batch mode. this turns off every single user prompt, so she just goes 👑
• --no-config-file, --no-cache — don't go looking for a yoyo.ini config file 🚫

---

ok so real talk: the page then repeats the entire positional arguments block and the entire options block, word for word. not a typo on my end, bestie, that's literally what's printed. so here it is again, because we keep every detail 💖

🎀 positional arguments (yes, again) 🎀

{init,apply,develop,list,rollback,reapply,mark,unmark,break-lock,new}

described on the page as Commands help.

• init — Initialize a new project ✨
• apply — Apply migrations 💅
• develop — Apply migrations without prompting. If there are no unapplied migrations, reapply the last migration 😭
• list — List all available and applied migrations. Each listed migration is prefixed with either A (applied) or U (unapplied) 👑
• rollback — Rollback migrations ⏪
• reapply — Rollback then reapply migrations 🦋
• mark — Mark migrations as applied, without running them 🙈
• unmark — Unmark applied migrations, without rolling them back 🎀
• break-lock — Break migration locks 🔓
• new — Create a new migration ⭐

💅 options (yes, again) 💅

• -h, --help — show this help message and exit 🫶
• --config, -c CONFIG — Path to config file 📁
• -v — Verbose output. Use multiple times to increase level of verbosity 🔥
• -b, --batch — Run in batch mode. Turns off all user prompts 👑
• --no-config-file, --no-cache — Don't look for a yoyo.ini config file 🚫

---

and that's the whole page, bestie, we read all of it, nothing skipped, we ate 💖

one last thing before you go — the footer on this one reads usage: yoyo [-h] [--config CONFI... with the date May 2025, so that's your version-ish line and your timestamp, right at the bottom where footers live. go migrate something gorgeous 🌸✨🦋