Netlist::Logger(3)

🎀 Netlist::Logger(3) — your girl's guide to error collecting & reporting 💅

okay so real talk, this file lives in the Perl User Contributed Documentation section, and the module itself answers to the name Verilog::Netlist::Logger. same energy, two names, iykyk ✨

---

🌸 NAME 🌸

Verilog::Netlist::Logger — literally just error collection and reporting, that's the whole vibe 🫶

---

⭐ SYNOPSIS ⭐

  use Verilog::Netlist::Logger;

  ...

  my $self = Verilog::Netlist::Logger->new();
  $self->info("We're here\n");
  $self->warn("Things look bad\n");
  $self->error("Things are even worse\n");
  $self->exit_if_error();

like yes bestie, that's it, that's the whole intro 🦋

---

💖 DESCRIPTION 💖

so Verilog::Netlist::Logger is the designated ✨messenger✨ — it's what you use to report all the errors that get detected by the Verilog::Netlist::* structures. no cap, that's its entire job.

by default, Verilog::Netlist goes ahead and makes a brand-new Logger object all on its own, and then passes it down to all the contained objects 🎀. but here's the fun part — you can make your own logger objects too, so you can catch those error messages or handle them however you want. main character energy: you decide 💅

---

🔥 MEMBER FUNCTIONS 🔥

💜 $self->error(object, Text...)

prints an error about the object, in a standard format. the object has to have a fileline method — non-negotiable, bestie 🙈

💜 $self->exit_if_error([allow=>'warning'])

exits the program if any errors were detected. periodt. and if you wanna be chill about it, you can optionally specify allow=>'warning' to ignore warnings ⭐

💜 $self->info(Text...)

prints an informational about the object in a standard format. the object must have a fileline method 💖 (yes, that's exactly what the docs say, i'm just the messenger 🧚)

💜 $self->lineno()

the line number the entity was created on 📍 like, the receipts of where it all began.

💜 $self->unlink_if_error(filename)

requests that the given file be deleted if any errors are detected when the Logger object is destroyed 😭 used for temporary files — so like, cleanup crew behavior, lowkey iconic 🍓

💜 $self->warn(Text...)

prints a warning about the object in a standard format. the object must have a fileline method 🌸

---

🌈 DISTRIBUTION 🌈

Verilog-Perl is part of the <https://www.veripool.org/> free Verilog EDA software tool suite — yes, the whole suite, obsessed 👑

the latest version is available from CPAN and from <https://www.veripool.org/verilog-perl> ✨ go get her.

Copyright 2000-2024 by Wilson Snyder. This package is free software; you can redistribute it and/or modify it under the terms of either the GNU Lesser General Public License Version 3 or the Perl Artistic License Version 2.0 🫶

---

👑 AUTHORS 👑

Wilson Snyder <wsnyder@wsnyder.org> 💌

---

🦋 SEE ALSO 🦋

• Verilog-Perl
• Verilog::Netlist
• Verilog::Netlist::Subclass

---

and that's the whole page, bestie ✨💖 this little love letter was rendered by perl v5.42.0, dated 2025-07-25, and it still says Netlist::Logger(3) at the top of every page like the icon it is 🎀💅