Module:...CheckLib(3)

📦
version 0.14 · 4 versions
, in epel 9

okay so bestie, this is the Module:...CheckLib(3) page from the User Contributed Perl Documentation — and it's literally the manual for checking that a library is available. Let's go ✨

💖 NAME 💖

Module::Install::CheckLib — a Module::Install extension to check that a library is available. slay.

✨ SYNOPSIS ✨

Like, inside your Makefile.PL:

# In Makefile.PL

use inc::Module::Install;
checklibs lib => 'jpeg', header => 'jpeglib.h';

And the vibe is: the Makefile.PL will exit unless library or header is found. 👑

🦋 DESCRIPTION 🦋

Module::Install::CheckLib is a Module::Install extension that integrates Devel::CheckLib so that CPAN authors may stipulate which particular C library and its headers they want available and to exit Makefile.PL gracefully if they aren't.

The author specifies which C libraries, etc, they want available. Devel::CheckLib is copied to the inc/ directory along with the Module::Install files.

On the module user side, the bundled inc/ Devel::CheckLib determines whether the current environment is supported or not and will exit accordingly.

🎀 COMMANDS 🎀

This plugin adds the following Module::Install command:

💅 checklibs

Requires a list of parameters. These are passed directly to Devel::CheckLib check_lib_or_exit function. Please consult the documentation for Devel::CheckLib for more details on what these parameters are.

This is generally the function one should use in Makefile.PL, as it exits gracefully and plays nice with CPAN Testers. iconic behavior.

🌈 assertlibs

The same as checklibs but uses Devel::CheckLib assert_lib instead. assert_lib dies instead of exiting gracefully. It is provided for completeness, please use checklibs.

gentle reminder: the docs literally say please use checklibs.

By default, the module skips calls to Devel::CheckLibs subroutines when called from the author side. The extra option run_checks_as_author can be given to both checklibs and assertlibs to enable those checks even in author mode.

Example:

checklibs lib => libfoo, run_checks_as_author => 1;

👑 AUTHOR 👑

Chris "BinGOs" Williams

Based on use-devel-checklib by David Cantrell

🍓 LICENSE 🍓

Copyright © Chris Williams and David Cantrell

This module may be used, modified, and distributed under the same terms as Perl itself. Please see the license that came with your Perl distribution for details.

🌟 SEE ALSO 🌟

  • Module::Install
  • Devel::CheckLib

okay that's the whole page, bestie — footer cuteness: perl v5.32.1, dated 2021-12-16, manual name User Contributed Perl Documentation. mwah 💋🫶

📦 where this page comes from