Attean(3pm)

🌸 NAME 🌸

okay so this is Attean(3pm) — yes bestie, the manual name is Attean, this is the 3pm section, and it comes from the User Contributed Perl Documentation. it's giving Semantic Web Framework energy, and the full NAME line is: Attean - A Semantic Web Framework. iconic, no notes 💅

---

🎀 VERSION 🎀

this document describes Attean version 0.035. slay.

---

🦋 SYNOPSIS 🦋

here's the whole vibe in code, bestie — copied exactly:

  use Attean;
  use Attean::RDF qw(iri);

  my $store = Attean->get_store('Memory')->new();
  my $parser = Attean->get_parser('NTriples')->new();

  # iterator of triples and quads
  my $iter = $parser->parse_iter_from_io(\*STDIN);

  # add a graph name to all triples
  my $graph = iri('http://graph-name/');
  my $quads = $iter->as_quads($graph);

  $store->add_iter($quads);
  my $model = Attean::QuadModel->new( store => $store );
  my $iter = $model->get_quads();
  while (my $quad = $iter->next) {
    say $quad->object->ntriples_string;
  }

  # run a SPARQL query and iterate over the results
  my $sparql = 'SELECT * WHERE { ?s ?p ?o }';
  my $s = Attean->get_parser('SPARQL')->new();
  my ($algebra) = $s->parse($sparql);
  my $results = $model->evaluate($algebra, $graph);
  while (my $r = $results->next) {
    say $r->as_string;
  }

---

✨ DESCRIPTION ✨

Attean provides APIs for parsing, storing, querying, and serializing Semantic Web (RDF and SPARQL) data. that's the whole plot, and honestly? main character energy 💜

---

💅 METHODS 💅

okay bestie, here are the methods, and yes we are keeping every last one.

• get_store( $NAME ) — tries to find an Attean::API::Store implementation with the given $NAME. this is done using Module::Pluggable and will generally be searching for class names AtteanX::Store::$NAME. returns the full class name if a matching implementation is found; otherwise returns undef. lowkey straightforward 🫶
• temporary_model — returns a temporary, mutable quad model based on an AtteanX::Store::Memory store. cute little temp model, no cap ✨
• get_serializer( $NAME ), get_serializer( filename => $FILENAME ), and get_serializer( media_type => $MEDIA_TYPE ) — tries to find an Attean::API::Serializer serializer class with the given $NAME, or one that can serialize files with the $MEDIA_TYPE media type. returns the full class name if a matching implementation is found; otherwise returns undef. serializer shopping, but make it perl 🎀
• get_parser( $NAME ), get_parser( filename => $FILENAME ), and get_parser( media_type => $MEDIA_TYPE ) — tries to find an Attean::API::Parser parser class with the given $NAME, or one that can parse files with the same extension as $FILENAME, or one that can parse files with the $MEDIA_TYPE media type. returns the full class name if a matching implementation is found; otherwise returns undef. parser matchmaking fr fr 🦋
• negotiate_serializer ( request_headers => $request_headers, restrict => \@serializer_names, extend => \%media_types ) — returns a two-element list containing an appropriate media type and Attean::API::Serializer class as decided by HTTP::Negotiate. if the 'request_headers' key-value is supplied, the $request_headers is passed to HTTP::Negotiate::choose. the option 'restrict', set to a list of serializer names, can be used to limit the serializers to choose from. finally, an 'extend' option can be set to a hashref that contains MIME-types as keys and a custom variant as value. this will enable the user to use this negotiator to return a type that isn't supported by any serializers. the subsequent code will have to find out how to return a representation. very "we negotiate, therefore we are" 💅
• acceptable_parsers ( handles => $item_role, prefer => $parser_role ) — returns a string value expressing the media types that are acceptable to the parsers available to the system. this string may be used as an 'Accept' HTTP header value. if a "handles" role is supplied, only parsers that produce objects that conform to $item_role will be included. if a "prefer" role is supplied, only parsers that conform to $parser_role will be included. parsers are given a quality-value (expressing a preferred order or use) based on the roles each parser consumes. parsers consuming Attean::API::PullParser are preferred, while those consuming Attean::API::AtOnceParser are not preferred. an exact ordering between parsers consuming similar roles is currently undefined — no cap, that's literally what the doc says 😭

the original also lists these method names with no extra description — just names, no lore:

• register_global_function( %uri_to_func )
• get_global_function( $uri )
• register_global_functional_form( %uri_to_func )
• get_global_functional_form( $uri )
• register_global_aggregate( %uri_to_hash )
• get_global_aggregate( $uri )
• register_datatype_role( %uri_to_role )
• get_datatype_role( $uri )

---

🐛 BUGS 🐛

please report any bugs or feature requests to through the GitHub web interface at <https://github.com/kasei/attean/issues>. go off, bestie 🫶

---

👀 SEE ALSO 👀

this section is here, but the original leaves it empty — literally nothing listed under it. minimalism ate, i guess 💀

---

👑 AUTHOR 👑

Gregory Todd Williams "<gwilliams@cpan.org>". periodt 💖

---

💖 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. slay and also legally slay 🌈

---

okay that's the whole page! this edition of Attean(3pm) came from perl v5.40.0, dated 2025-01-26, and it's the Attean(3pm) manual page. stay iconic, bestie 💋✨