Arch::Log(3pm)

📦 version 0.5.2, in ubuntu jammy

💖 Arch::Log — the class that's literally the Arch patch-log, bestie 💖

okay so real quick, this is Arch::Log, from the User Contributed Perl Documentation corner of the manual-verse, and it is exactly what it sounds like: a class that represents the Arch patch-log concept. she's giving "I hold one patch log and I know things about it" and honestly? iconic. 🎀

✨ SYNOPSIS ✨

use Arch::Log;
my $log = Arch::Log->new($rfc2822_message_string);
printf "Patch log date: %s\n", $log->header('standard_date');
print $log->dump;
my $first_new_file = $log->get_headers->{new_files}->[0];

like, that's it. that's the whole vibe check. you hand her a string, she hands you a whole patch log back. 🦋

🌸 DESCRIPTION 🌸

This class represents the patch-log concept in Arch and provides some useful methods. no cap, that's the whole job. she's a patch-log girlie and she's good at it. 💅

👑 METHODS 👑

The following class methods are available:

get_message, get_headers, header, get_changes, split_version, get_version, get_revision, get_revision_kind, get_revision_desc, dump.

that's the whole roster, bestie. now let's meet each one 💜

  • get_message — returns the original message, the exact one the object was constructed with. she kept the receipt. 🧾
  • get_headers — returns the hashref of all the headers, body included. also see the header method if you want the ✨spotlight✨ version.
  • header name
  • header name [new_value] — get or set the named header. and ooh, the special name 'body' represents the message body — aka the text that comes after the headers. 🫶
  • body [new_value]
  • existing_header_name [new_value] — this is just a shortcut for "header"('method'). but — and this is the important part — unlike "header"('method'), this method fails instead of returning undef if the log doesn't have the given header name. so if the header isn't there, she's not gonna quietly hand you a undef and let you find out later. she's gonna say something. 😭
  • get_changes — returns a list of changes in the corresponding changeset.
⚠️ ATTENTION! Patch logs do not distinguish metadata (ie permission) changes from ordinary content changes. Permission changes will be represented with a change type of 'M'. This is different from Arch::Changeset::get_changes and Arch::Tree::get_changes. so don't come for her when your permission change shows up as 'M', that's just how patch logs do. 💀
  • split_version — returns a list of 2 strings: the full version and the patch-level. two for one, we love a bundle deal. 🌈
  • get_version — returns the full version name, not unlike split_version. same energy, one string. ⭐
  • get_revision — returns the full revision name. this is currently a concatenation of headers Archive and Revision with a / separator. yes, currently. she said don't get attached. 🙈
  • get_revision_kind — returns one of the strings 'tag', 'import' or 'cset', depending on the revision kind this log represents. pick your fighter. 🔥
  • get_revision_desc — returns a revision description hashref with the keys: name, version, summary, creator, email, date, kind. seven keys, all accounted for, no notes. 💅
  • dump — returns the object dump using Data::Dumper. yes queen, show us everything. 🎀

💀 BUGS 💀

Awaiting for your reports.

she's literally just sitting there. waiting. inbox open. 🥺

🫶 AUTHORS 🫶

Mikhael Goikhman (migo@homemail.com--Perl-GPL/arch-perl--devel).

🔍 SEE ALSO 🔍

For more information, see tla, Arch::Session, Arch::Library, Arch::Changes.

and that's the whole page, bestie! this was Arch::Log from the User Contributed Perl Documentation section, brought to you by perl v5.20.2, dated 2005-11-14. she's been serving patch-log realness since 2005 and she has not missed once. periodt. 💖✨

📦 where this page comes from