Busine...BR::Biz(3pm)

👑 Business::BR::Biz (a 3pm user-contributed Perl doc)

okay bestie, welcome to the page for Business::BR::Biz, the module from the biz-br / Business-BR-Ids corner of CPAN. it's giving Brazilian-business-subjects energy, and it's also giving deprecated energy, so like, read the fine print 💅

---

✨ NAME ✨

Business::BR::Biz — DEPRECATED (the old description was: Modules for Brazilian business-related subjects). 🫶

---

🌸 SYNOPSIS 🌸

use Business::BR::Biz; # does nothing, it is here because of POD and $VERSION

okay so real talk, this use line is basically a decorative plant 🪴 — it does nothing. it's only hanging out here for the POD and the $VERSION. iconic, honestly.

---

💖 DESCRIPTION 💖

this module used to be a placeholder — like a sticky note on the fridge 🧲 — holding the overview for the 'biz-br' distribution, which is now called 'Business-BR-Ids'. and soon, not even that: they're gonna get rid of it entirely by scooping up the intro docs living here and moving them over to Business::BR::Ids. no cap. 🦋

🎀 EXPORT 🎀

None by default. that's it, that's the whole vibe. nothing comes out unless you ask. 💀

---

🔥 TESTING CORRECTNESS 🔥

so among all the functionalities that are gonna be available in this distribution, there are tests for the correctness of typical identification numbers and codes. very demure, very mindful of your digits. ✨

to be correct here means one very specific thing: it satisfies certain easily computed rules. like, a CPF number is correct if it's 11-digits-long and it satisfies two check equations which validate the check digits. math serving looks, fr fr. 🧮

the modules "Business::BR::*" will provide subroutines "test_*" for testing the correctness of such concepts. those are the little guys doing the work. 🫡

⚠️ big important vibe check: being correct does NOT mean an identification number or code has been verified to stand for some real entry — like, an actual Brazilian taxpayer citizen in the case of CPF. nope! that would require access to government databases which may or may not be available on a public basis. and besides, to verify something will not be easily computed in general, implying access to databases and applying specialized rules. so like, don't come for us. 😭

here we're trying to stick to a consistent terminology, and 'correct' will always mean validity against syntactical forms and shallow semantics. meanwhile 'verified' is the word reserved for telling if an entity really makes sense in the real world. 🌍

and bestie, this convention is purely arbitrary — it's for the sake of being formal in some way, that's literally all. terms like 'test', 'verify', 'check', 'validate', 'correct', 'valid' get thrown around interchangeably in colloquial prose. we just be like that. 🤷♀️

---

🍓 EXAMPLES 🍓

as a rule, the documentation and tests choose correct identification codes which are verified to be invalid by the time of the distribution update. yes, you read that right — correct but fake. 💅

that is, in Business::BR::CPF, the mentioned correct CPF number '390.533.447-05' is correct, but doesn't actually exist in government databases. she's valid syntactically and completely made up. main character energy, zero real footprint. 👑

---

🌈 SEE ALSO 🌈

as you might have guessed, this is not the first Perl distribution to approach this kind of functionality. take a look at 👀

http://search.cpan.org/search?module=Brasil::Checar::CPF
http://search.cpan.org/search?module=Brasil::Checar::CGC
http://search.cpan.org/~mamawe/Algorithm-CheckDigits-0.38/CheckDigits/M11_004.pm

if you want to find out about the namespace Business::BR, follow the link. 🔗

and please report bugs via CPAN RT, at:

http://rt.cpan.org/NoAuth/Bugs.html?Dist=Business-BR-Ids

---

💜 AUTHOR 💜

A. R. Ferreira, <ferreira@cpan.org> 🫶

---

⭐ COPYRIGHT AND LICENSE ⭐

Copyright (C) 2005 by A. R. Ferreira

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available. 📜💖

---

and that's the whole page, bestie!! 🎀 this was perl v5.36.0, dated 2022-10-13, brought to you by User Contributed Perl Documentation, and yes it really does spell the name Busine...BR::Biz up there in the header like someone got distracted mid-typing. slay. 💅✨