App::P...d::diff(3pm)

💖 App::Pinto::Command::diff 💖

okay bestie, gather round, because we're looking at App::Pinto::Command::diff — that's the Perl doc page, user-contributed, and it is entirely about showing you the difference between two stacks 🦋

---

✨ NAME ✨

App::Pinto::Command::diff — show difference between two stacks. that's it, that's the whole vibe 🎀

✨ VERSION ✨

version 0.14 — yeah she's a specific girlie 💅

✨ SYNOPSIS ✨

  pinto --root=REPOSITORY_ROOT diff [OPTIONS] LEFT [RIGHT]

look at her. so clean. so iconic. 👑

✨ DESCRIPTION ✨

!! THIS COMMAND IS EXPERIMENTAL !! 😭 not me having to say this but fr fr, she is experimental, so proceed with the awareness of a main character who reads the fine print.

This command shows the difference between two stacks or revisions, and it presents all of that in a format similar to diff[1]. like, you know how diff does its thing? same energy, but for your stacks 🫶

✨ COMMAND ARGUMENTS ✨

the command arguments are, lowkey, just the names of the stacks or the revision IDs you want to compare. that's the whole job. 🌸

• if you hand over a stack name, then the head revision of that stack is the one that gets used ✨
• if you only give one argument, then plot twist: it's assumed to be the RIGHT, and the head revision of the default stack slides in as the LEFT 💫
• and revision IDs? they can be truncated to uniqueness — so yes, you can absolutely just type the first few characters and let her figure it out. iykyk 💅

✨ COMMAND OPTIONS ✨

okay this is the part where we get into the flags, and there are exactly two, so like, manageable. 💖

• --diff-style=STYLE — this controls the style of the diff reports, and STYLE has to be either concise or detailed, no in-between, no third option, periodt.
  • concise reports show only one record for each distribution that was added or deleted 🎀
  • detailed reports show one record for every package that was added or deleted — so like, way more receipts 📜
  • the default style is concise ✨ BUT the default can be changed by setting the PINTO_DIFF_STYLE environment variable to whatever STYLE you prefer 💜
  • and heads up bestie: that variable affects the default style for diff reports generated by all other commands too, not just this one. it's giving global influence 😌
• --format=FORMAT — a printf-style format string that describes how the individual lines of the diff get printed 🖨️
  • for the description of the FORMAT, please refer to COMMAND OPTIONS in App::Pinto::Command::list — go read that one, she has the details 📖
  • the default format for concise diffs is %o[%F] %a/%f ✨
  • the default format for detailed diffs is %o[%F] %-40p %12v %a/%f ✨

---

🌈 EXAMPLES 🌈

these are literally the moment, look at how useful she is:

 pinto diff foo                  # Compare of head of default stack with head of foo stack
 pinto diff foo bar              # Compare heads of both foo and bar stack.
 pinto diff 1ae834f              # Compare head of default stack with revision 1ae834f
 pinto diff foo 1ae834f          # Compare head of foo stack with revision 1ae834f
 pinto diff 663fd2a 1ae834f      # Compare revision 663fd2a with revision 1ae834f

ate. no crumbs. 🍓

✨ AUTHOR ✨

Jeffrey Ryan Thalhammer <jeff@stratopan.com> — legend behavior, honestly 👑

✨ COPYRIGHT AND LICENSE ✨

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

and this is free software 🦋 you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself — slay, open source rights, we love to see it 🌸

---

and that's the whole page bestie!! go diff some stacks, stay experimental, and remember: perl v5.40.1, dated 2025-04-21, from the App::P...d::diff(3pm) manual — mwah, love u, bye!! 💅💖✨