This code is maintained in Mercurial repository at helixteamhub.cloud/mekk/projects/perl/repositories/oauthomatic.
Released versions can be downloaded from CPAN:
cpanm --look OAuthomatic
but note, that they are mashed-up by Pod::Weaver, so it is not recommended to edit those versions and patches made against them are not very welcome.
This module uses Dist::Zilla for build and release.
Install dependencies:
dzil listdeps --all --missing | cpanm --sudo
Build distro:
dzil build
(or dzil build --verbose to get better info what is built).
dzil build --verbose
Review documentation shape:
firefox README.html firefox OAuthomatic-X.Y/docs/
Test:
prove -l # without build dzil test # with build dzil test --all # with build, also release and author tests
Separate perl::critic:
perlcritic --profile perlcritic.rc lib # Elaborate perlcritic --profile perlcritic.rc --verbose 10 lib
To install locally:
dzil install
Preferable form: pull request.
I will also accept patches - Mercurial bundle, git-diff or plain diff (in this order of preference). In case of diffs, please specify the version diff is made against. Patches may be attached to Helix, or CPAN issue tracker.
For bigger changes, please open issue and describe your idea before working on the code.
edit version number in dist.ini (tag will be placed automatically)
dist.ini
edit Changes file
Changes
dzil build and hg commit to commit edits above and regenerated README.mkdn and README-development.txt.
hg commit
README.mkdn
README-development.txt
build, test, and publish to CPAN:
dzil release
push source changes:
hg push helix
To install OAuthomatic, copy and paste the appropriate command in to your terminal.
cpanm
cpanm OAuthomatic
CPAN shell
perl -MCPAN -e shell install OAuthomatic
For more information on module installation, please visit the detailed CPAN module installation guide.