[Bps-public-commit] r16612 - in String-BufferStack: . inc inc/.author inc/Module inc/Module/Install lib t

alexmv at bestpractical.com alexmv at bestpractical.com
Wed Oct 29 19:42:03 EDT 2008


Author: alexmv
Date: Wed Oct 29 19:42:02 2008
New Revision: 16612

Added:
   String-BufferStack/META.yml
   String-BufferStack/Makefile.PL
   String-BufferStack/inc/
   String-BufferStack/inc/.author/
   String-BufferStack/inc/Module/
   String-BufferStack/inc/Module/Install/
   String-BufferStack/inc/Module/Install.pm
   String-BufferStack/inc/Module/Install/Base.pm
   String-BufferStack/inc/Module/Install/Can.pm
   String-BufferStack/inc/Module/Install/Fetch.pm
   String-BufferStack/inc/Module/Install/Makefile.pm
   String-BufferStack/inc/Module/Install/Metadata.pm
   String-BufferStack/inc/Module/Install/Win32.pm
   String-BufferStack/inc/Module/Install/WriteAll.pm
   String-BufferStack/lib/
   String-BufferStack/lib/String/
   String-BufferStack/lib/String/BufferStack.pm
   String-BufferStack/t/
   String-BufferStack/t/01-basic.t
   String-BufferStack/t/02-simple-stack.t
   String-BufferStack/t/03-capture.t
   String-BufferStack/t/04-filter.t
   String-BufferStack/t/05-data.t
   String-BufferStack/t/06-preappend.t
Modified:
   String-BufferStack/   (props changed)

Log:
 r38718 at kohr-ah:  chmrr | 2008-10-29 19:41:57 -0400
  * First revision


Added: String-BufferStack/META.yml
==============================================================================
--- (empty file)
+++ String-BufferStack/META.yml	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,16 @@
+--- 
+abstract: Nested buffers for templating systems
+author: 
+  - Alex Vandiver <alexmv at bestpractical.com>
+distribution_type: module
+generated_by: Module::Install version 0.68
+license: Artistic
+meta-spec: 
+  url: http://module-build.sourceforge.net/META-spec-v1.3.html
+  version: 1.3
+name: String-BufferStack
+no_index: 
+  directory: 
+    - inc
+    - t
+version: undef

Added: String-BufferStack/Makefile.PL
==============================================================================
--- (empty file)
+++ String-BufferStack/Makefile.PL	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,9 @@
+use inc::Module::Install;
+
+name ('String-BufferStack');
+author ('Alex Vandiver <alexmv at bestpractical.com>');
+version_from ('lib/String/BufferStack.pm');
+abstract_from('lib/String/BufferStack.pm');
+license('Artistic');
+
+&WriteAll;

Added: String-BufferStack/inc/Module/Install.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/inc/Module/Install.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,281 @@
+#line 1
+package Module::Install;
+
+# For any maintainers:
+# The load order for Module::Install is a bit magic.
+# It goes something like this...
+#
+# IF ( host has Module::Install installed, creating author mode ) {
+#     1. Makefile.PL calls "use inc::Module::Install"
+#     2. $INC{inc/Module/Install.pm} set to installed version of inc::Module::Install
+#     3. The installed version of inc::Module::Install loads
+#     4. inc::Module::Install calls "require Module::Install"
+#     5. The ./inc/ version of Module::Install loads
+# } ELSE {
+#     1. Makefile.PL calls "use inc::Module::Install"
+#     2. $INC{inc/Module/Install.pm} set to ./inc/ version of Module::Install
+#     3. The ./inc/ version of Module::Install loads
+# }
+
+use 5.004;
+use strict 'vars';
+
+use vars qw{$VERSION};
+BEGIN {
+    # All Module::Install core packages now require synchronised versions.
+    # This will be used to ensure we don't accidentally load old or
+    # different versions of modules.
+    # This is not enforced yet, but will be some time in the next few
+    # releases once we can make sure it won't clash with custom
+    # Module::Install extensions.
+    $VERSION = '0.68';
+}
+
+# Whether or not inc::Module::Install is actually loaded, the
+# $INC{inc/Module/Install.pm} is what will still get set as long as
+# the caller loaded module this in the documented manner.
+# If not set, the caller may NOT have loaded the bundled version, and thus
+# they may not have a MI version that works with the Makefile.PL. This would
+# result in false errors or unexpected behaviour. And we don't want that.
+my $file = join( '/', 'inc', split /::/, __PACKAGE__ ) . '.pm';
+unless ( $INC{$file} ) {
+    die <<"END_DIE";
+Please invoke ${\__PACKAGE__} with:
+
+    use inc::${\__PACKAGE__};
+
+not:
+
+    use ${\__PACKAGE__};
+
+END_DIE
+}
+
+# If the script that is loading Module::Install is from the future,
+# then make will detect this and cause it to re-run over and over
+# again. This is bad. Rather than taking action to touch it (which
+# is unreliable on some platforms and requires write permissions)
+# for now we should catch this and refuse to run.
+if ( -f $0 and (stat($0))[9] > time ) {
+	die << "END_DIE";
+Your installer $0 has a modification time in the future.
+
+This is known to create infinite loops in make.
+
+Please correct this, then run $0 again.
+
+END_DIE
+}
+
+use Cwd        ();
+use File::Find ();
+use File::Path ();
+use FindBin;
+
+*inc::Module::Install::VERSION = *VERSION;
+ at inc::Module::Install::ISA     = __PACKAGE__;
+
+sub autoload {
+    my $self = shift;
+    my $who  = $self->_caller;
+    my $cwd  = Cwd::cwd();
+    my $sym  = "${who}::AUTOLOAD";
+    $sym->{$cwd} = sub {
+        my $pwd = Cwd::cwd();
+        if ( my $code = $sym->{$pwd} ) {
+            # delegate back to parent dirs
+            goto &$code unless $cwd eq $pwd;
+        }
+        $$sym =~ /([^:]+)$/ or die "Cannot autoload $who - $sym";
+        unshift @_, ($self, $1);
+        goto &{$self->can('call')} unless uc($1) eq $1;
+    };
+}
+
+sub import {
+    my $class = shift;
+    my $self  = $class->new(@_);
+    my $who   = $self->_caller;
+
+    unless ( -f $self->{file} ) {
+        require "$self->{path}/$self->{dispatch}.pm";
+        File::Path::mkpath("$self->{prefix}/$self->{author}");
+        $self->{admin} = "$self->{name}::$self->{dispatch}"->new( _top => $self );
+        $self->{admin}->init;
+        @_ = ($class, _self => $self);
+        goto &{"$self->{name}::import"};
+    }
+
+    *{"${who}::AUTOLOAD"} = $self->autoload;
+    $self->preload;
+
+    # Unregister loader and worker packages so subdirs can use them again
+    delete $INC{"$self->{file}"};
+    delete $INC{"$self->{path}.pm"};
+}
+
+sub preload {
+    my ($self) = @_;
+
+    unless ( $self->{extensions} ) {
+        $self->load_extensions(
+            "$self->{prefix}/$self->{path}", $self
+        );
+    }
+
+    my @exts = @{$self->{extensions}};
+    unless ( @exts ) {
+        my $admin = $self->{admin};
+        @exts = $admin->load_all_extensions;
+    }
+
+    my %seen;
+    foreach my $obj ( @exts ) {
+        while (my ($method, $glob) = each %{ref($obj) . '::'}) {
+            next unless $obj->can($method);
+            next if $method =~ /^_/;
+            next if $method eq uc($method);
+            $seen{$method}++;
+        }
+    }
+
+    my $who = $self->_caller;
+    foreach my $name ( sort keys %seen ) {
+        *{"${who}::$name"} = sub {
+            ${"${who}::AUTOLOAD"} = "${who}::$name";
+            goto &{"${who}::AUTOLOAD"};
+        };
+    }
+}
+
+sub new {
+    my ($class, %args) = @_;
+
+    # ignore the prefix on extension modules built from top level.
+    my $base_path = Cwd::abs_path($FindBin::Bin);
+    unless ( Cwd::abs_path(Cwd::cwd()) eq $base_path ) {
+        delete $args{prefix};
+    }
+
+    return $args{_self} if $args{_self};
+
+    $args{dispatch} ||= 'Admin';
+    $args{prefix}   ||= 'inc';
+    $args{author}   ||= ($^O eq 'VMS' ? '_author' : '.author');
+    $args{bundle}   ||= 'inc/BUNDLES';
+    $args{base}     ||= $base_path;
+    $class =~ s/^\Q$args{prefix}\E:://;
+    $args{name}     ||= $class;
+    $args{version}  ||= $class->VERSION;
+    unless ( $args{path} ) {
+        $args{path}  = $args{name};
+        $args{path}  =~ s!::!/!g;
+    }
+    $args{file}     ||= "$args{base}/$args{prefix}/$args{path}.pm";
+
+    bless( \%args, $class );
+}
+
+sub call {
+	my ($self, $method) = @_;
+	my $obj = $self->load($method) or return;
+        splice(@_, 0, 2, $obj);
+	goto &{$obj->can($method)};
+}
+
+sub load {
+    my ($self, $method) = @_;
+
+    $self->load_extensions(
+        "$self->{prefix}/$self->{path}", $self
+    ) unless $self->{extensions};
+
+    foreach my $obj (@{$self->{extensions}}) {
+        return $obj if $obj->can($method);
+    }
+
+    my $admin = $self->{admin} or die <<"END_DIE";
+The '$method' method does not exist in the '$self->{prefix}' path!
+Please remove the '$self->{prefix}' directory and run $0 again to load it.
+END_DIE
+
+    my $obj = $admin->load($method, 1);
+    push @{$self->{extensions}}, $obj;
+
+    $obj;
+}
+
+sub load_extensions {
+    my ($self, $path, $top) = @_;
+
+    unless ( grep { lc $_ eq lc $self->{prefix} } @INC ) {
+        unshift @INC, $self->{prefix};
+    }
+
+    foreach my $rv ( $self->find_extensions($path) ) {
+        my ($file, $pkg) = @{$rv};
+        next if $self->{pathnames}{$pkg};
+
+        local $@;
+        my $new = eval { require $file; $pkg->can('new') };
+        unless ( $new ) {
+            warn $@ if $@;
+            next;
+        }
+        $self->{pathnames}{$pkg} = delete $INC{$file};
+        push @{$self->{extensions}}, &{$new}($pkg, _top => $top );
+    }
+
+    $self->{extensions} ||= [];
+}
+
+sub find_extensions {
+    my ($self, $path) = @_;
+
+    my @found;
+    File::Find::find( sub {
+        my $file = $File::Find::name;
+        return unless $file =~ m!^\Q$path\E/(.+)\.pm\Z!is;
+        my $subpath = $1;
+        return if lc($subpath) eq lc($self->{dispatch});
+
+        $file = "$self->{path}/$subpath.pm";
+        my $pkg = "$self->{name}::$subpath";
+        $pkg =~ s!/!::!g;
+
+        # If we have a mixed-case package name, assume case has been preserved
+        # correctly.  Otherwise, root through the file to locate the case-preserved
+        # version of the package name.
+        if ( $subpath eq lc($subpath) || $subpath eq uc($subpath) ) {
+            open PKGFILE, "<$subpath.pm" or die "find_extensions: Can't open $subpath.pm: $!";
+            my $in_pod = 0;
+            while ( <PKGFILE> ) {
+                $in_pod = 1 if /^=\w/;
+                $in_pod = 0 if /^=cut/;
+                next if ($in_pod || /^=cut/);  # skip pod text
+                next if /^\s*#/;               # and comments
+                if ( m/^\s*package\s+($pkg)\s*;/i ) {
+                    $pkg = $1;
+                    last;
+                }
+            }
+            close PKGFILE;
+        }
+
+        push @found, [ $file, $pkg ];
+    }, $path ) if -d $path;
+
+    @found;
+}
+
+sub _caller {
+    my $depth = 0;
+    my $call  = caller($depth);
+    while ( $call eq __PACKAGE__ ) {
+        $depth++;
+        $call = caller($depth);
+    }
+    return $call;
+}
+
+1;

