Marcel Grünauer > Module-Changes-0.05 > Module::Changes::Parser::Free

Download:
Module-Changes-0.05.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.05   Source  

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.

syntax highlighting: