File: Contributors.pm

package info (click to toggle)
libmodule-install-contributors-perl 0.001-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 288 kB
  • sloc: perl: 2,911; makefile: 2
file content (82 lines) | stat: -rw-r--r-- 1,785 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
package Module::Install::Contributors;

use 5.006;
use strict;
use warnings;

BEGIN {
	$Module::Install::Contributors::AUTHORITY = 'cpan:TOBYINK';
	$Module::Install::Contributors::VERSION   = '0.001';
}

use base qw(Module::Install::Base);

sub contributors
{
	my $self = shift;
	push @{ $self->Meta->{values}{x_contributors} ||= [] }, @_;
}

1;

__END__

=pod

=encoding utf-8

=head1 NAME

Module::Install::Contributors - add an "x_contributors" section to your META.yml

=head1 SYNOPSIS

In your Makefile.PL:

 contributors "Alan Smithee", "Nicolas Bourbaki <nic@math.example.fr>";
 contributors "Spartacus <spartacus@example.it>";

=head1 DESCRIPTION

This is a plugin for L<Module::Install>. It adds a C<< x_contributors >>
section to your META.yml file. This is an array of strings, which should
normally be in C<< "Name <email>" >> format.

It provides one function to Module::Install-based Makefile.PLs:

=over

=item C<< contributors(@names) >>

=back

Repeated calls are cumulative. The example in the SYNOPSIS has three
contributors, not just Spartacus.

=head1 BUGS

Please report any bugs to
L<http://rt.cpan.org/Dist/Display.html?Queue=Module-Install-Contributors>.

=head1 SEE ALSO

L<Pod::Weaver::Section::Contributors>,
L<Dist::Zilla::Plugin::ContributorsFromGit>.

=head1 AUTHOR

Toby Inkster E<lt>tobyink@cpan.orgE<gt>.

=head1 COPYRIGHT AND LICENCE

This software is copyright (c) 2013 by Toby Inkster.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.

=head1 DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.