Added: String-BufferStack/inc/Module/Install/Base.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/inc/Module/Install/Base.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,70 @@
+#line 1
+package Module::Install::Base;
+
+$VERSION = '0.68';
+
+# Suspend handler for "redefined" warnings
+BEGIN {
+	my $w = $SIG{__WARN__};
+	$SIG{__WARN__} = sub { $w };
+}
+
+### This is the ONLY module that shouldn't have strict on
+# use strict;
+
+#line 41
+
+sub new {
+    my ($class, %args) = @_;
+
+    foreach my $method ( qw(call load) ) {
+        *{"$class\::$method"} = sub {
+            shift()->_top->$method(@_);
+        } unless defined &{"$class\::$method"};
+    }
+
+    bless( \%args, $class );
+}
+
+#line 61
+
+sub AUTOLOAD {
+    my $self = shift;
+    local $@;
+    my $autoload = eval { $self->_top->autoload } or return;
+    goto &$autoload;
+}
+
+#line 76
+
+sub _top { $_[0]->{_top} }
+
+#line 89
+
+sub admin {
+    $_[0]->_top->{admin} or Module::Install::Base::FakeAdmin->new;
+}
+
+sub is_admin {
+    $_[0]->admin->VERSION;
+}
+
+sub DESTROY {}
+
+package Module::Install::Base::FakeAdmin;
+
+my $Fake;
+sub new { $Fake ||= bless(\@_, $_[0]) }
+
+sub AUTOLOAD {}
+
+sub DESTROY {}
+
+# Restore warning handler
+BEGIN {
+	$SIG{__WARN__} = $SIG{__WARN__}->();
+}
+
+1;
+
+#line 138

Added: String-BufferStack/inc/Module/Install/Can.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/inc/Module/Install/Can.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,82 @@
+#line 1
+package Module::Install::Can;
+
+use strict;
+use Module::Install::Base;
+use Config ();
+### This adds a 5.005 Perl version dependency.
+### This is a bug and will be fixed.
+use File::Spec ();
+use ExtUtils::MakeMaker ();
+
+use vars qw{$VERSION $ISCORE @ISA};
+BEGIN {
+	$VERSION = '0.68';
+	$ISCORE  = 1;
+	@ISA     = qw{Module::Install::Base};
+}
+
+# check if we can load some module
+### Upgrade this to not have to load the module if possible
+sub can_use {
+	my ($self, $mod, $ver) = @_;
+	$mod =~ s{::|\\}{/}g;
+	$mod .= '.pm' unless $mod =~ /\.pm$/i;
+
+	my $pkg = $mod;
+	$pkg =~ s{/}{::}g;
+	$pkg =~ s{\.pm$}{}i;
+
+	local $@;
+	eval { require $mod; $pkg->VERSION($ver || 0); 1 };
+}
+
+# check if we can run some command
+sub can_run {
+	my ($self, $cmd) = @_;
+
+	my $_cmd = $cmd;
+	return $_cmd if (-x $_cmd or $_cmd = MM->maybe_command($_cmd));
+
+	for my $dir ((split /$Config::Config{path_sep}/, $ENV{PATH}), '.') {
+		my $abs = File::Spec->catfile($dir, $_[1]);
+		return $abs if (-x $abs or $abs = MM->maybe_command($abs));
+	}
+
+	return;
+}
+
+# can we locate a (the) C compiler
+sub can_cc {
+	my $self   = shift;
+	my @chunks = split(/ /, $Config::Config{cc}) or return;
+
+	# $Config{cc} may contain args; try to find out the program part
+	while (@chunks) {
+		return $self->can_run("@chunks") || (pop(@chunks), next);
+	}
+
+	return;
+}
+
+# Fix Cygwin bug on maybe_command();
+if ( $^O eq 'cygwin' ) {
+	require ExtUtils::MM_Cygwin;
+	require ExtUtils::MM_Win32;
+	if ( ! defined(&ExtUtils::MM_Cygwin::maybe_command) ) {
+		*ExtUtils::MM_Cygwin::maybe_command = sub {
+			my ($self, $file) = @_;
+			if ($file =~ m{^/cygdrive/}i and ExtUtils::MM_Win32->can('maybe_command')) {
+				ExtUtils::MM_Win32->maybe_command($file);
+			} else {
+				ExtUtils::MM_Unix->maybe_command($file);
+			}
+		}
+	}
+}
+
+1;
+
+__END__
+
+#line 157

Added: String-BufferStack/inc/Module/Install/Fetch.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/inc/Module/Install/Fetch.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,93 @@
+#line 1
+package Module::Install::Fetch;
+
+use strict;
+use Module::Install::Base;
+
+use vars qw{$VERSION $ISCORE @ISA};
+BEGIN {
+	$VERSION = '0.68';
+	$ISCORE  = 1;
+	@ISA     = qw{Module::Install::Base};
+}
+
+sub get_file {
+    my ($self, %args) = @_;
+    my ($scheme, $host, $path, $file) = 
+        $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return;
+
+    if ( $scheme eq 'http' and ! eval { require LWP::Simple; 1 } ) {
+        $args{url} = $args{ftp_url}
+            or (warn("LWP support unavailable!\n"), return);
+        ($scheme, $host, $path, $file) = 
+            $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return;
+    }
+
+    $|++;
+    print "Fetching '$file' from $host... ";
+
+    unless (eval { require Socket; Socket::inet_aton($host) }) {
+        warn "'$host' resolve failed!\n";
+        return;
+    }
+
+    return unless $scheme eq 'ftp' or $scheme eq 'http';
+
+    require Cwd;
+    my $dir = Cwd::getcwd();
+    chdir $args{local_dir} or return if exists $args{local_dir};
+
+    if (eval { require LWP::Simple; 1 }) {
+        LWP::Simple::mirror($args{url}, $file);
+    }
+    elsif (eval { require Net::FTP; 1 }) { eval {
+        # use Net::FTP to get past firewall
+        my $ftp = Net::FTP->new($host, Passive => 1, Timeout => 600);
+        $ftp->login("anonymous", 'anonymous at example.com');
+        $ftp->cwd($path);
+        $ftp->binary;
+        $ftp->get($file) or (warn("$!\n"), return);
+        $ftp->quit;
+    } }
+    elsif (my $ftp = $self->can_run('ftp')) { eval {
+        # no Net::FTP, fallback to ftp.exe
+        require FileHandle;
+        my $fh = FileHandle->new;
+
+        local $SIG{CHLD} = 'IGNORE';
+        unless ($fh->open("|$ftp -n")) {
+            warn "Couldn't open ftp: $!\n";
+            chdir $dir; return;
+        }
+
+        my @dialog = split(/\n/, <<"END_FTP");
+open $host
+user anonymous anonymous\@example.com
+cd $path
+binary
+get $file $file
+quit
+END_FTP
+        foreach (@dialog) { $fh->print("$_\n") }
+        $fh->close;
+    } }
+    else {
+        warn "No working 'ftp' program available!\n";
+        chdir $dir; return;
+    }
+
+    unless (-f $file) {
+        warn "Fetching failed: $@\n";
+        chdir $dir; return;
+    }
+
+    return if exists $args{size} and -s $file != $args{size};
+    system($args{run}) if exists $args{run};
+    unlink($file) if $args{remove};
+
+    print(((!exists $args{check_for} or -e $args{check_for})
+        ? "done!" : "failed! ($!)"), "\n");
+    chdir $dir; return !$?;
+}
+
+1;

