tainting(3pm)

✨ tainting(3pm) — the manual page, but make it cute ✨

okay bestie, gather round, because we're talking about tainting(3pm) 💅 this is the User Contributed Perl Documentation version, and honestly? it's a little messy but we're gonna get through it together 🫶

---

💖 NAME 💖

tainting — (DEPRECATED) Enable taint mode lexically

okay so the word DEPRECATED is right there in the name. that's not a vibe, that's a warning label. noted. 💀

---

🌸 VERSION 🌸

This document describes version 0.031 of tainting (from Perl distribution tainting), released on 2021-08-06. 🎀

---

✨ SYNOPSIS ✨

🦋 To enable tainting in a lexical block

{
    use tainting;
    # tainting is enabled
}
# tainting is disabled again

🦋 To disable tainting in a lexical block

use tainting;
{
    no tainting;
    # tainting is disabled
}
# tainting is enabled again

see how it flips back the second the block ends? that's the lexical part and it's giving main character energy ngl 👑

---

💜 DESCRIPTION 💜

DEPRECATION NOTICE: tainting.pm is broken and will be purged from CPAN because the lexical switching is done at compile time while tainting is performed at runtime. Please see Taint::Runtime and localize $TAINT instead.

not me having to say this but yeah, she's broken 💀 it's a timing thing: the lexical switching happens at compile time, but tainting actually happens at runtime, and those two are simply not syncing. it's giving long-distance relationship that didn't work out. so the whole thing is getting yeeted off CPAN. use Taint::Runtime and localize $TAINT instead, okay? 🫶

okay so for the historical record, here's what she was supposed to do:

This module provides a simpler interface to Taint::Runtime. The idea is so that there is no functions or variables to import. Just use or no, like warnings or strict. Tainting of %ENV will be done one time automatically the first time this module is used. 🌈

Please (PLEASE) read Taint::Runtime's documentation first about the pro's and con's of enabling/disabling tainting at runtime. TL;DR: Use -T if you can. 👑

fr fr, read the other docs first. the -T advice is the real one. don't skip it. 🙈

---

🧚 CONTRIBUTOR 🧚

Steven Haryanto <sharyanto@cpan.org>

---

🌈 HOMEPAGE 🌈

Please visit the project's homepage at <https://metacpan.org/release/tainting>. 🎀

---

⭐ SOURCE ⭐

Source repository is at <https://github.com/perlancar/perl-tainting>. 💖

---

🐛 BUGS 🐛

Please report any bugs or feature requests on the bugtracker website <https://rt.cpan.org/Public/Dist/Display.html?Name=tainting>. 🌸

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature. (yes queen, bring receipts, that's how you get it fixed 💅)

---

👀 SEE ALSO 👀

• Taint::Runtime

---

🫶 AUTHOR 🫶

perlancar <perlancar@cpan.org>

---

👑 COPYRIGHT AND LICENSE 👑

This software is copyright (c) 2021, 2017, 2012 by perlancar@cpan.org.

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

---

and that's the whole page bestie, no cap 💖 this was tainting(3pm), generated by perl v5.32.1, dated 2021-09-19 — stay tainted (or don't, honestly, use -T), mwah 🎀✨