view release on metacpan or  search on metacpan

script/fatpack-modules  view on Meta::CPAN

our $AUTHORITY = 'cpan:PERLANCAR'; # AUTHORITY
our $DATE = '2020-04-30'; # DATE
our $DIST = 'App-FatPackUtils'; # DIST
our $VERSION = '0.121'; # VERSION

use 5.010001;
use strict;
use warnings;

use Perinci::CmdLine::Any;

my $cmdline = Perinci::CmdLine::Any->new(
    url => "/Module/FatPack/fatpack_modules",
    program_name => "fatpack-modules",
);

$cmdline->run;

# ABSTRACT: Generate source code that contains fatpacked modules
# PODNAME: fatpack-modules

__END__

=pod

=encoding UTF-8

=head1 NAME

fatpack-modules - Generate source code that contains fatpacked modules

=head1 VERSION

This document describes version 0.121 of fatpack-modules (from Perl distribution App-FatPackUtils), released on 2020-04-30.

=head1 SYNOPSIS

Usage:

 % fatpack-modules [--add-begin-block] [--assume-strict]
     [--config-path=path | -c] [--config-profile=profile | -P]
     [--format=name] [--json] [--line-prefix=s] [-m=s+] [--module-name=s+]
     [--module-names-json=s] [--module-src key=s] [--module-srcs-json=s]
     [--(no)naked-res] [--no-add-begin-block] [--no-assume-strict]
     [--no-config | -C] [--no-env] [--no-overwrite] [--no-stripper]
     [--no-stripper-comment] [--no-stripper-log]
     [--no-stripper-maintain-linum] [--no-stripper-pod] [--no-stripper-ws]
     [--noadd-begin-block] [--noassume-strict] [--nooverwrite]
     [--nostripper] [--nostripper-comment] [--nostripper-log]
     [--nostripper-maintain-linum] [--nostripper-pod] [--nostripper-ws]
     [-o=s] [--output=s] [--overwrite] [--page-result[=program]] [--pm]
     [--postamble=s] [--preamble=s] [--put-hook-at-the-end] [--stripper]
     [--stripper-comment] [--stripper-log] [--stripper-maintain-linum]
     [--stripper-pod] [--stripper-ws] [module_name] ...

Examples:

Fatpack two modules:

 % fatpack-modules Text::Table::Tiny Try::Tiny

=head1 DESCRIPTION

This routine provides the same core technique employed by C<App::FatPacker>
(which is putting modules' source code inside Perl variables and loading them
on-demand via require hook) without all the other stuffs. All you need is supply
the names of modules (or the modules' source code themselves) and you'll get the
output in a file or string.

=head1 OPTIONS

C<*> marks required options.

=head2 Main options

=over

=item B<--add-begin-block>

Surround the code inside BEGIN { }.

=item B<--assume-strict>

Assume code runs under stricture.

=item B<--line-prefix>=I<s>

=item B<--pm>

Make code suitable to put inside .pm file instead of script.

This setting adjusts the code so it is suitable to put one or several instances
of the code inside one or more .pm files. Also sets default for --line-prefix
'#' --no-add-begin-block --put-hook-at-the-end.


=item B<--put-hook-at-the-end>

Put the require hook at the end of @INC using "push" instead of at the front using "unshift".

=back

=head2 Configuration options

=over

=item B<--config-path>=I<s>, B<-c>

Set path to configuration file.

=item B<--config-profile>=I<s>, B<-P>

Set configuration profile to use.

=item B<--no-config>, B<-C>

Do not use any configuration file.

=back