HTML::...:Types(3pm)

💅 HTML::FormHandler::Types — the Moose type constraints one (3pm)

okay so bestie, this is the HTML::FormHandler::Types page from the User Contributed Perl Documentation, and it's literally just type constraints. Moose type constraints. That's the whole vibe. Let's get into it 🫶

✨ VERSION ✨

version 0.40068 — yes it's a whole version number, we love a numbered era 🎀

🌸 SYNOPSIS 🌸

okay so here's the thing that trips everyone up: these types are provided by MooseX::Types. and these types must not be quoted when you use them. no quotes. none. periodt.

has 'posint' => ( is => 'rw', isa => PositiveInt);
has_field 'email' => ( apply => [ Email ] );

but!! types declared using Moose::Util::TypeConstraints, on the other hand, must be quoted. yes this is inconsistent, no I don't make the rules 😭

has_field 'text_both' => ( apply => [ PositiveInt, 'GreaterThan10' ] );

and to import these types into your forms, you gotta either specify (':all') or list out the types you actually want. main character energy only:

use HTML::FormHandler::Types (':all');

or, if you're being picky (respect):

use HTML::FormHandler::Types ('Email', 'PositiveInt');

🦋 DESCRIPTION 🦋

ngl, it would be possible to import the MooseX types (Common, etc), but for now they're just re-implementing them right here in this module. why? so they can change the messages and keep control of what types they provide. control is the vibe, we stan 💅

From MooseX::Types::Common:

'PositiveNum', 'PositiveInt', 'NegativeNum', 'NegativeInt', 'SingleDigit',
'SimpleStr', 'NonEmptySimpleStr', 'Password', 'StrongPassword', 'NonEmptyStr',

👑 Type Constraints 👑

these types check the value and issue an error message. so like, they're the ones who will call you out. lovingly. 🔥

• Email — uses Email::Valid
• State — checks that the state is in a list of two uppercase letters
• Zip — literally no description given in the original, it's giving mystery 💀
• IPAddress — must be a valid IPv4 address
• NoSpaces — no spaces in string allowed
• WordChars — must be made up of letters, digits, and underscores
• NotAllDigits — might be useful for passwords 👀
• Printable — must not contain non-printable characters
• SingleWord — contains a single word

---

🧚 Type Coercions 🧚

these types will transform the value without an error message. no scolding, just glow-up ✨

• Collapse — replaces multiple spaces with a single space
• Upper — makes the string all upper case
• Lower — makes the string all lower case
• Trim — trims the string of starting and ending spaces

💖 AUTHOR 💖

FormHandler Contributors — see HTML::FormHandler

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2017 by Gerda Shank.

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

---

fr fr that's the whole page, no cap. go forth and type-constrain responsibly 🌈

and that's a wrap bestie!! this was HTML::...:Types(3pm) from the User Contributed Perl Documentation, perl v5.34.0, dated 2022-03-25 — mwah, slay, bye 💜🦋