App::P...:revert(3pm)

🎀 NAME 🎀

App::Pinto::Command::revert — revert stack to a prior revision 💅

(yes bestie, this is that page from the User Contributed Perl Documentation, iykyk 🫶)

---

✨ VERSION ✨

version 0.14 — she's giving vintage, she's giving classic 🌸

---

🦋 SYNOPSIS 🦋

pinto --root=REPOSITORY_ROOT revert [OPTIONS] [STACK] [REVISION]

look at her. so simple. so powerful. main character energy fr fr ⭐

---

💜 DESCRIPTION 💜

!! THIS COMMAND IS EXPERIMENTAL !! 😭

okay so here's the tea 🍓 — this command restores the head of the stack to a prior state, and the way it does that is by creating a new revision that matches that prior state. so like, nothing gets deleted, nothing gets yeeted, she just makes a whole new revision that looks exactly like the old one. iconic behavior honestly 👑

but bestie, listen — if what you actually want is to move the head back to a prior state and discard everything that came after it? that's a different command. go check out the reset command for that one. totally different vibe, don't mix them up 💀

---

🌸 COMMAND ARGUMENTS 🌸

The arguments are the name of the stack and/or the id of the revision you're reverting to. 🫶

• if you don't hand her a revision id, it defaults to the immediate parent of the head revision of the stack.
• if you don't hand her a stack, it defaults to whichever stack is currently marked as the default.
• you can also pass the stack in with the --stack option instead. no stress, she's flexible ✨

some examples, because examples are everything:

pinto ... revert                   # Revert default stack to previous revision
pinto ... revert af01256e          # Revert default stack to revision af01256e
pinto ... revert mystack af01256e  # Revert mystack to revision af0125e

copy, paste, slay 💅

---

💖 COMMAND OPTIONS 💖

• --dry-run — go through all the motions, but do not actually commit any changes to the repository. when it's done, you get a diff showing the changes that would have been made. this is the "try it on in the fitting room before you buy it" option 🎀 — use it to see how upgrades would potentially impact the stack.
• --force — force reversion even if the revision is not actually an ancestor. normally you can only revert to a revision that the stack has actually been at, so this is the "okay bestie we're bending the rules today" button 😭. this option only has effect if you specify a target revision argument.
• --message=TEXT, -m TEXT — use TEXT as the revision history log message. if you don't use --message and you don't use --use-default-message, then you will get prompted to type the message into your text editor ✍️. the PINTO_EDITOR or EDITOR or VISUAL environment variables control which editor gets used. oh and — a log message is not required whenever the --dry-run option is set, or if the action didn't yield any changes to the repository. no changes, no essay, periodt 💅
• --stack=NAME, -s NAME — perform reversion on the stack with the given NAME. defaults to the name of whichever stack is currently marked as the default stack. use the stacks command to see the stacks in the repository 👀. this option is silently ignored if the stack is specified as a command argument instead — she doesn't argue, she just quietly moves on 🧚
• --use-default-message, -M — use the default value for the revision history log message. Pinto will generate a semi-informative log message just based on the command and its arguments 🤖. and if you set an explicit message with --message, the --use-default-message option will be silently ignored. again: silent. she's not gonna fight you about it 💜

---

👑 AUTHOR 👑

Jeffrey Ryan Thalhammer <jeff@stratopan.com> 💌

---

🌈 COPYRIGHT AND LICENSE 🌈

This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🫶

---

okay that's the whole page bestie, you ate that 🍓✨ — and just so you have the receipts, this was perl v5.40.1, dated 2025-04-21, filed under App::P...:revert(3pm). mwah 💋🎀