in reply to How to create and name module tarball for CPAN

What should I name my tarball for upload to CPAN?

For basic CPAN module naming advice:

For general advice to CPAN authors, you might like to scan the huge Writing Solid CPAN Modules for topics of interest.

👁️🍾👍🦟
  • Comment on Re: How to create and name module tarball for CPAN

Replies are listed 'Best First'.
Re^2: How to create and name module tarball for CPAN
by Polyglot (Chaplain) on Nov 28, 2023 at 03:06 UTC
    Unless someone has meritorious reasons for choosing a different name than I have selected, that portion of my development is already decided in my mind. It was not without first consulting the monks here, and I have accepted their combined wisdom (with very slight rearrangement) in the end. See that thread, here:

    Namespace/advice for new CPAN modules for Thai & Lao

    Among those suggestions made earlier, consider: "Regexp::CharProps::Thai" and the one that I was at that time leaning toward based on the many suggestions: "Regexp::Thai::CharClasses." What I am now choosing is a compromise between these, i.e. "Regexp::CharClasses::Thai".

    Feel free to sound a final warning if this is a misguided idea, but be aware it is not without due consideration on my part, and I have found that "Regexp::CharClasses" already exists on CPAN, so adding "Thai" to this seems logical.

    https://metacpan.org/pod/Regexp::CharClasses

    My module does exactly what one would expect of a module so named--it adds Unicode property character classes for use with Perl regular expressions handling Thai script.

    With all of this in mind, my question was not about the naming of the module, but rather of its tarball. Even the additional links provided by others here for beginners like me have not been super clear on this point, so I'm still a bit foggy on how to do this. For example, should the tarball also have the version number for the module included in its name? If so, is there a standard format for this (hyphens, underscores, decimal points, etc.)?

    Perhaps I'm overthinking everything, and I just need to jump in and get my feet wet. Perhaps the corrections are all to be made after complaints roll in that "that's not how to do it!" I don't know. I just prefer to do it right the first time.

    Blessings,

    ~Polyglot~

      ... my question was not about the naming of the module, but rather of its tarball. Even the additional links provided by others here for beginners like me have not been super clear on this point ...

      I think ++Bod's link Re: What do I use to release a module to CPAN for the first time? by davido is clear on this point.

      For davido's example Foo::Bar module, point number 15 states:

      At this point you'll have a tarball that you can upload to CPAN, named something like Foo-Bar-0.01.tar.gz

      👁️🍾👍🦟
      Well, I jumped. We'll see how it lands.

      Blessings,

      ~Polyglot~