1CPANPLUS::Internals::SeUasrecrh(C3o)ntributed Perl DocumCePnAtNaPtLiUoSn::Internals::Search(3)
2
3
4
6 CPANPLUS::Internals::Search - internals for searching for modules
7
9 my $aref = $cpan->_search_module_tree(
10 type => 'package',
11 allow => [qr/DBI/],
12 );
13
14 my $aref = $cpan->_search_author_tree(
15 type => 'cpanid',
16 data => \@old_results,
17 verbose => 1,
18 allow => [qw|KANE AUTRIJUS|],
19 );
20
21 my $aref = $cpan->_all_installed( );
22
24 The functions in this module are designed to find module(objects) based
25 on certain criteria and return them.
26
28 _search_module_tree( type => TYPE, allow => \@regexes, [data =>
29 \@previous_results ] )
30 Searches the moduletree for module objects matching the criteria you
31 specify. Returns an array ref of module objects on success, and false
32 on failure.
33
34 It takes the following arguments:
35
36 type
37 This can be any of the accessors for the "CPANPLUS::Module"
38 objects. This is a required argument.
39
40 allow
41 A set of rules, or more precisely, a list of regexes (via "qr//" or
42 plain strings), that the "type" must adhere too. You can specify as
43 many as you like, and it will be treated as an "OR" search. For an
44 "AND" search, see the "data" argument.
45
46 This is a required argument.
47
48 data
49 An arrayref of previous search results. This is the way to do an
50 "AND" search -- "_search_module_tree" will only search the module
51 objects specified in "data" if provided, rather than the moduletree
52 itself.
53
54 _search_author_tree( type => TYPE, allow => \@regexex, [data =>
55 \@previous_results ] )
56 Searches the authortree for author objects matching the criteria you
57 specify. Returns an array ref of author objects on success, and false
58 on failure.
59
60 It takes the following arguments:
61
62 type
63 This can be any of the accessors for the "CPANPLUS::Module::Author"
64 objects. This is a required argument.
65
66 allow
67 A set of rules, or more precisely, a list of regexes (via "qr//" or
68 plain strings), that the "type" must adhere too. You can specify as
69 many as you like, and it will be treated as an "OR" search. For an
70 "AND" search, see the "data" argument.
71
72 This is a required argument.
73
74 data
75 An arrayref of previous search results. This is the way to do an
76 "and" search -- "_search_author_tree" will only search the author
77 objects specified in "data" if provided, rather than the authortree
78 itself.
79
80 _all_installed()
81 This function returns an array ref of module objects of modules that
82 are installed on this system.
83
84
85
86perl v5.30.1 2019-12-10 CPANPLUS::Internals::Search(3)