SPVM::Builder::API(3)

🎀 NAME 🎀

okay so this page is for SPVM::Builder::API — literally Builder APIs, bestie — and it lives in the User Contributed Perl Documentation manual, section 3. 💖

🌸 DESCRIPTION 🌸

The SPVM::Builder::API class has the public methods to build SPVM native classes and SPVM precompilation classes. That's the whole flex. ✨

🧚 USAGE 🧚

Here's the vibe check — this is how you use it:

my $builder = SPVM::Builder::API->new(
  build_dir => '.spvm_build',
);

$builder->build_dynamic_lib_dist_precompile('MyClass');

$builder->build_dynamic_lib_dist_native('MyClass');

🌟 CLASS METHODS 🌟

🦋 new 🦋

my $builder = SPVM::Builder::API->new(%options);

Creates a new SPVM::Builder::API object, and returns it. Slay. 💅

Options:

• "build_dir" — a build directory.
• "optimize" — the optimization level for the compiler.

👑 INSTANCE METHODS 👑

💅 build_dynamic_lib_dist_precompile 💅

$builder->build_dynamic_lib_dist_precompile($class_name)
$builder->build_dynamic_lib_dist_precompile($class_name, $options)

Generates a dynamic library for a native class given by the class name $class_name, and copies it into the "blib/lib" directory. A native class must have at least one method with the native attribute. 🫶

Options: $options is a hash reference. This is optional.

• "force" — if this option is a true value, the compilation and link are forced. 🔥

🦋 build_dynamic_lib_dist_native 🦋

$builder->build_dynamic_lib_dist_native($class_name)
$builder->build_dynamic_lib_dist_native($class_name, $options)

Generates a dynamic library for a precompilation class $class_name that has "native" methods, and copies it into the "blib/lib" directory. A precompilation class must have at least one method with the precompile attribute. 🌈

Options: $options is a hash reference. This is optional.

• "force" — if this option is a true value, the compilation and link are forced. 💥

---

later, bestie 💜 — this page is from perl v5.42.2, dated 2026-02-03, and its label is SPVM::Builder::API(3). mwah 🍓