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


Module-Changes documentation  | view source Contained in the Module-Changes distribution.

Index


NAME

Top

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

SYNOPSIS

Top

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

DESCRIPTION

Top

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

Top

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

Top

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

BUGS AND LIMITATIONS

Top

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

Top

See perlmodinstall for information and options on installing Perl modules.

AVAILABILITY

Top

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

Top

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

COPYRIGHT AND LICENSE

Top


Module-Changes documentation  | view source Contained in the Module-Changes distribution.