NAME

App::DualLivedDiff - Diff between the perl core and dual-lived modules' CPAN distributions

SYNOPSIS

Example: Filter::Simple.

Given a simple YAML file .dualLivedDiffConfig in the current working directory or the Filter::Simple CPAN distribution:

---
exclude-regexes:
  - ^(?:\./)?MANIFEST$
  - ^(?:\./)?META.yml$
files:
  lib/Filter/Simple.pm: lib/Filter/Simple.pm
  Changes: lib/Filter/Simple/Changes
dirs-flat:
  t/: lib/Filter/Simple/t/
dirs-recursive:
  t/lib/Filter/Simple/: t/lib/Filter/Simple/

By running the following command, you can get the diff between your blead perl checkout and the CPAN distribution:

dualLivedDiff --dual http://search.cpan.org/CPAN/authors/id/S/SM/SMUELLER/Filter-Simple-0.84.tar.gz --blead $HOME/perl-ssh

Or this if you have CPAN.pm configured:

dualLivedDiff --dual SMUELLER/Filter-Simple-0.84.tar.gz --blead $HOME/perl-ssh

Or this if you want to search for a given module name:

dualLivedDiff --dual Filter::Simple --blead $HOME/perl-ssh

You can use the base-path-in-blead option in the YAML config file to set a base path within the blead-perl checkout. Example of the configuration for the Attribute::Handlers dual-lived module/distribution which lives entirely within ext/Attribute-Handlers:

---
base-path-in-blead: ext/Attribute-Handlers
files:
  Changes: Changes
  README: README
dirs-recursive:
  lib/: lib/
  t/: t/
  demo/: demo/

Run the "dualLivedDiff" program to get an overview of the command line options.

DESCRIPTION

Very early version of a tool to automatically generate diffs/patches between CPAN distributions of dual lived Perl modules and the perl core. The code isn't beautiful. It's a hack.

AUTHOR

Steffen Mueller, <smueller@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Steffen Mueller

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8 or, at your option, any later version of Perl 5 you may have available.