/ 
Dist-Zilla-Plugin-Doppelgaenger-0.008
River stage zero No dependents
/ Dist::Zilla::Plugin::Doppelgaenger

NAME

Dist::Zilla::Plugin::Doppelgaenger - Creates an evil twin of a CPAN distribution

VERSION

version 0.008

SYNOPSIS

[Doppelgaenger]
source_module = Foo::Bar
strip_pod = 1

DESCRIPTION

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:

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.

ATTRIBUTES

source_module (REQUIRED)

The name of a CPAN module to imitate. E.g. Foo::Bar

new_name

The new name to use in place of the source name. Defaults to the converted form of the distribution name.

cpan_mirror

This is a URI to a CPAN mirror. It must be an 'http' URI. Defaults to http://www.cpan.org/

strip_version

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.

strip_pod

Boolean for whether Pod should be stripped when copying from source. Default is false.

changes_file

Name of change log file. Defaults to 'Changes'.

update_changes_file

Boolean for whether change log should be updated with the source distribution when built. Default is true.

exclude_filename

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_match

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.

SUPPORT

Bugs / Feature Requests

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.

Source Code

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

AUTHOR

David Golden <dagolden@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2010 by David Golden.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004