WebSer...:Source(3pm)

💖 WebService::CIA::Source — the perl manpage but make it cute 💖

okay bestie, gather round, because we're reading the manual for WebService::CIA::Source, and it's a 3pm perl module page, so you know it's gonna be a whole thing. no cap. 🎀

---

✨ NAME ✨

WebService::CIA::Source — it's literally a base class for WebService::CIA sources. that's the whole job description. she's the blueprint, the blueprint-iest blueprint. 👑

---

🌸 SYNOPSIS 🌸

here's the vibe, copy-paste ready:

use WebService::CIA::Source;
my $source = WebService::CIA::Source->new();

two lines. iconic. she said "load me, then make me." 💅

---

🦋 DESCRIPTION 🦋

so WebService::CIA::Source is a base class for WebService::CIA sources — think WebService::CIA::Source::DBM and WebService::CIA::Source::Web. those are the daughters, this is the mother. 🌈

and like… could you technically use her as a source all on her own? sure bestie, technically. but it won't get you very far. that's not me being mean, that's the actual documentation being real with you. she's the abstract vibe, not the plug. 💀

---

🧚 METHODS 🧚

💜 new()

makes you a brand new WebService::CIA::Source object. takes no arguments. zero. none. she doesn't want them. periodt. ✨

💜 value($country_code, $field)

retrieves a value. and by "retrieves a value" i mean it always returns undef. every single time. the audacity honestly 😭 that's the bit though — she's a base class, she's not gonna do the work for you.

💜 all($country_code)

retrieves all fields and values. and it always returns an empty hashref. nothing. nada. a cute little empty {} for your troubles 🫶

---

👑 AUTHOR 👑

Ian Malpass (ian-cpan@indecorous.com)

---

🌟 COPYRIGHT 🌟

Copyright 2003-2007, Ian Malpass

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. so go off, redistribute responsibly. 🎀

and here's the tea: the CIA World Factbook's copyright information page (https://www.cia.gov/library/publications/the-world-factbook/docs/contributor_copyright.html) says, and i quote:

The Factbook is in the public domain. Accordingly, it may be copied freely without permission of the Central Intelligence Agency (CIA).

public domain baby!! copy away, no permission slip needed from the CIA themselves. iconic behaviour fr fr. 🔥

---

🔥 SEE ALSO 🔥

• WebService::CIA
• WebService::CIA::Parser
• WebService::CIA::Source::DBM
• WebService::CIA::Source::Web

go read those next bestie, they actually do stuff 💖

---

and that's the page!! this one's from perl v5.34.0, dated 2022-06-28, and it was giving ✨base class✨ the whole time. mwah. 💅🌸🦋