Beefy Boxes and Bandwidth Generously Provided by pair Networks
"be consistent"
 
PerlMonks  

Finally a first version of my Module! Questions...

by cosmicperl (Chaplain)
on Sep 16, 2007 at 16:08 UTC ( #639265=perlquestion: print w/replies, xml ) Need Help??

cosmicperl has asked for the wisdom of the Perl Monks concerning the following question:

Hi All,
  I've finally got the first version of my module ready and working. Albeit only in version 0.05, and distinctly lacking in features, it works all the same!
I've got my PAUSE account setup, and have applied for the namespace. Now I just need to package the .pm file appropriately. At the moment I just have the working .pm file. Nothing else. It includes =head data, etc. But that's all I have. It doesn't use any C or XS. I know I need a README file, etc before I gzip it up and upload it.
Could someone please direct me to a good guide on packaging this for CPAN, so that I get it right and don't make any mistakes.

Lyle Hopkins

Update... I'd also like to ensure that this module is capable of being automatically included in ActiveStates ppm repository.

UPDATE: Thanks to all the replies. They have certainly put me on the right track, should have the module uploaded shortly.
  • Comment on Finally a first version of my Module! Questions...

Replies are listed 'Best First'.
Re: Finally a first version of my Module! Questions...
by Joost (Canon) on Sep 16, 2007 at 16:19 UTC
    You need a bit more than just the .pm and README files to create a CPAN package. I think the best place to start is to read perlnewmod.

    It's probably easiest to create an "empty" source tree using h2xs and then copy the code from your .pm file into the template in the new tree (and fill in the documentation).

    When you've done that, you can run the usual

    perl Makefile.PL make make test make dist
    to create the distribution tarball.

    Also, you don't need to register a namespace. You can if you want to, but it's not required.

      Also, you don't need to register a namespace. You can if you want to, but it's not required.

      And is not that simple to get a namespace. If memory does not fails me, a new namespace will not be create unless that is a fairy amount of modules (like 5) that do something closely related.

      Alceu Rodrigues de Freitas Junior
      ---------------------------------
      "You have enemies? Good. That means you've stood up for something, sometime in your life." - Sir Winston Churchill
Re: Finally a first version of my Module! Questions...
by eyepopslikeamosquito (Bishop) on Sep 16, 2007 at 21:01 UTC
Re: Finally a first version of my Module! Questions...
by lima1 (Curate) on Sep 16, 2007 at 17:01 UTC
Re: Finally a first version of my Module! Questions...
by randyk (Parson) on Sep 16, 2007 at 19:10 UTC
    Update... I'd also like to ensure that this module is capable of being automatically included in ActiveStates ppm repository.
    ActiveState uses an automated system that will build ppm packages and place them in their repository if the package, and all of it's dependencies, build and test OK against the relevant base ActivePerl distribution. So as long as your package satisfies that, it should be automatically added to ActiveState's repository - this might take a week or so since it first appears on CPAN. If there's a problem with this, you can request one to be manually made and added to the uwinnipeg repository.
Re: Finally a first version of my Module! Questions...
by glasswalk3r (Friar) on Sep 16, 2007 at 18:08 UTC
    Update... I'd also like to ensure that this module is capable of being automatically included in ActiveStates ppm repository.

    First of all you should create a PPM package. There is documentation about this included in the ActivePerl distribution (see "Using PPM").

    Unfornatelly, I'm not aware about how to request a space in a PPM repository. :-(

    Alceu Rodrigues de Freitas Junior
    ---------------------------------
    "You have enemies? Good. That means you've stood up for something, sometime in your life." - Sir Winston Churchill
      I'm not aware about how to request a space in a PPM repository

      In the general case, if Activestate are able to build the module, it will be made available as a PPM package, following the same namespace layout as CPAN.

      On the rare occasion that the module is not available in the AS repository, Randy Kobes's unwinnipeg site usually has it available (see link elsewhere in the thread). The other repository that cover the bits and pieces left over is Trouchelle.

      Basically, though, if it's pure-Perl, Activestate will carry it.

      • another intruder with the mooring in the heart of the Perl

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://639265]
Approved by Joost
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others lurking in the Monastery: (6)
As of 2021-04-18 12:38 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found

    Notices?