XML::Fi...XInclude(3)

✨ NAME ✨

XML::Filter::XInclude — bestie, it's XInclude but as a SAX Filter 💅 (this is the XML::Fi...XInclude(3) page, yes the title got squished, we move)

---

🎀 SYNOPSIS 🎀

okay so here's the whole vibe, copy it exactly:

use XML::SAX;
use XML::SAX::Writer;
use XML::Filter::XInclude;

my $parser = XML::SAX::ParserFactory->parser(
    Handler => XML::Filter::XInclude->new(
        Handler => XML::SAX::Writer->new()
    )
);
$parser->parse_uri("foo.xml");

---

🦋 DESCRIPTION 🦋

So this module is a simple SAX filter that gives you XInclude support. That's the whole job. It does NOT support XPointer — not even a little bit, don't ask her 💀

XInclude is genuinely so simple, you just drop something like this into your XML document:

<xi:include href="foo.xml"
  xmlns:xi="http://www.w3.org/2001/XInclude"/>

and boom 💥 it will load foo.xml and parse it right into the current SAX stream. main character behaviour fr fr.

If you specify the attribute parse="text", then it gets treated as a plain text file instead, and it gets inserted into the stream as a series of calls to the characters() method. yes, a whole series, one after another, that's the move ✨

URI's are supported via LWP 🫶

Currently encoding is not supported. 😭 just so you know going in, no cap.

---

👑 AUTHOR 👑

Matt Sergeant, matt@sergeant.org — iconic, we love, periodt 💖

---

🌈 LICENSE 🌈

This is free software, you may use it and distribute it under the same terms as Perl itself. slay 🎀

---

and that's the page bestie!! brought to you by perl v5.42.0, dated 2025-07-25 — go forth and include ur files, iykyk 🦋💜🌸