ASPEER-MakeMaker

 view release on metacpan or  search on metacpan

README  view on Meta::CPAN

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,

README  view on Meta::CPAN

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.

README  view on Meta::CPAN

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.

README.md  view on Meta::CPAN

# 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:

README.md  view on Meta::CPAN

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

README.md  view on Meta::CPAN

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 2.154 seconds using v1.01-cache-2.11-cpan-1bcd28dbaf1 )