Dist::Zilla::Plugin::GithubMeta - Automatically include GitHub meta information in META.yml
version 0.24
# in dist.ini [GithubMeta] # to override the homepage [GithubMeta] homepage = http://some.sort.of.url/project/ # to override the github remote repo (defaults to 'origin') [GithubMeta] remote = github
Dist::Zilla::Plugin::GithubMeta is a Dist::Zilla plugin to include GitHub https://github.com meta information in META.yml.
META.yml
It automatically detects if the distribution directory is under git version control and whether the origin is a GitHub repository and will set the repository and homepage meta in META.yml to the appropriate URLs for GitHub.
git
origin
repository
homepage
Based on Module::Install::GithubMeta which was based on Module::Install::Repository by Tatsuhiko Miyagawa
remote
The GitHub remote repo can be overriden with this attribute. If not provided, it defaults to origin. You can provide multiple remotes to inspect. The first one that looks like a GitHub remote is used.
You may override the homepage setting by specifying this attribute. This should be a valid URL as understood by MooseX::Types::URI.
issues
If true, a bugtracker URL will be added to the distribution metadata for the project's GitHub issues page.
user
If given, the user parameter overrides the username found in the GitHub repository URL. This is useful if many people might release from their own workstations, but the distribution metadata should always point to one user's repo.
repo
If give, the repo parameter overrides the repository name found in the GitHub repository URL.
metadata
Required by Dist::Zilla::Role::MetaProvider
Dist::Zilla
Chris Williams <chris@bingosnet.co.uk>
Ricardo SIGNES <rjbs@cpan.org>
This software is copyright (c) 2011 by Chris Williams, Tatsuhiko Miyagawa and Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Dist::Zilla::Plugin::GithubMeta, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::GithubMeta
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::GithubMeta
For more information on module installation, please visit the detailed CPAN module installation guide.