NoCeM(3pm)

💖 NoCeM — the News::Article::NoCeM era 💖

okay bestie, so this is NoCeM, a Perl module (manual page NoCeM(3pm), from the User Contributed Perl Documentation crew) that generates accurate nocem notices. it's giving very specific, very powerful, and we're gonna get into it 🎀

---

✨ NAME ✨

News::Article::NoCeM — a module to generate accurate nocem notices 💅

---

🌸 SYNOPSIS 🌸

use News::Article::NoCeM;
my $nocem = new News::Article::NoCeM();

$nocem->hide($type, $spam);
$nocem->make_notice($type, $name, $issuer, $group, $prefix);
$nocem->sign($keyid, $passphrase);
$nocem->issue($conn, $ihave);

like, that's the whole vibe right there. five lines and you're posting notices, periodt ✨

---

🦋 DESCRIPTION 🦋

so what it actually does: it creates a nocem notice on the Usenet articles, and those notices may be posted normally to hide the messages. that's the whole point. hide the spam, look iconic doing it 👑

---

💜 USAGE 💜

use News::Article::NoCeM;

News::Article::NoCeM is a class that inherits News::Article and adds four new functions: hide(), make_notice(), sign() and issue(). and it also redefines two functions to disable them: post() and ihave(). not me just casually turning off two whole methods, we love a boundary-setting queen 💅

🎀 Article Methods 🎀

• hide ( TYPE, ARTICLE, [ARTICLE, ...] ) — hides one or more articles in the given TYPE. ARTICLE is an News::Article object that going to be hid. hide() will skip the articles without Newsgroup or Message-ID, and skip the ones already hid. (it's not gonna double-hide, it has standards 💖)

hide() returns the number of the articles hid.

• post
• ihave — post() and ihave() is disabled in News::Article::NoCeM. Please use issue() instead. 🚫 literally don't, they're off, use issue(), iykyk.
• make_notice ( TYPE, NAME, GROUP, ISSUER, [ PREFIX ] ) — retrieve articles marked by hide with TYPE, and make a notice fot them. If there's only one type within a container, then the container itself can be a notice. NAME is the identifier of the issuer. GROUP is the newsgroup the you will post nocem notice to. ISSUER is the email address of the issuer. PREFIX is the announcement before the nocem notice, which may explain the criteria of this notice, or where to find your public key for PGP verification. 🔑

make_notice() returns a News::Article::NoCeM object if success, and return undef if no article is hid.

• sign ( KEYID, PASSPHRASE ) — sign the content of the nocem notice with KEYID and PASSPHRASE. Please make sure that the issuer's public/secret keyring is ready. (do the prep work first bestie, no shortcuts 🙈)

sign() returns a News::Article::NoCeM object if success, and return undef if no article is hid, or pgp_sign failed.

• issue ( [ CONN, IHAVE ] ) — take optional CONN as a Net::NNTP object and issue the nocem notice. IHAVE indicates that call Net::NNTP::ihave() for submitting the notice, otherwise issue() will call News::Article::post() by default. 📬

issue() return the result of News::Article::post() or issue().

---

🌈 NOTES 🌈

standard article manipulation information can be read in the News::Article manpages. go read those too, they're the lore 📚

NoCeM FAQ is available on the web at <URL:http://www.cm.org/faq.html>. clicking that is free and the knowledge is priceless fr fr ✨

---

👑 AUTHOR 👑

written by Yen-Ming Lee <leeym@leeym.com>, based on a module by Tim Skirvin <tskirvin@killfile.org>. two absolute legends, we stan 🫶

---

💖 COPYRIGHT 💖

Copyright 2004-2005 by Yen-Ming Lee <leeym@leeym.com>. This code may be redistributed under the same terms as Perl itself. 💅

---

and that's a wrap, bestie 🌸 this page ships with perl v5.36.0 and was dated 2022-11-27 — no cap, that's the whole NoCeM(3pm) moment. slay, hydrate, and go hide some spam 💖✨🎀🦋