CSS::I...Builder(3pm)

💖 CSS::Inliner::TreeBuilder — the manual, but make it make sense 💖

okay bestie, welcome to the User Contributed Perl Documentation for CSS::Inliner::TreeBuilder (you'll also see this page filed under CSS::I...Builder(3pm) because terminals are cowards about long names 💀). pull up a chair, this one's short and kinda iconic.

---

✨ NAME ✨

CSS::Inliner::TreeBuilder — the parser that builds a HTML syntax tree. yes. that's literally the whole job description. main character energy fr fr 👑

---

🌸 SYNOPSIS 🌸

here's the vibe, verbatim, no cap:

use CSS::Inliner::TreeBuilder;

foreach my $file_name (@ARGV) {
  my $tree = CSS::Inliner::TreeBuilder->new();
  $tree->parse_file($file_name);

  print "Hey, here's a dump of the parse tree of $file_name:\n";
  $tree->dump(); # a method we inherit from HTML::Element
  print "And here it is, bizarrely rerendered as HTML:\n", $tree->as_HTML, "\n";

  $tree = $tree->delete();
}

like… new(), parse_file($file_name), dump(), as_HTML, delete(). a whole lil life cycle. slay. 🦋

ngl the # a method we inherit from HTML::Element comment in there is doing a lot of quiet heavy lifting — dump() isn't ours, we borrowed it. respect the lineage 💅

---

🎀 DESCRIPTION 🎀

so. this is a class for handling parsing of generic HTML. periodt.

here's the tea though 🍓: this sub-module is derived from HTML::TreeBuilder. and the way that HTML::TreeBuilder is almost completely incapable of handling non-standard HTML4 documents commonly seen in the wild — let alone HTML5 documents — is honestly kind of a mess 😭 like bestie, real-world HTML is feral and it was simply not ready.

so what this module does is basically perform some minor adjustments to the way parsing and printing occur, such that an acceptable result can be reached when handling real world documents. that's it. that's the whole glow-up. a lil tweak to parse + a lil tweak to print, and suddenly your cursed wild-west markup comes out looking like it went to therapy 🌈✨

---

🫶 cute sign-off 🫶

and that's the page!! no hidden options, no 40-flag wall of doom, just a smol module with big "I fixed the parser" energy 💜

this doc lives under perl v5.40.1, dated 2025-08-12, and the page you're reading is filed as CSS::I...Builder(3pm) — yes the truncation ate the good part of the name, we forgive it 🎀

go parse something beautiful bestie 💖👑