14 Aug 2017 18:48:57 UTC
- Distribution: Dist-Zilla-Plugin-ContributorsFromGit
- Module version: 0.019
- Source (raw)
- Browse (raw)
- How to Contribute
- Issues (3)
- Testers (715 / 0 / 0)
- KwaliteeBus factor: 0
- 93.85% Coverage
- License: lgpl_2_1
- Perl: v5.10.0
- Activity24 month
- Download (35.45KB)
- MetaCPAN Explorer
- Subscribe to distribution
- This version
- Latest version++ed by:2 non-PAUSE usersRSRCHBOY Chris Weyl
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- METACPAN CONTRIBUTOR MATCHING
- SEE ALSO
- COPYRIGHT AND LICENSE
Dist::Zilla::Plugin::ContributorsFromGit - Populate your 'CONTRIBUTORS' POD from the list of git authors
This document describes version 0.019 of Dist::Zilla::Plugin::ContributorsFromGit - released August 14, 2017 as part of Dist-Zilla-Plugin-ContributorsFromGit.
; in your dist.ini [ContributorsFromGit] ; in your weaver.ini [Contributors]
This plugin makes it easy to acknowledge the contributions of others by populating a %PodWeaver stash with the unique list of all git commit authors reachable from the current HEAD.
On collecting the unique list of reachable commit authors from git, we search and remove any git authors from the list of authors Dist::Zilla knows about. We then look for a stash named
%PodWeaver; if we don't find one then we create an instance of Dist::Zilla::Stash::PodWeaver and register it with our zilla instance. Then we add the list of contributors (the filtered git authors list) to the stash in such a way that Pod::Weaver::Section::Contributors can find them.
This plugin runs during the BeforeBuild phase.
The list of contributors is also added to distribution metadata under the custom
x_contributorskey. (e.g. in
If you have duplicate contributors because of differences in committer name or email you can use a
.mailmapfile to canonicalize contributor names and emails. See git help shortlog for details.
Note that using the Pod::Weaver::Section::Contributors section is in no way mandated or necessitated by this package; if you wish to use it you must include the Contributors section in your Pod::Weaver configuration in the traditional fashion.
MetaCPAN will attempt to match a contributor address back to a PAUSE account. However, it (currently) can only do that if the contributor's email address is their
PAUSEID@cpan.orgaddress. There are two mechanisms for helping to resolve this, if your commits are not using this address.
Both of these approaches have pros and cons that have been discussed at levels nearing the heat brought to any discussion of religion, homosexuality, or Chief O'Brien's actual rank at any ST:TNG convention. However, they both have the advantage of *working*, and through different modes of action. You are free to use one, both or neither. These are only important if you're not committing with your
@cpan.orgemail address and want the MetaCPAN to link to your author page from the page of the package you contributed to.
git help shortlogfor help on how to use this. A
.mailmapfile must be maintained in each repository using it.
This package contains a YAML file containing a mapping of
@cpan.orgauthor addresses; this list is consulted while building the contributors list, and can be used to replace a non-cpan.org address with one.
To add to or modify this mapping, fork, add your alternate email addresses to
share/author-emails.yaml, and submit a pull-request for inclusion. It'll be merged and released; as various authors update their set of installed modules and cut new releases, the mapping will appear.
Please see those modules/websites for more information related to this module.
Please report any bugs or feature requests on the bugtracker website https://github.com/rsrchboy/Dist-Zilla-Plugin-ContributorsFromGit/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
Chris Weyl <firstname.lastname@example.org>
Brendan Byrd <Perl@ResonatorSoft.org>
David Golden <email@example.com>
Graham Knop <firstname.lastname@example.org>
Mike Greb <email@example.com>
Randy Stauner <firstname.lastname@example.org>
Tatsuhiko Miyagawa <email@example.com>
Yanick Champoux <firstname.lastname@example.org>
This software is Copyright (c) 2017, 2015, 2014, 2013, 2012 by Chris Weyl.
This is free software, licensed under:
The GNU Lesser General Public License, Version 2.1, February 1999
Module Install Instructions
To install Dist::Zilla::Plugin::ContributorsFromGit, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install Dist::Zilla::Plugin::ContributorsFromGit
For more information on module installation, please visit the detailed CPAN module installation guide.