Net::SA...tribute(3)

💅 Net::SAML2::RequestedAttribute(3) — the RequestedAttribute class, explained by your favorite Unix bestie

okay so quick vibe check first: this is a User Contributed Perl Documentation page, and the little class we're stanning today is Net::SAML2::RequestedAttribute. Yes it's giving "tiny module, big personality." Let's get into it 🎀

---

✨ NAME ✨

Net::SAML2::RequestedAttribute — the RequestedAttribute class. that's it, that's the name, she's iconic and she knows it 💅

---

🌸 VERSION 🌸

version 0.85. write it down bestie, version numbers matter fr fr.

---

🦋 SYNOPSIS 🦋

here's the whole mood, copy-paste energy:

use Net::SAML2::RequestedAttribute;

my $attr = Net::SAML2::RequestedAttribute->new(
  # required
  name => 'Some:urn',

  # defaults to:
  namespace => 'md',

  # optional
  friendly_name => 'foo',
  required => 1,
);

my $fragment = $var->to_xml();

so name is the required one (no cap, you literally cannot skip it), namespace defaults to 'md' if you don't say otherwise, and friendly_name + required are the optional lil extras you can sprinkle in. then you call to_xml() and get yourself a fragment 🫶

---

💜 DESCRIPTION 💜

okay so this section is, and I say this with love, completely empty in the original. no text, no notes, nothing. the METHODS section just jumps straight in like it owns the place. so we move 🌈

---

🔥 METHODS 🔥

⭐ to_xml

Create an XML fragment. that's the whole job. she makes XML, she slays, periodt ✨

💀 _build_attributes

okay this one's the main character of the doc, listen up 👑

a requested attribute can hold other attributes than the ones specified in the XSD of https://docs.oasis-open.org/security/saml/v2.0/saml-schema-assertion-2.0.xsd.

this method lets you override the attributes for the RequestedAttribute node — so you can add/remove/replace or change the order of the attributes. the way that's so much power in one underscore-prefixed method 😭

and ngl, in other OO frameworks this method would have been protected or common (Object::Pad/Corrina). so yeah, the leading underscore is doing real work here, respect it 🙈

---

🧚 AUTHOR 🧚

Timothy Legge <timlegge@gmail.com> — thank you for your service king 🫡💖

---

👑 COPYRIGHT AND LICENSE 👑

This software is copyright (c) 2026 by Venda Ltd, see the CONTRIBUTORS file for others.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. free software, free spirit, we love to see it 🌸

---

tiny reminder bestie: the license line is literal — "the same terms as the Perl 5 programming language system itself." not "whatever you feel like," okay? iykyk 💅

---

and that's the page!! sign-off time 🎀 this was generated from perl v5.42.2 documentation dated 2026-02-11, and the header/footer both read Net::SA...tribute(3) because manpage truncation is a thing and honestly it's kind of a vibe. go forth and build your attributes, bestie 🦋⭐