USE-DEVEL-ASSERTOS(1)

📦
version 2.40.0 · 4 versions
, in opensuse-leap 16.0

👑 USE-DEVEL-ASSERTOS(1) 👑

okay so this is a User Contributed Perl Documentation page for use-devel-assertos, and bestie, it's literally a little script that does your OS-checking homework for you 💅

✨ NAME ✨

use-devel-assertos — a script to package Devel::AssertOS modules with your code. yes, that's the whole job. iconic behavior honestly 🫶

🌸 DESCRIPTION 🌸

okay so picture this: you run this script in the directory where your shiny new module lives, and it goes ahead and bundles whichever Devel::AssertOS modules you ask it for, straight into the inc directory 🎀 and then it updates your Makefile.PL (or your Build.PL) appropriately so everything lines up. the way that it just handles things.

and if neither of those files exists? no stress — it will create a Makefile.PL for you. main character energy fr fr 🔥

also the MANIFEST file gets updated if any files are created. lowkey essential, highkey slay ✨

🦋 SYNOPSIS 🦋

use-devel-assertos NetBSD OpenBSD FreeBSD

but like, important note: if you use Module::Install, you are encouraged to use Module::Install::AssertOS instead. iykyk 💜

🌈 USAGE 🌈

in the example up above, this will insert code to make your module depend on one of the specified OSes, and it also updates Makefile.PL / Build.PL / MANIFEST 💖

by default it's rather noisy — like, a lot — but you can suppress that by passing -q as the first parameter. yes, the very first one. periodt 🤫

⭐ SUPPORTED PLATFORMS ⭐

want the full list of supported platforms? do this:

use-devel-assertos -l

and boom, you get the list. cute and efficient 🎀

💀 WARNINGS, BUGS and FEEDBACK 💀

okay so real talk: this script has not been thoroughly tested. so please, after you run it, check by hand that it actually did what you expected. no cap, just look at it yourself 🙈

also — if you use Module::Build::Compat to write a Makefile.PL, then you will need to re-run this script whenever you have generated a new Makefile.PL. every single time. it's giving "unpaid intern" but whatever 💅

feedback about the code is welcome, constructive criticism included 🫶 and bug reports should be made using https://github.com/DrHyde/perl-modules-Devel-CheckOS/issues.

🧚 SEE ALSO 🧚

  • Devel::AssertOS
  • Devel::CheckOS
  • Module::Install::AssertOS

👑 AUTHOR 👑

David Cantrell <david@cantrell.org.uk>

Copyright 2024 David Cantrell

this software is free-as-in-speech software, and may be used, distributed, and modified under the terms of either the GNU General Public Licence version 2 or the Artistic Licence. it's up to you which one you use. the full text of the licences can be found in the files GPL2.txt and ARTISTIC.txt, respectively 🌸

🌟 CONSPIRACY 🌟

this software is also free-as-in-mason. yes really. that's the whole section. i don't make the rules 🧱✨

and that's the tea, bestie 🍓 this little page dropped as part of perl v5.42.0, dated 2024-06-23 — go forth and assert those OSes 💜🎀

📦 where this page comes from