CSAF::Document(3pm)

💖 CSAF::Document 💖

okay bestie, so this is CSAF::Document — the CSAF Document module, from the User Contributed Perl Documentation collection. she's giving very much "structured security advisories, but make it a Perl object" and honestly? iconic. 🌸

---

✨ NAME ✨

CSAF::Document — CSAF Document. that's it, that's the name, periodt. 💅

---

🌈 SYNOPSIS 🌈

here's the whole vibe, copy-paste ready, no cap:

use CSAF::Document;

my $csaf = CSAF::Document->new;

$csaf->document->title('Base CSAF Document');
$csaf->document->category('csaf_security_advisory');
$csaf->document->publisher(
    category  => 'vendor',
    name      => 'CSAF',
    namespace => 'https://csaf.io'
);

my $tracking = $csaf->document->tracking(
    id                   => 'CSAF:2024-001',
    status               => 'final',
    version              => '1.0.0',
    initial_release_date => 'now',
    current_release_date => 'now'
);

$tracking->revision_history->add(
    date    => 'now',
    summary => 'First release',
    number  => '1'
);

like, look at her go 🦋 she builds the document, sets the publisher, spins up tracking, adds a revision history entry. main character energy fr fr.

---

💜 DESCRIPTION 💜

The Common Security Advisory Framework (CSAF) Version 2.0 is the definitive reference for the language which supports creation, update, and interoperable exchange of security advisories as structured information on products, vulnerabilities and the status of impact and remediation among interested parties. ✨

basically: it's how you talk about vulns in a way everybody can read. the way that it structures everything?? obsessed.

<https://docs.oasis-open.org/csaf/csaf/v2.0/os/csaf-v2.0-os.html>

🎀 CSAF PROPERTIES 🎀

• document — returns a CSAF::Type::Document. your document object, your girl 💖
• product_tree — returns a CSAF::Type::ProductTree. the whole product family tree, lowkey iconic 🌳
• vulnerabilities — returns a CSAF::Type::Vulnerabilities. all the vulns, gathered up 🫶

---

🫶 SUPPORT 🫶

🐛 Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at <https://github.com/giterlizzi/perl-CSAF/issues>. You will be notified automatically of any progress on your issue. so like, you don't have to keep refreshing — she'll ping you 💅

📦 Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

<https://github.com/giterlizzi/perl-CSAF>

git clone https://github.com/giterlizzi/perl-CSAF.git

go ahead bestie, clone her, she's yours 🌸

---

👑 AUTHOR 👑

• Giuseppe Di Terlizzi <gdt@cpan.org>

the legend herself. we stan. 🎀

---

⭐ LICENSE AND COPYRIGHT ⭐

This software is copyright (c) 2023-2025 by Giuseppe Di Terlizzi.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

fr fr, free as in "go off, do your thing", same terms as Perl 5 itself. just don't be weird about it 💖

---

and that's the whole page, bestie!! 🦋 this was CSAF::Document(3pm) from perl v5.40.1, dated 2025-09-03 — she's fresh, she's documented, she ate. mwah 💅✨