Attean...:SPARQL(3pm)

✨ NAME ✨

AtteanX::Parser::SPARQL — SPARQL 1.1 Parser. You're reading the Attean...:SPARQL(3pm) page from the User Contributed Perl Documentation, and it's lowkey iconic. 💖

🌸 VERSION 🌸

This document describes AtteanX::Parser::SPARQL version 0.035. yes, 0.035, write it down bestie.

🦋 SYNOPSIS 🦋

okay so here's the vibe, code first:

use AtteanX::Parser::SPARQL;
my $algbrea = AtteanX::Parser::SPARQL->parse($sparql);
# or:
my $parser     = AtteanX::Parser::SPARQL->new();
my ($algebra) = $parser->parse_list_from_bytes($sparql);

# or to allow parsing of SPARQL 1.1 Updates:

my $algbrea = AtteanX::Parser::SPARQL->parse_update($sparql);
# or:
my $parser = AtteanX::Parser::SPARQL->new(update => 1);
my ($algebra) = $parser->parse_list_from_bytes($sparql);

Notice that $algbrea is spelled like that in the original synopsis — we're keeping it exactly, no “fixing” the variable name, periodt.

💅 DESCRIPTION 💅

This module implements a recursive-descent parser for SPARQL 1.1 using the AtteanX::Parser::SPARQLLex tokenizer. tokenizer bestie, it's giving lex realness. Successful parsing results in an object whose type is one of: Attean::Algebra::Query, Attean::Algebra::Update, or Attean::Algebra::Sequence. That's the whole type trio, no cap.

👑 ROLES 👑

This class consumes Attean::API::Parser, Attean::API::AtOnceParser, and Attean::API::AbbreviatingParser. three roles, all consumed, slay.

🎀 ATTRIBUTES 🎀

These are the attributes, exactly as the page lists them. The original doesn't spell out what each one does, so we're not inventing lore — just handing you the names, bestie:

• canonical_media_type
• media_types
• file_extensions
• handled_type
• lexer
• args
• build
• update
• namespaces
• baseURI
• filters
• blank_nodes
• has_blank_nodes_map

🔥 METHODS 🔥

Some methods get a description, some are just a signature and a dream. Here's the full lineup:

• parse ( $sparql ) — Parse the $sparql query string and return the resulting Attean::API::Algebra object. query mode: activated.
• parse_update ( $sparql ) — Parse the $sparql update string and return the resulting Attean::API::Algebra object. update mode: also activated.
• parse_list_from_io( $fh ) — listed as a method; the original page gives no extra description here. (just the signature, no extra lore)
• parse_list_from_bytes( $bytes ) — same deal: listed as a method, with no extra description in the original. signature only, bestie.
• parse_nodes ( $string ) — Returns a list of Attean::API::Term or Attean::API::Variable objects, parsed in SPARQL syntax from the supplied $string. Parsing is ended either upon seeing a DOT, or reaching the end of the string. DOT or done, those are the rules.
• error — Returns the error encountered during the last parse. the last parse's receipts, basically.
• new_binary_expression ( $operator, @operands ) — Returns a new binary expression structure.
• new_function_expression ( $function, @operands ) — Returns a new function expression structure.

💀 BUGS 💀

Please report any bugs or feature requests through the GitHub web interface at https://github.com/kasei/attean/issues. the issue tracker is right there, go off.

🌈 SEE ALSO 🌈

This section is empty in the original page — no SEE ALSO references listed. nothing to see here, literally.

🍓 AUTHOR 🍓

Gregory Todd Williams "<gwilliams@cpan.org>". author icon 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. same terms as Perl, periodt.

---

Sign-off: this page is from perl v5.40.0, dated 2025-01-26, and it's the Attean...:SPARQL(3pm) manual. byeeee 💖