NAME

prepare4release - prepare a Perl module directory for release

SYNOPSIS

prepare4release [--github | --gitlab] [--cpan] [--verbose]

prepare4release --usage

prepare4release --help

OPTIONS

--github

Use GitHub for META_MERGE URLs and pod2github in Makefile.PL. If .github/workflows/ci.yml is absent, create a GitHub Actions workflow (Perl matrix from Makefile.PL / use v5 through latest stable via MetaCPAN).

--gitlab

Use GitLab (default host https://gitlab.com/ unless git.server is set) for URLs and pod2github in Makefile.PL. If .gitlab-ci.yml is absent, create a GitLab CI pipeline with a similar Perl matrix.

--cpan

Adds CPAN-oriented Markdown shield lines (Repology/MetaCPAN, fury.io, cpants) in README.md together with license and Perl badges; see App::prepare4release. CI badges follow --github / --gitlab as described there.

--verbose

Print configuration, derived URLs, Perl matrix notes, and Alien::* hints to stderr.

--usage

Short usage (via Pod::Usage).

--help

Full documentation (via Pod::Usage).

DESCRIPTION

Run in the distribution root (prepare4release.json + Makefile.PL). Configuration uses a nested git object (author, repo, optional server) and optional ci.apt_packages for OS packages in generated CI.

The tool fills in module_name, version, and dist_name when omitted, patches Makefile.PL, and optionally adds CI files. See App::prepare4release for PREPARE4RELEASE_PERL_MAX, matrix rules, apt behaviour, and author test xt/metacpan-live.t (set RELEASE_TESTING=1).

SEE ALSO

App::prepare4release