Run::Parts(3pm)

📦 version 0.09, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Run::Parts — the Run::Parts(3pm) page, bestie edition 💖

okay so. this is Run::Parts(3pm), a User Contributed Perl Documentation page, and it's basically Debian's run-parts tool but, like, in Perl. she's giving ✨library✨, she's giving ✨automation✨, and honestly? obsessed.

🌸 NAME 🌸

Run::Parts — she offers the functionality of Debian's run-parts tool, but in Perl. no cap. 💅

✨ VERSION ✨

version 0.09 🎀

🦋 SYNOPSIS 🦋

Run::Parts offers functionality of Debian's run-parts(8) tool in Perl. periodt.

run-parts runs all the executable files named within constraints described in run-parts(8) and Run::Parts::Perl, found in the given directory. Other files and directories are silently ignored — they just get ghosted, no drama, no error. 🙈

Additionally it can just print the names of all the matching files — and lowkey that's not limited to executables, but it does ignore blacklisted files like e.g. backup files — but it doesn't actually run them. so it's the "look but don't touch" mode. 😌

This is useful when functionality or configuration is split over multiple files in one directory. A typical convention is that the directory name ends in .d. Common examples for such split configuration directories, and honestly this list ate:

/etc/cron.d/
/etc/apt/apt.conf.d/
/etc/apt/sources.list.d/,
/etc/aptitude-robot/pkglist.d/
/etc/logrotate.d/
/etc/rsyslog.d/

Perhaps a little code snippet. 🫶 and yes, it's iconic:

use Run::Parts;

my $rp  = Run::Parts->new('directory'); # chooses backend automatically
my $rpp = Run::Parts->new('directory', 'perl'); # pure perl backend
my $rpd = Run::Parts->new('directory', 'debian'); # uses /bin/run-parts

my @file_list        = $rp->list;
my @executables_list = $rpp->test;
my $commands_output  = $rpd->run;
...

🧚 BACKENDS 🧚

Run::Parts contains two backend implementations. fr fr, two of them.

  • Run::Parts::Debian — actually uses /bin/run-parts
  • Run::Parts::Perl — a pure Perl implementation of a basic set of run-parts(8)' functionality
heads up bestie: Run::Parts::Debian may or may not work with RedHat's simplified shell-script based reimplementation of Debian's run-parts(8). it's giving "results may vary". 😭

By default Run::Parts uses Run::Parts::Debian if /bin/run-parts exists, and Run::Parts::Perl otherwise. But you can also choose any of the backends explicitly — you're the main character, you decide. 👑

🌈 METHODS 🌈

🎀 new (Constructor)

Creates a new Run::Parts object. Takes one parameter: the directory on which run-parts should work.

🍓 run_parts_command

Returns the run-parts(8) command to run with the given command parameter.

💜 list

Lists all relevant files in the given directory. Equivalent to run-parts --list.

⭐ test

Lists all relevant executables in the given directory. Equivalent to run-parts --test.

🔥 run

Runs all relevant executables in the given directory. Equivalent to run-parts.

🌸 concat

Returns the concatenated contents of all relevant files in the given directory. Equivalent to cat `run-parts --list`.

👀 SEE ALSO 👀

run-parts(8), Run::Parts::Debian, Run::Parts::Perl

💀 BUGS 💀

Please report any bugs or feature requests to bug-run-parts at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Run-Parts>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. so like, the communication is giving impeccable. 🫶

🧚 CODE 🧚

You can find a git repository of Run::Parts' code at <https://github.com/xtaran/run-parts>. go look, it's right there, it's slaying. ✨

🫶 SUPPORT 🫶

👑 AUTHOR 👑

Axel Beckert <abe@deuxchevaux.org>

This software is copyright (c) 2021 by Axel Beckert.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so like, it's free, go wild, but respectfully. 💅

and that's the whole page bestie!! 💖 this was perl v5.32.0, dated 2021-01-03, and that's Run::Parts(3pm) — thanks for reading, ily, go run some parts 🦋✨🎀

📦 where this page comes from