My first ever CPAN module!
Well it had to happen one day I suppose! Though I am amazed it took this long because been playing with the notion for some years now.
What’s ironic is that I’ve uploaded something I’ve only recently developed and not some older and more established code/modules/libraries that I have lying around. Still plenty of time for them to be dusted down and uploaded
For the uninitiated these are the first steps you need to make….
- Get a PAUSE account… https://pause.perl.org
- Register Namespace (from menu)
- Upload module (from menu)
Sounds easy doesn’t it. Well it actually is easy and just looks daunting when its unknown quantity.
Before point 2 u should check that namespace is free on CPAN. With point 2 you do provide some details about the module and there could be a discussion. You can do point 3 immediately however I waited a week to see if there were any issues (mine was a root level namespace… but no one came back).
If all goes well then you module will appear on CPAN the next day (which it did!). There are tools / logs on PAUSE which provides status on you upload and if needed ways to fix some of the potential problems.
PAUSE may look “antiquated”… but it works and thats what counts.
Of course I don’t like the simple life (or rather I don’t make my life simple enough!). So instead of sticking with h2xs and subversion I decided it was time to upgrade to Module::Build and git! So I’ve learned enough of both to cause some damage and get the module onto CPAN and source code onto GitHub. Actually Module::Build (especially when used with Module::Starter) & git were really simply to pick up…. most work was just getting my head around GitHub.
This is where they live:
- Learn more git!
- Add more docs & tests (neither currently cover what Builder can do)
- Add in some further developments I have here
- Refactor it all
Also when I get a moment I may blog about Builder.
PS. Below are useful links which I recommend reading before embarking on same journey….