[Perl/perl5] 6a8c70: h2xs - add Git support and support for multiple mo...

  Branch: refs/heads/yves/util_perlnewdist
  Home:   https://github.com/Perl/perl5
  Commit: 6a8c70f65402dbd3c090c2b4bc124e525a8553b8
      https://github.com/Perl/perl5/commit/6a8c70f65402dbd3c090c2b4bc124e525a8553b8
  Author: Yves Orton <[email protected]>
  Date:   2026-08-16 (Sun, 16 Aug 2026)

  Changed paths:
    M lib/h2xs.t
    M utils/h2xs.PL

  Log Message:
  -----------
  h2xs - add Git support and support for multiple modules

Add --git to initialize a repository, stage the generated distribution,
and create an initial commit. Add --gitignore to create the Git ignore
files without initializing a repository.

Add --with which supports a comma-separated lists of additional
pure-Perl modules that will be generated. A leading :: extends the primary
module name.

Add --module as an alias for --name.

Add --author and --email for generated metadata.

Update the generated test and MANIFEST to account for additional modules
and Git metadata, and test the new options.


  Commit: 032d28f56790975cbf70219b9c95fcb2ce7f34cc
      https://github.com/Perl/perl5/commit/032d28f56790975cbf70219b9c95fcb2ce7f34cc
  Author: Yves Orton <[email protected]>
  Date:   2026-08-16 (Sun, 16 Aug 2026)

  Changed paths:
    M lib/h2xs.t
    M pod/perldelta.pod
    M utils/h2xs.PL

  Log Message:
  -----------
  h2xs - warn about omitting autoloading

These days there isn't such a good reason to use autoload. So discourage
it in modern h2xs. Its just a warning tho.


  Commit: 87364fdbd9081aed401754be0dacf5ce6722ef1a
      https://github.com/Perl/perl5/commit/87364fdbd9081aed401754be0dacf5ce6722ef1a
  Author: Yves Orton <[email protected]>
  Date:   2026-08-16 (Sun, 16 Aug 2026)

  Changed paths:
    M utils/h2xs.PL

  Log Message:
  -----------
  h2xs - Obfuscate email addresses generated by h2xs

Apply the same light obfuscation to author email addresses wherever h2xs
writes them. No need to make it easy for email harvestors.


  Commit: 6222ab61dd850d47fce4a376c59636b001d5e0c5
      https://github.com/Perl/perl5/commit/6222ab61dd850d47fce4a376c59636b001d5e0c5
  Author: Yves Orton <[email protected]>
  Date:   2026-08-16 (Sun, 16 Aug 2026)

  Changed paths:
    M MANIFEST
    M Porting/Maintainers.pl
    A lib/perlnewdist.t
    M pod/perl.pod
    M pod/perldelta.pod
    M pod/perlmodstyle.pod
    M pod/perlnewmod.pod
    M pod/perlutil.pod
    M utils.lst
    M utils/Makefile.PL
    M utils/h2xs.PL
    A utils/perlnewdist.PL

  Log Message:
  -----------
  util/perlnewdist - new utility to create perl modules

Add a beginner-friendly command for creating a new Perl distribution.
The command is a thin wrapper around h2xs, with modern defaults for
pure-Perl modules, optional XS and Exporter support, repeatable
additional modules, author configuration, email obfuscation, and Git
initialization.

Documents perlnewdist as the normal starting point for new modules and
reserve h2xs references for its lower-level XS and C-header workflows.
Add tests covering distribution creation, configuration, metadata, help,
and the initial Git commit.

h2xs is still the goto tool for generating new projects, but perlnewdist
just exposes a cleaner nice api with defaults more oriented towards pure
perl hackers instead of towards people porting C libraries.


Compare: https://github.com/Perl/perl5/compare/6a8c70f65402%5E...6222ab61dd85

To unsubscribe from these emails, change your notification settings at https://github.com/Perl/perl5/settings/notifications