1CPANPLUS::Internals::SoUusrecre(C3o)ntributed Perl DocumCePnAtNaPtLiUoSn::Internals::Source(3)
2
6 CPANPLUS::Internals::Source - internals for updating source files
7
9 ### lazy load author/module trees ###
10 $cb->_author_tree;
12 $cb->_module_tree;
13
15 CPANPLUS::Internals::Source controls the updating of source files and
16 the parsing of them into usable module/author trees to be used by
17 "CPANPLUS".
18 Functions exist to check if source files are still "good to use" as
20 well as update them, and then parse them.
21 The flow looks like this:
23 $cb->_author_tree || $cb->_module_tree
25 $cb->_check_trees
26 $cb->__check_uptodate
27 $cb->_update_source
28 $cb->__update_custom_module_sources
29 $cb->__update_custom_module_source
30 $cb->_build_trees
31 ### engine methods
32 { $cb->_init_trees;
33 $cb->_standard_trees_completed
34 $cb->_custom_trees_completed
35 }
36 $cb->__create_author_tree
37 ### engine methods
38 { $cb->_add_author_object }
39 $cb->__create_module_tree
40 $cb->__create_dslip_tree
41 ### engine methods
42 { $cb->_add_module_object }
43 $cb->__create_custom_module_entries
44 $cb->_dslip_defs
46
48 $cb->_build_trees( uptodate => BOOL, [use_stored => BOOL, path => $path,
49 verbose => BOOL] )
50 This method rebuilds the author- and module-trees from source.
51 It takes the following arguments:
53 uptodate
55 Indicates whether any on disk caches are still ok to use.
56 path
58 The absolute path to the directory holding the source files.
59 verbose
61 A boolean flag indicating whether or not to be verbose.
62 use_stored
64 A boolean flag indicating whether or not it is ok to use previously
65 stored trees. Defaults to true.
66 Returns a boolean indicating success.
68 $cb->_check_trees( [update_source => BOOL, path => PATH, verbose => BOOL] )
70 Retrieve source files and return a boolean indicating whether or not
71 the source files are up to date.
72 Takes several arguments:
74 update_source
76 A flag to force re-fetching of the source files, even if they are
77 still up to date.
78 path
80 The absolute path to the directory holding the source files.
81 verbose
83 A boolean flag indicating whether or not to be verbose.
84 Will get information from the config file by default.
86 $cb->__check_uptodate( file => $file, name => $name, [update_source =>
88 BOOL, verbose => BOOL] )
89 "__check_uptodate" checks if a given source file is still up-to-date
90 and if not, or when "update_source" is true, will re-fetch the source
91 file.
92 Takes the following arguments:
94 file
96 The source file to check.
97 name
99 The internal shortcut name for the source file (used for config
100 lookups).
101 update_source
103 Flag to force updating of sourcefiles regardless.
104 verbose
106 Boolean to indicate whether to be verbose or not.
107 Returns a boolean value indicating whether the current files are up to
109 date or not.
110 $cb->_update_source( name => $name, [path => $path, verbose => BOOL] )
112 This method does the actual fetching of source files.
113 It takes the following arguments:
115 name
117 The internal shortcut name for the source file (used for config
118 lookups).
119 path
121 The full path where to write the files.
122 verbose
124 Boolean to indicate whether to be verbose or not.
125 Returns a boolean to indicate success.
127 $cb->__create_author_tree([path => $path, uptodate => BOOL, verbose =>
129 BOOL])
130 This method opens a source files and parses its contents into a
131 searchable author-tree or restores a file-cached version of a previous
132 parse, if the sources are uptodate and the file-cache exists.
133 It takes the following arguments:
135 uptodate
137 A flag indicating whether the file-cache is uptodate or not.
138 path
140 The absolute path to the directory holding the source files.
141 verbose
143 A boolean flag indicating whether or not to be verbose.
144 Will get information from the config file by default.
146 Returns a tree on success, false on failure.
148 $cb->_create_mod_tree([path => $path, uptodate => BOOL, verbose => BOOL])
150 This method opens a source files and parses its contents into a
151 searchable module-tree or restores a file-cached version of a previous
152 parse, if the sources are uptodate and the file-cache exists.
153 It takes the following arguments:
155 uptodate
157 A flag indicating whether the file-cache is up-to-date or not.
158 path
160 The absolute path to the directory holding the source files.
161 verbose
163 A boolean flag indicating whether or not to be verbose.
164 Will get information from the config file by default.
166 Returns a tree on success, false on failure.
168 $cb->__create_dslip_tree([path => $path, uptodate => BOOL, verbose =>
170 BOOL])
171 This method opens a source files and parses its contents into a
172 searchable dslip-tree or restores a file-cached version of a previous
173 parse, if the sources are uptodate and the file-cache exists.
174 It takes the following arguments:
176 uptodate
178 A flag indicating whether the file-cache is uptodate or not.
179 path
181 The absolute path to the directory holding the source files.
182 verbose
184 A boolean flag indicating whether or not to be verbose.
185 Will get information from the config file by default.
187 Returns a tree on success, false on failure.
189 $cb->_dslip_defs ()
191 This function returns the definition structure (ARRAYREF) of the dslip
192 tree.
193 $file = $cb->_add_custom_module_source( uri => URI, [verbose => BOOL] );
195 Adds a custom source index and updates it based on the provided URI.
196 Returns the full path to the index file on success or false on failure.
198 $index = $cb->__custom_module_source_index_file( uri => $uri );
200 Returns the full path to the encoded index file for $uri, as used by
201 all "custom module source" routines.
202 $file = $cb->_remove_custom_module_source( uri => URI, [verbose => BOOL] );
204 Removes a custom index file based on the URI provided.
205 Returns the full path to the index file on success or false on failure.
207 %files = $cb->__list_custom_module_sources
209 This method scans the 'custom-sources' directory in your base directory
210 for additional sources to include in your module tree.
211 Returns a list of key value pairs as follows:
213 /full/path/to/source/file%3Fencoded => http://decoded/mirror/path
215 $bool = $cb->__update_custom_module_sources( [verbose => BOOL] );
217 Attempts to update all the index files to your custom module sources.
218 If the index is missing, and it's a "file://" uri, it will generate a
220 new local index for you.
221 Return true on success, false on failure.
223 $ok = $cb->__update_custom_module_source
225 Attempts to update all the index files to your custom module sources.
226 If the index is missing, and it's a "file://" uri, it will generate a
228 new local index for you.
229 Return true on success, false on failure.
231 $bool = $cb->__write_custom_module_index( path => /path/to/packages, [to =>
233 /path/to/index/file, verbose => BOOL] )
234 Scans the "path" you provided for packages and writes an index with all
235 the available packages to "$path/packages.txt". If you'd like the index
236 to be written to a different file, provide the "to" argument.
237 Returns true on success and false on failure.
239 $bool = $cb->__create_custom_module_entries( [verbose => BOOL] )
241 Creates entries in the module tree based upon the files as returned by
242 "__list_custom_module_sources".
243 Returns true on success, false on failure.
245perl v5.36.0 2022-07-22 CPANPLUS::Internals::Source(3)