NAME

Text::Diff::FormattedHTML - Generate a colorful HTML diff of strings/files.

VERSION

Version 0.08

SYNOPSIS

    use Text::Diff::FormattedHTML;
    my $output = diff_files($file1, $file2);
    # for strings
    my $output = diff_strings( { vertical => 1 }, $file1, $file2);
    # as you might want some CSS:
    open OUT, ">diff.html";
    print OUT "<style type='text/css'>\n", diff_css(), "</style>\n";
    print OUT diff_files('fileA', 'fileB');
    close OUT;

DESCRIPTION

Presents in a (nice?) HTML table the difference between two files or strings. Inspired on GitHub diff view.

SUBROUTINES

diff_files

   my $html = diff_files("filename1", "filename2");

"diff_files" and "diff_strings" support a first optional argument (an hash reference) where options can be set.

Valid options are:

"vertical": Can be set to a true value, for a more compact table.
"limit_onesided": Makes tables look nicer when there is a side with too many new lines.

diff_strings

   my $html = diff_strings("string1", "string2");

Compare strings. First split by newline, and then treat them as file content (see function above).

diff_css

   my $css = diff_css;

Return the default css. You are invited to override it.

AUTHOR

Alberto Simoes, "<ambs at cpan.org>"

BUGS

Please report any bugs or feature requests to "bug-text-diff-formattedhtml at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Text-Diff-FormattedHTML>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Text::Diff::FormattedHTML

You can also look for information at:

RT: CPAN's request tracker (report bugs here)
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Text-Diff-FormattedHTML>
AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/Text-Diff-FormattedHTML>
CPAN Ratings
<http://cpanratings.perl.org/d/Text-Diff-FormattedHTML>
Search CPAN
<http://search.cpan.org/dist/Text-Diff-FormattedHTML/>

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.