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


version 0.008


  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:

  0.001     2010-12-17 08:37:08 EST5EDT

    - Generated from AUTHOR/Foo-Bar-1.23.tar.gz

    - See for details

If you strip Pod, you may with to explore replacing it with new Pod using the Dist::Zilla::Plugin::AppendExternalData plugin.


source_module (REQUIRED)

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


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.


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.


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.


Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at 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.

  git clone


David Golden <>


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

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004