Perl Monk, Perl Meditation | |
PerlMonks |
How do I package a module and related apps for successful upload to cpanby PUCKERING (Sexton) |
on Sep 15, 2022 at 05:31 UTC ( [id://11146889]=perlquestion: print w/replies, xml ) | Need Help?? |
PUCKERING has asked for the wisdom of the Perl Monks concerning the following question: I'm having trouble uploading a Dist::Zilla distro to PAUSE using the name GHCN. The email I received says: "This distribution name will only be indexed when uploaded by users with permission for the package GHCN. Either someone else has ownership over that package name, or this is a brand new distribution and that package name was neither listed in the 'provides' field in the META file nor found inside the distribution's modules. Therefore, no modules will be indexed." What I'm uploading is a tarball build with Dist::Zilla and which contains a collection of modules that are for building applications that access the NOAA Global Climatology Network data repository. I've named these modules GHCN::Station, GHCN::StationTable etc. There is no GHCN.pm module. There is no existing entry for GHCN in cpan. I've also developed several application scripts for general use that are based on the GHCN modules. They exist as .pl scripts in the distro bin directory that invoke a run() subroutine within corresponding modules in the lib/App directory. For example, the script ghcn_fetch.pl is really just a thin wrapper around App::GHCH::Fetch, which in turn uses the GHCN:: modules noted earlier. My objective is to have: 1. A single cpan entry GHCN which lists all the GHCN:: modules 2. A single cpan entry for App::GHCN which lists App::GHCN::Fetch, App::GHCN::Extremes and App::GHCN::StationCounts 3. cpan entries for ghcn_fetch.pl, ghcn_extremes.pl and ghcn_station_counts.pl Maybe this is a tall order. Maybe I need one distro for the GHCN modules (but what to name it?) and other distros for the apps. So far I've tried name = GHCN and name = bin/ghcn_fetch.pl, but both of those generate a permission error (see message noted above). I could try name = App-GHCN-Fetch, but every failed attempt further pollutes the namespace, so I'd like to have some idea of how to do this correctly before adding more deadwood. Another possibility is name = GHCN-StationTable since it is the most important class of the collection -- the one that does all the heavy lifting. I had a look at a few projects that had modules and apps, but there didn't seem to be a consistent way to do things, or any documentation for Dist::Zilla explaining how to structure and name a distribution like this. And speaking of documentation, my .pl scripts, which I said reside under bin are listed as Documentation! Why? See https://metacpan.org/release/PUCKERING/GHCN-v0.22.258 Any suggestions for structuring this project and specifying it in dist.ini so that I can get a reasonable deployment of the modules and the accompanying apps would be appreciated.
Back to
Seekers of Perl Wisdom
|
|