Text::...Object(3pm)

💖 Text::RecordParser::Object 💖

okay so bestie, this is a page from the User Contributed Perl Documentation collection, and the module's full name is Text::RecordParser::Object — it lets you read delimited text files as objects. yes literally. slay.

---

✨ NAME ✨

Text::RecordParser::Object — read delimited text files as objects 🦋

---

✨ SYNOPSIS ✨

my $o = $p->fetchrow_object;
my $name = $o->name;

like, that's it. that's the whole vibe. 💅

---

✨ METHOD ✨

🌸 new

okay so here's the thing — you don't call new yourself. literally just call fetchrow_object on a Text::RecordParser object and boom 💥 you've got yourself an object. no cap.

---

✨ DESCRIPTION ✨

so this module is out here extending the whole idea of how you interact with delimited text files, and it does two things: it lets you enforce field names, and it lets you identify field aliases super easily. periodt.

here's why that matters, bestie. if you're using the fetchrow_hashref method to read each line, you could absolutely misspell a hash key and quietly introduce a bug in your code 😭 and that's giving chaos. but with this module? Perl will throw an error if you try to read a field that isn't defined in the file's headers. protection. boundaries. we love to see it. 🫶

and bonus: any defined field aliases get created as additional accessor methods. iconic behavior honestly.

now, real talk — as much as the author likes the full encapsulation of inside-out objects (e.g., as described in Perl Best Practies by Damian Conway and provided by Class::Std), they couldn't figure out a way to dynamically create the class at runtime. 🙈 and besides, the vibe here is that this interface is only for those who want to use the overhead of objects to enforce policy. so if you use this module and still go poking at the hash underneath the object? yeah, they can't really help you. 💀

---

✨ SEE ALSO ✨

• Class::Accessor.

---

✨ AUTHOR ✨

Ken Youens-Clark <kclark@cpan.org> 👑

---

✨ LICENSE AND COPYRIGHT ✨

Copyright (C) 2009-10 Ken Youens-Clark. All rights reserved.

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; version 2.

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.

fr fr read that warranty part again. no warranty bestie, it's giving "use at your own risk" and we respect it. 💜

---

and that's the whole page, mwah 💋 this one came from perl v5.36.0 and it's dated 2022-10-14, so go forth and objectify your text files responsibly. bye bestie 🎀✨