NAME
Liveman::Append - adds sections for methods and functions from lib/**.pm
to lib/**.md
SYNOPSIS
use Liveman::Append;
my $liveman_append = Liveman::Append->new;
ref $liveman_append # => Liveman::Append
DESCRIPTION
Adds a manual about module methods and functions (lib/**.pm
) to their manuals (lib/**.md
).
- 1. Methods is a Perl subroutine starting with the
sub
keyword. - 2. Features are instance properties added by OOP frameworks such as
Aion
,Moose
,Moo
,Mo
, and starting with thehas
keyword.
SUBROUTINES
new (@params)
Constructor.
mkmd ($md)
Creates an md file.
appends ()
Adds routines and features to lib/**.md
from lib/**.pm
.
append ($path)
Adds routines and functions from a module ($path
) to its manual.
File lib/Alt/The/Plan.pm:
package Alt::The::Plan;
sub planner {
my ($self) = @_;
}
# This is first!
sub miting {
my ($self, $meet, $man, $woman) = @_;
}
sub _exquise_me {
my ($self, $meet, $man, $woman) = @_;
}
1;
-e "lib/Alt/The/Plan.md" # -> undef
# Set the mocks:
*Liveman::Append::_git_user_name = sub {'Yaroslav O. Kosmina'};
*Liveman::Append::_git_user_email = sub {'dart@cpan.org'};
*Liveman::Append::_year = sub {2023};
*Liveman::Append::_license = sub {"Perl5"};
*Liveman::Append::_land = sub {"Rusland"};
my $liveman_append = Liveman::Append->new->append("lib/Alt/The/Plan.pm");
$liveman_append->{count} # -> 1
$liveman_append->{added} # -> 2
-e "lib/Alt/The/Plan.md" # -> 1
# And again:
$liveman_append = Liveman::Append->new->append("lib/Alt/The/Plan.pm");
$liveman_append->{count} # -> 1
$liveman_append->{added} # -> 0
File lib/Alt/The/Plan.md is:
# NAME
Alt::The::Plan -
# SYNOPSIS
\```perl
use Alt::The::Plan;
my $alt_the_plan = Alt::The::Plan->new;
\```
# DESCRIPTION
.
# SUBROUTINES
## planner ()
.
\```perl
my $alt_the_plan = Alt::The::Plan->new;
$alt_the_plan->planner # -> .3
\```
## miting ($meet, $man, $woman)
This is first!
\```perl
my $alt_the_plan = Alt::The::Plan->new;
$alt_the_plan->miting($meet, $man, $woman) # -> .3
\```
# INSTALL
For install this module in your system run next [command](https://metacpan.org/pod/App::cpm):
\```sh
sudo cpm install -gvv Alt::The::Plan
\```
# AUTHOR
Yaroslav O. Kosmina [dart@cpan.org](mailto:dart@cpan.org)
# LICENSE
⚖ **Perl5**
# COPYRIGHT
The Alt::The::Plan module is copyright © 2023 Yaroslav O. Kosmina. Rusland. All rights reserved.
AUTHOR
Yaroslav O. Kosmina mailto:dart@cpan.org
LICENSE
⚖ GPLv3
COPYRIGHT
The Liveman::Append module is copyright © 2023 Yaroslav O. Kosmina. Rusland. All rights reserved.