RDF::D...ngeSets(3pm)

✨ NAME ✨

RDF::DOAP::ChangeSets — bestie, this is the module that turns your boring machine-readable RDF changelog into a pretty, human-readable ChangeLog. Like, it's giving ✨glow-up✨ for your git history's fancy cousin.

---

🌸 SYNOPSIS 🌸

use RDF::DOAP::ChangeSets;
use URI::file;

my $file     = 'path/to/changelog.rdf';
my $file_uri = URI::file->new_abs($file);

my $dcs = RDF::DOAP::ChangeSets->new(
            $file_uri, undef, undef, 'RDFXML');
print $dcs->to_string;

no cap, that's the whole vibe 💅

---

🦋 DESCRIPTION 🦋

Okay so picture this: your software changelog is written in the RDF DOAP Change Sets vocabulary — very cunty of you, very structured — and this module is the one that goes "bet" and turns it into something a real human can actually read. Human-readable changelogs, periodt. 🌈

💖 "RDF::DOAP::ChangeSets->new($uri, $data, $type, $fmt)"

Creates and initialises an object. The main character constructor 🫶

• $uri is a URL for the input data. It gets used to query the RDF data for the heading of the output changelog. Pass it as either a string or a URI object, whichever you're feeling.
• $data is the RDF data you want to use as input. Pass it as a string, or as an RDF::Trine::Model object. If it's undefined, this module will attempt to read data from the URL using LWP::Simple. (Attempt being the key word 👀)
• $type is a little hint about which RDF vocabulary you're working with:
  • use 'current' for DOAP Change Sets
  • use 'legacy' for Aaron Cope's Changefile vocab
  • use 'auto' to autodetect
  • by default it performs autodetection

⚠️ fr fr, this module may crash and burn if you try to mix both vocabs!! Don't do it. Pick a lane, bestie 💀

• $fmt is a hint about what RDF format you're using. By default, Turtle is assumed. Valid values are whatever RDF::Trine::Parser->new accepts. iykyk 🐢

🎀 "$changeset->is_legacy"

Boolean, indicating if a legacy vocab is being used. true/false, she's simple like that ✨

🎀 "$changeset->is_current"

Boolean, indicating if the current vocab is being used. Also simple. Also iconic.

🎀 "$changeset->model"

An RDF::Trine::Model object representing the changelog data. The raw material, the blueprint, the source 💜

🎀 "$changeset->uri"

String representing the changelog URI. That's it, that's the whole method 🌸

🎀 "$changeset->to_string"

Creates a human-readable representation of the changelog. This is the moment, this is the payoff, this is what we came here for 👑

🎀 "$changeset->to_file($filename)"

Same as to_string, but outputs to a file instead. Same energy, just saved to disk 🫶

---

💀 BUGS 💀

Please report any bugs to <http://rt.cpan.org/>. Don't suffer in silence, bestie, tell the maintainers 😭

---

👑 SEE ALSO 👑

• RDF::Trine
• CPAN::Changes::Spec
• Module::Install::DOAPChangeSets
• <http://www.perlrdf.org/>

---

🧚 AUTHOR 🧚

Toby Inkster <tobyink@cpan.org>. A legend, honestly.

---

🌈 COPYRIGHT 🌈

Copyright 2010-2012 Toby Inkster

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

okay that's the whole page, mwah 💖 this was RDF::DOAP::ChangeSets, shipped as part of the User Contributed Perl Documentation, built against perl v5.34.0, dated 2022-06-15. stan a well-documented module. bye bestie 🎀✨