NAME

DiaColloDB::Upgrade - DiaColloDB utilities: auto-magic upgrades: top level

SYNOPSIS

##========================================================================
## PRELIMINARIES

use DiaColloDB::Upgrade;

##========================================================================
## Top-level

@upgrades = $CLASS_OR_OBJECT->available();
@needed = $CLASS_OR_OBJECT->needed($coldb, @upgrades);
$bool = $CLASS_OR_OBJECT->upgrade($coldb, @upgrades);

DESCRIPTION

DiaColloDB::Upgrade is a convenience package for performing automatic in-place upgrades to DiaColloDB database directories, used by the dcdb-upgrade.perl script included in the DiaColloDB distribution.

Globals

Variable: @ISA

DiaColloDB::Upgrade inherits from DiaColloDB::Logger.

Variable: @upgrades

An ARRAY of available automagic upgrade sub-packages (DiaColloDB::Upgrade:: suffixes).

Top-level

available

@upgrades = $CLASS_OR_OBJECT->available();

Returns list of available upgrade-packages (DiaColloDB::Upgrade:: suffixes).

needed

@needed = $CLASS_OR_OBJECT->needed($coldb, @upgrades);

Returns list of those upgrades in @upgrades which are applicable to $coldb.

upgrade

$bool = $CLASS_OR_OBJECT->upgrade($coldb, @upgrades);

Force-applies upgrades in @upgrades to $coldb.

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2016 by Bryan Jurish

This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.

SEE ALSO

dcdb-upgrade.perl(1), DiaColloDB::Upgrade::Base(3pm), DiaColloDB::Upgrade::v0_08_to_v0_09_multimap(3pm), DiaColloDB(3pm), perl(1), ...