How to release to CPAN

Preparation

1. Permission to create PR in the repo https://github.com/line/line-bot-sdk-perl/
2. PAUSE account and co-maintainer permission of the distribution LINE-Bot-API
3. cpanm -nq App::cpm
   • (sudo if it is required.)
4. cpm install -g Dist::Milla LWP::Protocol::https Dist::Zilla::Plugin::Test::Perl::Critic Test::Pod JSON::XS Furl::HTTP Test2::V0
   • (sudo if it is required, too.)
5. milla setup
   • It will ask you license and copyright holder, but they will be overwritten by dist.ini
6. Make sure the git remote named "origin" is exactly [email protected]:line/line-bot-sdk-perl.git. This is needed by milla

Cheatsheet

If all preparation described above is done, run these commands:

git checkout release # it may requires -b
git merge master
milla release

• Then, on Github Release Tab, create a new "release" item with the newly-pushed tag. Paste the latest Change log as content.
• And create a P-R from release to master.

Dry-run

milla release does a lot of leg work, roughly these:

1. Promp for the version number (usually current version number + 0.01, but this can be arbitrary)
2. Alter the version sting in .pm files
3. Re-generate all the CPAN meta-data in MANIFEST, META.json, META.yml, README
4. Build the tarball "tar.gz" with some generated "author tests" an run the test suite with "mill test"
5. Commit the changes of meta-data to git repo
6. Tag the latest status with the given version number
7. git push origin --tags -- push the current branch as well as the new tags to remote.
8. Actually upload new tarball to CPAN after user confirmed on prompt.

When in doubt or trouble, you many want to examine the generate tarball without uploading it to CPAN. There are two options.

The first is running milla build -- this generate a tarball without altering version number

The second is by running FAKE_RELEASE=1 milla release -- this will run from step 1 to 7 -- but not 8. It'll produce a new tarball while also commit the machine-generated changes as well as push the new tags as the side-effect. If you exaime the tarball and decided not to upload it to CPAN, you'll also ned to delete the new git tags from both local and remote.