PAR::Repository::Client::DBM - Contains all the DBM access functions
use PAR::Repository::Client;
This module implements access to the underlying DBMs.
All of the methods described here shouldn't be used frivolously in user code even if some of them are part of the API and are guaranteed not to change.
Takes one or no arguments. Without arguments, all DBM files are checked. With an argument, only the specified DBM file will be checked.
Returns true if either one of the following conditions match:
The repository does not support checksums.
The checksums (and thus also the DBM files) haven't been downloaded yet.
The local copies of the checksums do not match those of the repository.
In cases two and three above, the return value is actually the hash reference of checksums that was fetched from the repository.
Returns the empty list if the local checksums match those of the repository exactly.
You don't usually need to call this directly. By default, DBM files are only fetched from the repository if necessary.
Fetches the modules_dists.dbm database from the repository, ties it to a DBM::Deep object and returns a tied hash reference or the empty list on failure. Second return value is the name of the local temporary file.
modules_dists.dbm
In case of failure, an error message is available via the error() method.
error()
The method uses the _fetch_dbm_file() method which must be implemented in a subclass such as PAR::Repository::Client::HTTP.
_fetch_dbm_file()
Fetches the scripts_dists.dbm database from the repository, ties it to a DBM::Deep object and returns a tied hash reference or the empty list on failure. Second return value is the name of the local temporary file.
scripts_dists.dbm
Fetches the dependencies.dbm database from the repository, ties it to a DBM::Deep object and returns a tied hash reference or the empty list on failure. Second return value is the name of the local temporary file.
dependencies.dbm
Closes the modules_dists.dbm file and does all necessary cleaning up.
This is called when the object is destroyed.
Closes the scripts_dists.dbm file and does all necessary cleaning up.
Closes the dependencies.dbm file and does all necessary cleaning up.
These private methods should not be relied upon from the outside of the module.
This is a private method.
Generic method returning a dbm. Requires two arguments. The type of the DBM (modules, scripts, dependencies), and the name of the remote DBM file. The latter should be taken from one of the package constants.
modules
scripts
dependencies
Given a reference to a file handle, a reference to a string or a file name, this method parses a checksum file and returns a hash reference associating file names with their base64 encoded MD5 hashes.
If passed a ref to a string, the contents of the string will be assumed to contain the checksum data.
This module is directly related to the PAR project. You need to have basic familiarity with it. Its homepage is at http://par.perl.org/
PAR
See PAR, PAR::Dist, PAR::Repository, etc.
PAR::Repository::Query implements the querying interface. The methods described in that module's documentation can be called on PAR::Repository::Client objects.
PAR::Repository::Client
PAR::Repository implements the server side creation and manipulation of PAR repositories.
PAR::WebStart is doing something similar but is otherwise unrelated.
Steffen Mueller, <smueller@cpan.org>
Copyright 2006-2009 by Steffen Mueller
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6 or, at your option, any later version of Perl 5 you may have available.
To install PAR::Repository::Client, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PAR::Repository::Client
CPAN shell
perl -MCPAN -e shell install PAR::Repository::Client
For more information on module installation, please visit the detailed CPAN module installation guide.