CONTENTS

• NAME
• SYNOPSIS
• DESCRIPTION
  • OPTIONS
• AUTHOR

#NAME

CPAN::Plugin::Specfile - Proof of concept implementation of a trivial CPAN::Plugin

#SYNOPSIS

# once in the cpan shell
o conf plugin_list push CPAN::Plugin::Specfile

# make permanent
o conf commit

# any time in the cpan shell to write a spec file
test Acme::Meta

# disable
# if it is the last in plugin_list:
o conf plugin_list pop
# otherwise, determine the index to splice:
o conf plugin_list
# and then use splice, e.g. to splice position 3:
o conf plugin_list splice 3 1

#DESCRIPTION

Implemented as a post-test hook, this plugin writes a specfile after every successful test run. The content is also written to the terminal.

As a side effect, the timestamps of the written specfiles reflect the linear order of all dependencies.

WARNING: This code is just a small demo how to use the plugin system of the CPAN shell, not a full fledged spec file writer. Do not expect new features in this plugin.

#OPTIONS

The target directory to store the spec files in can be set using dir as in

o conf plugin_list push CPAN::Plugin::Specfile=dir,/tmp/specfiles-000042

The default directory for this is the plugins/CPAN::Plugin::Specfile directory in the cpan_home directory.

#AUTHOR

Andreas Koenig <andk@cpan.org>, Branislav Zahradnik <barney@cpan.org>

Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via the GitHub issue tracker or email regarding any issues with the site itself, search, or rendering of documentation.

The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the Perl issue tracker, the mailing list, or IRC to report any issues with the contents or format of the documentation.