NAME

Dist::Zilla::Plugin::PodnameFromClassname - Insert PODNAME for Moops classes.

Requires Perl 5.10+ Travis status Distribution kwalitee CPAN Testers result coverage 81.4%

VERSION

Version 0.1100, released 2016-04-02.

SYNOPSIS

In dist.ini:

[PodnameFromClassname]

In a Moops class:

# PODCLASSNAME

class My::Class { ... }

Results in:

# PODNAME: My::Class

class My::Class { ... }

DESCRIPTION

Dist::Zilla::Plugin::PodnameFromClassname is useful together with Moops and Pod::Weaver. Since Moops classes generally don't also have a package statement Pod::Weaver can't pick up the module name.

Using this plugin and adding a # PODCLASSNAME line fixes that (by replacing such a line with the standard # PODNAME: $classname comment). There should be only one # PODCLASSNAME comment per file.

The plugin picks the first line that starts with class, role, namespace or library and uses the package name given on that line.

The comment line should match this regular expression:

qr/^[\t ]*# PODCLASSNAME:?$/ms

Note: While this plugin was developed with Moops in mind, it should work with any module that introduces any of those keywords.

SEE ALSO

SOURCE

https://github.com/Csson/p5-Dist-Zilla-Plugin-PodnameFromClassname

HOMEPAGE

https://metacpan.org/release/Dist-Zilla-Plugin-PodnameFromClassname

AUTHOR

Erik Carlsson <info@code301.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Erik Carlsson.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.