Debian...icense(3pm)

📦
version 0.2 · 4 versions
, in ubuntu noble, ubuntu resolute

okay bestie, so this is a little Perl module from the User Contributed Perl Documentation corner of the 3pm man pages, and it's genuinely so useful it's not even funny. It's called Debian::Copyright::Stanza::License and yes, that name is a mouthful, but she's worth it. Let's get into it. ✨

🌸 NAME 🌸

Debian::Copyright::Stanza::License — she's the License stanza of a Debian copyright file. That's the whole personality. 💅

🎀 VERSION 🎀

This doc is describing Debian::Copyright::Stanza::License version 0.2. That's the one. Periodt.

🦋 SYNOPSIS 🦋

Here's the vibe, in code:

my $copy = Debian::Copyright::Stanza::License->new(\%data);
print $copy;                         # auto-stringification

That second line? It's giving auto-stringification — she turns herself into text with zero effort. Iconic behaviour. 🔥

💜 DESCRIPTION 💜

Debian::Copyright::Stanza::License lets you represent and manipulate a "License:" stanza from Debian copyright files, and she does it the object-oriented way, because obviously. 🫶

And in string context? She converts herself to a textual representation. So you just print her and she shows up looking gorgeous. No extra steps, no fuss, we love a module that handles her own business. 😭💖

✨ FIELDS ✨

These are the fields that License stanzas actually support, listed below for you:

  • License
  • Comment
⚠️ heads up bestie, real copyright fields can have dashes in their names. Those get replaced with underscores. So don't come for me when you see _ where you expected -, that's just how she rolls. 🙈

👑 CONSTRUCTOR 👑

🌈 new

new( { field => value, ... } )

She creates a brand-new Debian::Copyright::Stanza::License object for you, and if you feel like it, you can optionally initialise her with the data you supply. Very flexible. Very main character energy. ⭐

💀 SEE ALSO 💀

Real talk: Debian::Copyright::Stanza::License inherits most of her functionality from Debian::Copyright::Stanza. She didn't build all of this from scratch, she's standing on the shoulders of an icon. Go look at that page too, iykyk. 🌈

Copyright (C) 2011-12 Nicholas Bamber nicholas@periapt.co.uk

This module is substantially based upon Debian::Control::Stanza::Source. Copyright (C) 2009 Damyan Ivanov dmn@debian.org

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

okay that's the whole page, bestie, you're fully caught up. 🧚💖

this little writeup was living in the perl v5.36.0 docs, dated 2022-10-14, filed under Debian...icense(3pm) — stay hydrated, read your man pages, and slay the day away. 🎀🌸💜

📦 where this page comes from