[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