Perl::Dist::WiX::Mixin::Checkpoint - Checkpoint support for Perl::Dist::WiX

This document describes Perl::Dist::WiX::Mixin::Checkpoint version 1.500002.

	# This module is not to be used independently.
	# It provides methods to be called on a Perl::Dist::WiX object.

	$dist = Perl::Dist::WiX->new(
		# ...
		checkpoint_before => 5,
		checkpoint_after => [8, 9],
		checkpoint_stop => 9,
		# ...
	);

This module provides the routines that Perl::Dist::WiX uses in order to support checkpointing.

There are 2 portions to the interface to this module - the parameters to new() (documented in that module), and the object methods that Perl::Dist::WiX uses to coordinate checkpointing, as described below.

These routines are not meant to be called from external classes. Perl::Dist::WiX calls these routines as required.

checkpoint_task executes a portion of creating an installer.

The first parameter is the name of the subroutine to be executed.

The second parameter is the task number that goes with that subroutine.

Returns true (technically, the object that called it), or throws an exception.

This routine is called for each task (a task is a method on Perl::Dist::WiX or a subclass of it) defined in the tasklist parameter to Perl::Dist::WiX-new()>.

Returns the file that the Perl::Dist::WiX object is stored in when checkpoint_save is called.

Currently unimplemented, and throws an exception saying so.

Saves a checkpoint within the checkpoint subdirectory of Perl::Dist::WiX->temp_dir()

Restores a checkpoint saved to the checkpoint subdirectory of Perl::Dist::WiX->temp_dir() with checkpoint_save.

See Perl::Dist::WiX::Diagnostics (Perl::Dist::WiX::Diagnostics) for a list of exceptions that this module can throw.

WARNING: The checkpointing facility in this module is NOT stable. It is currently implemented using Storable with the $Storable::Deparse variable set to 1 (localized, of course). This probably WILL change in the future, as when checkpoints are reloaded, hash entries are appearing that weren't intended to be there. I am also not sure that references that were weakened are weakened when reloaded.

Restored checkpoints currently crash with "Free in wrong pool" errors in global destruction - if an exception occurs, they're reported there instead.

Do NOT use this in production. Debugging a distribution using the facilities provided here is fine.

Bugs should be reported via:

1) The CPAN bug tracker at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Perl-Dist-WiX if you have an account there.

2) Email to <bug-Perl-Dist-WiX@rt.cpan.org> if you do not.

For other issues, contact the topmost author.

Curtis Jewell <csjewell@cpan.org>

Adam Kennedy <adamk@cpan.org>

Perl::Dist, Perl::Dist::WiX, http://ali.as/, http://csjewell.comyr.com/perl/

Copyright 2009 - 2010 Curtis Jewell.

Copyright 2008 - 2009 Adam Kennedy.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this distribution.