WWW::Noss::OPML(3)

🦋 WWW::Noss::OPML 💅

okay so bestie, welcome to the WWW::Noss::OPML page — a fine piece of User Contributed Perl Documentation, and your new fav little module for reading and writing OPML files ✨

---

🌸 NAME 🌸

WWW::Noss::OPML — OPML file reader/writer 🎀

---

✨ USAGE ✨

ok so here's the whole vibe, no cap:

use WWW::Noss::OPML;

my $opml = WWW::Noss::OPML->from_perl(
    title => 'Name',
    feeds => [ { ... }, ... ],
);

$opml->to_file('path/to/xml');

# Read from file
$opml = WWW::Noss::OPML->from_xml('path/to/xml');

like, make one, write it out, read it back. iconic behavior honestly 👑

---

💖 DESCRIPTION 💖

WWW::Noss::OPML is a module that gives you an interface for reading and writing OPML files. and like — heads up bestie — this is a private module 🙈 so if you want the actual user docs, go consult the noss manual instead, iykyk 🫶

---

🧚 METHODS 🧚

• $opml = WWW::Noss::OPML->from_perl(%param) — makes a brand new WWW::Noss::OPML object out of the params you hand it in the %param hash 💫

here's the list of valid fields for that %param hash. and listen — the only required field is "title" ⭐

• title — the title string for the OPML file, periodt.
• feeds — an array ref of outline feed hashes. each hash should look something like this:

{
  title    => ..., # required
  xml_url  => ..., # required
  text     => ...,
  html_url => ...,
  groups   => [ ... ],
}

like, title and xml_url are required (no skipping those bestie), the rest are optional 💅

• $opml = WWW::Noss::OPML->from_xml($file) — create a WWW::Noss::OPML object from the OPML file you give it. read it and weep 🥹
• $dom = $opml->to_xml([ %param ]) — returns an XML::LibXML::Document DOM object that represents the object. so DOM-y ✨

%param is an optional hash of extra params to configure the converted XML structure. valid values are:

• folders — boolean determining whether to include outline folders in the XML structure. defaults to true. (also yes, the original spells it "strucutre" — we love a typo moment 💀)

• $file = $opml->to_file($file, [ %param ]) — writes the OPML object's XML structure out to $file. returns $file on success, and dies on failure 😭

%param is an optional hash of extra params — it accepts the same options as to_xml().

• $fh = $opml->to_fh($fh, [ %param ]) — writes the OPML object's XML structure to the $fh file handle. returns $fh on success, and dies on failure 💀

%param is an optional hash of extra params — same options as to_xml(), again.

• $title = $opml->title() / $opml->set_title($title) — getter/setter for the OPML's title attribute. get it, set it, slay 🌈
• \@feeds = $opml->feeds() / $opml->set_feeds(\@feeds) — getter/setter for the OPML's feeds attribute 🍓
• $rn = $opml->rename_group($old, $new) — walks through every feed's group list and renames the group $old to $new. returns the number of groups renamed 🔥

---

👑 AUTHOR 👑

Written by Samuel Young, <samyoung12788@gmail.com>.

This project's source lives on its Codeberg page <https://codeberg.org/1-1sam/noss.git>. comments and pull requests are welcome! (yes fr fr, come thru 🫶)

---

🎀 COPYRIGHT 🎀

Copyright (C) 2025-2026 Samuel Young

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

bestie that's the license text, keep it exactly as-is, it's giving legally binding 💅

---

🌈 SEE ALSO 🌈

XML::LibXML::Document, noss — go check 'em out ✨

---

and that's the whole page, bestie 🦋💜 — brought to you by perl v5.42.2, dated 2026-02-15, straight off the WWW::Noss::OPML(3) page. mwah 💋