Dpkg::Chang...try::Debian(3perl)

💖 Dpkg::Changelog::Entry::Debian — a 3perl bestie guide 💖

🌸 NAME 🌸

Dpkg::Changelog::Entry::Debian — represents a Debian changelog entry.

🌈 DESCRIPTION 🌈

okay so bestie, this class represents a Debian changelog entry. It implements the generic interface Dpkg::Changelog::Entry. Only functions specific to this implementation are described below — the rest are inherited, iykyk 💅.

🛠️ METHODS 🛠️

• @items = $entry->get_change_items() — returns a list of change items. Each item contains at least one line. A change line starting with an asterisk denotes the start of a new item. Any change line like ""[ Raphaël Hertzog ]"" is treated like an item of its own even if it starts a set of items attributed to this person (the following line necessarily starts a new item). periodt ✨
• @errors = $entry->parse_header() / @errors = $entry->parse_trailer() — returns a list of errors. Each item in the list is an error message describing the problem. If the empty list is returned, no errors have been found. no cap 🫶
• $entry->normalize() — normalizes the content. Strips whitespaces at end of lines, uses a single empty line to separate each part. clean girl aesthetic 🎀
• $src = $entry->get_source() — returns the name of the source package associated to the changelog entry.
• $ver = $entry->get_version() — returns the version associated to the changelog entry.
• @dists = $entry->get_distributions() — returns a list of target distributions for this version.
• $ctrl = $entry->get_optional_fields() — returns a set of optional fields exposed by the changelog entry. It always returns a Dpkg::Control object (possibly empty though).
• $urgency = $entry->get_urgency() — returns the urgency of the associated upload. urgent bestie behavior 🔥
• $maint = $entry->get_maintainer() — returns the string identifying the person who signed this changelog entry.
• $time = $entry->get_timestamp() — returns the timestamp of the changelog entry.
• $time = $entry->get_timepiece() — returns the timestamp of the changelog entry as a Time::Piece object. This function might return undef if there was no timestamp. heads up, bestie 🙈

🧰 UTILITY FUNCTIONS 🧰

• $bool = match_header($line) — checks if the line matches a valid changelog header line.
• $bool = match_trailer($line) — checks if the line matches a valid changelog trailing line.
• @closed_bugs = find_closes($changes) — takes one string as argument and finds Closes: #123456, #654321 statements as supported by the Debian Archive software in it. Returns all closed bug numbers in an array. bug-closing slay 🐛✨

🔥 CHANGES 🔥

Version 2.00 (dpkg 1.20.0)

• Remove methods: $entry->check_header(), $entry->check_trailer().
• Hide variables: $regex_header, $regex_trailer.

Version 1.03 (dpkg 1.18.8)

• New methods: $entry->get_timepiece().

Version 1.02 (dpkg 1.18.5)

• New methods: $entry->parse_header(), $entry->parse_trailer().
• Deprecated methods: $entry->check_header(), $entry->check_trailer().

Version 1.01 (dpkg 1.17.2)

• New functions: match_header(), match_trailer()
• Deprecated variables: $regex_header, $regex_trailer

Version 1.00 (dpkg 1.15.6)

• Mark the module as public.

---

that's the whole page, bestie 🫶 — this gem comes from libdpkg-perl, version 1.23.11-dirty, dated 2026-09-09. now go read those changelogs and absolutely slay ✨💅