Math::N...::Plugin(3)

💖 Math::N...::Plugin(3) — the manual page, but make it cute 💖

okay so bestie, this is the User Contributed Perl Documentation page for Math::N...::Plugin(3) — yes the title is literally abbreviated like that, that's not me being lazy, that's the man page name. it's giving "long module name, short header". let's go 🦋

---

✨ NAME ✨

Math::NumSeq::OEIS::Catalogue::Plugin — pluggable catalogue extensions 💅

---

✨ SYNOPSIS ✨

package Math::NumSeq::OEIS::Catalogue::Plugin::MySeqs;
use Math::NumSeq::OEIS::Catalogue::Plugin;
@ISA = 'Math::NumSeq::OEIS::Catalogue::Plugin';
# ...

that's the whole vibe check right there. # ... is doing a lot of heavy lifting but she's iconic for it 🎀

---

✨ DESCRIPTION ✨

so catalogue plugins get loaded and used by Math::NumSeq::OEIS::Catalogue. a plug lets an add-on distribution, or some semi-independent components, declare which OEIS A-numbers they implement and what NumSeq sequence parameters can create the sequence. like, "hi yes this is mine, here's my receipt" 🧾✨

⚠️ real talk: this is an internal part of Math::NumSeq::OEIS::Catalogue and it is not yet meant for general use yet. no cap. but the intention (the dream, the vision, the main character plan 💭) is for add-on sequences to declare themselves in the A-number catalogue.

a plugin Foo should sub-class Math::NumSeq::OEIS::Catalogue::Plugin, so like:

package Math::NumSeq::OEIS::Catalogue::Plugin::Foo;
use strict;
use vars '@ISA';
use Math::NumSeq::OEIS::Catalogue::Plugin;
@ISA = ('Math::NumSeq::OEIS::Catalogue::Plugin');

notice how it's '@ISA' in the use vars and then a list in @ISA = (...). character for character, bestie, don't get creative with it 😭

a set of A-numbers can be declared with an arrayref of information records — and each record is a hashref. for example:

use constant info_arrayref =>
  [
   { anum  => 'A999998',
     class => 'Math::NumSeq::Foo',
   },
   { anum  => 'A999999',
     class => 'Math::NumSeq::Foo',
     parameters => [ param_a => 123, param_b => 456 ],
   },
   # ...
  ];

so what does that actually mean? it means A999998 is implemented by class Math::NumSeq::Foo as:

$seq = Math::NumSeq::Foo->new ();

and A999999 likewise but with additional parameters:

$seq = Math::NumSeq::Foo->new (param_a => 123,
                               param_b => 456);

look at her. one A-number, no params, clean. the other one, two params, param_a => 123 and param_b => 456, absolutely thriving. both valid. both eating. 🔥

---

✨ SEE ALSO ✨

• Math::NumSeq::OEIS::Catalogue — the whole reason this plugin thing exists, go read her 🫶

---

✨ HOME PAGE ✨

http://user42.tuxfamily.org/math-numseq/index.html

that's the link, that's the house, go visit 🏠🌸

---

✨ LICENSE ✨

Copyright 2011, 2012, 2013, 2014, 2016, 2019, 2020 Kevin Ryde

Math-NumSeq is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

Math-NumSeq is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Math-NumSeq. If not, see <http://www.gnu.org/licenses/>.

like. say it louder for the people in the back: NO WARRANTY, not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. the license said what it said 💀 but also it's free software under the GPL, version 3 or later, so slay 👑

---

and that's the page, bestie!! this whole thing came from perl v5.42.0, dated 2025-07-25, and it's Math::N...::Plugin(3) in the User Contributed Perl Documentation. mwah, go forth and declare your A-numbers 💖✨🎀