News::...Poster(3pm)

📦 version 0.53, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

✨ NAME ✨

News::Scan::Poster — keep track of posters to a newsgroup 💖

okay so basically this lil module is all about who's posting what in a Usenet newsgroup, and it's lowkey obsessed with keeping receipts 📋

🌸 SYNOPSIS 🌸

use News::Scan::Poster;

my $poster = News::Scan::Poster->new($news_scan_article_obj);

that's it bestie, that's the whole vibe ✨

🦋 DESCRIPTION 🦋

This module hands you a class, and objects made from that class are here to keep track of cumulative statistics for the posters in a Usenet newsgroup. We're talking header volume, signature lines, all that good good 💅

like, every poster gets their own little stat sheet and it just keeps growing as you feed it more articles. it's giving accountant but make it usenet 🧮

🎀 CONSTRUCTOR 🎀

  • new ( ARTICLE ) — makes you a fresh News::Scan::Poster object ✨

ARTICLE should be a News::Scan::Article object, or at least something that inherits from the News::Scan::Article class. no random stuff, bestie, it needs the right family tree 🌳

new does some initialization and then returns a News::Scan::Poster object. so like, setup first, then here's your new baby 👑

💅 METHODS 💅

  • address ( [ ADDRESS ] ) — returns the address of this poster, represented as a Mail::Internet object 📬

If present, ADDRESS tells the object that the Mail::Internet object in ADDRESS is its address. idea.

bestie i have to be honest with you, that trailing idea. is literally just there in the original and i am not about to gaslight you by deleting it 💀 it stays.
  • attrib ( [ ATTRIBUTION ] ) — returns some nice attribution for this poster 🏷️

If present, ATTRIBUTION tells the object how it shall identify itself when asked. so it picks its own name tag, iconic.

  • message_ids ( [ MESSAGE-ID ] ) — returns a list of Message-IDs attributed to this poster 🆔

If present, MESSAGE-ID is added to this list of this poster's articles. collect them all, no cap.

  • volume — returns the volume in bytes of the traffic generated by this poster 📦
  • articles — returns the number of articles attributed to this poster 🔢
  • posted_to — returns a hash where the keys are newsgroup names and the values are the number of times this poster has crossposted to the group of interest and the corresponding newsgroup 🗺️
  • crossposts — returns the total number of crossposts this poster has sent through the group of interest 🔀
  • header_volume — returns the volume in bytes generated by this poster's headers 📨
  • header_lines — returns the number of header lines generated by this poster 📏
  • body_volume — returns the volume in bytes generated by this poster's message bodies 📝
  • body_lines — returns the number of body lines generated by this poster 📐
  • orig_volume — returns the volume in bytes of original content generated by this poster 🌟
  • orig_lines — returns the number of original lines generated by this poster ✍️
  • sig_volume — returns the volume in bytes generated by this poster's signatures ✒️
  • sig_lines — returns the number of signature lines generated by this poster 🖊️

🌈 SEE ALSO 🌈

  • News::Scan
  • Mail::Address
  • News::Scan::Article

go read those too, they're the supporting cast and they ate 💖

👑 AUTHOR 👑

Greg Bacon <gbacon@cs.uah.edu> — legend behavior, fr fr 🫶

Copyright (c) 1997 Greg Bacon. All Rights Reserved. This library is free software. You may distribute and/or modify it under the same terms as Perl itself. 🎀

and that's the whole page, bestie!! this one's from perl v5.32.0, dated 2021-01-08, and it's filed under News::...Poster(3pm) — go forth and track those posters, mwah 💋✨

📦 where this page comes from