SpecParser(3pm)

💖 NAME 💖

Lire::Config::SpecParser — creates configuration specification from XML files. Bestie, this is the SpecParser(3pm) page from LogReport's Lire Documentation, and it's literally all about building config specs from XML. Periodt. ✨

✨ SYNOPSIS ✨

Here's the whole vibe in code:

use Lire::Config::SpecParser;

my $parser = new Lire::Config::SpecParser;
my $spec = $parser->parsefile( 'spec.xml' );

$parser->merge_specifications_dir( '/etc/lire/config' );
my $spec = $parser->configspec();

🦋 DESCRIPTION 🦋

okay so this is an Lire::XMLParser which can build Lire::Config::ConfigSpec objects from an XML file. Main character energy: XML goes in, config spec objects come out. 🫶

🎀 new() 🎀

Makes a brand-new parser object. Slay.

🎀 configspec() 🎀

Hands you back the parsed Lire::Config::ConfigSpec object. Iconic.

🎀 merge_specifications_dir( $dir ) 🎀

Parses all the files ending in '.xml' in the $directory, and the types defined in those files get merged into this parser's ConfigSpec object. (Yep, the signature says $dir and the description says $directory — we keep it exactly like that.) 💅

🎀 merge_specification_dir( $file ) 🎀

Parses the $file XML file and merges the types it defines into the ConfigSpec defined by this parser. Note: the method name here is the singular merge_specification_dir — that's literally what the page says, bestie. 🌸

🌈 SEE ALSO 🌈

Go check out these fam: Lire::Config::Parser(3pm), Lire::Config::TypeSpec(3pm), and Lire::Config::ConfigSpec(3pm). ✨

👑 AUTHORS 👑

• Wessel Dankers <wsl@logreport.org>
• Francis J. Lacoste <flacoste@logreport.org>

⭐ VERSION ⭐

The version line is literally:

$Id: SpecParser.pm,v 1.44 2006/07/23 13:16:30 vanbaal Exp $

💜 COPYRIGHT 💜

Copyright (C) 2002,2004 Stichting LogReport Foundation LogReport@LogReport.org

This file is part of Lire.

Lire 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 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html.

---

okay bye bestie — this page came from Lire 2.1.1, dated 2025-09-28, and yes it's the SpecParser(3pm) manual. 💅✨🦋