™.. CPANPLUS::Internals::Source - Online Linux Manual PageSection : 3pm
Updated : 2009-07-06
Source : perl v5.10.1
Note : Perl Programmers Reference Guide
NAMECPANPLUS::Internals::Source
SYNOPSIS ### lazy load author/module trees ###
$cb−>_author_tree;
$cb−>_module_tree;
DESCRIPTIONCPANPLUS::Internals::Source controls the updating of source files and the parsing of them into usable module/author trees to be used by \*(C`CPANPLUS\*(C'\fR. Functions exist to check if source files are still \*(C`good to use\*(C'\fR as well as update them, and then parse them. The flow looks like this: $cb−>_author_tree || $cb−>_module_tree
$cb−>_check_trees
$cb−>_ _check_uptodate
$cb−>_update_source
$cb−>_ _update_custom_module_sources
$cb−>_ _update_custom_module_source
$cb−>_build_trees
### engine methods
{ $cb−>_init_trees;
$cb−>_standard_trees_completed
$cb−>_custom_trees_completed
}
$cb−>_ _create_author_tree
### engine methods
{ $cb−>_add_author_object }
$cb−>_ _create_module_tree
$cb−>_ _create_dslip_tree
### engine methods
{ $cb−>_add_module_object }
$cb−>_ _create_custom_module_entries
$cb−>_dslip_defs
METHODS
$cb−>_build_trees( uptodate => BOOL, [use_stored => BOOL, path => $path, verbose => BOOL] )This method rebuilds the author− and module-trees from source. It takes the following arguments: uptodate Indicates whether any on disk caches are still ok to use. path The absolute path to the directory holding the source files. verbose A boolean flag indicating whether or not to be verbose. use_stored A boolean flag indicating whether or not it is ok to use previously stored trees. Defaults to true. Returns a boolean indicating success.
$cb−>_check_trees( [update_source => BOOL, path => PATH, verbose => BOOL] )Retrieve source files and return a boolean indicating whether or not the source files are up to date. Takes several arguments: update_source A flag to force re-fetching of the source files, even if they are still up to date. path The absolute path to the directory holding the source files. verbose A boolean flag indicating whether or not to be verbose. Will get information from the config file by default.
$cb−>_ _check_uptodate( file => $file, name => $name, [update_source => BOOL, verbose => BOOL] )\*(C`_\|_check_uptodate\*(C'\fR checks if a given source file is still up-to-date and if not, or when \*(C`update_source\*(C'\fR is true, will re-fetch the source file. Takes the following arguments: file The source file to check. name The internal shortcut name for the source file (used for config lookups). update_source Flag to force updating of sourcefiles regardless. verbose Boolean to indicate whether to be verbose or not. Returns a boolean value indicating whether the current files are up to date or not.
$cb−>_update_source( name => $name, [path => $path, verbose => BOOL] )This method does the actual fetching of source files. It takes the following arguments: name The internal shortcut name for the source file (used for config lookups). path The full path where to write the files. verbose Boolean to indicate whether to be verbose or not. Returns a boolean to indicate success.
$cb−>_ _create_author_tree([path => $path, uptodate => BOOL, verbose => BOOL])This method opens a source files and parses its contents into a searchable author-tree or restores a file-cached version of a previous parse, if the sources are uptodate and the file-cache exists. It takes the following arguments: uptodate A flag indicating whether the file-cache is uptodate or not. path The absolute path to the directory holding the source files. verbose A boolean flag indicating whether or not to be verbose. Will get information from the config file by default. Returns a tree on success, false on failure.
$cb−>_create_mod_tree([path => $path, uptodate => BOOL, verbose => BOOL])This method opens a source files and parses its contents into a searchable module-tree or restores a file-cached version of a previous parse, if the sources are uptodate and the file-cache exists. It takes the following arguments: uptodate A flag indicating whether the file-cache is up-to-date or not. path The absolute path to the directory holding the source files. verbose A boolean flag indicating whether or not to be verbose. Will get information from the config file by default. Returns a tree on success, false on failure.
$cb−>_ _create_dslip_tree([path => $path, uptodate => BOOL, verbose => BOOL])This method opens a source files and parses its contents into a searchable dslip-tree or restores a file-cached version of a previous parse, if the sources are uptodate and the file-cache exists. It takes the following arguments: uptodate A flag indicating whether the file-cache is uptodate or not. path The absolute path to the directory holding the source files. verbose A boolean flag indicating whether or not to be verbose. Will get information from the config file by default. Returns a tree on success, false on failure.
$cb−>_dslip_defs ()This function returns the definition structure (ARRAYREF) of the dslip tree.
$file = $cb−>_add_custom_module_source( uri => URI, [verbose => BOOL] );Adds a custom source index and updates it based on the provided URI. Returns the full path to the index file on success or false on failure.
$index = $cb−>_ _custom_module_source_index_file( uri => $uri );Returns the full path to the encoded index file for $uri, as used by all \*(C`custom module source\*(C'\fR routines.
$file = $cb−>_remove_custom_module_source( uri => URI, [verbose => BOOL] );Removes a custom index file based on the URI provided. Returns the full path to the index file on success or false on failure.
%files = $cb−>_ _list_custom_module_sourcesThis method scans the 'custom−sources' directory in your base directory for additional sources to include in your module tree. Returns a list of key value pairs as follows: /full/path/to/source/file%3Fencoded => http://decoded/mirror/path
$bool = $cb−>_ _update_custom_module_sources( [verbose => BOOL] );Attempts to update all the index files to your custom module sources. If the index is missing, and it's a \*(C`file://\*(C'\fR uri, it will generate a new local index for you. Return true on success, false on failure.
$ok = $cb−>_ _update_custom_module_sourceAttempts to update all the index files to your custom module sources. If the index is missing, and it's a \*(C`file://\*(C'\fR uri, it will generate a new local index for you. Return true on success, false on failure.
$bool = $cb−>_ _write_custom_module_index( path => /path/to/packages, [to => /path/to/index/file, verbose => BOOL] )Scans the \*(C`path\*(C'\fR you provided for packages and writes an index with all the available packages to \*(C`$path/packages.txt\*(C'\fR. If you'd like the index to be written to a different file, provide the \*(C`to\*(C'\fR argument. Returns true on success and false on failure.
$bool = $cb−>_ _create_custom_module_entries( [verbose => BOOL] )Creates entries in the module tree based upon the files as returned by \*(C`_\|_list_custom_module_sources\*(C'\fR. Returns true on success, false on failure. 0
Johanes Gumabo
Data Size : 30,265 byte
man-CPANPLUS::Internals::Source.3pmBuild : 2024-12-05, 20:55 :
Visitor Screen : x
Visitor Counter ( page / site ) : 5 / 171,345
Visitor ID : :
Visitor IP : 18.116.89.70 :
Visitor Provider : AMAZON-02 :
Provider Position ( lat x lon ) : 39.962500 x -83.006100 : x
Provider Accuracy Radius ( km ) : 1000 :
Provider City : Columbus :
Provider Province : Ohio , : ,
Provider Country : United States :
Provider Continent : North America :
Visitor Recorder : Version :
Visitor Recorder : Library :
Online Linux Manual Page : Version : Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page : Library : lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page : Library : lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base : Version : Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base : Library : lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.
ERROR : Need New Coding : (parse_manual_page_|249|CPANPLUS::Internals::Source.3pm|36/37|el══─{─══.|.el══─{─══. ds -- \|\(em\|
) (htmlprn|149|CPANPLUS::Internals::Source.3pm|36/37|.el══─{─══. ds -- — |.el══─{─══. ds -- \|\(em\|
) (parse_manual_page_|249|CPANPLUS::Internals::Source.3pm|41|br══─}─══|'br══─}─══
) (htmlprn|149|CPANPLUS::Internals::Source.3pm|41|'br══─}─══ |'br══─}─══
) (rof_nr_x|149|CPANPLUS::Internals::Source.3pm|51/52|\nF|.ie \nF ══─{─══. de IX
) (rof_unit_scale_px|41|CPANPLUS::Internals::Source.3pm|51/52|F|.ie \nF ══─{─══. de IX
) (rof_if|19|CPANPLUS::Internals::Source.3pm|51/52|\nF|.ie \nF ══─{─══. de IX
) (htmlprn|149|CPANPLUS::Internals::Source.3pm|51/52|.ie \nF ══─{─══. de IX|.ie \nF ══─{─══. de IX
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|53|\$1\t\\n%\t"\\$2" |. tm Index:\\$1\t\\n%\t"\\$2"
) (parse_manual_page_|249|CPANPLUS::Internals::Source.3pm|57|══─}─══|.══─}─══
) (htmlprn|149|CPANPLUS::Internals::Source.3pm|57|.══─}─══ |.══─}─══
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|146|\*(C`CPANPLUS\*(C'\fR. |\&\f(CW\*(C`CPANPLUS\*(C'\fR.
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|148|\*(C`good to use\*(C'\fR as |Functions exist to check if source files are still \f(CW\*(C`good to use\*(C'\fR as
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|222|\*(C`_\|_check_uptodate\*(C'\fR checks if a given source file is still up-to-date |\&\f(CW\*(C`_\|_check_uptodate\*(C'\fR checks if a given source file is still up-to-date
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|223|\*(C`update_source\*(C'\fR is true, will re-fetch the source |and if not, or when \f(CW\*(C`update_source\*(C'\fR is true, will re-fetch the source
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|339|\*(C`custom module source\*(C'\fR routines. |all \f(CW\*(C`custom module source\*(C'\fR routines.
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|362|\*(C`file://\*(C'\fR uri, it will generate |If the index is missing, and it's a \f(CW\*(C`file://\*(C'\fR uri, it will generate
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|371|\*(C`file://\*(C'\fR uri, it will generate |If the index is missing, and it's a \f(CW\*(C`file://\*(C'\fR uri, it will generate
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|378|\*(C`path\*(C'\fR you provided for packages and writes an index with all |Scans the \f(CW\*(C`path\*(C'\fR you provided for packages and writes an index with all
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|379|\*(C`$path/packages.txt\*(C'\fR. If you'd like the index |the available packages to \f(CW\*(C`$path/packages.txt\*(C'\fR. If you'd like the index
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|380|\*(C`to\*(C'\fR argument. |to be written to a different file, provide the \f(CW\*(C`to\*(C'\fR argument.
) (rof_escape_sequence|91|CPANPLUS::Internals::Source.3pm|387|\*(C`_\|_list_custom_module_sources\*(C'\fR. |by \f(CW\*(C`_\|_list_custom_module_sources\*(C'\fR.
)