view release on metacpan or  search on metacpan

script/depak  view on Meta::CPAN

=head1 CONFIGURATION FILE

This script can read configuration files. Configuration files are in the format of L<IOD>, which is basically INI with some extra features.

By default, these names are searched for configuration filenames (can be changed using C<--config-path>): F</home/u1/.config/depak.conf>, F</home/u1/depak.conf>, or F</etc/depak.conf>.

All found files will be read and merged.

To disable searching for configuration files, pass C<--no-config>.

You can put multiple profiles in a single file by using section names like C<[profile=SOMENAME]> or C<[SOMESECTION profile=SOMENAME]>. Those sections will only be read if you specify the matching C<--config-profile SOMENAME>.

You can also put configuration for multiple programs inside a single file, and use filter C<program=NAME> in section names, e.g. C<[program=NAME ...]> or C<[SOMESECTION program=NAME]>. The section will then only be used when the reading program match...

You can also filter a section by environment variable using the filter C<env=CONDITION> in section names. For example if you only want a section to be read if a certain environment variable is true: C<[env=SOMEVAR ...]> or C<[SOMESECTION env=SOMEVAR ...

To load and configure plugins, you can use either the C<-plugins> parameter (e.g. C<< -plugins=DumpArgs >> or C<< -plugins=DumpArgs@before_validate_args >>), or use the C<[plugin=NAME ...]> sections, for example:

 [plugin=DumpArgs]
 -event=before_validate_args
 -prio=99
 
 [plugin=Foo]
 -event=after_validate_args
 arg1=val1
 arg2=val2

 

which is equivalent to setting C<< -plugins=-DumpArgs@before_validate_args@99,-Foo@after_validate_args,arg1,val1,arg2,val2 >>.

List of available configuration parameters:

 allow_xs (see --allow-xs)
 args (see --arg)
 code_after_shebang (see --code-after-shebang)
 debug_keep_tempdir (see --debug-keep-tempdir)
 exclude_core (see --include-core)
 exclude_dist (see --exclude-dist)
 exclude_list (see --exclude-list)
 exclude_module (see --exclude-module)
 exclude_pattern (see --exclude-pattern)
 exclude_prereq (see --exclude-prereq)
 format (see --format)
 include_dir (see --include-dir)
 include_dist (see --include-dist)
 include_list (see --include-list)
 include_module (see --include-module)
 include_prereq (see --include-prereq)
 input_file (see --input-file)
 log_level (see --log-level)
 multiple_runs (see --multiple-runs)
 naked_res (see --naked-res)
 output_file (see --output-file)
 overwrite (see --overwrite)
 pack_method (see --pack-method)
 perl_version (see --perl-version)
 put_hook_at_the_end (see --put-hook-at-the-end)
 shebang (see --shebang)
 skip_not_found (see --skip-not-found)
 squish (see --squish)
 strip (see --strip)
 stripper (see --stripper)
 stripper_comment (see --no-stripper-comment)
 stripper_log (see --stripper-log)
 stripper_maintain_linum (see --stripper-maintain-linum)
 stripper_pod (see --no-stripper-pod)
 stripper_ws (see --no-stripper-ws)
 test (see --test)
 test_cases (see --test-cases)
 trace_extra_opts (see --trace-extra-opts)
 trace_method (see --trace-method)
 use (see --use)

Profiles are also automatically matched to the name of the script being
processed, if not specified. For example:

 [profile=parse-id-phone]
 trace_method=require
 #overwrite=1
 include=Parse::PhoneNumber::ID
 include=Perinci::CmdLine::Lite
 include=Data::Check::Structure
 include=Text::Table::Tiny

which will automatically be used when you depak a script named
C<parse-id-phone>.

=head1 ENVIRONMENT

=head2 DEPAK_OPT

String. Specify additional command-line options.

=head2 DEBUG_KEEP_TEMPDIR => bool

Set default for C<debug_keep_tempdir> option.

=head1 FILES

=head2 /home/u1/.config/depak.conf

=head2 /home/u1/depak.conf

=head2 /etc/depak.conf

=head1 HOMEPAGE

Please visit the project's homepage at L<https://metacpan.org/release/App-depak>.

=head1 SOURCE

Source repository is at L<https://github.com/perlancar/perl-App-depak>.

=head1 SEE ALSO

L<App::FatPacker>, L<Module::FatPack>, L<App::FatPackUtils>

L<Module::DataPack>, L<App::DataPackUtils>