summaryrefslogtreecommitdiff
path: root/helpers/perl
blob: 83ab1a10e7e571b8093cffaf10a82c6489cf3e6b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
# -*- perl -*-

use strict;
use Config;
use Cwd;
use File::Spec::Functions;

my %seen;

sub print_modules_real {
    my ($base, $dir, $word, $include_pod) = @_;

    # return immediately if potential completion doesn't match current word
    # a double comparison is used to avoid dealing with string lengths
    # (the shorter being the pattern to be used as the regexp)
    # word 'Fi', base 'File' -> match 'File' against 'Fi'
    # word 'File::Sp', base 'File' -> match 'File::Sp' against 'File'
    return
           if $base
        && $word
        && $base !~ /^\Q$word/
        && $word !~ /^\Q$base/;

    chdir($dir) or return;

    # print each file
    foreach my $file (sort(glob('*.pm'), glob('*.pod'))) {
        next if ($file =~ /\.pod$/ and not $include_pod);
        $file =~ s/\.(?:pm|pod)$//;
        my $module = $base . $file;
        next if $module !~ /^\Q$word/;
        next if $seen{$module}++;
        print $module, "\n";
    }

    # recurse in each subdirectory
    foreach my $directory (grep {-d} glob('*')) {
        my $subdir = $dir . '/' . $directory;
        if ($directory =~ /^(?:[.\d]+|$Config{archname}|auto)$/) {

            # exclude subdirectory name from base
            print_modules_real(undef, $subdir, $word, $include_pod);
        } else {

            # add subdirectory name to base
            print_modules_real($base . $directory . '::',
                $subdir, $word, $include_pod);
        }
    }
}

sub print_modules {
    my ($word, $include_pod) = @_;

    my $origdir = getcwd;
    foreach my $directory (@INC) {
        print_modules_real(undef, $directory, $word, $include_pod);
        chdir $origdir;
    }
}

sub print_functions {
    my ($word) = @_;

    my $perlfunc;
    for (@INC, undef) {
        return if not defined;
        $perlfunc = catfile $_, qw( pod perlfunc.pod );
        last if -r $perlfunc;
    }

    open my $fh, '<', $perlfunc or return;

    my $nest_level = -1;
    while (<$fh>) {
        next if 1 .. /^=head2 Alphabetical Listing of Perl Functions$/;
        ++$nest_level if /^=over/;
        --$nest_level if /^=back/;
        next          if $nest_level;
        next unless /^=item (-?\w+)/;
        my $function = $1;
        next if $function !~ /^\Q$word/;
        next if $seen{$function}++;
        print $function, "\n";
    }

}

my $type = shift;
my $word = shift;

if ($type eq 'functions') {
    print_functions($word);
} elsif ($type eq 'modules') {
    print_modules($word);
} elsif ($type eq 'perldocs') {
    print_modules($word, 1);
}