Thank you for considering contributing to this distribution. This file
contains instructions that will help you work with the source code. If you
have any questions or difficulties, you can reach the maintainer(s) by email
or through the bug queue described later in this document.

The distribution, which can be found on CPAN, contains only the files useful
to a user of the distribution.

The project contains the same files as the distribution but additionally
includes author tests and various configuration files used to develop or
release the distribution.

You do not need the project to contribute patches. The project is only used
to create a tarball and release it or if you would like to run the author


You can run tests directly using the prove tool:

  $ prove -l
  $ prove -lv t/some_test_file.t
  $ prove -lvr t/

or with the Makefile:

  $ perl Makefile.PL
  $ make
  $ make test

prove is entirely sufficent for you to test any patches you have.

You may need to satisfy some dependencies. If you use cpanminus, you can do
it without downloading the tarball first:

  $ cpanm --reinstall --installdeps Test::RequiredMinimumDependencyVersion


The project can be found on GitHub:

The project is managed with Dist::Zilla. You do not need Dist::Zilla to
contribute patches or run the author tests. You do need Dist::Zilla to create
a tarball.

If you would like to work with the project, clone it with the following

  $ git clone
  $ git submodule update --init

You may need to satisfy some dependencies. You can use cpanminus in the
cloned project to install them:

  $ cpanm --installdeps --with-develop .

You can run tests directly using the prove tool:

  $ prove -l
  $ prove -lv t/some_test_file.t
  $ prove -lvr t/

Including the author tests:

  $ prove -lvr xt/

or with Dist::Zilla

  $ dzil test
  $ dzil test --release


The code for this distribution is hosted at GitHub. The repository is:
You can submit code changes by forking the repository, pushing your code
changes to your clone, and then submitting a pull request. Detailed
instructions for doing that is available here:

If you have found a bug, but do not have an accompanying patch to fix it, you
can submit an issue report here:

If you send me a patch or pull request, your name and email address will be
included as a contributor (using the attribution on the commit or patch),
unless you specifically request for it not to be. If you wish to be listed
under a different name or address, you should submit a pull request to the
.mailmap file to contain the correct mapping.

Alternatively you can also submit a patch by email to the maintainer(s).
There is no need for you to use Git or GitHub.