Initial Commit

database/perl/vendor/lib/PPI/Token/Quote/Double.pm

@@ -0,0 +1,138 @@
+package PPI::Token::Quote::Double;
+
+=pod
+
+=head1 NAME
+
+PPI::Token::Quote::Double - A standard "double quote" token
+
+=head1 INHERITANCE
+
+  PPI::Token::Quote::Double
+  isa PPI::Token::Quote
+      isa PPI::Token
+          isa PPI::Element
+
+=head1 DESCRIPTION
+
+A C<PPI::Token::Quote::Double> object represents a double-quoted
+interpolating string.
+
+The string is treated as a single entity, L<PPI> will not try to
+understand what is in the string during the parsing process.
+
+=head1 METHODS
+
+There are several methods available for C<PPI::Token::Quote::Double>, beyond
+those provided by the parent L<PPI::Token::Quote>, L<PPI::Token> and
+L<PPI::Element> classes.
+
+=cut
+
+use strict;
+use Params::Util                     qw{_INSTANCE};
+use PPI::Token::Quote                ();
+use PPI::Token::_QuoteEngine::Simple ();
+
+our $VERSION = '1.270'; # VERSION
+
+our @ISA = qw{
+	PPI::Token::_QuoteEngine::Simple
+	PPI::Token::Quote
+};
+
+
+
+
+
+#####################################################################
+# PPI::Token::Quote::Double Methods
+
+=pod
+
+=head2 interpolations
+
+The interpolations method checks to see if the double quote actually
+contains any interpolated variables.
+
+Returns true if the string contains interpolations, or false if not.
+
+=cut
+
+# Upgrade: Return the interpolated substrings.
+# Upgrade: Returns parsed expressions.
+sub interpolations {
+	# Are there any unescaped $things in the string
+	!! ($_[0]->content =~ /(?<!\\)(?:\\\\)*[\$\@]/);
+}
+
+=pod
+
+=head2 simplify
+
+For various reasons, some people find themselves compelled to have
+their code in the simplest form possible.
+
+The C<simplify> method will, if possible, modify a simple double-quoted
+string token in place, turning it into the equivalent single-quoted
+string. If the token is modified, it is reblessed into the
+L<PPI::Token::Quote::Single> package.
+
+Because the length of the content is not changed, there is no need
+to call the document's C<flush_locations> method.
+
+The object itself is returned as a convenience.
+
+=cut
+
+sub simplify {
+	# This only works on EXACTLY this class
+	my $self = _INSTANCE(shift, 'PPI::Token::Quote::Double') or return undef;
+
+	# Don't bother if there are characters that could complicate things
+	my $content = $self->content;
+	my $value   = substr($content, 1, length($content) - 2);
+	return $self if $value =~ /[\\\$@\'\"]/;
+
+	# Change the token to a single string
+	$self->{content} = "'$value'";
+	bless $self, 'PPI::Token::Quote::Single';
+}
+
+
+
+
+
+
+
+#####################################################################
+# PPI::Token::Quote Methods
+
+sub string {
+	my $str = $_[0]->{content};
+	substr( $str, 1, length($str) - 2 );
+}
+
+1;
+
+=pod
+
+=head1 SUPPORT
+
+See the L<support section|PPI/SUPPORT> in the main module.
+
+=head1 AUTHOR
+
+Adam Kennedy E<lt>adamk@cpan.orgE<gt>
+
+=head1 COPYRIGHT
+
+Copyright 2001 - 2011 Adam Kennedy.
+
+This program is free software; you can redistribute
+it and/or modify it under the same terms as Perl itself.
+
+The full text of the license can be found in the
+LICENSE file included with this module.
+
+=cut

database/perl/vendor/lib/PPI/Token/Quote/Interpolate.pm

@@ -0,0 +1,76 @@
+package PPI::Token::Quote::Interpolate;
+
+=pod
+
+=head1 NAME
+
+PPI::Token::Quote::Interpolate - The interpolation quote-like operator
+
+=head1 INHERITANCE
+
+  PPI::Token::Quote::Interpolate
+  isa PPI::Token::Quote
+      isa PPI::Token
+          isa PPI::Element
+
+=head1 DESCRIPTION
+
+A C<PPI::Token::Quote::Interpolate> object represents a single
+interpolation quote-like operator, such as C<qq{$foo bar $baz}>.
+
+=head1 METHODS
+
+There are no methods available for C<PPI::Token::Quote::Interpolate>
+beyond those provided by the parent L<PPI::Token::Quote>, L<PPI::Token> and
+L<PPI::Element> classes.
+
+=cut
+
+use strict;
+use PPI::Token::Quote ();
+use PPI::Token::_QuoteEngine::Full ();
+
+our $VERSION = '1.270'; # VERSION
+
+our @ISA = qw{
+	PPI::Token::_QuoteEngine::Full
+	PPI::Token::Quote
+};
+
+
+
+
+
+#####################################################################
+# PPI::Token::Quote Methods
+
+sub string {
+	my $self     = shift;
+	my @sections = $self->_sections;
+	my $str      = $sections[0];
+	substr( $self->{content}, $str->{position}, $str->{size} );	
+}
+
+1;
+
+=pod
+
+=head1 SUPPORT
+
+See the L<support section|PPI/SUPPORT> in the main module.
+
+=head1 AUTHOR
+
+Adam Kennedy E<lt>adamk@cpan.orgE<gt>
+
+=head1 COPYRIGHT
+
+Copyright 2001 - 2011 Adam Kennedy.
+
+This program is free software; you can redistribute
+it and/or modify it under the same terms as Perl itself.
+
+The full text of the license can be found in the
+LICENSE file included with this module.
+
+=cut

database/perl/vendor/lib/PPI/Token/Quote/Literal.pm

@@ -0,0 +1,80 @@
+package PPI::Token::Quote::Literal;
+
+=pod
+
+=head1 NAME
+
+PPI::Token::Quote::Literal - The literal quote-like operator
+
+=head1 INHERITANCE
+
+  PPI::Token::Quote::Literal
+  isa PPI::Token::Quote
+      isa PPI::Token
+          isa PPI::Element
+
+=head1 DESCRIPTION
+
+A C<PPI::Token::Quote::Literal> object represents a single literal
+quote-like operator, such as C<q{foo bar}>.
+
+=head1 METHODS
+
+There are no methods available for C<PPI::Token::Quote::Literal> beyond
+those provided by the parent L<PPI::Token::Quote>, L<PPI::Token> and
+L<PPI::Element> classes.
+
+=cut
+
+use strict;
+use PPI::Token::Quote              ();
+use PPI::Token::_QuoteEngine::Full ();
+
+our $VERSION = '1.270'; # VERSION
+
+our @ISA = qw{
+	PPI::Token::_QuoteEngine::Full
+	PPI::Token::Quote
+};
+
+
+
+
+
+#####################################################################
+# PPI::Token::Quote Methods
+
+sub string {
+	my $self     = shift;
+	my @sections = $self->_sections;
+	my $str      = $sections[0];
+	substr( $self->{content}, $str->{position}, $str->{size} );	
+}
+
+
+# Use the same implementation as another module
+*literal = *PPI::Token::Quote::Single::literal;
+
+1;
+
+=pod
+
+=head1 SUPPORT
+
+See the L<support section|PPI/SUPPORT> in the main module.
+
+=head1 AUTHOR
+
+Adam Kennedy E<lt>adamk@cpan.orgE<gt>
+
+=head1 COPYRIGHT
+
+Copyright 2001 - 2011 Adam Kennedy.
+
+This program is free software; you can redistribute
+it and/or modify it under the same terms as Perl itself.
+
+The full text of the license can be found in the
+LICENSE file included with this module.
+
+=cut

database/perl/vendor/lib/PPI/Token/Quote/Single.pm

@@ -0,0 +1,93 @@
+package PPI::Token::Quote::Single;
+
+=pod
+
+=head1 NAME
+
+PPI::Token::Quote::Single - A 'single quote' token
+
+=head1 INHERITANCE
+
+  PPI::Token::Quote::Single
+  isa PPI::Token::Quote
+      isa PPI::Token
+          isa PPI::Element
+
+=head1 SYNOPSIS
+
+  'This is a single quote'
+  
+  q{This is a literal, but NOT a single quote}
+
+=head1 DESCRIPTION
+
+A C<PPI::Token::Quote::Single> object represents a single quoted string
+literal. 
+
+=head1 METHODS
+
+There are no methods available for C<PPI::Token::Quote::Single> beyond
+those provided by the parent L<PPI::Token::Quote>, L<PPI::Token> and
+L<PPI::Element> classes.
+
+=cut
+
+use strict;
+use PPI::Token::Quote ();
+use PPI::Token::_QuoteEngine::Simple ();
+
+our $VERSION = '1.270'; # VERSION
+
+our @ISA = qw{
+	PPI::Token::_QuoteEngine::Simple
+	PPI::Token::Quote
+};
+
+
+
+
+
+#####################################################################
+# PPI::Token::Quote Methods
+
+sub string {
+	my $str = $_[0]->{content};
+	substr( $str, 1, length($str) - 2 );
+}
+
+
+my %UNESCAPE = (
+	"\\'"  => "'",
+	"\\\\" => "\\",
+);
+
+sub literal {
+	# Unescape \\ and \' ONLY
+	my $str = $_[0]->string;
+	$str =~ s/(\\.)/$UNESCAPE{$1} || $1/ge;
+	return $str;
+}
+
+1;
+
+=pod
+
+=head1 SUPPORT
+
+See the L<support section|PPI/SUPPORT> in the main module.
+
+=head1 AUTHOR
+
+Adam Kennedy E<lt>adamk@cpan.orgE<gt>
+
+=head1 COPYRIGHT
+
+Copyright 2001 - 2011 Adam Kennedy.
+
+This program is free software; you can redistribute
+it and/or modify it under the same terms as Perl itself.
+
+The full text of the license can be found in the
+LICENSE file included with this module.
+
+=cut