MediaW...t::page(3pm)

💖 MediaWiki::DumpFile::page — the manual, but make it make sense 💖

okay bestie, sit down, we're learning MediaWiki::DumpFile::page, part of the User Contributed Perl Documentation situation (perl manual, section 3pm, iykyk). This is the whole vibe. 🦋

---

✨ NAME ✨

Parse::MediaWikiDump::page — the object that represents one specific revision of a MediaWiki page. that's it, that's the job, and it eats every time 💅

---

🌸 ABOUT 🌸

so, plot twist: you don't really make these yourself. this object gets handed to you by the next method of Parse::MediaWikiDump::Pages and Parse::MediaWikiDump::Revisions. literally it just appears in your life like a little gift 🎀

like, you could construct instances of this particular object on your own, but the main character move is using it to read out information about a page that lives in a MediaWiki instance. that's the whole point. that's the assignment. 👑

---

🌈 SYNOPSIS 🌈

use MediaWiki::DumpFile::Compat;

$pages = Parse::MediaWikiDump::Pages->new('pages-articles.xml');

#get all the records from the dump files, one record at a time
while(defined($page = $pages->next)) {
  print "title '", $page->title, "' id ", $page->id, "\n";
}

not me reading a whole XML dump one record at a time like it's a group chat I'm catching up on 😭 iconic behaviour honestly

---

💜 METHODS 💜

okay this is the good part. every method, every detail, no skips, fr fr.

• $page->redirect — returns an empty string (something like '') for the main namespace, or a string holding the name of the namespace. so like, if it's giving redirect energy, you'll know 🫶
• $page->categories — hands you a reference to an array stuffed with a list of categories, or undef if there are literally no categories. ⚠️ big caveat bestie: this method does not understand templates, so it may not return every category the article actually belongs to. it's doing its best, but it's not omniscient, lowkey.
• $page->title — returns a string of the full article title, and yes that includes the namespace if one's present. full government name energy 🧚
• $page->namespace — returns a string of the article's namespace, or an empty string if the article is chilling in the default namespace. no namespace, no problem 💖
• $page->id — returns a number, and that number is the id for the page inside the MediaWiki instance. her ID, if you will 🪪
• $page->revision_id — returns a number, and that number is the revision id for the page in the MediaWiki instance. different number, different lore ✨
• $page->timestamp — returns a string looking exactly like this: 2005-07-09T18:41:10Z. that format, no deviations, periodt ⏰
• $page->username — returns a string of the username responsible for this specific revision of the article, or undef if the editor was anonymous. anon editors stay mysterious 🙈
• $page->userid — returns a number that's the id for the user that $page->username gives you back, or undef if the editor was anonymous. matching set, cute 🎀
• $page->userip — returns a string of the IP of the editor if the edit was anonymous, or undef otherwise. so if it's anon, you get the address; if not, nothing, nada, undef 💀
• $page->minor — returns 1 if this article was flagged as a minor edit, otherwise returns 0. binary. decisive. slay ⭐
• $page->text — returns a reference to a string that contains the article title text. yes, a reference to a string, we said what we said 🔥

---

🌟 a lil sign-off 🌟

and that's the whole page, bestie — this doc is from the User Contributed Perl Documentation, MediaWiki::DumpFile::page(3pm), version perl v5.34.0, dated 2022-06-15. go forth and parse your dumps, you absolute legend 👑💖✨