MooseX...tNumber(3pm)

💖 MooseX::Types::PortNumber 💖

okay so bestie, welcome to MooseX::Types::PortNumber — it's a Moose type library for port numbers, and it's brought to you straight from the Internet Assigned Numbers Authority (IANA). yes, that IANA. the port police. the ones who decide which numbers get to be ports. periodt. 👑

this little cutie lives in the perl man pages (section 3pm, user contributed perl documentation, iykyk) and it's giving extremely niche but extremely useful.

---

✨ VERSION ✨

version 0.03 — she's tiny but she's mighty 💅

---

🌸 SYNOPSIS 🌸

okay so here's the whole vibe, no cap:

package MyClass;
use Moose;
use MooseX::Types::PortNumber
    qw( PortNumber PortWellKnow PortRegistered PortPrivate );

has port => ( isa => PortNumber,     is => 'ro' );
has well => ( isa => PortWellKnow,   is => 'ro' );
has reg  => ( isa => PortRegistered, is => 'ro' );
has priv => ( isa => PortPrivate,    is => 'ro' );

look at that. four attributes, four types, all of them is => 'ro' because we're chill like that. 🦋

---

🎀 DESCRIPTION 🎀

so the port numbers get split into three ranges, and the way that they do it is iconic:

• the Well Known Ports — those are the ones from 0 through 1023
• the Registered Ports — those are the ones from 1024 through 49151
• the Dynamic and/or Private Ports — those are the ones from 49152 through 65535

and now the serious part, bestie, listen up: DCCP Well Known ports SHOULD NOT be used without IANA registration. the registration procedure is defined in [RFC4340], Section 19.9. don't skip the paperwork, it's not cute. 😭

same energy for the middle range: DCCP Registered ports SHOULD NOT be used without IANA registration. and again, the registration procedure is defined in [RFC4340], Section 19.9. fr fr. 🫶

---

👀 SEE ALSO 👀

go touch some grass, or alternatively, go read the actual list of ports:

• http://www.iana.org/assignments/port-numbers

---

🛠️ SUPPORT 🛠️

found a bug? (rude, but okay.) bugs may be submitted through the RT bug tracker:

• http://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-Types-PortNumber

or you can email bug-moosex-types-portnumber@rt.cpan.org 📧

also, the author is usually hanging out on IRC as 'drolsky' on irc://irc.perl.org — so if you wanna vibe check them directly, that's where. 💬

---

💸 DONATIONS 💸

okay so this part is genuinely so sweet. if you'd like to thank the author for the work they've done on this module, please consider making a "donation" via PayPal. they spend a lot of free time creating free software and would appreciate any support you'd care to offer. 🥹💖

but — and this is important — they are not suggesting that you must do this in order for them to continue working on this particular software. they will continue to do so, inasmuch as they have in the past, for as long as it interests them.

similarly, a donation made this way will probably not make them work on this software much more, unless they get so many donations that they can consider working on free software full time (let's all have a chuckle at that together 😭).

to donate, log into PayPal and send money to autarch@urth.org, or use the button at:

• http://www.urth.org/~autarch/fs-donation.html

---

👑 AUTHORS 👑

the legends themselves:

• Thiago Rondon <thiago@aware.com.br>
• Dave Rolsky <autarch@urth.org>

---

📜 COPYRIGHT AND LICENSE 📜

this software is copyright (c) 2016 by Thiago Rondon & Dave Rolsky.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay. 💜

---

and that's the whole page, bestie!! this doc was rendered by perl v5.34.0 on 2022-06-16 — so yeah, it's been around a minute, but she still eats. go forth and type your ports responsibly. 🌈✨