view release on metacpan or  search on metacpan

script/complete-module  view on Meta::CPAN

# and generated automatically using Perinci::CmdLine::Gen version 0.502

use 5.010001;
use strict;
use warnings;
use Log::ger;

use Perinci::CmdLine::Any;

our $AUTHORITY = 'cpan:PERLANCAR'; # AUTHORITY
our $DATE = '2023-12-01'; # DATE
our $DIST = 'App-CompleteCLIs'; # DIST
our $VERSION = '0.153'; # VERSION

my $cmdline = Perinci::CmdLine::Any->new(
    url => "/Complete/Module/complete_module",
    program_name => "complete-module",
    log => 1,
    read_config => 0,
    read_env => 0,
);

$cmdline->run;

# ABSTRACT: Complete with installed Perl module names
# PODNAME: complete-module

__END__

=pod

=encoding UTF-8

=head1 NAME

complete-module - Complete with installed Perl module names

=head1 VERSION

This document describes version 0.153 of complete-module (from Perl distribution App-CompleteCLIs), released on 2023-12-01.

=head1 SYNOPSIS

B<complete-module> B<L<--help|/"--help, -h, -?">> (or B<L<-h|/"--help, -h, -?">>, B<L<-?|/"--help, -h, -?">>)

B<complete-module> B<L<--version|/"--version, -v">> (or B<L<-v|/"--version, -v">>)

B<complete-module> [B<L<--debug|/"--debug">>|B<L<--log-level|/"--log-level=s">>=I<level>|B<L<--quiet|/"--quiet">>|B<L<--trace|/"--trace">>|B<L<--verbose|/"--verbose">>] [B<L<--exclude-dir|/"--exclude-dir">>|B<L<--include-dir|/"--exclude-dir">>] [B<L<...

=head1 DESCRIPTION

For each directory in C<@INC> (coderefs are ignored), find Perl modules and
module prefixes which have C<word> as prefix. So for example, given C<Te> as
C<word>, will return e.g. C<[Template, Template::, Term::, Test, Test::, Text::]>.
Given C<Text::> will return C<[Text::ASCIITable, Text::Abbrev, ...]> and so on.

This function has a bit of overlapping functionality with L<Module::List>, but
this function is geared towards shell tab completion. Compared to Module::List,
here are some differences: 1) list modules where prefix is incomplete; 2)
interface slightly different; 3) (currently) doesn't do recursing; 4) contains
conveniences for completion, e.g. map casing, expand intermediate paths (see
C<Complete> for more details on those features), autoselection of path separator
character, some shortcuts, and so on.

=head1 OPTIONS

C<*> marks required options.

=head2 Main options

=over

=item B<--exclude-dir>

(No description)


=item B<--exclude-leaf>

(No description)


=item B<--no-find-pm>

(No description)


=item B<--no-find-pmc>

(No description)


=item B<--no-find-pod>

(No description)


=item B<--no-find-prefix>

(No description)


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

Namespace prefix.

This is useful if you want to complete module under a specific namespace
(instead of the root). For example, if you set C<ns_prefix> to
C<Dist::Zilla::Plugin> (or C<Dist::Zilla::Plugin::>) and word is C<F>, you can get
C<['FakeRelease', 'FileFinder::', 'FinderCode']> (those are modules under the
C<Dist::Zilla::Plugin::> namespace).


=item B<--ns-prefixes-json>=I<s>

Namespace prefixes (JSON-encoded).

See C<--ns-prefixes>.

=item B<--ns-prefixes>=I<s@>