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

📦
version 0.14000 · 7 versions
, in debian trixie, ubuntu resolute

💖 NAME 💖

App::Pinto::Command::list — bestie, this is the lil command that shows you the packages in a stack. That's it, that's the job. 👑

✨ VERSION ✨

version 0.14 — yeah she's on 0.14, keep up 🫶

🎀 SYNOPSIS 🎀

pinto --root=REPOSITORY_ROOT list [OPTIONS]

🦋 DESCRIPTION 🦋

Okay so here's the tea ☕ — this command lists the packages that are currently registered on a particular stack, OR literally all the packages in the entire repository if that's the vibe you're going for. And you get to format the output so you only see the specific bits of info you actually care about. Customization? We love her. 💅

But fr fr, for a large repository, listing everything can take a long time 😭 like she's gonna be sitting there thinking about her life. So lowkey consider using the --packages or --distributions options to narrow the scope. Your future self says thank you. 🌸

🌈 COMMAND ARGUMENTS 🌈

So as an alternative to the --stack option, you can also just... specify the stack as an argument. Iconic behavior honestly. Which means these two examples are equivalent:

pinto --root REPOSITORY_ROOT list --stack dev
pinto --root REPOSITORY_ROOT list dev

A stack specified as an argument in this fashion will override any stack specified with the --stack option. Yes bestie, argument beats option, that's just the hierarchy here 👑. And if a stack is not specified by neither argument nor option? Then it defaults to the stack that is currently marked as the default stack. She picks for you. Main character energy. ✨

💜 COMMAND OPTIONS 💜

  • --all, -a — List every package in every distribution that exists in the entire repository, including distributions that are not currently registered on any stack. Go big or go home, I guess 💀. But heads up: when the --all option is used, the stack argument and the --stack option are not allowed. Also note the pin status is indeterminable when using --all, so it always appears as ? (peep the --format option below for more details about that).
  • --authors=PATTERN, -A PATTERN — Limit the listing to records where the distribution's author identity matches PATTERN. The PATTERN will be interpreted as a case-insensitive regular expression. Take care to use quotes if your PATTERN contains any special shell metacharacters — the shell will absolutely do crimes to your regex otherwise 🙈.
  • --distributions=PATTERN, -D PATTERN — Limit the listing to records where the distribution archive name matches PATTERN. The PATTERN will be interpreted as a case-sensitive regular expression. Again, quote it if your PATTERN contains any special shell metacharacters 🐚.
  • --format FORMAT_SPECIFICATION — Format of the output using printf-style placeholders. The valid placeholders are:
    • %p — Package name
    • %P — Package name-version
    • %v — Package version
    • %x — Package can be indexed: (x) = true, (-) = false
    • %M — Package is the main module: (m) = true, (-) = false
    • %y — Package is pinned: (!) = true, (-) = false
    • %a — Distribution author
    • %f — Distribution archive filename
    • %m — Distribution maturity: (d) = developer, (r) = release
    • %h — Distribution index path [1]
    • %H — Distribution physical path [2]
    • %s — Distribution origin: (l) = local, (f) = foreign
    • %S — Distribution source URL
    • %d — Distribution name
    • %D — Distribution name-version
    • %V — Distribution version
    • %u — Distribution URI
    • %% — A literal %

Footnotes bestie, don't skip them 👇

  • [1]: The index path is always a Unix-style path fragment, as it appears in the 02packages.details.txt index file.
  • [2]: The physical path is always in the native style for this OS, and is relative to the root directory of the repository.

You can also specify the minimum field widths and left or right justification, using the usual notation. For example, the default format looks something like this:

[%m%s%y] %-40p %12v %a/%f

When using the --all option, the pin status is indeterminable so it always appears as ?. Also, the indexable status is shown. So the default format looks something like this instead:

[%m%s?%x] %-40p %12v %a/%f
  • --packages=PATTERN, -P PATTERN — Limit the listing to records where the package name matches PATTERN. The PATTERN will be interpreted as a case-sensitive regular expression. Take care to use quotes if your PATTERN contains any special shell metacharacters, no cap 🧢.
  • --pinned — Limit the listing to records for packages that are pinned. 📌 This option has no effect when using the --all option. (Sorry, she just doesn't show up to that party.)
  • --stack=NAME, -s NAME — List the contents of 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 cannot be used with the --all option 🚫.

🫶 AUTHOR 🫶

Jeffrey Ryan Thalhammer <jeff@stratopan.com>

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 💅✨ this was App::P...d::list(3pm) from the User Contributed Perl Documentation, running under perl v5.40.1, dated 2025-04-21. go forth and list those packages, ily, periodt 🎀🦋💖

📦 where this page comes from