[dbsrgits/DBIx-Class-DeploymentHandler.git] / lib / DBIx / Class / DeploymentHandler / HandlesVersioning.pm

package DBIx::Class::DeploymentHandler::HandlesVersioning;
use Moose::Role;

# note: the sets returned need to match!
requires 'next_version_set';
requires 'previous_version_set';

1;

__END__

# normally a VersionHandler will take
# a to_version and yeild an iterator of
# "version sets" or something like that.
#
# A "version set" is basically an arrayref
# of "version numbers" (which we already know
# is vague as is.)  Typically an call to a
# VH w/ a db version of 1 and a "to_version"
# of 5 will iterate over something like this:
# [1, 2]
# [2, 3]
# [3, 4]
# [4, 5]
#
# Of course rob wants to be able to have dep
# management with his versions, so I *think* his
# would work like this:
#
# to_version = 7, db_version = 1
# [1]
# [5]
# [7]
#
# Because 7 depended on 5, 5 was installed first;
# note that this potentially never released module
# doesn't use version pairs, instead it just yeilds
# versions.  Version pairs are too much work for users
# to have to deal with in that sitation.  We may
# actually switch to this for other versioners.
#
# The upshot of all this is that the DeploymentMethod
# needs to be able to take an ArrayRef[VersionNumber],
# instead of just a pair of VersionNumber.
vim: ts=2 sw=2 expandtab
Commit	Line	Data
24794769	1	package DBIx::Class::DeploymentHandler::HandlesVersioning;
	2	use Moose::Role;
	3
f344dd91	4	# note: the sets returned need to match!
24794769	5	requires 'next_version_set';
f344dd91	6	requires 'previous_version_set';
24794769	7
24794769	8	1;
	9
	10	__END__
	11
	12	# normally a VersionHandler will take
	13	# a to_version and yeild an iterator of
	14	# "version sets" or something like that.
	15	#
	16	# A "version set" is basically an arrayref
	17	# of "version numbers" (which we already know
	18	# is vague as is.) Typically an call to a
	19	# VH w/ a db version of 1 and a "to_version"
	20	# of 5 will iterate over something like this:
	21	# [1, 2]
	22	# [2, 3]
	23	# [3, 4]
	24	# [4, 5]
	25	#
	26	# Of course rob wants to be able to have dep
	27	# management with his versions, so I think his
	28	# would work like this:
	29	#
	30	# to_version = 7, db_version = 1
	31	# [1]
	32	# [5]
	33	# [7]
	34	#
	35	# Because 7 depended on 5, 5 was installed first;
	36	# note that this potentially never released module
	37	# doesn't use version pairs, instead it just yeilds
	38	# versions. Version pairs are too much work for users
	39	# to have to deal with in that sitation. We may
	40	# actually switch to this for other versioners.
	41	#
	42	# The upshot of all this is that the DeploymentMethod
	43	# needs to be able to take an ArrayRef[VersionNumber],
	44	# instead of just a pair of VersionNumber.
	45	vim: ts=2 sw=2 expandtab