An expedient CPAN uploader for Raku
igo create-layout [--directory=.]
igo create-archive [--directory=.]
igo upload --user=<user> --password=<password> [--directory=.]
This provides a simple way to upload Raku modules to CPAN.
I made it because I found that other things either took over the whole workflow, or didn't do enough.
So all this does is create a tarball of the files in the distribution, using the name and version specified in the META6 file and then uploads it to PAUSE with the credentials specified.
The way this works is that the first time it runs it creates an
Oyatul layout specification
in your distribution's directory as .layout
this will contain all
of the files found in the directory which don't begin with a '.', now
if you're anything like me you may have your working directory littered
with test files and backups and so forth so you may want to edit this file
before creating the archive, this can be achieved by running
igo create-layout
When you have all the files that you want to release and then edit
the .layout
as required (it's JSON and quite obvious,) to remove
extraneous files (or, if you want to distribute dot files that didn't get
added for instance add them.)
If you want to check that you really have all the files you need in the archive that would be uploaded then you can run
igo create-archive
and inspect and test as you see fit.
When you are all happy with what you are going to upload then you just do
igo upload --username=<PAUSE username> --password=<PAUSE password>
Which will create the archive and upload it with the credentials supplied.
If you don't want to continuously type the credentials at the command line
you can create the file $HOME/.config/igo/pause.ini
with :
user <username>
password <password>
If you are unhappy with having your password in plaintext then CPAN::Uploader::Tiny does support encrypted files, but you can work that our for yourself.
Please feel free to use the Igo
module in your own code, but
it isn't well documented for the time being.
This uses Archive::LibArchive to make the tarball to upload, so you will need to have libarchive
installed, either via your platform's package manager or by some other means. I don't know if it is available for Windows.
Assuming you have a working Rakudo installation you should be able to install this with zef :
# From the source directory
zef install .
# Remote installation
zef install Igo
Suggestions and patches that may make this more useful in your software are welcomed via github at
https://github.com/jonathanstowe/Igo/issues
This is free software.
Please see the LICENCE file in the distribution.
© Jonathan Stowe 2019 - 2021