Developing OAuthomatic
Grabbing the source
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.
Building and testing
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).
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
Local install
To install locally:
dzil install
Contributing
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.
Making CPAN release (author only)
edit version number in
dist.ini
(tag will be placed automatically)edit
Changes
filedzil build
andhg commit
to commit edits above and regeneratedREADME.mkdn
andREADME-development.txt
.build, test, and publish to CPAN:
dzil release
push source changes:
hg push helix