Added: String-BufferStack/inc/Module/Install/Makefile.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/inc/Module/Install/Makefile.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,237 @@
+#line 1
+package Module::Install::Makefile;
+
+use strict 'vars';
+use Module::Install::Base;
+use ExtUtils::MakeMaker ();
+
+use vars qw{$VERSION $ISCORE @ISA};
+BEGIN {
+	$VERSION = '0.68';
+	$ISCORE  = 1;
+	@ISA     = qw{Module::Install::Base};
+}
+
+sub Makefile { $_[0] }
+
+my %seen = ();
+
+sub prompt {
+	shift;
+
+	# Infinite loop protection
+	my @c = caller();
+	if ( ++$seen{"$c[1]|$c[2]|$_[0]"} > 3 ) {
+		die "Caught an potential prompt infinite loop ($c[1]|$c[2]|$_[0])";
+	}
+
+	# In automated testing, always use defaults
+	if ( $ENV{AUTOMATED_TESTING} and ! $ENV{PERL_MM_USE_DEFAULT} ) {
+		local $ENV{PERL_MM_USE_DEFAULT} = 1;
+		goto &ExtUtils::MakeMaker::prompt;
+	} else {
+		goto &ExtUtils::MakeMaker::prompt;
+	}
+}
+
+sub makemaker_args {
+	my $self = shift;
+	my $args = ($self->{makemaker_args} ||= {});
+	%$args = ( %$args, @_ ) if @_;
+	$args;
+}
+
+# For mm args that take multiple space-seperated args,
+# append an argument to the current list.
+sub makemaker_append {
+	my $self = sShift;
+	my $name = shift;
+	my $args = $self->makemaker_args;
+	$args->{name} = defined $args->{$name}
+		? join( ' ', $args->{name}, @_ )
+		: join( ' ', @_ );
+}
+
+sub build_subdirs {
+	my $self    = shift;
+	my $subdirs = $self->makemaker_args->{DIR} ||= [];
+	for my $subdir (@_) {
+		push @$subdirs, $subdir;
+	}
+}
+
+sub clean_files {
+	my $self  = shift;
+	my $clean = $self->makemaker_args->{clean} ||= {};
+	%$clean = (
+		%$clean, 
+		FILES => join(' ', grep length, $clean->{FILES}, @_),
+	);
+}
+
+sub realclean_files {
+	my $self  = shift;
+	my $realclean = $self->makemaker_args->{realclean} ||= {};
+	%$realclean = (
+		%$realclean, 
+		FILES => join(' ', grep length, $realclean->{FILES}, @_),
+	);
+}
+
+sub libs {
+	my $self = shift;
+	my $libs = ref $_[0] ? shift : [ shift ];
+	$self->makemaker_args( LIBS => $libs );
+}
+
+sub inc {
+	my $self = shift;
+	$self->makemaker_args( INC => shift );
+}
+
+my %test_dir = ();
+
+sub _wanted_t {
+	/\.t$/ and -f $_ and $test_dir{$File::Find::dir} = 1;
+}
+
+sub tests_recursive {
+	my $self = shift;
+	if ( $self->tests ) {
+		die "tests_recursive will not work if tests are already defined";
+	}
+	my $dir = shift || 't';
+	unless ( -d $dir ) {
+		die "tests_recursive dir '$dir' does not exist";
+	}
+	require File::Find;
+	%test_dir = ();
+	File::Find::find( \&_wanted_t, $dir );
+	$self->tests( join ' ', map { "$_/*.t" } sort keys %test_dir );
+}
+
+sub write {
+	my $self = shift;
+	die "&Makefile->write() takes no arguments\n" if @_;
+
+	my $args = $self->makemaker_args;
+	$args->{DISTNAME} = $self->name;
+	$args->{NAME}     = $self->module_name || $self->name || $self->determine_NAME($args);
+	$args->{VERSION}  = $self->version || $self->determine_VERSION($args);
+	$args->{NAME}     =~ s/-/::/g;
+	if ( $self->tests ) {
+		$args->{test} = { TESTS => $self->tests };
+	}
+	if ($] >= 5.005) {
+		$args->{ABSTRACT} = $self->abstract;
+		$args->{AUTHOR}   = $self->author;
+	}
+	if ( eval($ExtUtils::MakeMaker::VERSION) >= 6.10 ) {
+		$args->{NO_META} = 1;
+	}
+	if ( eval($ExtUtils::MakeMaker::VERSION) > 6.17 and $self->sign ) {
+		$args->{SIGN} = 1;
+	}
+	unless ( $self->is_admin ) {
+		delete $args->{SIGN};
+	}
+
+	# merge both kinds of requires into prereq_pm
+	my $prereq = ($args->{PREREQ_PM} ||= {});
+	%$prereq = ( %$prereq,
+		map { @$_ }
+		map { @$_ }
+		grep $_,
+		($self->build_requires, $self->requires)
+	);
+
+	# merge both kinds of requires into prereq_pm
+	my $subdirs = ($args->{DIR} ||= []);
+	if ($self->bundles) {
+		foreach my $bundle (@{ $self->bundles }) {
+			my ($file, $dir) = @$bundle;
+			push @$subdirs, $dir if -d $dir;
+			delete $prereq->{$file};
+		}
+	}
+
+	if ( my $perl_version = $self->perl_version ) {
+		eval "use $perl_version; 1"
+			or die "ERROR: perl: Version $] is installed, "
+			. "but we need version >= $perl_version";
+	}
+
+	$args->{INSTALLDIRS} = $self->installdirs;
+
+	my %args = map { ( $_ => $args->{$_} ) } grep {defined($args->{$_})} keys %$args;
+
+	my $user_preop = delete $args{dist}->{PREOP};
+	if (my $preop = $self->admin->preop($user_preop)) {
+		$args{dist} = $preop;
+	}
+
+	my $mm = ExtUtils::MakeMaker::WriteMakefile(%args);
+	$self->fix_up_makefile($mm->{FIRST_MAKEFILE} || 'Makefile');
+}
+
+sub fix_up_makefile {
+	my $self          = shift;
+	my $makefile_name = shift;
+	my $top_class     = ref($self->_top) || '';
+	my $top_version   = $self->_top->VERSION || '';
+
+	my $preamble = $self->preamble 
+		? "# Preamble by $top_class $top_version\n"
+			. $self->preamble
+		: '';
+	my $postamble = "# Postamble by $top_class $top_version\n"
+		. ($self->postamble || '');
+
+	local *MAKEFILE;
+	open MAKEFILE, "< $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!";
+	my $makefile = do { local $/; <MAKEFILE> };
+	close MAKEFILE or die $!;
+
+	$makefile =~ s/\b(test_harness\(\$\(TEST_VERBOSE\), )/$1'inc', /;
+	$makefile =~ s/( -I\$\(INST_ARCHLIB\))/ -Iinc$1/g;
+	$makefile =~ s/( "-I\$\(INST_LIB\)")/ "-Iinc"$1/g;
+	$makefile =~ s/^(FULLPERL = .*)/$1 "-Iinc"/m;
+	$makefile =~ s/^(PERL = .*)/$1 "-Iinc"/m;
+
+	# Module::Install will never be used to build the Core Perl
+	# Sometimes PERL_LIB and PERL_ARCHLIB get written anyway, which breaks
+	# PREFIX/PERL5LIB, and thus, install_share. Blank them if they exist
+	$makefile =~ s/^PERL_LIB = .+/PERL_LIB =/m;
+	#$makefile =~ s/^PERL_ARCHLIB = .+/PERL_ARCHLIB =/m;
+
+	# Perl 5.005 mentions PERL_LIB explicitly, so we have to remove that as well.
+	$makefile =~ s/("?)-I\$\(PERL_LIB\)\1//g;
+
+	# XXX - This is currently unused; not sure if it breaks other MM-users
+	# $makefile =~ s/^pm_to_blib\s+:\s+/pm_to_blib :: /mg;
+
+	open  MAKEFILE, "> $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!";
+	print MAKEFILE  "$preamble$makefile$postamble" or die $!;
+	close MAKEFILE  or die $!;
+
+	1;
+}
+
+sub preamble {
+	my ($self, $text) = @_;
+	$self->{preamble} = $text . $self->{preamble} if defined $text;
+	$self->{preamble};
+}
+
+sub postamble {
+	my ($self, $text) = @_;
+	$self->{postamble} ||= $self->admin->postamble;
+	$self->{postamble} .= $text if defined $text;
+	$self->{postamble}
+}
+
+1;
+
+__END__
+
+#line 363

Added: String-BufferStack/inc/Module/Install/Metadata.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/inc/Module/Install/Metadata.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,336 @@
+#line 1
+package Module::Install::Metadata;
+
+use strict 'vars';
+use Module::Install::Base;
+
+use vars qw{$VERSION $ISCORE @ISA};
+BEGIN {
+	$VERSION = '0.68';
+	$ISCORE  = 1;
+	@ISA     = qw{Module::Install::Base};
+}
+
+my @scalar_keys = qw{
+    name module_name abstract author version license
+    distribution_type perl_version tests installdirs
+};
+
+my @tuple_keys = qw{
+    build_requires requires recommends bundles
+};
+
+sub Meta            { shift        }
+sub Meta_ScalarKeys { @scalar_keys }
+sub Meta_TupleKeys  { @tuple_keys  }
+
+foreach my $key (@scalar_keys) {
+    *$key = sub {
+        my $self = shift;
+        return $self->{values}{$key} if defined wantarray and !@_;
+        $self->{values}{$key} = shift;
+        return $self;
+    };
+}
+
+foreach my $key (@tuple_keys) {
+    *$key = sub {
+        my $self = shift;
+        return $self->{values}{$key} unless @_;
+
+        my @rv;
+        while (@_) {
+            my $module = shift or last;
+            my $version = shift || 0;
+            if ( $module eq 'perl' ) {
+                $version =~ s{^(\d+)\.(\d+)\.(\d+)}
+                             {$1 + $2/1_000 + $3/1_000_000}e;
+                $self->perl_version($version);
+                next;
+            }
+            my $rv = [ $module, $version ];
+            push @rv, $rv;
+        }
+        push @{ $self->{values}{$key} }, @rv;
+        @rv;
+    };
+}
+
+# configure_requires is currently a null-op
+sub configure_requires { 1 }
+
+# Aliases for build_requires that will have alternative
+# meanings in some future version of META.yml.
+sub test_requires      { shift->build_requires(@_)  }
+sub install_requires   { shift->build_requires(@_)  }
+
+# Aliases for installdirs options
+sub install_as_core    { $_[0]->installdirs('perl')   }
+sub install_as_cpan    { $_[0]->installdirs('site')   }
+sub install_as_site    { $_[0]->installdirs('site')   }
+sub install_as_vendor  { $_[0]->installdirs('vendor') }
+
+sub sign {
+    my $self = shift;
+    return $self->{'values'}{'sign'} if defined wantarray and ! @_;
+    $self->{'values'}{'sign'} = ( @_ ? $_[0] : 1 );
+    return $self;
+}
+
+sub dynamic_config {
+	my $self = shift;
+	unless ( @_ ) {
+		warn "You MUST provide an explicit true/false value to dynamic_config, skipping\n";
+		return $self;
+	}
+	$self->{'values'}{'dynamic_config'} = $_[0] ? 1 : 0;
+	return $self;
+}
+
+sub all_from {
+    my ( $self, $file ) = @_;
+
+    unless ( defined($file) ) {
+        my $name = $self->name
+            or die "all_from called with no args without setting name() first";
+        $file = join('/', 'lib', split(/-/, $name)) . '.pm';
+        $file =~ s{.*/}{} unless -e $file;
+        die "all_from: cannot find $file from $name" unless -e $file;
+    }
+
+    $self->version_from($file)      unless $self->version;
+    $self->perl_version_from($file) unless $self->perl_version;
+
+    # The remaining probes read from POD sections; if the file
+    # has an accompanying .pod, use that instead
+    my $pod = $file;
+    if ( $pod =~ s/\.pm$/.pod/i and -e $pod ) {
+        $file = $pod;
+    }
+
+    $self->author_from($file)   unless $self->author;
+    $self->license_from($file)  unless $self->license;
+    $self->abstract_from($file) unless $self->abstract;
+}
+
+sub provides {
+    my $self     = shift;
+    my $provides = ( $self->{values}{provides} ||= {} );
+    %$provides = (%$provides, @_) if @_;
+    return $provides;
+}
+
+sub auto_provides {
+    my $self = shift;
+    return $self unless $self->is_admin;
+
+    unless (-e 'MANIFEST') {
+        warn "Cannot deduce auto_provides without a MANIFEST, skipping\n";
+        return $self;
+    }
+
+    # Avoid spurious warnings as we are not checking manifest here.
+
+    local $SIG{__WARN__} = sub {1};
+    require ExtUtils::Manifest;
+    local *ExtUtils::Manifest::manicheck = sub { return };
+
+    require Module::Build;
+    my $build = Module::Build->new(
+        dist_name    => $self->name,
+        dist_version => $self->version,
+        license      => $self->license,
+    );
+    $self->provides(%{ $build->find_dist_packages || {} });
+}
+
+sub feature {
+    my $self     = shift;
+    my $name     = shift;
+    my $features = ( $self->{values}{features} ||= [] );
+
+    my $mods;
+
+    if ( @_ == 1 and ref( $_[0] ) ) {
+        # The user used ->feature like ->features by passing in the second
+        # argument as a reference.  Accomodate for that.
+        $mods = $_[0];
+    } else {
+        $mods = \@_;
+    }
+
+    my $count = 0;
+    push @$features, (
+        $name => [
+            map {
+                ref($_) ? ( ref($_) eq 'HASH' ) ? %$_
+                                                : @$_
+                        : $_
+            } @$mods
+        ]
+    );
+
+    return @$features;
+}
+
+sub features {
+    my $self = shift;
+    while ( my ( $name, $mods ) = splice( @_, 0, 2 ) ) {
+        $self->feature( $name, @$mods );
+    }
+    return $self->{values}->{features}
+    	? @{ $self->{values}->{features} }
+    	: ();
+}
+
+sub no_index {
+    my $self = shift;
+    my $type = shift;
+    push @{ $self->{values}{no_index}{$type} }, @_ if $type;
+    return $self->{values}{no_index};
+}
+
+sub read {
+    my $self = shift;
+    $self->include_deps( 'YAML', 0 );
+
+    require YAML;
+    my $data = YAML::LoadFile('META.yml');
+
+    # Call methods explicitly in case user has already set some values.
+    while ( my ( $key, $value ) = each %$data ) {
+        next unless $self->can($key);
+        if ( ref $value eq 'HASH' ) {
+            while ( my ( $module, $version ) = each %$value ) {
+                $self->can($key)->($self, $module => $version );
+            }
+        }
+        else {
+            $self->can($key)->($self, $value);
+        }
+    }
+    return $self;
+}
+
+sub write {
+    my $self = shift;
+    return $self unless $self->is_admin;
+    $self->admin->write_meta;
+    return $self;
+}
+
+sub version_from {
+    my ( $self, $file ) = @_;
+    require ExtUtils::MM_Unix;
+    $self->version( ExtUtils::MM_Unix->parse_version($file) );
+}
+
+sub abstract_from {
+    my ( $self, $file ) = @_;
+    require ExtUtils::MM_Unix;
+    $self->abstract(
+        bless(
+            { DISTNAME => $self->name },
+            'ExtUtils::MM_Unix'
+        )->parse_abstract($file)
+     );
+}
+
+sub _slurp {
+    my ( $self, $file ) = @_;
+
+    local *FH;
+    open FH, "< $file" or die "Cannot open $file.pod: $!";
+    do { local $/; <FH> };
+}
+
+sub perl_version_from {
+    my ( $self, $file ) = @_;
+
+    if (
+        $self->_slurp($file) =~ m/
+        ^
+        use \s*
+        v?
+        ([\d_\.]+)
+        \s* ;
+    /ixms
+      )
+    {
+        my $v = $1;
+        $v =~ s{_}{}g;
+        $self->perl_version($1);
+    }
+    else {
+        warn "Cannot determine perl version info from $file\n";
+        return;
+    }
+}
+
+sub author_from {
+    my ( $self, $file ) = @_;
+    my $content = $self->_slurp($file);
+    if ($content =~ m/
+        =head \d \s+ (?:authors?)\b \s*
+        ([^\n]*)
+        |
+        =head \d \s+ (?:licen[cs]e|licensing|copyright|legal)\b \s*
+        .*? copyright .*? \d\d\d[\d.]+ \s* (?:\bby\b)? \s*
+        ([^\n]*)
+    /ixms) {
+        my $author = $1 || $2;
+        $author =~ s{E<lt>}{<}g;
+        $author =~ s{E<gt>}{>}g;
+        $self->author($author); 
+    }
+    else {
+        warn "Cannot determine author info from $file\n";
+    }
+}
+
+sub license_from {
+    my ( $self, $file ) = @_;
+
+    if (
+        $self->_slurp($file) =~ m/
+        (
+            =head \d \s+
+            (?:licen[cs]e|licensing|copyright|legal)\b
+            .*?
+        )
+        (=head\\d.*|=cut.*|)
+        \z
+    /ixms
+      )
+    {
+        my $license_text = $1;
+        my @phrases      = (
+            'under the same (?:terms|license) as perl itself' => 'perl',        1,
+            'GNU public license'                              => 'gpl',         1,
+            'GNU lesser public license'                       => 'gpl',         1,
+            'BSD license'                                     => 'bsd',         1,
+            'Artistic license'                                => 'artistic',    1,
+            'GPL'                                             => 'gpl',         1,
+            'LGPL'                                            => 'lgpl',        1,
+            'BSD'                                             => 'bsd',         1,
+            'Artistic'                                        => 'artistic',    1,
+            'MIT'                                             => 'mit',         1,
+            'proprietary'                                     => 'proprietary', 0,
+        );
+        while ( my ($pattern, $license, $osi) = splice(@phrases, 0, 3) ) {
+            $pattern =~ s{\s+}{\\s+}g;
+            if ( $license_text =~ /\b$pattern\b/i ) {
+                if ( $osi and $license_text =~ /All rights reserved/i ) {
+                        warn "LEGAL WARNING: 'All rights reserved' may invalidate Open Source licenses. Consider removing it.";
+		}
+                $self->license($license);
+                return 1;
+            }
+        }
+    }
+
+    warn "Cannot determine license info from $file\n";
+    return 'unknown';
+}
+
+1;

Added: String-BufferStack/inc/Module/Install/Win32.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/inc/Module/Install/Win32.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,65 @@
+#line 1
+package Module::Install::Win32;
+
+use strict;
+use Module::Install::Base;
+
+use vars qw{$VERSION $ISCORE @ISA};
+BEGIN {
+	$VERSION = '0.68';
+	$ISCORE  = 1;
+	@ISA     = qw{Module::Install::Base};
+}
+
+# determine if the user needs nmake, and download it if needed
+sub check_nmake {
+	my $self = shift;
+	$self->load('can_run');
+	$self->load('get_file');
+	
+	require Config;
+	return unless (
+		$^O eq 'MSWin32'                     and
+		$Config::Config{make}                and
+		$Config::Config{make} =~ /^nmake\b/i and
+		! $self->can_run('nmake')
+	);
+
+	print "The required 'nmake' executable not found, fetching it...\n";
+
+	require File::Basename;
+	my $rv = $self->get_file(
+		url       => 'http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe',
+		ftp_url   => 'ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe',
+		local_dir => File::Basename::dirname($^X),
+		size      => 51928,
+		run       => 'Nmake15.exe /o > nul',
+		check_for => 'Nmake.exe',
+		remove    => 1,
+	);
+
+	if (!$rv) {
+        die <<'END_MESSAGE';
+
+-------------------------------------------------------------------------------
+
+Since you are using Microsoft Windows, you will need the 'nmake' utility
+before installation. It's available at:
+
+  http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe
+      or
+  ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe
+
+Please download the file manually, save it to a directory in %PATH% (e.g.
+C:\WINDOWS\COMMAND\), then launch the MS-DOS command line shell, "cd" to
+that directory, and run "Nmake15.exe" from there; that will create the
+'nmake.exe' file needed by this module.
+
+You may then resume the installation process described in README.
+
+-------------------------------------------------------------------------------
+END_MESSAGE
+	}
+}
+
+1;

Added: String-BufferStack/inc/Module/Install/WriteAll.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/inc/Module/Install/WriteAll.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,43 @@
+#line 1
+package Module::Install::WriteAll;
+
+use strict;
+use Module::Install::Base;
+
+use vars qw{$VERSION $ISCORE @ISA};
+BEGIN {
+	$VERSION = '0.68';
+	$ISCORE  = 1;
+	@ISA     = qw{Module::Install::Base};
+}
+
+sub WriteAll {
+    my $self = shift;
+    my %args = (
+        meta        => 1,
+        sign        => 0,
+        inline      => 0,
+        check_nmake => 1,
+        @_
+    );
+
+    $self->sign(1)                if $args{sign};
+    $self->Meta->write            if $args{meta};
+    $self->admin->WriteAll(%args) if $self->is_admin;
+
+    if ( $0 =~ /Build.PL$/i ) {
+        $self->Build->write;
+    } else {
+        $self->check_nmake if $args{check_nmake};
+        unless ( $self->makemaker_args->{'PL_FILES'} ) {
+        	$self->makemaker_args( PL_FILES => {} );
+        }
+        if ($args{inline}) {
+            $self->Inline->write;
+        } else {
+            $self->Makefile->write;
+        }
+    }
+}
+
+1;

Added: String-BufferStack/lib/String/BufferStack.pm
==============================================================================
--- (empty file)
+++ String-BufferStack/lib/String/BufferStack.pm	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,484 @@
+package String::BufferStack;
+
+use strict;
+use warnings;
+
+=head1 NAME
+
+String::BufferStack - Nested buffers for templating systems
+
+=head1 SYNOPSIS
+
+  my $stack = String::BufferStack->new;
+  $stack->push( filter => sub {return uc shift} );
+  $stack->append("content");
+  $stack->flush_output;
+
+=head1 DESCRIPTION
+
+C<String::BufferStack> provides a framework for storing nested
+buffers.  By default, all of the buffers flow directly to the output
+method, but individual levels of the stack can apply filters, or store
+their output in a scalar reference.
+
+=head1 METHODS
+
+=head2 new PARAMHASH
+
+Creates a new buffer stack and returns it.  Possible arguments include:
+
+=over
+
+=item prealoc
+
+Preallocate this many bytes in the output buffer.  This can reduce
+reallocations, and thus speed up appends.
+
+=item out_method
+
+The method to call when output trickles down to the bottom-most buffer
+and is flushed via L<flush_output>.  The default C<out_method> prints
+the content to C<STDOUT>.  This method will always be called with
+non-undef, non-zero length content.
+
+=back
+
+=cut
+
+sub new {
+    my $class = shift;
+    my %args = @_;
+    my $output = " "x($args{prealloc} || 0);
+    $output = '';
+    return bless {
+        stack => [],
+        data_stack => [],
+        top => undef,
+        output => \$output,
+        out_method => $args{out_method} || sub { print STDOUT @_ },
+        pre_appends => {},
+    }, $class;
+}
+
+=head2 push PARAMHASH
+
+Pushes a new frame onto the buffer stack.  By default, the output from
+this new frame connects to the input of the previous frame.  There are
+a number of possible options:
+
+=over
+
+=item buffer
+
+A string reference, into which the output from this stack frame will
+appear.  By default, this is the input buffer of the previous frame.
+
+=item private
+
+If a true value is passed for C<private>, it creates a private string
+reference, and uses that as the buffer -- this is purely for
+convenience.  That is, the following blocks are equivilent:
+
+  my $buffer = "";
+  $stack->push( buffer => \$buffer );
+  # ...
+  $stack->pop;
+  print $buffer;
+
+  $stack->push( private => 1 );
+  # ...
+  print $stack->pop;
+
+=item pre_append
+
+A callback, which will be called with a reference to the
+C<String::BufferStack> object, and the arguments to append, whenever
+this stack frame has anything appended to the input buffer, directly
+or indirectly.
+
+Within the context of the pre-append callback, L</append>,
+L</direct_append>, and L</set_pre_append> function on the frame the
+pre-append is attached to, not the topmost trame.  Using L</append>
+within the pre-append callback is not suggested; use
+L</direct_append> instead.  L</set_pre_append> can be used to alter or
+remove the pre-append callback itself -- this is not uncommon, in
+the case where the first append is the only one which needs be watched
+for, for instance.
+
+=item filter
+
+A callback, used to process data which is appended to the stack frame.
+By default, filters are lazy, being called only when a frame is
+popped.  They can be forced at any time by calling L</flush_filters>,
+however.
+
+=item data
+
+Arbitrary data associated with this stack frame.
+C<String::BufferStack> does not inspect this or rely on it in any way,
+besides tracking it.  See also L</data>, L</data_ref>, and
+L</data_depth>.
+
+=back
+
+=cut
+
+sub push {
+    my $self = shift;
+    my $frame = {
+        buffer => $self->{top} ? $self->{top}{pre_filter} : $self->{output},
+        pre_append => undef,
+        filter => undef,
+        data => undef,
+        @_
+    };
+    my $filter = "";
+    my $buffer = "";
+    $frame->{buffer} = \$buffer if delete $frame->{private};
+    $frame->{length} = (defined ${$frame->{buffer}}) ? length ${$frame->{buffer}} : 0;
+    $frame->{pre_filter} = $frame->{filter} ? \$filter : $frame->{buffer};
+    $self->{top} = $frame;
+    local $self->{local_frame} = $frame;
+    $self->set_pre_append(delete $frame->{pre_append}) if exists $frame->{pre_append};
+    CORE::push(@{$self->{stack}}, $frame);
+    CORE::push(@{$self->{data_stack}}, $frame->{data}) if $frame->{data};
+}
+
+=head2 depth
+
+Returns the current depth of the stack.  This starts at 0, when no
+frames have been pushed, and increases by one for each frame pushed.
+
+=cut
+
+sub depth {
+    my $self = shift;
+    return scalar @{$self->{stack}};
+}
+
+=head2 append STRING [, STRING, ...]
+
+Appends the given strings to the input side of the topmost buffer.
+This will call all pre-append hooks attached to it, as well.  Note
+that if the frame has a filter, the filter will not immediately run,
+but will be delayed until the frame is L</pop>'d, or L</flush_filters>
+is called.
+
+When called with no frames on the stack, appends the stringins
+directly to the L</output_buffer>.
+
+=cut
+
+sub append {
+    my $self = shift;
+    my $frame = $self->{local_frame} || $self->{top};
+    my $ref = $frame ? $frame->{pre_filter} : $self->{output};
+    if ($frame and not $frame->{filter} and exists $self->{pre_appends}{$frame->{buffer}}) {
+        # This is an append to the output buffer, signal all pre_append hooks for it
+        for my $frame (@{$self->{pre_appends}{$frame->{buffer}}}) {
+            die unless $frame->{pre_append};
+            local $self->{local_frame} = $frame;
+            $frame->{pre_append}->($self, @_) if $frame->{pre_append};
+        }
+    }
+    for (@_) {
+        $$ref .= $_ if defined;
+    }
+}
+
+=head2 direct_append STRING [, STRING, ...]
+
+Similar to L</append>, but appends the strings to the output side of
+the frame, skipping pre-append callbacks and filters.
+
+When called with no frames on the stack, appends the stringins
+directly to the L</output_buffer>.
+
+=cut
+
+sub direct_append {
+    my $self = shift;
+    my $frame = $self->{local_frame} || $self->{top};
+    my $ref = $frame ? $frame->{buffer} : $self->{output};
+    for (@_) {
+        $$ref .= $_ if defined;
+    }
+}
+
+=head2 pop
+
+Removes the topmost frame on the stack, flushing the topmost filters
+in the process.  Returns the output buffer of the frame -- note that
+this may not contain only strings appended in the current frame, but
+also those from before, as a speed optimization.  That is:
+
+   $stack->append("one");
+   $stack->push;
+   $stack->append(" two");
+   $stack->pop;   # returns "one two"
+
+This operation is a no-op if there are no frames on the stack.
+
+=cut
+
+sub pop {
+    my $self = shift;
+    return unless $self->{top};
+    $self->filter;
+    my $frame = CORE::pop(@{$self->{stack}});
+    CORE::pop(@{$self->{data_stack}}) if $frame->{data};
+    local $self->{local_frame} = $frame;
+    $self->set_pre_append(undef);
+    $self->{top} = @{$self->{stack}} ? $self->{stack}[-1] : undef;
+    return ${$frame->{buffer}};
+}
+
+=head2 set_pre_append CALLBACK
+
+Alters the pre-append callback on the topmost frame.  The callback
+will be called before text is appended to the input buffer of the
+frame, and will be passed the C<String::BufferStack> and the arguments
+to L</append>.
+
+=cut
+
+sub set_pre_append {
+    my $self = shift;
+    my $hook = shift;
+    my $frame = $self->{local_frame} || $self->{top};
+    return unless $frame;
+    if ($hook and not $frame->{pre_append}) {
+        CORE::push(@{$self->{pre_appends}{$frame->{buffer}}}, $frame);
+    } elsif (not $hook and $frame->{pre_append}) {
+        $self->{pre_appends}{ $frame->{buffer} }
+            = [ grep { $_ ne $frame } @{ $self->{pre_appends}{ $frame->{buffer} } } ];
+        delete $self->{pre_appends}{ $frame->{buffer} }
+            unless @{ $self->{pre_appends}{ $frame->{buffer} } };
+    }
+    $frame->{pre_append} = $hook;
+}
+
+=head2 set_filter FILTER
+
+Alters the filter on the topmost frame.  Doing this flushes the
+filters on the topmost frame.
+
+=cut
+
+sub set_filter {
+    my $self = shift;
+    my $filter = shift;
+    return unless $self->{top};
+    $self->filter;
+    if (defined $self->{top}{filter} and not defined $filter) {
+        # Removing a filter, flush, then in = out
+        $self->{top}{pre_filter} = $self->{top}{buffer};
+    } elsif (not defined $self->{top}{filter} and defined $filter) {
+        # Adding a filter, add a pre_filter stage
+        my $pre_filter = "";
+        $self->{top}{pre_filter} = \$pre_filter;
+    }
+    $self->{top}{filter} = $filter;
+}
+
+=head2 filter
+
+Filters the topmost stack frame, if it has outstanding unfiltered
+data.  This will propagate content to lower frames, possibly calling
+their pre-append hooks.
+
+=cut
+
+sub filter {
+    my $self = shift;
+    my $frame = shift || $self->{top};
+    return unless $frame and $frame->{filter} and length ${$frame->{pre_filter}};
+
+    # We remove the input before we shell out to the filter, so we
+    # don't get into infinite loops.
+    my $input = ${$frame->{pre_filter}};
+    ${$frame->{pre_filter}} = '';
+    my $output = $frame->{filter}->($input);
+    if (exists $self->{pre_appends}{$frame->{buffer}}) {
+        for my $frame (@{$self->{pre_appends}{$frame->{buffer}}}) {
+            local $self->{local_frame} = $frame;
+            $frame->{pre_append}->($self, $output);
+        }
+    }
+    ${$frame->{buffer}} .= $output;
+}
+
+=head2 flush
+
+If there are no frames on the stack, calls L</flush_output>.
+Otherwise, calls L</flush_filters>.
+
+=cut
+
+sub flush {
+    my $self = shift;
+    # Flushing with no stack flushes the output
+    return $self->flush_output unless $self->depth;
+    # Otherwise it just flushes the filters
+    $self->flush_filters;
+}
+
+=head2 flush_filters
+
+Flushes all filters.  This does not flush output from the output
+buffer; see L</flush_output>.
+
+=cut
+
+sub flush_filters {
+    my $self = shift;
+    # Push content through filters -- reverse so the top one is first
+    for my $frame (reverse @{$self->{stack}}) {
+        $self->filter($frame);
+    }
+}
+
+=head2 flush_output
+
+Flushes all filters using L</flush_filters>, then flushes output from
+the output buffer, using the configured L</out_method>.
+
+=cut
+
+sub flush_output {
+    my $self = shift;
+    $self->flush_filters;
+
+    # Look at what we have at the end
+    return unless length ${$self->{output}};
+    $self->{out_method}->(${$self->{output}});
+    ${$self->{output}} = "";
+    return "";
+}
+
+=head2 output_buffer
+
+Returns the pending output buffer.
+
+=cut
+
+sub output_buffer {
+    my $self = shift;
+    return ${$self->{output}};
+}
+
+=head2 output_buffer_ref
+
+Returns a reference to the output buffer, allowing you to modify the output buffer.
+
+=cut
+
+sub output_buffer_ref {
+    my $self = shift;
+    return $self->{output};
+}
+
+=head2 buffer
+
+Returns the contents of the output buffer of the topmost frame; if
+there are no frames, returns the output buffer.
+
+=cut
+
+sub buffer {
+    my $self = shift;
+    return $self->{top} ? ${$self->{top}{buffer}} : ${$self->{output}};
+}
+
+=head2 length
+
+Returns the number of characters appended to the current frame; if
+there are no frames, returns the length of the output buffer.
+
+=cut
+
+sub length {
+    my $self = shift;
+    return $self->{top} ? length(${$self->{top}{buffer}}) - $self->{top}{length} : length(${$self->{output}});
+}
+
+=head2 clear
+
+Clears I<all> buffers in the stack, including the output buffer.
+
+=cut
+
+sub clear {
+    my $self = shift;
+    ${$self->{output}} = "";
+    ${$_->{pre_filter}} = ${$_->{buffer}} = "" for @{$self->{stack}};
+    return "";
+}
+
+=head2 clear_top
+
+Clears the topmost buffer in the stack; if there are no frames on the
+stack, clears the output buffer.
+
+=cut
+
+sub clear_top {
+    my $self = shift;
+    if ($self->{top}) {
+        ${$self->{top}{pre_filter}} = ${$self->{top}{buffer}} = "";
+    } else {
+        ${$self->{output}} = "";
+    }
+    return "";
+}
+
+=head2 out_method [CALLBACK]
+
+Gets or sets the output method callback.
+
+=cut
+
+sub out_method {
+    my $self = shift;
+    $self->{out_method} = shift if @_;
+    return $self->{out_method};
+}
+
+=head2 data [INDEX]
+
+With no arguments, returns the topmost defined C<data> argument to
+L</push>.  With C<INDEX> provided, indexes into the array of defined
+C<data> elements, -1 being the most recent, 0 being the first.
+
+=cut
+
+sub data {
+    my $self = shift;
+    my $i = @_ ? shift : -1;
+    return $self->{data_stack}[$i];
+}
+
+=head2 data_depth
+
+Returns the number of data elements in the stack.
+
+=cut
+
+sub data_depth {
+    my $self = shift;
+    return scalar @{$self->{data_stack}};
+}
+
+=head2 data_ref
+
+Returns a reference to the data stack, allowing it to be arbitrarily
+manipulated.
+
+=cut
+
+sub data_ref {
+    my $self = shift;
+    return $self->{data_stack};
+}
+
+1;

Added: String-BufferStack/t/01-basic.t
==============================================================================
--- (empty file)
+++ String-BufferStack/t/01-basic.t	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,83 @@
+use warnings;
+use strict;
+
+use Test::More 'no_plan';
+use YAML;
+
+use vars qw/$BUFFER/;
+$BUFFER = "";
+
+use_ok 'String::BufferStack';
+
+# Test printing to STDOUT
+my $stack = String::BufferStack->new;
+ok($stack, "Made an object");
+isa_ok($stack, 'String::BufferStack');
+{
+    open my $output, '>>', \$BUFFER;
+    local *STDOUT = $output;
+    $stack->append("Content");
+    is($BUFFER, "", "No output after append");
+    $stack->flush;
+    is($BUFFER, "Content", "Saw content on STDOUT");
+}
+
+# Tests with no buffer stack
+$stack = String::BufferStack->new( out_method => sub { $BUFFER .= join("", @_) });
+$BUFFER = "";
+$stack->append("Some string");
+is($stack->buffer, "Some string", "No stack, append goes through to output");
+is($stack->output_buffer, "Some string", "Same as output buffer");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Another append does exactly that
+$stack->append(", and more");
+is($stack->buffer, "Some string, and more", "No stack, append goes through to output");
+is($stack->output_buffer, "Some string, and more", "Same as output buffer");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Can inspect and modify the output buffer
+isa_ok($stack->output_buffer_ref, "SCALAR", "Output ref is a ref to a scalar");
+is(${$stack->output_buffer_ref}, "Some string, and more", "Dereferencing shows content");
+${$stack->output_buffer_ref} = "Moose";
+is(${$stack->output_buffer_ref}, "Moose", "Altering it changes output ref, deref'd");
+is($stack->output_buffer, "Moose", "Altering it changes output itself");
+is($stack->buffer, "Moose", "Also top buffer");
+
+# Flush the output
+$stack->flush;
+is($stack->buffer, "", "Flush clears output");
+is($stack->output_buffer, "", "Also output buffer");
+is($BUFFER, "Moose", "Flush moved to output");
+
+# Ensure no saved state
+$BUFFER = "";
+$stack->append("More");
+is($stack->buffer, "More", "Append after flush goes through");
+is($stack->output_buffer, "More", "Same as output buffer");
+is($BUFFER, "", "Without flush, doesn't output");
+$stack->flush;
+is($stack->buffer, "", "Flush clears output");
+is($stack->output_buffer, "", "Also output buffer");
+is($BUFFER, "More", "Flush moved to output");
+
+# Clear 
+$BUFFER = "";
+$stack->append("Never seen");
+is($stack->buffer, "Never seen", "See the append");
+is($stack->output_buffer, "Never seen", "Same as output buffer");
+$stack->clear;
+is($stack->buffer, "", "Clear empties the buffers");
+is($stack->output_buffer, "", "output buffer as well");
+$stack->flush;
+is($BUFFER, "", "No buffers, no output after flush");
+
+# Clear top is same, with no capture
+$stack->append("Never seen");
+is($stack->buffer, "Never seen", "See the append");
+is($stack->output_buffer, "Never seen", "Same as output buffer");
+$stack->clear_top;
+is($stack->buffer, "", "Clear empties the buffers");
+is($stack->output_buffer, "", "output buffer as well");
+$stack->flush;
+is($BUFFER, "", "No buffers, no output after flush");

Added: String-BufferStack/t/02-simple-stack.t
==============================================================================
--- (empty file)
+++ String-BufferStack/t/02-simple-stack.t	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,67 @@
+use warnings;
+use strict;
+
+use Test::More 'no_plan';
+use YAML;
+
+use vars qw/$BUFFER/;
+
+use_ok 'String::BufferStack';
+
+my $stack = String::BufferStack->new( out_method => sub { $BUFFER .= join("", @_) });
+ok($stack, "Made an object");
+isa_ok($stack, 'String::BufferStack');
+
+# Tests with no buffer stack
+$BUFFER = "";
+$stack->append("Some string");
+is($stack->buffer, "Some string", "No stack, append goes through to output");
+is($stack->output_buffer, "Some string", "Same as output buffer");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Add to the stack
+is($stack->depth, 0, "Has no depth yet");
+$stack->push;
+is($stack->depth, 1, "Has a frame");
+
+# Another append does exactly that
+$stack->append(", and more");
+is($stack->buffer, "Some string, and more", "One step down, append goes through to output");
+is($stack->output_buffer, "Some string, and more", "Same as output buffer");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Pop it
+is($stack->depth, 1, "Still has a frame");
+$stack->pop;
+is($stack->depth, 0, "No frames anymore");
+
+# State is unchanged
+is($stack->buffer, "Some string, and more", "One step down, append goes through to output");
+is($stack->output_buffer, "Some string, and more", "Same as output buffer");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Flush the output
+$stack->flush;
+is($stack->buffer, "", "Flush clears output");
+is($stack->output_buffer, "", "Also output buffer");
+is($BUFFER, "Some string, and more", "Flush moved to output");
+
+# Popping again does nothing
+is($stack->pop, undef, "Popping again returns undef");
+is($stack->depth, 0, "And leaves depth unchanged");
+is($stack->buffer, "", "Buffer is still empty");
+is($stack->output_buffer, "", "Also output buffer");
+
+# Nested pushes do the right thing
+$stack->push;
+$stack->push;
+$stack->append("Nested");
+is($stack->buffer, "Nested", "Nested append");
+is($stack->output_buffer, "Nested", "Nested append carried through to output");
+is($stack->pop, "Nested", "Popping produces correct content");
+is($stack->buffer, "Nested", "Nested append");
+is($stack->output_buffer, "Nested", "Nested append carried through to output");
+is($stack->pop, "Nested", "Popping produces correct content");
+is($stack->buffer, "Nested", "Nested append");
+is($stack->output_buffer, "Nested", "Nested append carried through to output");
+is($stack->pop, undef, "Too many pops returns undef");

Added: String-BufferStack/t/03-capture.t
==============================================================================
--- (empty file)
+++ String-BufferStack/t/03-capture.t	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,59 @@
+use warnings;
+use strict;
+
+use Test::More 'no_plan';
+use YAML;
+
+use vars qw/$BUFFER $DEEPER/;
+
+use_ok 'String::BufferStack';
+
+my $stack = String::BufferStack->new( out_method => sub { $BUFFER .= join("", @_) });
+ok($stack, "Made an object");
+isa_ok($stack, 'String::BufferStack');
+
+# Tests with no buffer stack
+$BUFFER = "";
+$stack->append("Some string");
+is($stack->buffer, "Some string", "No stack, append goes through to output");
+is($stack->output_buffer, "Some string", "Same as output buffer");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Add to the stack
+$DEEPER = "";
+$stack->push(buffer => \$DEEPER);
+
+# Another tacks onto $DEEPER
+$stack->append(", and more");
+is($stack->buffer, ", and more", "One step down, append doesn't go through");
+is($stack->output_buffer, "Some string", "Output is different");
+is($DEEPER, ", and more", "Append caught by lower level");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Pop it
+$stack->pop;
+
+# Rest of stack unchanged
+is($stack->buffer, "Some string", "Back to as it was");
+is($stack->output_buffer, "Some string", "As well");
+
+# Push it again
+$DEEPER = "";
+$stack->push(buffer => \$DEEPER);
+$stack->append(", again");
+is($DEEPER, ", again", "Append has effect");
+$stack->clear_top;
+is($stack->output_buffer, "Some string", "Output buffer unchanged");
+is($stack->buffer, "", "clear_top only affects top buffer");
+is($DEEPER, "", "Referenced buffer is cleared");
+
+# Write and try a flush
+$stack->append(", again");
+$stack->flush;
+is($stack->output_buffer, "Some string", "With depth, flush is just filters");
+is($BUFFER, "", "Hence no output seen");
+$stack->flush_output;
+is($stack->output_buffer, "", "flush_all pushes the output buffer");
+is($stack->buffer, ", again", "But not non-output buffers");
+is($DEEPER, ", again", "..nor their variables");
+is($BUFFER, "Some string", "Output seen");

Added: String-BufferStack/t/04-filter.t
==============================================================================
--- (empty file)
+++ String-BufferStack/t/04-filter.t	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,149 @@
+use warnings;
+use strict;
+
+use Test::More 'no_plan';
+use YAML;
+
+use vars qw/$BUFFER $DEEPER/;
+
+use_ok 'String::BufferStack';
+
+my $stack = String::BufferStack->new( out_method => sub { $BUFFER .= join("", @_) });
+ok($stack, "Made an object");
+isa_ok($stack, 'String::BufferStack');
+
+# Tests with no buffer stack
+$BUFFER = "";
+$stack->append("Some string");
+is($stack->buffer, "Some string", "No stack, append goes through to output");
+is($stack->output_buffer, "Some string", "Same as output buffer");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Add to the stack a no-op filter
+$stack->push(filter => sub {return shift} );
+
+# Without flush_filters, doesn't appear in output
+$stack->append(", and more");
+is($stack->buffer, "Some string", "Buffer is shared with output, nothing yet");
+is($stack->output_buffer, "Some string", "Output is still there");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Flushing filters shoves it into buffer, and output
+$stack->flush_filters;
+is($stack->buffer, "Some string, and more", "Flushing filters gets to buffer");
+is($stack->output_buffer, "Some string, and more", "Which is also output");
+is($BUFFER, "", "..but not flushed");
+
+# Pop it
+$stack->pop;
+is($stack->buffer, "Some string, and more", "Unchanged after pop");
+is($stack->output_buffer, "Some string, and more", "Also output is");
+
+# Add a upper-case filter
+$stack->push(filter => sub {return uc shift} );
+$stack->append(", now!");
+is($stack->buffer, "Some string, and more", "Nothing yet");
+is($stack->output_buffer, "Some string, and more", "Also nothing in output");
+is($BUFFER, "", "Without flush, doesn't output");
+
+# Flushing filters shoves it into buffer, and output
+$stack->flush_filters;
+is($stack->buffer, "Some string, and more, NOW!", "See upper-case filter output");
+is($stack->output_buffer, "Some string, and more, NOW!", "Also in output");
+
+# Popping flushes filters
+$stack->append("  Whee!");
+$stack->pop;
+is($stack->buffer, "Some string, and more, NOW!  WHEE!", "See filter output");
+is($stack->output_buffer, "Some string, and more, NOW!  WHEE!", "Also in output");
+$stack->clear;
+
+# Test clearing in the middle of everything
+$stack->append("First ");
+$stack->push(filter => sub {return ">>".shift(@_)."<<"} );
+$stack->append("second");
+$stack->clear;
+is($stack->buffer, "", "Clear emptied it out");
+$stack->append("third");
+is($stack->buffer, "", "Still empty");
+$stack->pop;
+is($stack->buffer, ">>third<<", "See last append after clear");
+$stack->clear;
+
+# Repeated flushes don't call the filter
+$stack->push(filter => sub {return ">>".shift(@_)."<<"} );
+$stack->flush_filters;
+is($stack->buffer, "", "No input, no output");
+$stack->flush_filters;
+is($stack->buffer, "", "Still no input, no output");
+$stack->append("here");
+is($stack->buffer, "", "Input, but not flushed");
+$stack->flush_filters;
+is($stack->buffer, ">>here<<", "Flushed once, get output");
+$stack->flush_filters;
+is($stack->buffer, ">>here<<", "Flushed again, no more");
+$stack->append("");
+is($stack->buffer, ">>here<<", "Appending nothing does nothing");
+$stack->append(undef);
+is($stack->buffer, ">>here<<", "Appending undef does nothing");
+$stack->pop;
+$stack->clear;
+
+
+# Filter nesting!
+$stack->push(filter => sub {return ">>".shift(@_)."<<"} );
+$stack->append("first");
+is($stack->buffer, "", "Nothing yet");
+$stack->flush_filters;
+is($stack->buffer, ">>first<<", "First filter output");
+is($stack->output_buffer, ">>first<<", "Output buffer as well");
+$stack->push(filter => sub {$_[0] =~ tr/a-z/b-za/; $_[0]} );
+is($stack->buffer, "", "Nothing on the new buffer");
+is($stack->output_buffer, ">>first<<", "Nothing more yet");
+$stack->append("second");
+is($stack->buffer, "", "Nothing on the new buffer");
+is($stack->output_buffer, ">>first<<", "Nothing more yet");
+$stack->filter;
+is($stack->buffer, "tfdpoe", "Pushes output through");
+is($stack->output_buffer, ">>first<<", "Output unchanged yet");
+$stack->flush_filters;
+is($stack->buffer, "", "Flushing all of them clears the buffer");
+is($stack->output_buffer, ">>first<<>>tfdpoe<<", "And adds to output");
+$stack->pop;
+$stack->pop;
+is($stack->buffer, ">>first<<>>tfdpoe<<", "Unchanged after pop");
+is($stack->output_buffer, ">>first<<>>tfdpoe<<", "Also output");
+$stack->append("verbatim");
+is($stack->output_buffer, ">>first<<>>tfdpoe<<verbatim", "Top level has no filter");
+$stack->filter;
+is($stack->output_buffer, ">>first<<>>tfdpoe<<verbatim", "Filter does nothing with no stack");
+$stack->clear;
+
+## Modifying filters mid-runtime
+$stack->push(filter => sub {return ">>".shift(@_)."<<"});
+$stack->append("first");
+$stack->flush;
+is($stack->buffer, ">>first<<", "First filter output");
+$stack->append("second");
+is($stack->buffer, ">>first<<", "Without flush, no result yet");
+
+# Unsetting filter
+$stack->set_filter(undef);
+is($stack->buffer, ">>first<<>>second<<", "Unsetting filter flushes");
+$stack->append("third");
+is($stack->buffer, ">>first<<>>second<<third", "No flush needed anymore");
+
+# Keep it unset
+$stack->set_filter(undef);
+is($stack->buffer, ">>first<<>>second<<third", "No flush needed anymore");
+
+# Setting to something else
+$stack->set_filter(sub {return uc shift});
+$stack->append("hi");
+is($stack->buffer, ">>first<<>>second<<third", "No flush, no data");
+$stack->set_filter(sub {return "(content)"});
+is($stack->buffer, ">>first<<>>second<<thirdHI", "Changing does a flush");
+$stack->append("This doesn't matter");
+$stack->flush;
+is($stack->buffer, ">>first<<>>second<<thirdHI(content)", "See new filter in action");
+$stack->pop;

Added: String-BufferStack/t/05-data.t
==============================================================================
--- (empty file)
+++ String-BufferStack/t/05-data.t	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,77 @@
+use warnings;
+use strict;
+
+use Test::More 'no_plan';
+use YAML;
+
+use vars qw/$BUFFER/;
+
+use_ok 'String::BufferStack';
+
+my $stack = String::BufferStack->new( out_method => sub { $BUFFER .= join("", @_) });
+ok($stack, "Made an object");
+isa_ok($stack, 'String::BufferStack');
+
+# Check data depth with no data set
+$stack->push;
+is($stack->depth, 1, "Pushing alters depth");
+is($stack->data_depth, 0, "With no data, data depth is still 0");
+is($stack->data, undef, "Has no data");
+$stack->pop;
+
+# Simple data tests
+my $data = {key => "value"};
+$stack->push( data => $data);
+is($stack->depth, 1, "Pushing alters depth");
+is($stack->data_depth, 1, "With data, increases data depth");
+is($stack->data, $data, "Is same ref");
+is_deeply($stack->data, {key => "value"}, "Can get top data");
+
+# Stores the same ref, so can alter $data
+$data->{key} = "new";
+is_deeply($stack->data, {key => "new"}, "Can get top data");
+
+# Indexing
+is_deeply($stack->data(0), $stack->data, "Index 0 is same data");
+is_deeply($stack->data(-1), $stack->data, "Index -1 is same data");
+
+# Add more for indexing
+$stack->push( data => "deeper" );
+is($stack->data, "deeper", "Has new data value");
+$stack->push( data => "deepest" );
+is($stack->data, "deepest", "Has new data value");
+is($stack->data_depth, 3, "Pushed two data levels");
+is_deeply($stack->data(0), $data, "Index 0 is same data");
+is_deeply($stack->data(1), "deeper", "Index 1 is deeper");
+is_deeply($stack->data(2), "deepest", "Index 2 is deepest");
+is_deeply($stack->data(-1), "deepest", "Index -1 is deepest");
+
+# Test that we can munge the ref
+is_deeply($stack->data_ref, [{key => "new"}, "deeper", "deepest"], "Have ref");
+push @{$stack->data_ref}, "moose!";
+is($stack->data_depth, 4, "Affected data depth");
+is($stack->data, "moose!", "Can see added data");
+pop @{$stack->data_ref};
+
+# Check popping makes sense
+$stack->pop;
+is($stack->data, "deeper", "Back to previous value");
+$stack->pop;
+is($stack->data, $data, "Back to first value");
+is($stack->data_depth, 1, "Only one level deep");
+
+# Extra non-data pushes don't change it
+$stack->push;
+is($stack->depth, 2, "Pushing alters depth");
+is($stack->data_depth, 1, "Second push had no data");
+is_deeply($stack->data, {key => "new"}, "Top data is unchanged");
+
+# Popping non-data frames don't change it
+$stack->pop;
+is($stack->data_depth, 1, "Popping non-data element doesn't change data depth");
+is_deeply($stack->data, {key => "new"}, "Top data is unchanged");
+
+# Popping the data frame makes it go away
+$stack->pop;
+is($stack->data_depth, 0, "Popping data element changes data depth");
+is($stack->data, undef, "Top data is no more");

Added: String-BufferStack/t/06-preappend.t
==============================================================================
--- (empty file)
+++ String-BufferStack/t/06-preappend.t	Wed Oct 29 19:42:02 2008
@@ -0,0 +1,110 @@
+use warnings;
+use strict;
+
+use Test::More 'no_plan';
+use YAML;
+
+use vars qw/$BUFFER/;
+
+use_ok 'String::BufferStack';
+
+my $stack = String::BufferStack->new( out_method => sub { $BUFFER .= join("", @_) });
+ok($stack, "Made an object");
+isa_ok($stack, 'String::BufferStack');
+
+$stack->append(q{<start elem="something"});
+my $closed = 0;
+$stack->push( pre_append => 
+                  sub {
+                      my $stack = shift;
+                      $stack->set_pre_append(undef);
+                      $closed = 1;
+                      $stack->direct_append(">");
+                  }
+              );
+$stack->append("Content!");
+is($closed, 1);
+$stack->pop;
+is($stack->buffer, q{<start elem="something">Content!});
+$stack->append($closed ? q{</start>} : q{ />}); 
+is($stack->buffer, q{<start elem="something">Content!</start>});
+$stack->clear;
+
+$stack->append(q{<start elem="something"});
+$closed = 0;
+$stack->push( pre_append => 
+                  sub {
+                      my $stack = shift;
+                      $stack->set_pre_append(undef);
+                      $closed = 1;
+                      $stack->direct_append(">");
+                  }
+              );
+$stack->pop;
+$stack->append($closed ? q{</start>} : q{ />}); 
+is($stack->buffer, q{<start elem="something" />});
+$stack->clear;
+
+# Filters and pre_appends
+$stack->append(q{<start elem="something"});
+$closed = 0;
+$stack->push( pre_append => 
+                  sub {
+                      my $stack = shift;
+                      $stack->set_pre_append(undef);
+                      $closed = 1;
+                      $stack->direct_append(' hi="there">');
+                  },
+              filter => sub {
+                  return uc shift;
+              }
+          );
+$stack->append("Content!");
+$stack->pop;
+$stack->append($closed ? q{</start>} : q{ />}); 
+is($stack->buffer, q{<start elem="something" hi="there">CONTENT!</start>});
+$stack->clear;
+
+# Multiple pre_appends for a single buffer
+my $first = 0;
+my $second = 0;
+$stack->push( pre_append => sub { $first++ } );
+$stack->append("Whee!");
+is($first, 1, "First pre-append seen");
+$stack->push( pre_append => sub { $second++ } );
+$stack->append("More!");
+is($first, 2, "First pre-append seen again");
+is($second, 1, "Second pre-append seen as well");
+$stack->pop;
+$stack->append("Almost done!");
+is($first, 3, "First pre-append seen yet again");
+is($second, 1, "But not second");
+$stack->pop;
+$stack->append("Done!");
+is($first, 3, "No change in first");
+is($second, 1, "Nor second");
+$stack->clear;
+
+# Altering pre_appends mid-course
+$first = $second = 0;
+$stack->push( pre_append => sub {shift->set_pre_append(undef) if ++$first >= 3});
+$stack->append("one");
+is($first, 1, "First pre-append seen");
+$stack->push( pre_append => sub {shift->set_pre_append(undef) if ++$second >= 3});
+$stack->append("two");
+is($first, 2, "First pre-append seen again");
+is($second, 1, "Second pre-append seen as well");
+$stack->append("three");
+is($first, 3, "First hits again!");
+is($second, 2, "Second as well");
+$stack->append("four");
+is($first, 3, "First is done");
+is($second, 3, "Second still going strong");
+$stack->append("five");
+is($first, 3, "First is done");
+is($second, 3, "Second is also done");
+$stack->pop;
+$stack->append("popped");
+is($first, 3, "First is still done");
+is($second, 3, "Second is also done");
+$stack->pop;



More information about the Bps-public-commit mailing list