Dpkg::Source::Format(3perl)

💅 Dpkg::Source::Format 💅

ok so this is a page from libdpkg-perl, bestie — welcome to the Dpkg::Source::Format show, the little Perl class that handles your debian/source/format files 💖

---

✨ NAME ✨

Dpkg::Source::Format — literally here to manipulate debian/source/format files, no cap 🎀

---

🌸 DESCRIPTION 🌸

This module hands you a whole class that can manipulate Debian source package debian/source/format files. that's it, that's the vibe. it's giving "small but essential," iykyk 🦋

---

🔥 METHODS 🔥

• $format = Dpkg::Source::Format->new(%opts) — creates a brand new object that corresponds to a source package's debian/source/format file. new object, who dis 💅

the options are:

• filename — sets the filename to use to parse and set the format 📁
• format — sets and validates the format to use, instead of loading the default file, but only if no filename has been specified 👑

• $format->set_from_parts($major[, $minor[, $variant]]) — sets the source format from its parts. $major is mandatory (like, required required), while $minor and $variant are optional ✨

⚠️ notice: this function performs no validation. zero. none. it's on you, bestie 😭

• ($major, $minor, $variant) = $format->set($format) — sets (and validates — unlike its chaotic sibling above) the source $format you specified. it returns the parsed format parts as a list, and the optional $minor and $variant parts might be undef 🙈
• ($major, $minor, $variant) = $format->get()
• $format = $format->get() — gets the source format, either as a properly formatted scalar, or as a list of its parts, where the optional $minor and $variant parts might be undef. two moods, same method 🫶
• $count = $format->parse($fh, $desc) — parses the source format string from $fh, with filehandle description $desc ⭐
• $count = $format->load($filename) — parses the contents of $filename looking for a source package format string 🌈
• $string = "$format"
• $string = $format->output([$fh]) — returns a string representing the source package format version. and if $fh is set, it prints that string to the filehandle 🔥
• $format->save($filename) — saves the source package format into the given $filename. write it down, keep it safe, slay 🎀

---

🦋 CHANGES 🦋

⭐ Version 1.00 (dpkg 1.19.3)

• marked the module as public. it's official, it's out there, main character energy 👑

---

and that's the whole page, bestie! go forth and format your sources 💜

ok so the sign-off: this was libdpkg-perl, version 1.23.11-dirty, dated 2026-09-09 — and yes the version really does say dirty, we love a messy icon 💀🍓 bye bye, mwah! 💖