CPAN::Changes::Release - Information about a particular release
my $rel = CPAN::Changes::Release->new( version => '0.01', date => '2009-07-06', ); $rel->add_changes( { group => 'THINGS THAT MAY BREAK YOUR CODE' }, 'Return a Foo object instead of a Bar object in foobar()' );
A changelog is made up of one or more releases. This object provides access to all of the key data that embodies a release including the version number, date of release, and all of the changelog information lines. Any number of changelog lines can be grouped together under a heading.
Creates a new release object, using %args as the default data.
%args
Gets/sets the version number for this release.
Gets/sets the date for this release.
Gets the list of changes for this release as a hashref of group/changes pairs. If a group name is specified, an array ref of changes for that group is returned. Should that group not exist, undef is returned.
Appends a list of changes to the release. Specifying a group option appends them to that particular group. NB: the default group is represented by and empty string.
group
# Append to default group $release->add_changes( 'Added foo() function' ); # Append to a particular group $release->add_changes( { group => 'Fixes' }, 'Fixed foo() function' );
Replaces the existing list of changes with the supplied values. Specifying a group option will only replace change items in that group.
Clears all changes from the release.
Returns a list of current groups in this release.
If sort is provided, groups are sorted according to the given function. If not, they are sorted alphabetically.
Creates an empty group under the names provided.
Deletes the groups of changes specified.
Deletes all groups that don't contain any changes.
Returns the release data as a string, suitable for inclusion in a Changes file.
If group_sort is provided, change groups are sorted according to the given function. If not, groups are sorted alphabetically.
CPAN::Changes::Spec
CPAN::Changes
Test::CPAN::Changes
Brian Cassidy <bricas@cpan.org>
Copyright 2011 by Brian Cassidy
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install CPAN::Changes, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CPAN::Changes
CPAN shell
perl -MCPAN -e shell install CPAN::Changes
For more information on module installation, please visit the detailed CPAN module installation guide.