Attean...eParser(3pm)

Attean::API::AtOnceParser is the main character of this page from the User Contributed Perl Documentation, 3pm section. Let's get into it, bestie. 🫶

💖 NAME 💖

Attean::API::AtOnceParser — a role for parsers that natively parse all input before returning any data.

🌸 VERSION 🌸

This page describes Attean::API::AtOnceParser version 0.035, no cap.

✨ DESCRIPTION ✨

The Attean::API::AtOnceParser role defines parsers that have to parse all the input data before any objects are constructed and returned, or passed to callback functions. It's giving "finish the whole snack before sharing," honestly. 🍓

This role adds methods that build on that all-at-once functionality so you can parse data using different approaches. Obsessed with the flexibility, lowkey. ✨

🎀 ROLES 🎀

This role consumes the Attean::API::Parser role. Periodt. 💅

🧚 REQUIRED METHODS 🧚

Any class consuming this role must provide the following methods, fr fr:

• 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.

💅 METHODS 💅

This role provides default implementations of the following methods:

• parse_iter_from_io( $fh ) — returns an Attean::API::Iterator that results from parsing the data read from the IO::Handle object $fh.
• parse_iter_from_bytes( $data ) — returns an Attean::API::Iterator that results from parsing the data read from the UTF-8 encoded byte string $data.
• parse_cb_from_io( $fh ) — calls the $parser->handler function once for each object that results 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 results from parsing the data read from the UTF-8 encoded byte string $data.

🐛 BUGS 🐛

Please report any bugs or feature requests through the GitHub web interface at <https://github.com/kasei/attean/issues>. The maintainers wanna hear it, bestie — don't gatekeep the bug reports. 🦋

👀 SEE ALSO 👀

The original page has this heading but lists no entries under it. So, like, nothing extra to link here — but we keep the section because structure is iconic. 💜

👑 AUTHOR 👑

Gregory Todd Williams "<gwilliams@cpan.org>" — yes, that's the author credit, exactly as written. 👑

📜 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 that's the page! footer vibes: perl v5.40.0, dated 2025-01-26, on the Attean...eParser(3pm) page. byeee 💜