NAME

Conjury::Stage - Perl Conjury staging areas

SYNOPSIS

  use Conjury::Stage;

  $stage = Conjury::Stage->new ( I<HASH> );
  $stage->make_subdir ( F<filename> );

  ($basedir, $subdir) = find_stage ( F<directory> );

DESCRIPTION

The Conjury::Stage module defines the object class used to model a staging area for intermediate constructions. A stage contains a journal object and methods for creating new subdirectories in the staging area. The find_stage function is also defined for parsing a pathname and returning the base directory of the stage and the relative remainer of the pathname.

A "stage" is an association between a directory and a journal object mapped to a file in that directory with a standard name. On most platforms, journal files in a stage are named .conjury-journal, but some filesystems have funny conventions so your experience may vary.

Conjury::Stage->new

Creates a stage object associated with a directory. The arguments are named in a hash. All of them are optional.

Use the optional 'Directory' argument to associate the stage with a directory other than the one associated with the current context.

Use the optional 'Journal' argument to associate the stage explicitly with a specific journal object.

$stage->make_subdir(directory)

Creates a subdirectory within the stage. The named subdirectory must be specified by relative path. The subdirectory is created during the compile phase.

Exported Functions

There is only one exported function: find_stage. Whether this should be only made available as an object method is an argument not settled yet.

find_stage directory

Finds the stage object for the specified directory.

In array context, this returns a 2-tuple of the base directory for the stage object and the relative path from the base to specified directory.

AUTHOR

James Woodyatt <jhw@wetware.com>