Attean...hParser(3pm)

okay so welcome to the Attean...hParser(3pm) page from the User Contributed Perl Documentation, bestie 💖 this is the little home of Attean::API::PushParser, and it's giving parser-role excellence.

🌸 NAME 🌸

Attean::API::PushParser — the role for parsers that natively call a callback function for each parsed item ✨

🎀 VERSION 🎀

This document is all about Attean::API::PushParser version 0.035 — yes, that exact version, no cap 💅

🦋 DESCRIPTION 🦋

So the Attean::API::PushParser role defines parsers that can efficiently call a callback function for each object constructed from the parsed data. It adds methods on top of that functionality so you can parse data using different approaches. Efficient callback energy + flexible parsing approaches = main character role behavior, honestly 🔥

👑 ROLES 👑

This role consumes the Attean::API::Parser role. That's the whole section, and it ate 💅 periodt.

🛠️ REQUIRED METHODS 🛠️

If your class consumes this role, it must provide these methods — no skipping, bestie 🚨

• parse_cb_from_io( $fh ) — calls the $parser->handler function once for each object that result from parsing the data read from the IO::Handle object $fh 💖
• parse_cb_from_bytes( $data ) — calls the $parser->handler function once for each object that result from parsing the data read from the UTF-8 encoded byte string $data ✨

🌈 METHODS 🌈

The role provides default implementations of these methods — yes, defaults, we love a lowkey generous role 🫶

• parse_iter_from_io( $fh ) — returns an Attean::API::Iterator that result from parsing the data read from the IO::Handle object $fh 🦋
• parse_iter_from_bytes( $data ) — returns an Attean::API::Iterator that result from parsing the data read from the UTF-8 encoded byte string $data 🌸
• parse_list_from_io( $fh ) — returns a list of all objects that result from parsing the data read from the IO::Handle object $fh 🎀
• parse_list_from_bytes( $data ) — returns a list of all objects that result from parsing the data read from the UTF-8 encoded byte string $data 💜

💀 BUGS 💀

Bug or feature request? Please report any bugs or feature requests through the GitHub web interface at <https://github.com/kasei/attean/issues> — that's the place for bug reports and feature requests, fr fr 🙈

⭐ SEE ALSO ⭐

There are no SEE ALSO references listed here — the section is literally empty, so we're just gonna vibe 🫶💫

🧚 AUTHOR 🧚

Gregory Todd Williams "<gwilliams@cpan.org>" — iconic author behavior 👑

🍓 COPYRIGHT 🍓

Copyright (c) 2014--2022 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

okay final footer energy, bestie: this page is from perl v5.40.0, dated 2025-01-26, and it's the Attean...hParser(3pm) page — bye, go parse something fabulous 💖✨