Bio::GMOD::Util::CheckVersions - Find current versions of GMOD installations
use Bio::GMOD::Util::CheckVersions; my $gmod = Bio::GMOD::Util::CheckVersions->new(-mod => 'WormBase'); my $live = $gmod->live_version(); my $dev = $gmod->development_version(); my $local = $gmod->local_version();
Bio::GMOD::Util::CheckVersions provides several methods for determining the current live and development versions of a MOD. In addition it includes several methods for fetching locally installed version as well as versions of installed packages, useful for updating and archiving purposes.
By providing live_url annd version_cgi_live in the MOD adaptor defaults -- as well as installing a suitable CGI, no additional subclassing will be necessary. Likewise, to provide easy access to development versions, provide the development_url and version_cgi_dev variables.
Alternatively, you may provide custom methods for live_version, development_version, and local_version by subclassing Bio::GMOD::Util::CheckVersions, using the name of the MOD.
Create a new Bio::GMOD::Util::CheckVersions object.
Fetch the version of the current live release. Called in scalar context, this method returns the corresponding version; otherwise it returns a hash with keys of:
status The status of the version check request url The URL of the site checked title The title of the database description A brief description of the MOD version The installed version at the site released The date the current version was released
live_version() fetches the version from the master WormBase site at www.wormbase.org,
Fetch the version of the current development release. Behaves as live_version() described above but for the development server of the current MOD, if one exists. Called in scalar context, development_version() returns the version, otherwise it returns the same hash described for live_version();
Check the version and release date for any of the generic mirror site. Called in scalar context, mirror_version() returns the installed version, otherwise it returns the same hash described for live_version();
Required options: -site url for site to fetch the version from (http://caltech.wormbase.org/) -cgi the relative path to the version CGI (ie /cgi-bin/version)
local_version() should be supplied by a MOD specific CheckVersions subclass.
Read the symlink at the provided path. This is useful, for example, when an installation uses a top-level symlink to point at the currently installed version of a release. In these cases, read_symlink() can be used to fetch the currently installed version.
Check the version at the provided site returning a hash of status, title, version, released, and site. This subroutine relies on the small CGI script located at /db/util/dump_version on each site.
Todd Harris <email@example.com>.
Copyright (c) 2003-2005 Cold Spring Harbor Laboratory.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.