view release on metacpan or  search on metacpan

templates/CONTRIBUTING.md  view on Meta::CPAN

{{
    my $repo = $dist->distmeta->{resources}{repository}{web} //
               $dist->distmeta->{resources}{repository}{url};

    my $vcs = $dist->distmeta->{resources}{repository}{type};


if ((my $link = $repo ) =~ /github/) { <<~EOF
   The public repository for this code is managed with $vcs and is hosted at GitHub.
   It is available via the web at:

     $repo

   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:

     https://help.github.com/
     https://help.github.com/articles/creating-a-pull-request
   EOF
}

elsif ((my $link = $repo ) =~ /gitlab/) { <<~EOF
   The public repository for this code is managed with $vcs and is hosted at GitLab.
   It is available via the web at:

     $repo

   You can submit code changes by forking the repository, pushing your code
   changes to your clone, and then submitting a merge request. Detailed
   instructions for doing that is available here:

     https://docs.gitlab.com/ee/user
     https://docs.gitlab.com/ee/user/project/merge_requests/getting_started.html
   EOF
}

else { <<~EOF

  The public repository for this code is managed with $vcs and is found here:

      $repo 
  EOF
}

}}

My primary repository actually uses Mercurial, so if you are more
comfortable using that, drop a line to {{ $dist->authors->[0] }}.


Installing Dependencies
-----------------------

Dependencies for this module are recorded in the `META.json` file.
Installation is most easily done with `cpanminus`[1], which can be
made available locally via:

  $ curl -L https://cpanmin.us/ -o cpanm
  $ chmod +x cpanm

To install the dependencies into a local directory (to avoid polluting
your Perl distribution),

  $ export PERL5LIB=${PERL5LIB}:$PWD/local
  $ cpanm -l local --installdeps --with-recommends --with-develop .

This installs the dependencies into the `./local` directory.  Be sure
to clean up the PERL5LIB environment variable when you are done!


Working without Dist::Zilla
---------------------------

This directory contains a working Makefile.PL that will allow you to
work without `Dist::Zilla`.

If you have installed dependencies into a local directory, make sure that
is in your `PERL5LIB` path.

Then, as usual,

  $ perl Makefile.PL
  $ make
  $ make test

Working with Dist::Zilla
------------------------
 
`Dist::Zilla` is a tool whose flexibility is derived from a wide range
of plugins.  The first step is to install `Dist::Zilla` itself:

  $ cpanm Dist::Zilla

Then, install the plugins that this module requires.  In this example
they are stored locally, to avoid polluting your Perl distribution.
If you haven't already done so, add the local directory to your
`PERL5LIB` path:

  $ export PERL5LIB=${PERL5LIB}:$PWD/local
  $ dzil authordeps --missing | cpanm -l local

You should then also install any additional requirements not needed by the
dzil build but may be needed by tests or other development:
 
  $ dzil listdeps --author --missing | cpanm -l local
  $ dzil listdeps --develop --missing | cpanm -l local
  $ cpanm -l local --installdeps --with-develop .
 
Once installed, here are some dzil commands you might try:
 
  $ dzil build
  $ dzil test
  $ dzil xtest
 
You can learn more about `Dist::Zilla` at http://dzil.org/.
 
Submitting Patches
------------------