NAME

CPANPLUS::Dist::Debora::Pod - Parse Pod documents

VERSION

version 0.014

SYNOPSIS

use CPANPLUS::Dist::Debora::Pod;

$pod = CPANPLUS::Dist::Debora::Pod->find($module_name, @dirs);

$pod_text    = $pod->text;
$summary     = $pod->summary;
$description = $pod->description;

DESCRIPTION

This Pod::Simple subclass finds and parses files in Perl's Pod markup language. Information that is not relevant for extracting descriptions and license information is ignored.

SUBROUTINES/METHODS

find

my $pod = CPANPLUS::Dist::Debora::Pod->find($module_name, @dirs);

Takes a module name and a list of directories to search for Pod files. Returns a Pod object or the undefined value.

new

my $pod = CPANPLUS::Dist::Debora::Pod->new;

Creates a new object.

parse_file

$pod->parse_file($name);

Parses the specified Pod file.

text

my $pod_text = $pod->text;

Returns the Pod document, which is simplified for the purpose of finding descriptions and license information.

Use Software::LicenseUtils to guess the license.

my @licenses = Software::LicenseUtils->guess_license_from_pod($pod_text);

title

my $title = $pod->title;

Returns the Pod document's title or the undefined value.

If the Pod document contains the section below, "Hoo::Boy::Wowza - Stuff wow yeah!" will be returned.

=head1 NAME

Hoo::Boy::Wowza - Stuff wow yeah!

summary

my $summary = $pod->summary;

Returns the Pod document's one-line description or the undefined value.

If the Pod document contains the section below, "Stuff wow yeah!" will be returned.

=head1 NAME

Hoo::Boy::Wowza - Stuff wow yeah!

description

my $description = $pod->description;

Returns the first paragraphs of the Pod document's description or the undefined value.

copyrights

for my $copyright (@{$pod->copyrights}) {
    my $year   = $copyright->{year};
    my $holder = $copyright->{holder};
}

Returns the copyright years and holders.

section

my $pod_text = $pod->section($level, $title);

Searches for a section with the specified title on the specified level.

DIAGNOSTICS

None.

CONFIGURATION AND ENVIRONMENT

None.

DEPENDENCIES

Requires the modules Pod::Simple and Pod::Simple::Search, which are distributed with Perl.

INCOMPATIBILITIES

None.

BUGS AND LIMITATIONS

None known.

AUTHOR

Andreas Vögele <voegelas@cpan.org>

LICENSE AND COPYRIGHT

Copyright (C) 2024 Andreas Vögele

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