#dzil — Public Fediverse posts

We just got bitten at work by what we think is an incompatible change in the Dist::Zilla ecosystem. I remember seeing somewhere in the dzil doco that it was unstable and liable to incompatible changes at any time, which is one of the reasons why I have for years recommended that no-one ever use it.

#perl #dzil

@smonff And #DZil ain’t that steep a learning curve. The basics are literally *easier* than authoring a Makefile.PL or Build.PL

And https://metacpan.org/pod/Dist::Zilla::Starter exists

#DistZilla #Perl

@rrwo It *does* have everything #DZil built! In fact, I specifically crafted my dist.ini with that aim.

The `build/main` branch has everything generated from main: https://codeberg.org/mjgardner/perl-Log-Any-Adapter-MacOS-OSLog/src/branch/build/main

And the `build/release` branch has everything generated for #CPAN releases: https://codeberg.org/mjgardner/perl-Log-Any-Adapter-MacOS-OSLog/src/branch/build/release

And the "How to contribute” documentation tells you how to do both: https://metacpan.org/dist/Log-Any-Adapter-MacOS-OSLog/contribute

Suggestions and PRs welcome!

* https://codeberg.org/mjgardner/perl-Log-Any-Adapter-MacOS-OSLog/issues
* https://codeberg.org/mjgardner/perl-Log-Any-Adapter-MacOS-OSLog/pulls

#Perl

Et voilà, the latest version of my #Perl module and script for writing to the #macOS Unified Log, no #ObjectiveC or #Swift required!

* #CPAN: https://metacpan.org/dist/Log-Any-Adapter-MacOS-OSLog
* source on #Codeberg: https://codeberg.org/mjgardner/perl-Log-Any-Adapter-MacOS-OSLog

The contributing guide tells you all you need to know about how to develop this module either with #DistZilla or without: https://metacpan.org/dist/Log-Any-Adapter-MacOS-OSLog/contribute

/ @Codeberg @metacpan

#DZil #Mac #programming #coding #SoftwareDevelopment #SoftwareEngineering #Codeberg

Sorry to all the #dzil haters, but in the end I'm going back to Dist::Zilla for this and my other #Perl #CPAN distributions. I tried the alternatives, but they all failed me for one reason or another.

And in the end, it's just hard to argue with a negative line count delta.

The good news is that I've got it configured to maintain build/main and build/release branches that one can fork and contribute to without having to install all my dependencies.

I think I feel another blog post coming on.

I've released a new version of Dist-Zilla-Plugin-UsefulReadme to #CPAN.

This is a #perl #dzil plugin for generating a README with just the useful bits of the module POD.

This latest version adds a minor option to disable adding prerequisites (mainly for bootstrapping itself) and tweaks some tests.

https://metacpan.org/release/RRWO/Dist-Zilla-Plugin-UsefulReadme-v0.5.1

@jochie #Perl POD is static at rest by nature, so there’s no built-in way to bake a program/topic in there.

However, @rjbs’ https://metacpan.org/pod/Dist::Zilla is a great “maximum overkill” system for automating boilerplate POD (via https://metacpan.org/pod/Dist::Zilla::Plugin::PodWeaver), tests, version control operations, deployments, etc.

There are other tools on #CPAN to do only what you want and stop there, but #dzil can grow with you.

@ChristosArgyrop #dzil is pretty awesome for scaling up all the boilerplate operations of maintaining and releasing multiple #CPAN module distributions. Many thanks to @rjbs

Dear #perl @Perl folks that use Dist::Zilla. I'm trying to release a new version of Validation::Class but I'm stuck with dzil release. All tests pass, files are modified but for some reason the modifications aren't committed to Git?

To clarify, my Git index is clean before running the release command.

I've got no clue on how to proceed here as I barely know how Dist::Zilla works.

https://github.com/Htbaa/Validation-Class

#dzil

@ovid Speaking for myself when publishing my first CPAN dist: #dzil was easiest! It was the only thing I saw that matched my mental model. 🤷

I feel sorry for any brand-new #Perl developer who wants to publish their first module to the #CPAN.

I now use #dzil. I can't imagine that's useful for a new developer.

What's the easiest way for a new developer to learn to publish something to the CPAN?

@DrHyde @Perl It’s understandable when you consider @rjbs invented it to maintain his 200+ #CPAN dists. And it’s possible to enable folks to successfully contribute to #dzil projects without making them use it. Unfortunately, that’s not configured by default.

@EndlessMason @davehodg #dzil also includes a plug-in to automatically rewrite tests in `xt` to skip unless the appropriate environment variable is set, so you don’t have to remember to write that in your test scripts yourself https://metacpan.org/pod/Dist::Zilla::Plugin::ExtraTests #Perl