Dist::Zilla::Plugin::Doppelgaenger - Creates an evil twin of a CPAN distribution
version 0.008
[Doppelgaenger] source_module = Foo::Bar strip_pod = 1
This Dist::Zilla plugin creates a new CPAN distribution with a new name based on the latest stable distribution of a source module.
Please do not do this without the permission of the authors or maintainers of the source.
If the Changes files is flagged to be updated, you must have {{$NEXT}} in your Changes files and use the NextRelease plugin. The source distribution will be added on a line in the Changes file after {{$NEXT}}. After release, your original Changes file might look something like this:
{{$NEXT}}
NextRelease
0.001 2010-12-17 08:37:08 EST5EDT - Generated from AUTHOR/Foo-Bar-1.23.tar.gz - See https://metacpan.org/changes/release/AUTHOR/Foo-Bar-1.23 for details
If you strip Pod, you may with to explore replacing it with new Pod using the Dist::Zilla::Plugin::AppendExternalData plugin.
The name of a CPAN module to imitate. E.g. Foo::Bar
The new name to use in place of the source name. Defaults to the converted form of the distribution name.
This is a URI to a CPAN mirror. It must be an 'http' URI. Defaults to http://www.cpan.org/
http://www.cpan.org/
Boolean for whether any assignments to $VERSION should be stripped out of the source. This is a crude hack and acts by killing a line of code containing such assignments. This obviously may not work in all cases and should be used with caution. Default is false.
$VERSION
Boolean for whether Pod should be stripped when copying from source. Default is false.
Name of change log file. Defaults to 'Changes'.
Boolean for whether change log should be updated with the source distribution when built. Default is true.
To exclude certain files from being gathered, use the exclude_filename option. This may be used multiple times to specify multiple files to exclude.
exclude_filename
This is just like exclude_filename but provides a regular expression pattern. Files matching the pattern are not gathered. This may be used multiple times to specify multiple patterns to exclude.
Please report any bugs or feature requests through the issue tracker at https://github.com/dagolden/Dist-Zilla-Plugin-Doppelgaenger/issues. You will be notified automatically of any progress on your issue.
This is open source software. The code repository is available for public review and contribution under the terms of the license.
https://github.com/dagolden/Dist-Zilla-Plugin-Doppelgaenger
git clone https://github.com/dagolden/Dist-Zilla-Plugin-Doppelgaenger.git
David Golden <dagolden@cpan.org>
This software is Copyright (c) 2010 by David Golden.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004
To install Dist::Zilla::Plugin::Doppelgaenger, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::Doppelgaenger
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::Doppelgaenger
For more information on module installation, please visit the detailed CPAN module installation guide.