/usr/share/perl5/Dist/Zilla/Plugin/AutoVersion.pm is in libdist-zilla-perl 5.008-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 | package Dist::Zilla::Plugin::AutoVersion;
{
$Dist::Zilla::Plugin::AutoVersion::VERSION = '5.008';
}
# ABSTRACT: take care of numbering versions so you don't have to
use Moose;
with(
'Dist::Zilla::Role::VersionProvider',
'Dist::Zilla::Role::TextTemplate',
);
use namespace::autoclean;
use DateTime 0.44 (); # CLDR fixes
has major => (
is => 'ro',
isa => 'Int',
required => 1,
default => 1,
);
has time_zone => (
is => 'ro',
isa => 'Str',
required => 1,
default => 'GMT',
);
has format => (
is => 'ro',
isa => 'Str',
required => 1,
default => q<{{ $major }}.{{ cldr('yyDDD') }}>
. q<{{ sprintf('%01u', ($ENV{N} || 0)) }}>
. q<{{$ENV{DEV} ? (sprintf '_%03u', $ENV{DEV}) : ''}}>
);
sub provide_version {
my ($self) = @_;
my $now = DateTime->now(time_zone => $self->time_zone);
my $version = $self->fill_in_string(
$self->format,
{
major => \( $self->major ),
cldr => sub { $now->format_cldr($_[0]) },
},
);
$self->log_debug([ 'providing version %s', $version ]);
return $version;
}
__PACKAGE__->meta->make_immutable;
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Dist::Zilla::Plugin::AutoVersion - take care of numbering versions so you don't have to
=head1 VERSION
version 5.008
=head1 DESCRIPTION
This plugin automatically produces a version string, generally based on the
current time. By default, it will be in the format: 1.yyDDDn
=head1 ATTRIBUTES
=head2 major
The C<major> attribute is just an integer that is meant to store the major
version number. If no value is specified in configuration, it will default to
1.
This attribute's value can be referred to in the autoversion format template.
=head2 format
The format is a L<Text::Template> string that will be rendered to form the
version. It is meant to access to one variable, C<$major>, and one subroutine,
C<cldr>, which will format the current time (in GMT) using CLDR patterns (for
which consult the L<DateTime> documentation).
The default value is:
{{ $major }}.{{ cldr('yyDDD') }}
{{ sprintf('%01u', ($ENV{N} || 0)) }}
{{$ENV{DEV} ? (sprintf '_%03u', $ENV{DEV}) : ''}}
=head1 SEE ALSO
Core Dist::Zilla plugins:
L<PkgVersion|Dist::Zilla::Plugin::PkgVersion>,
L<PodVersion|Dist::Zilla::Plugin::PodVersion>,
L<NextRelease|Dist::Zilla::Plugin::NextRelease>.
Dist::Zilla roles:
L<VersionProvider|Dist::Zilla::Role::VersionProvider>,
L<TextTemplate|Dist::Zilla::Role::TextTemplate>.
=head1 AUTHOR
Ricardo SIGNES <rjbs@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by 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.
=cut
|