in reply to Submitting a module to cpan

Ok, so looking at my cpan page, http://search.cpan.org/~jillrowe/, I don't think I have this whole submission thing down.

I have two modules I want to submit. I have the Runner-Init, which has a few modules within it, and Annovar-Wrapper.

They are here

https://github.com/jerowe/Annovar-Wrapper

https://github.com/jerowe/Runner-Init

Where can I find a resource on submitting a module using git? There was a blog post that is referenced all over the place, but its not there anymore. There are plenty of resources on making a module best practices, but not so much on the actual submission of a module. Help, please!

Replies are listed 'Best First'.
Re^2: Submitting a module to cpan (releasing using git)
by Anonymous Monk on Jul 16, 2014 at 09:54 UTC

      Everything for git and uploading a module references this blog post http://blog.usarundbrief.com/?p=36

      Which clearly no longer exists.

      The milla tool looks very promising. I will look into that. I used the module-start to set up my skeleton and just went from there, but maybe I should have looked into the Dist::Zilla too.

      When I get this figured out I will definitely thoroughly document it someplace!

        Everything for git and uploading a module references this blog post http://blog.usarundbrief.com/?p=36

        Yes, but it still gives away the secret :)

        1) have the cpan distrbution layout (module-starter guarantees this)

        2) tag a release on github

        3) give pause regular github tarball url with with a cpan dist style filename at end, ie give it http://github.com/username/perl-module-dist/tarball/tagname/Perl-Module-Dist-1.22.tgz

        And thats it, then press “Upload this URL” and you're done

        The caveats are, don't forgot to make manifest... so you have a MANIFEST and META.yml in the git repo

        Thank you so much for the reference to milla! It is a lifesaver!

        So for anyone who was wondering when I was using PAUSE I was using the upload a url option. Using a git I created a branch for each version (like the git workflow best practices recommends) and was using the URL to that branch.

        I think that what happened is that it needs to be an archive, tar or zip. So if I had used https://github.com/jerowe/Annovar-Wrapper/archive/Annovar-Wrapper-1.1.zip maybe that would have been ok, but just giving PAUSE https://github.com/jerowe/Annovar-Wrapper/tree/Annovar-Wrapper-1.1 did not work. As it turns out the PAUSE upload form says archives only, but I thought that it had a utility for git since I saw that referenced.

        I'm going to just use milla, but its nice to know how to do it both ways. ;) A big thanks to everyone for your help!

Re^2: Submitting a module to cpan
by hippo (Archbishop) on Jul 16, 2014 at 09:22 UTC

    Most of the submission process is covered in the About PAUSE page. Have you read this? Specifically what more do you need to know than is covered in this document?

    The fact that you have chosen to use git as your version control system should not be relevant. Once you've built the distribution tarball and tested it yourself just follow the submission instructions which apply regardless of the repository.

    By the way, your last 2 posts have come in as Anonymous. It would probably help you to keep track of responses, etc. if you were to login.