ASPEER-MakeMaker
view release on metacpan or search on metacpan
ASPEER::MakeMaker
ASPEER::MakeMaker is the parent distribution for sharing
ExtUtils::MakeMaker customizations across ASPEER MakeMaker plugins.
The module is designed to be loaded from a Makefile.PL. On import it can
wrap selected ExtUtils::MakeMaker sections, add project-specific
Makefile macros, and append a reusable postamble containing common make
targets.
GitHub Attestations
The release workflow generates GitHub artifact attestations for
distribution archives. Install the GitHub CLI with gh attestation
support and authenticate with gh auth login.
Download ASPEER-MakeMaker-VERSION.tar.gz from a GitHub release,
attestation from this repository. The workflow publishes the same
archive to GitHub Releases and CPAN. Older releases and GitHub's
automatically generated source-code archives are not covered.
Purpose
This distribution centralizes build-time conventions that would
otherwise be copied between plugin distributions. In particular it
provides:
- MakeMaker import hooks for selected Makefile generation sections.
- A const_config extension that publishes shared constants as Makefile
macros.
- A postamble extension that appends common make targets from a
template.
- A post_initialize extension that controls the install map and records
the Git revision beside VERSION_FROM.
- A retained util_sync target and method for copying the shared utility
files into an older or standalone distribution when required.
- Shared logging, file, argument-parsing, and Perl runtime construction
helpers.
The module-level sidecar documents describe the individual pieces:
- lib/ASPEER/MakeMaker.pm.md
- lib/ASPEER/MakeMaker/MM/Import.pm.md
- lib/ASPEER/MakeMaker/MM.pm.md
- lib/ASPEER/MakeMaker/MM/Util.pm.md
- lib/ASPEER/MakeMaker/MM/Constant.pm.md
Notes
This module modifies ExtUtils::MakeMaker behavior by replacing selected
ExtUtils::MM::* methods at import time. It should therefore be loaded as
part of Makefile generation, not as a general runtime dependency.
The distribution requires Perl 5.8 or later.
# ASPEER::MakeMaker
`ASPEER::MakeMaker` is the parent distribution for sharing
`ExtUtils::MakeMaker` customizations across ASPEER MakeMaker plugins.
The module is designed to be loaded from a `Makefile.PL`. On import it can
wrap selected `ExtUtils::MakeMaker` sections, add project-specific Makefile
macros, and append a reusable postamble containing common make targets.
## GitHub Attestations
The release workflow generates [GitHub artifact attestations](https://docs.github.com/en/actions/concepts/security/artifact-attestations)
for distribution archives. Install the [GitHub CLI](https://cli.github.com/)
with `gh attestation` support and authenticate with `gh auth login`.
Download `ASPEER-MakeMaker-VERSION.tar.gz` from a GitHub release, MetaCPAN,
or a CPAN mirror, replace `VERSION`, and verify it with:
A successful verification confirms that the archive checksum matches an
attestation from this repository. The workflow publishes the same archive to
GitHub Releases and CPAN. Older releases and GitHub's automatically generated
source-code archives are not covered.
## Purpose
This distribution centralizes build-time conventions that would otherwise be
copied between plugin distributions. In particular it provides:
- MakeMaker import hooks for selected Makefile generation sections.
- A `const_config` extension that publishes shared constants as Makefile
macros.
- A `postamble` extension that appends common make targets from a template.
- A `post_initialize` extension that controls the install map and records the
Git revision beside `VERSION_FROM`.
- A retained `util_sync` target and method for copying the shared utility files
into an older or standalone distribution when required.
- Shared logging, file, argument-parsing, and Perl runtime construction helpers.
## Basic Usage
The module-level sidecar documents describe the individual pieces:
- `lib/ASPEER/MakeMaker.pm.md`
- `lib/ASPEER/MakeMaker/MM/Import.pm.md`
- `lib/ASPEER/MakeMaker/MM.pm.md`
- `lib/ASPEER/MakeMaker/MM/Util.pm.md`
- `lib/ASPEER/MakeMaker/MM/Constant.pm.md`
## Notes
This module modifies `ExtUtils::MakeMaker` behavior by replacing selected
`ExtUtils::MM::*` methods at import time. It should therefore be loaded as part
of Makefile generation, not as a general runtime dependency.
The distribution requires Perl 5.8 or later.
lib/ASPEER/MakeMaker.pm view on Meta::CPAN
@makemaker_args,
$source_file,
);
```
Copies one of this distribution's helper files into a consuming
distribution. The method expects the fixed MakeMaker argument block first,
followed by the source file path. The destination is not passed directly.
Instead, `util_sync` derives it from the parsed `TO_INST_PM` MakeMaker value.
The destination lookup uses the source basename and selects an installed module
path ending in:
```text
MM/<source basename>
```
For example, a source named `Util.pm` is matched against a target path ending
in `MM/Util.pm`.
The method validates that:
lib/ASPEER/MakeMaker.pm view on Meta::CPAN
ASPEER::MakeMaker->util_sync(
@makemaker_args,
$source_file,
);
Copies one of this distribution's helper files into a consuming
distribution. The method expects the fixed MakeMaker argument block first,
followed by the source file path. The destination is not passed directly.
Instead, C<util_sync> derives it from the parsed C<TO_INST_PM> MakeMaker value.
The destination lookup uses the source basename and selects an installed module
path ending in:
MM/<source basename>
For example, a source named C<Util.pm> is matched against a target path ending
in C<MM/Util.pm>.
The method validates that:
=over
lib/ASPEER/MakeMaker.pm.md view on Meta::CPAN
@makemaker_args,
$source_file,
);
```
Copies one of this distribution's helper files into a consuming
distribution. The method expects the fixed MakeMaker argument block first,
followed by the source file path. The destination is not passed directly.
Instead, `util_sync` derives it from the parsed `TO_INST_PM` MakeMaker value.
The destination lookup uses the source basename and selects an installed module
path ending in:
```text
MM/<source basename>
```
For example, a source named `Util.pm` is matched against a target path ending
in `MM/Util.pm`.
The method validates that:
( run in 1.106 second using v1.01-cache-2.11-cpan-1bcd28dbaf1 )