package Dist::Zilla::Plugin::AutoVersion; { $Dist::Zilla::Plugin::AutoVersion::VERSION = '4.300030'; } # 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 =head1 NAME Dist::Zilla::Plugin::AutoVersion - take care of numbering versions so you don't have to =head1 VERSION version 4.300030 =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