ExtUtil...ls::Base(3)

📦
version 0.037 · 6 versions
, in epel 10

💅 ExtUtils::Builder::BuildTools::Base(3) — the perl one, user contributed, you're welcome

okay so bestie, welcome to ExtUtils::Builder::BuildTools::Base, a whole base class for BuildTools implementations. It's giving "mom friend of the compiler world" — it doesn't do the work itself, it just hands out the delegates that do. 🫶

✨ VERSION ✨

version 0.037 — yes, that's the number, memorize it for the vibe check. 🎀

🌸 DESCRIPTION 🌸

So this is a base-class for providers of compiler configuration. That's the whole personality. It defines the following delegates, and honestly? They ate. 👑

🌈 compile($source, $target, %options)

This compiles $source to $target. Simple as that. It takes these optional arguments, and no, you can't skip reading them:

  • type — the type of the final product. Must be one of:
    • executable — an executable to be run. This is the default, so if you don't say anything you get this one. 💫
    • static-library — a static library to link against.
    • shared-library — a dynamic library to link against.
    • loadable-object — a loadable extension. On most platforms this is literally the same as a dynamic library, but some (Mac) make a distinction between these two. iykyk. 🍓
⚠️ okay this one matters, listen up: if you first compile for a static library that will later be linked into a shared library, you need to pick 'shared-library' here. not static-library. don't do it. I'm serious. 😭
  • profiles — a list of profile that can be used when compiling and linking. One profile comes with this distribution: '@Perl', which sets up the appropriate things to compile/link with libperl. iconic behavior honestly. 💜
  • include_dirs — a list of directories to add to the include path, e.g. ['include', '.'].
  • define — a hash of preprocessor defines, e.g. {DEBUG => 1, HAVE_FEATURE => 0}.
  • language — the language to use for compilation. Valid values are C or C++. no java bestie, sorry. 🙈
  • standard — the language standard to use, e.g. c99, c11.
  • extra_args — a list of additional arguments to the compiler. go off, add whatever. 🔥
  • type — this works the same as with compile.
  • profile — this works the same as with compile. (yes it's profile here and profiles up there, that's not a typo, that's just how it is, don't come for me 💀)
  • language — this works the same as with compile.
  • libraries — a list of libraries to link to. E.g. ['z'].
  • library_dirs — a list of directories to find libraries in. E.g. ['/opt/my-app/lib/'].
  • extra_args — a list of additional arguments to the linker.

🧚 the file-name girlies (all of them take $basename, $dir = undef)

  • object_file($basename, $dir = undef) — given a basename this will return the matching object file name. 🎀
  • library_file($basename, $dir = undef) — given a basename this will return the matching shared library file name. 💖
  • static_library_file($basename, $dir = undef) — given a basename this will return the matching static library file name. ✨
  • loadable_file($basename, $dir = undef) — given a basename this will return the matching loadable library file name. 🌟
  • executable_file($basename, $dir = undef) — given a basename this will return the matching executable file name. 👑

they all just... tell you the file name. lowkey the most helpful siblings in the whole module. slay. 💅

🌈 AUTHOR 🌈

Leon Timmermans <fawaka@gmail.com> — shoutout to the main character who wrote this. 💜

This software is copyright (c) 2012 by Leon Timmermans.

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

and that's the whole page bestie!! footer vibes for the record: this one's from perl v5.40.2, dated 2026-08-25, and the manpage header does the little ExtUtil...ls::Base(3) name-shortening thing because apparently even perl gets lazy with long names sometimes 😭💖 mwah, go compile something, you've got this 🦋🌸

📦 where this page comes from