Marcel GrĂ¼nauer

NAME

Module::Changes::Parser::Free - rudimentary freeform Changes file parser

SYNOPSIS

    use Module::Changes;
    my $parser = Module::Changes->make_object_for_type('parser_free');
    my $changes = $parser->parse_from_file('Changes');

DESCRIPTION

This class attempts to parse a freeform Changes file into an object hierarchy representing the Changes.

It can cope with this kind of format:

    Revision history for Perl extension Web::Scraper

    0.17  Wed Sep 19 19:12:25 PDT 2007
            - Reverted Term::Encoding support since it causes segfaults
              (double utf-8 encoding) in some environment

    0.16  Tue Sep 18 04:48:47 PDT 2007
            - Support 'RAW' and 'TEXT' for TextNode object
            - Call Term::Encoding from scraper shell if installed

The distribution name is expected to be the last word on the first line. The indenting of the change lines is expected to be consistent.

There's also basic support for dealing with german-style dates, so it will turn Do Okt 18 10:09:39 CEST 2007 into Thu Oct 18 10:09:39 CEST 2007 and take it from there.

The parser is by no means robust; it's more intended as quick hack to parse existing Changes files. Patches welcome.

METHODS

This class inherits all methods from Module::Changes::Parser.

parse_string
    $parser->parse_string($string);

Takes a string containing the freeform Changes and returns a Changes object that contains all the information about releases and so on.

TAGS

If you talk about this module in blogs, on del.icio.us or anywhere else, please use the modulechanges tag.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests to bug-module-changes@rt.cpan.org, or through the web interface at http://rt.cpan.org.

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

AVAILABILITY

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>.

AUTHOR

Marcel Grünauer, <marcel@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2007 by Marcel Grünauer

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