Scalar-Properties-1.100860000755000765000024 011353417342 15042 5ustar00marcelstaff000000000000Changes000644000765000024 520511353417342 16417 0ustar00marcelstaff000000000000Scalar-Properties-1.100860Revision history for Perl extension Scalar-Properties 1.100860 2010-03-27 16:06:07 Europe/Vienna - converted the distribution to Dist::Zilla-style 0.15 Thu Jul 25 15:27:43 CEST 2008 (Marcel Gruenauer ) - Changed dist style and Changes back to standard. People didn't like it - the nail that sticks out gets hammered down. - Added standard test files; this will also help with CPANTS. 0.14 Thu, 29 May 2008 12:07:03 -0000 (Marcel Gruenauer ) - Converted Changes file to YAML style - .shipit: added Twitter step - Makefile.PL: added auto_install() and process_templates() - lib/*: converted to template - updated MANIFEST - updated t/perlcriticrc - .shipit: fixed svk.tagpattern - tags: NEWFEATURE 0.13 Thu, 18 Oct 2007 10:09:39 +0200 (Marcel Gruenauer ) - fixed version requirement of Test::More - improved documentation 0.12 Sun, 09 Nov 2003 11:31:00 +0100 (David Cantrell ) - applied patch to fix interpolation bug, reported and patch supplied by makamaka@users.sourceforge.jp - added test for this bug - changed true() function in test.pl to show a useful comment for each test if supplied 0.11 Tue, 04 Nov 2003 18:54:00 +0100 (David Cantrell ) - fixed operand ordering bug in generated functions for binary ops - fixed bug in test suite which only showed up after fixing above ;-) 0.10 Wed, 27 Jun 2001 20:31:45 +0100 (Marcel Gruenauer ) - added code execution methods, abs(), zero() - added is_false() method - added 'has_' prefix for property querying - added property propagation (pass_on(), passed_on(), get_pass_on()) - added property introspection (get_props(), del_props(), del_all_props()) - added tests and documentation for all of the above 0.03 Wed, 27 Jun 2001 16:08:46 +0100 (Marcel Gruenauer ) - added many string methods, plus tests and documentation - changed boolean methods to return an overloaded boolean value so it can take properties as well 0.02 Tue, 26 Jun 2001 00:08:24 +0100 (Marcel Gruenauer ) - value() stringifies if argument not of this package - added options to import() to be able to selectively specify constant overloading from different packages, e.g. overloading 'qr' from a Regex package - added methods length, size, reverse and tests for those - added TODO document 0.01 Tue, 26 Jun 2001 19:35:58 +0100 (Marcel Gruenauer ) - original version; created by h2xs 1.20 with options -XAn Scalar::Properties dist.ini000644000765000024 23711353417342 16550 0ustar00marcelstaff000000000000Scalar-Properties-1.100860name = Scalar-Properties author = Marcel Gruenauer license = Perl_5 copyright_holder = Marcel Gruenauer copyright_year = 2001 [@MARCEL] Scalar000755000765000024 011353417342 16736 5ustar00marcelstaff000000000000Scalar-Properties-1.100860/libProperties.pm000644000765000024 4015311353417342 21612 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/lib/Scalaruse 5.008; use strict; use warnings; package Scalar::Properties; our $VERSION = '1.100860'; # ABSTRACT: Run-time properties on scalar variables use overload q{""} => \&value, bool => \&is_true, '+' => \&plus, '-' => \&minus, '*' => \×, '/' => \÷, '%' => \&modulo, '**' => \&exp, '<=>' => \&numcmp, 'cmp' => \&cmp, # the following would be autogenerated from 'cmp', but # we want to make the methods available explicitly, along # with case-insensitive versions 'eq' => \&eq, 'ne' => \&ne, 'lt' => \<, 'gt' => \>, 'le' => \&le, 'ge' => \≥ sub import { my $pkg = shift; my @defs = qw/integer float binary q qr/; my @req; @_ = ':all' unless @_; for my $key (@_) { if ($key eq ':all') { @req = @defs; } else { die __PACKAGE__ . " does not export '$key'" unless grep /^$key$/ => @defs; push @req => $key; } } overload::constant map { $_ => \&handle } @req; # also manually export some routines my $callpkg = caller(1); no strict 'refs'; *{"$callpkg\::$_"} = \&{"$pkg\::$_"} for qw/pass_on passed_on get_pass_on/; } # object's hash keys that aren't properties (apart from those starting with # and underscore, which are private anyway) our %NON_PROPS = map { $_ => 1 } our @NON_PROPS = qw/true/; # property propagation sub pass_on { our %PASS_ON = map { $_ => 1 } our @PASS_ON = @_; } sub passed_on { our %PASS_ON; exists $PASS_ON{ +shift } } sub get_pass_on { our @PASS_ON } sub get_props { # get a list of the value's properties my $self = shift; our %NON_PROPS; return grep { !(/^_/ || exists $NON_PROPS{$_}) } keys %$self; } sub del_prop { # delete one or more properties my $self = shift; our %NON_PROPS; for my $prop (@_) { die "$prop is private, not a property" if substr($prop, 0, 1) eq '_'; die "$prop cannot be deleted" if exists $NON_PROPS{$prop}; delete $self->{$prop}; } } sub del_all_props { my $self = shift; my @props = $self->get_props; delete $self->{$_} for @props; } sub handle { # create a new overloaded object my ($orig, $interp, $context, $sub, @prop) = @_; my $self = bless { _value => $orig, _interp => $interp, _context => $context, true => ($orig) ? 1 : 0, }, __PACKAGE__; # propagate properties marked as such via pass_on from # participating overloaded values passed in @prop for my $val (grep { ref $_ eq __PACKAGE__ } @prop) { for my $prop ($val->get_props) { $self->{$prop} = $val->{$prop} if passed_on($prop); } } return $self; } sub create { # take a value and a list of participating values and create # a new object from them by filling in the gaps that handle() # expects with defaults. As seen from handle(), the participating # values (i.e., the values that the first arg was derived from) # are passed so that properties can be properly propagated my ($val, @props) = @_; handle($val, $val, '', sub { }, @props); } # call this as a sub, not a method as it also takes unblessed scalars # anything not of this package is stringified to give any potential # other overloading a chance to get at it's actual value sub value { # my $v = ref $_[0] eq __PACKAGE__ ? $_[0]->{_value} : "$_[0]"; # $v =~ s/\\n/\n/gs; # no idea why newlines become literal '\n' my $v = ref $_[0] eq __PACKAGE__ ? $_[0]->{_interp} : "$_[0]"; return $v; } # ==================== Generated methods ==================== # Generate some string, numeric and boolean methods sub gen_meth { my $template = shift; while (my ($name, $op) = splice(@_, 0, 2)) { (my $code = $template) =~ s/NAME/$name/g; $code =~ s/OP/$op/g; eval $code; die "Internal error: $@" if $@; } } my $binop = 'sub NAME { my($n, $m) = @_[0,1]; ($m, $n) = ($n, $m) if($_[2]); create(value($n) OP value($m), $n, $m) }'; gen_meth $binop, qw! plus + minus - times * divide / modulo % exp ** numcmp <=> cmp cmp eq eq ne ne lt lt gt gt le le ge ge concat . append . !; # needs 'CORE::lc', otherwise 'Ambiguous call resolved as CORE::lc()' my $bool_i = 'sub NAME { create( CORE::lc(value($_[0])) OP CORE::lc(value($_[1])), @_[0,1] ) }'; gen_meth $bool_i, qw! eqi eq nei ne lti lt gti gt lei le gei ge !; my $func = 'sub NAME { create(OP(value($_[0])), $_[0]) }'; gen_meth $func, qw! abs abs length CORE::length size CORE::length uc uc ucfirst ucfirst lc lc lcfirst lcfirst hex hex oct oct !; # ==================== Miscellaneous Numeric methods ==================== sub zero { create($_[0] == 0, $_[0]) } # ==================== Miscellaneous Boolean methods ==================== sub is_true { $_[0]->{true} } sub is_false { !$_[0]->{true} } sub true { my $self = shift; $self->{true} = @_ ? shift : 1; return $self; } sub false { $_[0]->true(0) } # ==================== Miscellaneous String methods ==================== sub reverse { create(scalar reverse(value($_[0])), $_[0]) } sub swapcase { my $s = shift; $s =~ y/A-Za-z/a-zA-Z/; return create($s) } # $foo->split(/PATTERN/, LIMIT) sub split { my ($orig, $pat, $limit) = @_; $limit ||= 0; $pat = qr/\s+/ unless ref($pat) eq 'Regexp'; # The following should work: # map { create($_, $orig) } split $pat => value($orig), $limit; # But there seems to be a bug in split # (cf. p5p: 'Bug report: split splits on wrong pattern') my @el; eval '@el = split $pat => value($orig), $limit;'; die $@ if $@; return map { create($_, $orig) } @el; } # ==================== Code-execution methods ==================== sub times_do { my ($self, $sub) = @_; die 'times_do() method expected a coderef' unless ref $sub eq 'CODE'; for my $i (1 .. $self) { $sub->($i); } } sub do_upto_step { my ($self, $limit, $step, $sub) = @_; die 'expected last arg to be a coderef' unless ref $sub eq 'CODE'; # for my $i ($self..$limit) { $sub->($i); } my $i = $self; while ($i <= $limit) { $sub->($i); $i += $step; } } sub do_downto_step { my ($self, $limit, $step, $sub) = @_; die 'expected last arg to be a coderef' unless ref $sub eq 'CODE'; my $i = $self; while ($i >= $limit) { $sub->($i); $i -= $step; } } sub do_upto { do_upto_step($_[0], $_[1], 1, $_[2]) } sub do_downto { do_downto_step($_[0], $_[1], 1, $_[2]) } sub AUTOLOAD { my $self = shift; (my $prop = our $AUTOLOAD) =~ s/.*:://; return if $prop eq 'DESTROY' || substr($prop, 0, 1) eq '_'; # $x->is_foo or $x->has_foo will return true if 'foo' is # a hash key with a true value return defined $self->{ substr($prop, 4) } && $self->{ substr($prop, 4) } if substr($prop, 0, 4) eq 'has_'; return defined $self->{ substr($prop, 3) } && $self->{ substr($prop, 3) } if substr($prop, 0, 3) eq 'is_'; if (@_) { $self->{$prop} = shift; return $self; } return $self->{$prop}; } 1; __END__ =pod =for stopwords abs eqi gei gti lei lti oct swapcase =head1 NAME Scalar::Properties - Run-time properties on scalar variables =head1 VERSION version 1.100860 =head1 SYNOPSIS use Scalar::Properties; my $val = 0->true; if ($val && $val == 0) { print "yup, its true alright...\n"; } my @text = ( 'hello world'->greeting(1), 'forget it', 'hi there'->greeting(1), ); print grep { $_->is_greeting } @text; my $l = 'hello world'->length; =head1 DESCRIPTION Scalar::Properties attempts to make Perl more object-oriented by taking an idea from Ruby: Everything you manipulate is an object, and the results of those manipulations are objects themselves. 'hello world'->length (-1234)->abs "oh my god, it's full of properties"->index('g') The first example asks a string to calculate its length. The second example asks a number to calculate its absolute value. And the third example asks a string to find the index of the letter 'g'. Using this module you can have run-time properties on initialized scalar variables and literal values. The word 'properties' is used in the Perl 6 sense: out-of-band data, little sticky notes that are attached to the value. While attributes (as in Perl 5's attribute pragma, and see the C family of modules) are handled at compile-time, properties are handled at run-time. Internally properties are implemented by making their values into objects with overloaded operators. The actual properties are then simply hash entries. Most properties are simply notes you attach to the value, but some may have deeper meaning. For example, the C and C properties plays a role in boolean context, as the first example of the Synopsis shows. Properties can also be propagated between values. For details, see the EXPORTS section below. Here is an example why this might be desirable: pass_on('approximate'); my $pi = 3->approximate(1); my $circ = 2 * $rad * $pi; # now $circ->approximate indicates that this value was derived # from approximate values Please don't use properties whose name start with an underscore; these are reserved for internal use. You can set and query properties like this: =over 4 =item C<$var-Emyprop(1)> sets the property to a true value. =item C<$var-Emyprop(0)> sets the property to a false value. Note that this doesn't delete the property (to do so, use the C method described below). =item C<$var-Eis_myprop>, C<$var-Ehas_myprop> returns a true value if the property is set (i.e., defined and has a true value). The two alternate interfaces are provided to make querying attributes sound more natural. For example: $foo->is_approximate; $bar->has_history; =back Values thus made into objects also expose various utility methods. All of those methods (unless noted otherwise) return the result as an overloaded value ready to take properties and method calls itself, and don't modify the original value. =head1 METHODS =head2 get_props Get a list of names of the value's properties. =head2 del_props(LIST) Deletes one or more properties from the value. This is different than setting the property value to zero. =head2 del_all_props Deletes all of the value's properties. =head2 plus(EXPR) Returns the value that is the sum of the value whose method has been called and the argument value. This method also overloads addition, so: $a = 7 + 2; $a = 7->plus(2); # the same =head2 minus(EXPR) Returns the value that is the the value whose method has been called minus the argument value. This method also overloads subtraction. =head2 times(EXPR) Returns the value that is the the value whose method has been called times the argument value. This method also overloads multiplication. =head2 divide(EXPR) Returns the value that is the the value whose method has been called divided by the argument value. This method also overloads division. =head2 modulo(EXPR) Returns the value that is the the value whose method has been called modulo the argument value. This method also overloads the modulo operator. =head2 exp(EXPR) Returns the value that is the the value whose method has been called powered by the argument value. This method also overloads the exponentiation operator. =head2 abs Returns the absolute of the value. =head2 zero Returns a boolean value indicating whether the value is equal to 0. =head2 length Returns the result of the built-in C function applied to the value. =head2 size Same as C. =head2 reverse Returns the reverse string of the value. =head2 uc Returns the result of the built-in function C applied to the value. =head2 ucfirst Returns the result of the built-in function C applied to the value. =head2 lc Returns the result of the built-in function C applied to the value. =head2 lcfirst Returns the result of the built-in function C applied to the value. =head2 hex Returns the result of the built-in function C applied to the value. =head2 oct Returns the result of the built-in function C applied to the value. =head2 concat(EXPR) Returns the result of the argument expression appended to the value. =head2 append(EXPR) Same as C. =head2 swapcase Returns a version of the value with every character's case reversed, i.e. a lowercase character becomes uppercase and vice versa. =head2 split /PATTERN/, LIMIT Returns a list of overloaded values that is the result of splitting (according to the built-in C function) the value along the pattern, into a number of values up to the limit. =head2 numcmp(EXPR) Returns the (overloaded) value of the numerical three-way comparison. This method also overloads the C=E> operator. =head2 cmp(EXPR) Returns the (overloaded) value of the alphabetical three-way comparison. This method also overloads the C operator. =head2 eq(EXPR) Return the (overloaded) boolean value of the C string comparison. This method also overloads that operators. =head2 ne(EXPR) Return the (overloaded) boolean value of the C string comparison. This method also overloads that operators. =head2 lt(EXPR) Return the (overloaded) boolean value of the C string comparison. This method also overloads that operators. =head2 gt(EXPR) Return the (overloaded) boolean value of the C string comparison. This method also overloads that operators. =head2 le(EXPR) Return the (overloaded) boolean value of the C string comparison. This method also overloads that operators. =head2 ge(EXPR) Return the (overloaded) boolean value of the C string comparison. This method also overloads that operators. =head2 eqi Same as C, but is case-insensitive. =head2 nei> Same as C, but is case-insensitive. =head2 lti Same as C, but is case-insensitive. =head2 gti Same as C, but is case-insensitive. =head2 lei Same as C, but is case-insensitive. =head2 gei Same as C, but is case-insensitive. =head2 is_true Returns whether the (overloaded) boolean status of the value is true. =head2 is_false Returns whether the (overloaded) boolean status of the value is false. =head2 create FIXME =head2 del_prop FIXME =head2 do_downto FIXME =head2 do_downto_step FIXME =head2 do_upto FIXME =head2 do_upto_step FIXME =head2 false FIXME =head2 gen_meth FIXME =head2 handle FIXME =head2 times_do FIXME =head2 true FIXME =head2 value FIXME =head1 FUNCTIONS =head2 pass_on(LIST) Sets (replaces) the list of properties that are passed on. There is only one such list for the whole mechanism. The whole property interface is experimental, but this one in particular is likely to change in the future. This function is exported automatically. =head2 passed_on(STRING) Tests whether a property is passed on and returns a boolean value. This function is exported automatically. =head2 get_pass_on Returns a list of names of properties that are passed on. This function is exported automatically. =head1 INSTALLATION See perlmodinstall for information and options on installing Perl modules. =head1 BUGS AND LIMITATIONS No bugs have been reported. Please report any bugs or feature requests through the web interface at L. =head1 AVAILABILITY The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit L to find a CPAN site near you, or see L. The development version lives at L. Instead of sending patches, please fork this project using the standard git and github infrastructure. =head1 AUTHOR Marcel Gruenauer =head1 COPYRIGHT AND LICENSE This software is copyright (c) 2001 by Marcel Gruenauer. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. =cut t000755000765000024 011353417342 15226 5ustar00marcelstaff000000000000Scalar-Properties-1.10086001_all.t000644000765000024 1640511353417342 16650 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t# Before `make install' is performed this script should be runnable with # `make test'. After `make install' it should work as `perl test.pl' ######################### We start with some black magic to print on failure. # Change 1..1 below to 1..last_test_to_print . # (It may become useful if the test is moved to ./t subdirectory.) BEGIN { $| = 1; print "1..151\n"; } END { print "not ok 1\n" unless $loaded; } use Scalar::Properties; $loaded = 1; print "ok 1\n"; ######################### End of black magic. # Insert your test code below (better if it prints "ok 13" # (correspondingly "not ok 13") depending on the success of chunk 13 # of the test code): our $testcount = 1; # compensate for 'ok' above sub true { my $ok = shift; our $testcount; $testcount++; print 'not ' unless $ok; print "ok $testcount " . ($_[0] ? $_[0] : '') . "\n"; } sub false { true(!$_[0]) } my $pkg = 'Scalar::Properties'; { # test added by DCANTRELL to tickle the binary-op operand re-ordering bug true(time - 300 > 0, "binary-op operand re-ordering bug"); } { # test added by DCANTRELL to test for rt.cpan.org bug 4312 my $test = 0; true( $test . "\$test" . "\\$test" . "\\\$test" . "\\\\$test" eq '0$test\0\$test\\\\0', "variable interpolation bug" ); } # die; false(0); true(1); false(0->is_true); true(0->is_false); false(1->is_false); true(1->is_true); { my $foo = 0->true; true($foo->value == 0->{_value}); true($foo); $foo += 7; true(ref $foo eq $pkg); true($foo); true($foo == 7); true($foo->{_value} == 7); } { my $bar = 42->times(3); true($bar == 126); true($bar); $bar->false; false($bar); true($bar == 126); true($bar->times(4) == 504); # set a property; note that the '1' itself becomes overloaded. $bar->approximate(1); true($bar->approximate); true($bar->is_approximate); true($bar->has_approximate); $bar->approximate(0); false($bar->approximate); false($bar->is_approximate); false($bar->has_approximate); } { my $val = 0->true; true($val && $val == 0); } { my $quux = 37->prime(1); true($quux); true($quux == 37); true($quux->is_prime); } { my $baza = 42->value; my $bazb = 42; true(ref $baza eq ''); true($baza == $bazb); } { my $h = 'hello world'; true($h); true($h eq 'hello world'); $h->greeting(1); true($h->is_greeting); my @blah; push @blah => $h; push @blah => 'forget it'; push @blah => 'hi there'->greeting(1); my @greets = grep { $_->is_greeting } @blah; true(@greets == 2); true($greets[0] eq 'hello world'); true($greets[1] eq 'hi there'); } { false(''); true(''->true); false(''->false); true('x'); true('x'->true); false('x'->false); } { my $len = 'hello world'->length; true(ref $len eq $pkg); true($len == 11); my $rev = 'hello world'->reverse; true(ref $rev eq $pkg); true($rev eq 'dlrow olleh'); true(1234->length == 4); true(1234->size == 1234->length); true(1234->reverse == 4321); } { my $t = 'hello cruel world'; my @s; @s = $t->split; true(@s == 3); true($s[0] eq 'hello'); true($s[1] eq 'cruel'); true($s[2] eq 'world'); @s = $t->split(qr/ll/); true(@s == 2); true($s[0] eq 'he'); true($s[1] eq 'o cruel world'); @s = $t->split(qr/\s+/, 2); true(@s == 2); true($s[0] eq 'hello'); true($s[1] eq 'cruel world'); # There was a bug with split(), so we try it again to be # sure it works @s = $t->split(qr/ll/); true(@s == 2); true($s[0] eq 'he'); true($s[1] eq 'o cruel world'); } { true('hello world'->uc eq 'HELLO WORLD'); true('hello world'->ucfirst eq 'Hello world'); true('HELLO WORLD'->lc eq 'hello world'); true('HELLO WORLD'->lcfirst eq 'hELLO WORLD'); my $s = 'hello world'; true(ref $s->uc eq $pkg); true(ref $s->ucfirst eq $pkg); true(ref $s->lc eq $pkg); true(ref $s->lcfirst eq $pkg); } { true('0xAf'->hex == 175); true('aF'->hex == 175); true(123->hex == 291); true(777->oct == 511); true(123->oct == 83); my $h = '0xffffff'; true(ref $h->hex eq $pkg); true(ref $h->oct eq $pkg); } { true('hello'->concat(' world') eq 'hello world'); true(ref 'hello'->concat(' world') eq $pkg); true(ref 'hello'->append(' world') eq $pkg); } { my $s = 'Hello World'; true($s->swapcase, 'hELLO wORLD'); } { my $s1 = 'aaa'; my $s2 = 'bbb'; true($s1 eq $s1); true($s1->eq($s1)); true($s1 ne $s2); true($s1->ne($s2)); true($s1 lt $s2); true($s1->lt($s2)); true($s2 gt $s1); true($s2->gt($s1)); true($s1 le $s1); true($s1 le $s2); true($s1->le($s1)); true($s1->le($s2)); true($s2 ge $s1); true($s2 ge $s2); true($s2->ge($s1)); true($s2->ge($s2)); true(ref $s1->eq($s1) eq $pkg); true(ref $s1->ne($s1) eq $pkg); true(ref $s1->lt($s1) eq $pkg); true(ref $s1->gt($s1) eq $pkg); true(ref $s1->le($s1) eq $pkg); true(ref $s1->ge($s1) eq $pkg); } { my $s1 = 'aaa'; my $s2 = 'BBB'; true($s1->eqi($s1)); true($s1->nei($s2)); true($s1->lti($s2)); true($s2->gti($s1)); true($s1->lei($s1)); true($s1->lei($s2)); true($s2->gei($s1)); true($s2->gei($s2)); true(ref $s1->eqi($s1) eq $pkg); true(ref $s1->nei($s1) eq $pkg); true(ref $s1->lti($s1) eq $pkg); true(ref $s1->gti($s1) eq $pkg); true(ref $s1->lei($s1) eq $pkg); true(ref $s1->gei($s1) eq $pkg); } { my $out; 3->times_do(sub { $out .= 'Hello' }); true($out eq 'HelloHelloHello'); $out = ''; 5->times_do(sub { $out .= shift }); true($out == 12345); my $sub = sub { $out .= "$_[0].. " }; $out = ''; 1->do_upto(5 => $sub); true($out eq '1.. 2.. 3.. 4.. 5.. '); $out = ''; 1->do_upto_step(5, 2, $sub); true($out eq '1.. 3.. 5.. '); $out = ''; 5->do_upto(1 => $sub); true($out eq ''); $out = ''; 5->do_downto(3 => $sub); true($out eq '5.. 4.. 3.. '); $out = ''; 5->do_downto_step(2, 2, $sub); true($out eq '5.. 3.. '); $out = ''; 3->do_downto(5 => $sub); true($out eq ''); } { true((-1942)->abs() == 1942); true(0->abs == 0); true(773->abs == 773); true(0->zero); false(1->zero); my $foo = 27; false($foo->zero); $foo -= 27; true($foo->zero); } { pass_on('approximate'); true(get_pass_on == 1); true(passed_on('approximate')); } { my $foo = 1; $foo->history(1); my $pi = 3->approximate(1); my $bar = $foo + $pi; true($bar->is_approximate); false($bar->has_history); } { my $h1 = 'hi world'->approximate(1); my $h2 = $h1->uc; my @h3 = $h1->split; true($_->approximate) for $h1, $h2, @h3; } { my $ship = 1701->class('galaxy'); $ship->quadrant('alpha'); $ship->crew(1017); my @props = $ship->get_props; true(@props == 3); true(grep /^$_$/ => @props) for qw/class quadrant crew/; $ship->crew(0); true($ship->get_props == 3); $ship->del_prop('crew'); @props = $ship->get_props; true(@props == 2); true(grep /^$_$/ => @props) for qw/class quadrant/; $ship->del_all_props; @props = $ship->get_props; true(@props == 0); } 00-compile.t000644000765000024 171411353417342 17422 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl use strict; use warnings; use Test::More; use File::Find; use File::Temp qw{ tempdir }; my @modules; find( sub { return if $File::Find::name !~ /\.pm\z/; my $found = $File::Find::name; $found =~ s{^lib/}{}; $found =~ s{[/\\]}{::}g; $found =~ s/\.pm$//; # nothing to skip push @modules, $found; }, 'lib', ); my @scripts = glob "bin/*"; plan tests => scalar(@modules) + scalar(@scripts); { # fake home for cpan-testers # no fake requested ## local $ENV{HOME} = tempdir( CLEANUP => 1 ); is( qx{ $^X -Ilib -e "use $_; print '$_ ok'" }, "$_ ok", "$_ loaded ok" ) for sort @modules; SKIP: { eval "use Test::Script; 1;"; skip "Test::Script needed to test script compilation", scalar(@scripts) if $@; foreach my $file ( @scripts ) { my $script = $file; $script =~ s!.*/!!; script_compiles_ok( $file, "$script script compiles" ); } } } author-critic.t000644000765000024 54411353417342 20312 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{AUTHOR_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for testing by the author'); } } use strict; use warnings; use Test::More; use English qw(-no_match_vars); eval "use Test::Perl::Critic"; plan skip_all => 'Test::Perl::Critic required to criticise code' if $@; all_critic_ok();release-meta-yaml.t000644000765000024 45411353417342 21041 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::CPAN::Meta"; plan skip_all => "Test::CPAN::Meta required for testing META.yml" if $@; meta_yaml_ok();release-pod-coverage.t000644000765000024 76411353417342 21532 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::Pod::Coverage 1.08"; plan skip_all => "Test::Pod::Coverage 1.08 required for testing POD coverage" if $@; eval "use Pod::Coverage::TrustPod"; plan skip_all => "Pod::Coverage::TrustPod required for testing POD coverage" if $@; all_pod_coverage_ok({ coverage_class => 'Pod::Coverage::TrustPod' });release-pod-syntax.t000644000765000024 44711353417342 21263 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::Pod 1.00"; plan skip_all => "Test::Pod 1.00 required for testing POD" if $@; all_pod_files_ok();release-pod-spell.t000644000765000024 67311353417342 21055 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Pod::Wordlist::hanekomu"; plan skip_all => "Pod::Wordlist:hanekomu required for testing POD spelling" if $@; eval "use Test::Spelling"; plan skip_all => "Test::Spelling required for testing POD spelling" if $@; all_pod_files_spelling_ok('lib');release-kwalitee.t000644000765000024 43211353417342 20754 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::Kwalitee"; plan skip_all => "Test::Kwalitee required for testing kwalitee" if $@;release-portability.t000644000765000024 47611353417342 21521 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::Portability::Files"; plan skip_all => "Test::Portability::Files required for testing portability" if $@; run_tests();release-synopsis.t000644000765000024 46211353417342 21041 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::Synopsis"; plan skip_all => "Test::Synopsis required for testing synopses" if $@; all_synopsis_ok('lib');release-minimum-version.t000644000765000024 52511353417342 22310 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::MinimumVersion"; plan skip_all => "Test::MinimumVersion required for testing minimum versions" if $@; all_minimum_version_from_metayml_ok();release-has-version.t000644000765000024 47211353417342 21411 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::HasVersion"; plan skip_all => "Test::HasVersion required for testing version numbers" if $@; all_pm_version_ok();release-check-changes.t000644000765000024 45711353417342 21641 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::CheckChanges"; plan skip_all => "Test::CheckChanges required for testing changes" if $@; ok_changes();release-dist-manifest.t000644000765000024 46511353417342 21724 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl BEGIN { unless ($ENV{RELEASE_TESTING}) { require Test::More; Test::More::plan(skip_all => 'these tests are for release candidate testing'); } } use Test::More; eval "use Test::DistManifest"; plan skip_all => "Test::DistManifest required for testing the manifest" if $@; manifest_ok();MANIFEST.SKIP000644000765000024 73411353417342 17004 0ustar00marcelstaff000000000000Scalar-Properties-1.100860# Version control files and dirs. bRCS\b bCVS\b .svn .git ,v$ # Makemaker/Build.PL generated files and dirs. MANIFEST.old ^Makefile$ ^Build$ ^blib ^pm_to_blib$ ^_build ^MakeMaker-\d embedded cover_db smoke.html smoke.yaml smoketee.txt sqlnet.log BUILD.SKIP COVER.SKIP CPAN.SKIP t/000_standard__* Debian_CPANTS.txt nytprof.out # Temp, old, emacs, vim, backup files. ~$ .old$ .swp$ .tar$ .tar\.gz$ ^#.*#$ ^\.# .shipit # Local files, not to be included ^scratch$ ^core$ ^var$ perlcriticrc000644000765000024 56411353417342 17762 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t# no strict 'refs' [TestingAndDebugging::ProhibitNoStrict] allow = refs [-BuiltinFunctions::ProhibitStringyEval] [-ControlStructures::ProhibitMutatingListFunctions] [-Subroutines::ProhibitExplicitReturnUndef] [-Subroutines::ProhibitSubroutinePrototypes] [-Variables::ProhibitConditionalDeclarations] # for mkdir $dir, 0777 [-ValuesAndExpressions::ProhibitLeadingZeros] 000-report-versions.t000644000765000024 2474711353417342 21266 0ustar00marcelstaff000000000000Scalar-Properties-1.100860/t#!perl use warnings; use strict; use Test::More 0.88; # Include a cut-down version of YAML::Tiny so we don't introduce unnecessary # dependencies ourselves. package Local::YAML::Tiny; use strict; use Carp 'croak'; # UTF Support? sub HAVE_UTF8 () { $] >= 5.007003 } BEGIN { if ( HAVE_UTF8 ) { # The string eval helps hide this from Test::MinimumVersion eval "require utf8;"; die "Failed to load UTF-8 support" if $@; } # Class structure require 5.004; $YAML::Tiny::VERSION = '1.40'; # Error storage $YAML::Tiny::errstr = ''; } # Printable characters for escapes my %UNESCAPES = ( z => "\x00", a => "\x07", t => "\x09", n => "\x0a", v => "\x0b", f => "\x0c", r => "\x0d", e => "\x1b", '\\' => '\\', ); ##################################################################### # Implementation # Create an empty YAML::Tiny object sub new { my $class = shift; bless [ @_ ], $class; } # Create an object from a file sub read { my $class = ref $_[0] ? ref shift : shift; # Check the file my $file = shift or return $class->_error( 'You did not specify a file name' ); return $class->_error( "File '$file' does not exist" ) unless -e $file; return $class->_error( "'$file' is a directory, not a file" ) unless -f _; return $class->_error( "Insufficient permissions to read '$file'" ) unless -r _; # Slurp in the file local $/ = undef; local *CFG; unless ( open(CFG, $file) ) { return $class->_error("Failed to open file '$file': $!"); } my $contents = ; unless ( close(CFG) ) { return $class->_error("Failed to close file '$file': $!"); } $class->read_string( $contents ); } # Create an object from a string sub read_string { my $class = ref $_[0] ? ref shift : shift; my $self = bless [], $class; my $string = $_[0]; unless ( defined $string ) { return $self->_error("Did not provide a string to load"); } # Byte order marks # NOTE: Keeping this here to educate maintainers # my %BOM = ( # "\357\273\277" => 'UTF-8', # "\376\377" => 'UTF-16BE', # "\377\376" => 'UTF-16LE', # "\377\376\0\0" => 'UTF-32LE' # "\0\0\376\377" => 'UTF-32BE', # ); if ( $string =~ /^(?:\376\377|\377\376|\377\376\0\0|\0\0\376\377)/ ) { return $self->_error("Stream has a non UTF-8 BOM"); } else { # Strip UTF-8 bom if found, we'll just ignore it $string =~ s/^\357\273\277//; } # Try to decode as utf8 utf8::decode($string) if HAVE_UTF8; # Check for some special cases return $self unless length $string; unless ( $string =~ /[\012\015]+\z/ ) { return $self->_error("Stream does not end with newline character"); } # Split the file into lines my @lines = grep { ! /^\s*(?:\#.*)?\z/ } split /(?:\015{1,2}\012|\015|\012)/, $string; # Strip the initial YAML header @lines and $lines[0] =~ /^\%YAML[: ][\d\.]+.*\z/ and shift @lines; # A nibbling parser while ( @lines ) { # Do we have a document header? if ( $lines[0] =~ /^---\s*(?:(.+)\s*)?\z/ ) { # Handle scalar documents shift @lines; if ( defined $1 and $1 !~ /^(?:\#.+|\%YAML[: ][\d\.]+)\z/ ) { push @$self, $self->_read_scalar( "$1", [ undef ], \@lines ); next; } } if ( ! @lines or $lines[0] =~ /^(?:---|\.\.\.)/ ) { # A naked document push @$self, undef; while ( @lines and $lines[0] !~ /^---/ ) { shift @lines; } } elsif ( $lines[0] =~ /^\s*\-/ ) { # An array at the root my $document = [ ]; push @$self, $document; $self->_read_array( $document, [ 0 ], \@lines ); } elsif ( $lines[0] =~ /^(\s*)\S/ ) { # A hash at the root my $document = { }; push @$self, $document; $self->_read_hash( $document, [ length($1) ], \@lines ); } else { croak("YAML::Tiny failed to classify the line '$lines[0]'"); } } $self; } # Deparse a scalar string to the actual scalar sub _read_scalar { my ($self, $string, $indent, $lines) = @_; # Trim trailing whitespace $string =~ s/\s*\z//; # Explitic null/undef return undef if $string eq '~'; # Quotes if ( $string =~ /^\'(.*?)\'\z/ ) { return '' unless defined $1; $string = $1; $string =~ s/\'\'/\'/g; return $string; } if ( $string =~ /^\"((?:\\.|[^\"])*)\"\z/ ) { # Reusing the variable is a little ugly, # but avoids a new variable and a string copy. $string = $1; $string =~ s/\\"/"/g; $string =~ s/\\([never\\fartz]|x([0-9a-fA-F]{2}))/(length($1)>1)?pack("H2",$2):$UNESCAPES{$1}/gex; return $string; } # Special cases if ( $string =~ /^[\'\"!&]/ ) { croak("YAML::Tiny does not support a feature in line '$lines->[0]'"); } return {} if $string eq '{}'; return [] if $string eq '[]'; # Regular unquoted string return $string unless $string =~ /^[>|]/; # Error croak("YAML::Tiny failed to find multi-line scalar content") unless @$lines; # Check the indent depth $lines->[0] =~ /^(\s*)/; $indent->[-1] = length("$1"); if ( defined $indent->[-2] and $indent->[-1] <= $indent->[-2] ) { croak("YAML::Tiny found bad indenting in line '$lines->[0]'"); } # Pull the lines my @multiline = (); while ( @$lines ) { $lines->[0] =~ /^(\s*)/; last unless length($1) >= $indent->[-1]; push @multiline, substr(shift(@$lines), length($1)); } my $j = (substr($string, 0, 1) eq '>') ? ' ' : "\n"; my $t = (substr($string, 1, 1) eq '-') ? '' : "\n"; return join( $j, @multiline ) . $t; } # Parse an array sub _read_array { my ($self, $array, $indent, $lines) = @_; while ( @$lines ) { # Check for a new document if ( $lines->[0] =~ /^(?:---|\.\.\.)/ ) { while ( @$lines and $lines->[0] !~ /^---/ ) { shift @$lines; } return 1; } # Check the indent level $lines->[0] =~ /^(\s*)/; if ( length($1) < $indent->[-1] ) { return 1; } elsif ( length($1) > $indent->[-1] ) { croak("YAML::Tiny found bad indenting in line '$lines->[0]'"); } if ( $lines->[0] =~ /^(\s*\-\s+)[^\'\"]\S*\s*:(?:\s+|$)/ ) { # Inline nested hash my $indent2 = length("$1"); $lines->[0] =~ s/-/ /; push @$array, { }; $self->_read_hash( $array->[-1], [ @$indent, $indent2 ], $lines ); } elsif ( $lines->[0] =~ /^\s*\-(\s*)(.+?)\s*\z/ ) { # Array entry with a value shift @$lines; push @$array, $self->_read_scalar( "$2", [ @$indent, undef ], $lines ); } elsif ( $lines->[0] =~ /^\s*\-\s*\z/ ) { shift @$lines; unless ( @$lines ) { push @$array, undef; return 1; } if ( $lines->[0] =~ /^(\s*)\-/ ) { my $indent2 = length("$1"); if ( $indent->[-1] == $indent2 ) { # Null array entry push @$array, undef; } else { # Naked indenter push @$array, [ ]; $self->_read_array( $array->[-1], [ @$indent, $indent2 ], $lines ); } } elsif ( $lines->[0] =~ /^(\s*)\S/ ) { push @$array, { }; $self->_read_hash( $array->[-1], [ @$indent, length("$1") ], $lines ); } else { croak("YAML::Tiny failed to classify line '$lines->[0]'"); } } elsif ( defined $indent->[-2] and $indent->[-1] == $indent->[-2] ) { # This is probably a structure like the following... # --- # foo: # - list # bar: value # # ... so lets return and let the hash parser handle it return 1; } else { croak("YAML::Tiny failed to classify line '$lines->[0]'"); } } return 1; } # Parse an array sub _read_hash { my ($self, $hash, $indent, $lines) = @_; while ( @$lines ) { # Check for a new document if ( $lines->[0] =~ /^(?:---|\.\.\.)/ ) { while ( @$lines and $lines->[0] !~ /^---/ ) { shift @$lines; } return 1; } # Check the indent level $lines->[0] =~ /^(\s*)/; if ( length($1) < $indent->[-1] ) { return 1; } elsif ( length($1) > $indent->[-1] ) { croak("YAML::Tiny found bad indenting in line '$lines->[0]'"); } # Get the key unless ( $lines->[0] =~ s/^\s*([^\'\" ][^\n]*?)\s*:(\s+|$)// ) { if ( $lines->[0] =~ /^\s*[?\'\"]/ ) { croak("YAML::Tiny does not support a feature in line '$lines->[0]'"); } croak("YAML::Tiny failed to classify line '$lines->[0]'"); } my $key = $1; # Do we have a value? if ( length $lines->[0] ) { # Yes $hash->{$key} = $self->_read_scalar( shift(@$lines), [ @$indent, undef ], $lines ); } else { # An indent shift @$lines; unless ( @$lines ) { $hash->{$key} = undef; return 1; } if ( $lines->[0] =~ /^(\s*)-/ ) { $hash->{$key} = []; $self->_read_array( $hash->{$key}, [ @$indent, length($1) ], $lines ); } elsif ( $lines->[0] =~ /^(\s*)./ ) { my $indent2 = length("$1"); if ( $indent->[-1] >= $indent2 ) { # Null hash entry $hash->{$key} = undef; } else { $hash->{$key} = {}; $self->_read_hash( $hash->{$key}, [ @$indent, length($1) ], $lines ); } } } } return 1; } # Set error sub _error { $YAML::Tiny::errstr = $_[1]; undef; } # Retrieve error sub errstr { $YAML::Tiny::errstr; } ##################################################################### # Use Scalar::Util if possible, otherwise emulate it BEGIN { eval { require Scalar::Util; }; if ( $@ ) { # Failed to load Scalar::Util eval <<'END_PERL'; sub refaddr { my $pkg = ref($_[0]) or return undef; if (!!UNIVERSAL::can($_[0], 'can')) { bless $_[0], 'Scalar::Util::Fake'; } else { $pkg = undef; } "$_[0]" =~ /0x(\w+)/; my $i = do { local $^W; hex $1 }; bless $_[0], $pkg if defined $pkg; $i; } END_PERL } else { Scalar::Util->import('refaddr'); } } ##################################################################### # main test ##################################################################### package main; BEGIN { # Skip modules that either don't want to be loaded directly, such as # Module::Install, or that mess with the test count, such as the Test::* # modules listed here. my %skip = map { $_ => 1 } qw( App::FatPacker Module::Install Test::YAML::Meta Test::Pod::Coverage Test::Portability::Files ); my $Test = Test::Builder->new; $Test->plan(skip_all => "META.yml could not be found") unless -f 'META.yml' and -r _; my $meta = (Local::YAML::Tiny->read('META.yml'))->[0]; my %requires; for my $require_key (grep { /requires/ } keys %$meta) { my %h = %{ $meta->{$require_key} }; $requires{$_}++ for keys %h; } delete $requires{perl}; diag("Testing with Perl $], $^X"); for my $module (sort keys %requires) { next if $skip{$module}; use_ok $module or BAIL_OUT("can't load $module"); local $SIG{__WARN__} = sub { note "$module: $_[0]" }; my $version = $module->VERSION; $version = 'undefined' unless defined $version; diag(" $module version is $version"); } done_testing; } LICENSE000644000765000024 4353011353417342 16154 0ustar00marcelstaff000000000000Scalar-Properties-1.100860This software is copyright (c) 2001 by Marcel Gruenauer. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. Terms of the Perl programming language system itself a) the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or b) the "Artistic License" --- The GNU General Public License, Version 1, February 1989 --- This software is Copyright (c) 2001 by Marcel Gruenauer. This is free software, licensed under: The GNU General Public License, Version 1, February 1989 GNU GENERAL PUBLIC LICENSE Version 1, February 1989 Copyright (C) 1989 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The license agreements of most software companies try to keep users at the mercy of those companies. By contrast, our General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. The General Public License applies to the Free Software Foundation's software and to any other program whose authors commit to using it. You can use it for your programs, too. When we speak of free software, we are referring to freedom, not price. Specifically, the General Public License is designed to make sure that you have the freedom to give away or sell copies of free software, that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of a such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must tell them their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License Agreement applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any work containing the Program or a portion of it, either verbatim or with modifications. Each licensee is addressed as "you". 1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this General Public License and to the absence of any warranty; and give any other recipients of the Program a copy of this General Public License along with the Program. You may charge a fee for the physical act of transferring a copy. 2. You may modify your copy or copies of the Program or any portion of it, and copy and distribute such modifications under the terms of Paragraph 1 above, provided that you also do the following: a) cause the modified files to carry prominent notices stating that you changed the files and the date of any change; and b) cause the whole of any work that you distribute or publish, that in whole or in part contains the Program or any part thereof, either with or without modifications, to be licensed at no charge to all third parties under the terms of this General Public License (except that you may choose to grant warranty protection to some or all third parties, at your option). c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the simplest and most usual way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this General Public License. d) You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. Mere aggregation of another independent work with the Program (or its derivative) on a volume of a storage or distribution medium does not bring the other work under the scope of these terms. 3. You may copy and distribute the Program (or a portion or derivative of it, under Paragraph 2) in object code or executable form under the terms of Paragraphs 1 and 2 above provided that you also do one of the following: a) accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Paragraphs 1 and 2 above; or, b) accompany it with a written offer, valid for at least three years, to give any third party free (except for a nominal charge for the cost of distribution) a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Paragraphs 1 and 2 above; or, c) accompany it with the information you received as to where the corresponding source code may be obtained. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form alone.) Source code for a work means the preferred form of the work for making modifications to it. For an executable file, complete source code means all the source code for all modules it contains; but, as a special exception, it need not include source code for modules which are standard libraries that accompany the operating system on which the executable file runs, or for standard header files or definitions files that accompany that operating system. 4. You may not copy, modify, sublicense, distribute or transfer the Program except as expressly provided under this General Public License. Any attempt otherwise to copy, modify, sublicense, distribute or transfer the Program is void, and will automatically terminate your rights to use the Program under this License. However, parties who have received copies, or rights to use copies, from you under this General Public License will not have their licenses terminated so long as such parties remain in full compliance. 5. By copying, distributing or modifying the Program (or any work based on the Program) you indicate your acceptance of this license to do so, and all its terms and conditions. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. 7. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of the license which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the license, you may choose any version ever published by the Free Software Foundation. 8. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS Appendix: How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to humanity, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) 19yy This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) 19xx name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (a program to direct compilers to make passes at assemblers) written by James Hacker. , 1 April 1989 Ty Coon, President of Vice That's all there is to it! --- The Artistic License 1.0 --- This software is Copyright (c) 2001 by Marcel Gruenauer. This is free software, licensed under: The Artistic License 1.0 The Artistic License Preamble The intent of this document is to state the conditions under which a Package may be copied, such that the Copyright Holder maintains some semblance of artistic control over the development of the package, while giving the users of the package the right to use and distribute the Package in a more-or-less customary fashion, plus the right to make reasonable modifications. Definitions: - "Package" refers to the collection of files distributed by the Copyright Holder, and derivatives of that collection of files created through textual modification. - "Standard Version" refers to such a Package if it has not been modified, or has been modified in accordance with the wishes of the Copyright Holder. - "Copyright Holder" is whoever is named in the copyright or copyrights for the package. - "You" is you, if you're thinking about copying or distributing this Package. - "Reasonable copying fee" is whatever you can justify on the basis of media cost, duplication charges, time of people involved, and so on. (You will not be required to justify it to the Copyright Holder, but only to the computing community at large as a market that must bear the fee.) - "Freely Available" means that no fee is charged for the item itself, though there may be fees involved in handling the item. It also means that recipients of the item may redistribute it under the same conditions they received it. 1. You may make and give away verbatim copies of the source form of the Standard Version of this Package without restriction, provided that you duplicate all of the original copyright notices and associated disclaimers. 2. You may apply bug fixes, portability fixes and other modifications derived from the Public Domain or from the Copyright Holder. A Package modified in such a way shall still be considered the Standard Version. 3. You may otherwise modify your copy of this Package in any way, provided that you insert a prominent notice in each changed file stating how and when you changed that file, and provided that you do at least ONE of the following: a) place your modifications in the Public Domain or otherwise make them Freely Available, such as by posting said modifications to Usenet or an equivalent medium, or placing the modifications on a major archive site such as ftp.uu.net, or by allowing the Copyright Holder to include your modifications in the Standard Version of the Package. b) use the modified Package only within your corporation or organization. c) rename any non-standard executables so the names do not conflict with standard executables, which must also be provided, and provide a separate manual page for each non-standard executable that clearly documents how it differs from the Standard Version. d) make other distribution arrangements with the Copyright Holder. 4. You may distribute the programs of this Package in object code or executable form, provided that you do at least ONE of the following: a) distribute a Standard Version of the executables and library files, together with instructions (in the manual page or equivalent) on where to get the Standard Version. b) accompany the distribution with the machine-readable source of the Package with your modifications. c) accompany any non-standard executables with their corresponding Standard Version executables, giving the non-standard executables non-standard names, and clearly documenting the differences in manual pages (or equivalent), together with instructions on where to get the Standard Version. d) make other distribution arrangements with the Copyright Holder. 5. You may charge a reasonable copying fee for any distribution of this Package. You may charge any fee you choose for support of this Package. You may not charge a fee for this Package itself. However, you may distribute this Package in aggregate with other (possibly commercial) programs as part of a larger (possibly commercial) software distribution provided that you do not advertise this Package as a product of your own. 6. The scripts and library files supplied as input to or produced as output from the programs of this Package do not automatically fall under the copyright of this Package, but belong to whomever generated them, and may be sold commercially, and may be aggregated with this Package. 7. C or perl subroutines supplied by you and linked into this Package shall not be considered part of this Package. 8. The name of the Copyright Holder may not be used to endorse or promote products derived from this software without specific prior written permission. 9. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. The End META.yml000644000765000024 142711353417342 16377 0ustar00marcelstaff000000000000Scalar-Properties-1.100860--- abstract: 'Run-time properties on scalar variables' author: - 'Marcel Gruenauer ' build_requires: {} configure_requires: ExtUtils::MakeMaker: 6.11 generated_by: 'Dist::Zilla version 1.100711' license: perl meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: 1.4 name: Scalar-Properties provides: Scalar::Properties: file: lib/Scalar/Properties.pm version: 1.100860 requires: Carp: 0 English: 0 File::Find: 0 File::Temp: 0 Scalar::Util: 0 Test::More: 0.88 overload: 0 perl: 5.008 resources: bugtracker: http://rt.cpan.org/Public/Dist/Display.html?Name=Scalar-Properties homepage: http://search.cpan.org/dist/Scalar-Properties/ repository: http://github.com/hanekomu/Scalar-Properties version: 1.100860 META.json000644000765000024 211111353417342 16536 0ustar00marcelstaff000000000000Scalar-Properties-1.100860{ "resources" : { "homepage" : "http://search.cpan.org/dist/Scalar-Properties/", "repository" : "http://github.com/hanekomu/Scalar-Properties", "bugtracker" : "http://rt.cpan.org/Public/Dist/Display.html?Name=Scalar-Properties" }, "generated_by" : "Dist::Zilla version 1.100711", "meta-spec" : { "version" : 1.4, "url" : "http://module-build.sourceforge.net/META-spec-v1.4.html" }, "version" : "1.100860", "name" : "Scalar-Properties", "author" : [ "Marcel Gruenauer " ], "license" : "perl", "build_requires" : {}, "provides" : { "Scalar::Properties" : { "version" : "1.100860", "file" : "lib/Scalar/Properties.pm" } }, "requires" : { "Test::More" : "0.88", "perl" : "5.008", "Scalar::Util" : "0", "English" : "0", "File::Find" : "0", "File::Temp" : "0", "overload" : "0", "Carp" : "0" }, "abstract" : "Run-time properties on scalar variables", "configure_requires" : { "ExtUtils::MakeMaker" : "6.11" } } INSTALL000644000765000024 102211353417342 16146 0ustar00marcelstaff000000000000Scalar-Properties-1.100860 This is the Perl distribution Scalar-Properties. ## Installation Scalar-Properties installation is straightforward. If your CPAN shell is set up, you should just be able to do % cpan Scalar::Properties Download it, unpack it, then build it as per the usual: % perl Makefile.PL % make && make test Then install it: % make install ## Documentation Scalar-Properties documentation is available as in POD. So you can do: % perldoc Scalar::Properties to read the documentation with your favorite pager. Makefile.PL000644000765000024 276111353417342 17102 0ustar00marcelstaff000000000000Scalar-Properties-1.100860 use strict; use warnings; BEGIN { require 5.008; } use ExtUtils::MakeMaker 6.11; my %WriteMakefileArgs = ( 'test' => { 'TESTS' => 't/*.t' }, 'NAME' => 'Scalar::Properties', 'DISTNAME' => 'Scalar-Properties', 'CONFIGURE_REQUIRES' => { 'ExtUtils::MakeMaker' => '6.11' }, 'AUTHOR' => 'Marcel Gruenauer ', 'BUILD_REQUIRES' => {}, 'ABSTRACT' => 'Run-time properties on scalar variables', 'EXE_FILES' => [], 'VERSION' => '1.100860', 'PREREQ_PM' => { 'Test::More' => '0.88', 'Scalar::Util' => '0', 'English' => '0', 'File::Find' => '0', 'File::Temp' => '0', 'overload' => '0', 'Carp' => '0' }, 'LICENSE' => 'perl' ); delete $WriteMakefileArgs{LICENSE} unless eval { ExtUtils::MakeMaker->VERSION(6.31) }; WriteMakefile(%WriteMakefileArgs); README000644000765000024 2175411353417342 16033 0ustar00marcelstaff000000000000Scalar-Properties-1.100860NAME Scalar::Properties - Run-time properties on scalar variables VERSION version 1.100860 SYNOPSIS use Scalar::Properties; my $val = 0->true; if ($val && $val == 0) { print "yup, its true alright...\n"; } my @text = ( 'hello world'->greeting(1), 'forget it', 'hi there'->greeting(1), ); print grep { $_->is_greeting } @text; my $l = 'hello world'->length; DESCRIPTION Scalar::Properties attempts to make Perl more object-oriented by taking an idea from Ruby: Everything you manipulate is an object, and the results of those manipulations are objects themselves. 'hello world'->length (-1234)->abs "oh my god, it's full of properties"->index('g') The first example asks a string to calculate its length. The second example asks a number to calculate its absolute value. And the third example asks a string to find the index of the letter 'g'. Using this module you can have run-time properties on initialized scalar variables and literal values. The word 'properties' is used in the Perl 6 sense: out-of-band data, little sticky notes that are attached to the value. While attributes (as in Perl 5's attribute pragma, and see the "Attribute::*" family of modules) are handled at compile-time, properties are handled at run-time. Internally properties are implemented by making their values into objects with overloaded operators. The actual properties are then simply hash entries. Most properties are simply notes you attach to the value, but some may have deeper meaning. For example, the "true" and "false" properties plays a role in boolean context, as the first example of the Synopsis shows. Properties can also be propagated between values. For details, see the EXPORTS section below. Here is an example why this might be desirable: pass_on('approximate'); my $pi = 3->approximate(1); my $circ = 2 * $rad * $pi; # now $circ->approximate indicates that this value was derived # from approximate values Please don't use properties whose name start with an underscore; these are reserved for internal use. You can set and query properties like this: "$var->myprop(1)" sets the property to a true value. "$var->myprop(0)" sets the property to a false value. Note that this doesn't delete the property (to do so, use the "del_props" method described below). "$var->is_myprop", "$var->has_myprop" returns a true value if the property is set (i.e., defined and has a true value). The two alternate interfaces are provided to make querying attributes sound more natural. For example: $foo->is_approximate; $bar->has_history; Values thus made into objects also expose various utility methods. All of those methods (unless noted otherwise) return the result as an overloaded value ready to take properties and method calls itself, and don't modify the original value. METHODS get_props Get a list of names of the value's properties. del_props(LIST) Deletes one or more properties from the value. This is different than setting the property value to zero. del_all_props Deletes all of the value's properties. plus(EXPR) Returns the value that is the sum of the value whose method has been called and the argument value. This method also overloads addition, so: $a = 7 + 2; $a = 7->plus(2); # the same minus(EXPR) Returns the value that is the the value whose method has been called minus the argument value. This method also overloads subtraction. times(EXPR) Returns the value that is the the value whose method has been called times the argument value. This method also overloads multiplication. divide(EXPR) Returns the value that is the the value whose method has been called divided by the argument value. This method also overloads division. modulo(EXPR) Returns the value that is the the value whose method has been called modulo the argument value. This method also overloads the modulo operator. exp(EXPR) Returns the value that is the the value whose method has been called powered by the argument value. This method also overloads the exponentiation operator. abs Returns the absolute of the value. zero Returns a boolean value indicating whether the value is equal to 0. length Returns the result of the built-in "length" function applied to the value. size Same as "length()". reverse Returns the reverse string of the value. uc Returns the result of the built-in function "uc()" applied to the value. ucfirst Returns the result of the built-in function "ucfirst()" applied to the value. lc Returns the result of the built-in function "lc()" applied to the value. lcfirst Returns the result of the built-in function "lcfirst()" applied to the value. hex Returns the result of the built-in function "hex()" applied to the value. oct Returns the result of the built-in function "oct()" applied to the value. concat(EXPR) Returns the result of the argument expression appended to the value. append(EXPR) Same as "concat(EXPR)". swapcase Returns a version of the value with every character's case reversed, i.e. a lowercase character becomes uppercase and vice versa. split /PATTERN/, LIMIT Returns a list of overloaded values that is the result of splitting (according to the built-in "split" function) the value along the pattern, into a number of values up to the limit. numcmp(EXPR) Returns the (overloaded) value of the numerical three-way comparison. This method also overloads the "<=>" operator. cmp(EXPR) Returns the (overloaded) value of the alphabetical three-way comparison. This method also overloads the "cmp" operator. eq(EXPR) Return the (overloaded) boolean value of the "eq" string comparison. This method also overloads that operators. ne(EXPR) Return the (overloaded) boolean value of the "ne" string comparison. This method also overloads that operators. lt(EXPR) Return the (overloaded) boolean value of the "lt" string comparison. This method also overloads that operators. gt(EXPR) Return the (overloaded) boolean value of the "gt" string comparison. This method also overloads that operators. le(EXPR) Return the (overloaded) boolean value of the "le" string comparison. This method also overloads that operators. ge(EXPR) Return the (overloaded) boolean value of the "ge" string comparison. This method also overloads that operators. eqi Same as "eq()", but is case-insensitive. nei> Same as "ne()", but is case-insensitive. lti Same as "lt()", but is case-insensitive. gti Same as "gt()", but is case-insensitive. lei Same as "le()", but is case-insensitive. gei Same as "ge()", but is case-insensitive. is_true Returns whether the (overloaded) boolean status of the value is true. is_false Returns whether the (overloaded) boolean status of the value is false. create FIXME del_prop FIXME do_downto FIXME do_downto_step FIXME do_upto FIXME do_upto_step FIXME false FIXME gen_meth FIXME handle FIXME times_do FIXME true FIXME value FIXME FUNCTIONS pass_on(LIST) Sets (replaces) the list of properties that are passed on. There is only one such list for the whole mechanism. The whole property interface is experimental, but this one in particular is likely to change in the future. This function is exported automatically. passed_on(STRING) Tests whether a property is passed on and returns a boolean value. This function is exported automatically. get_pass_on Returns a list of names of properties that are passed on. This function is exported automatically. INSTALLATION See perlmodinstall for information and options on installing Perl modules. BUGS AND LIMITATIONS No bugs have been reported. Please report any bugs or feature requests through the web interface at . AVAILABILITY The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit to find a CPAN site near you, or see . The development version lives at . Instead of sending patches, please fork this project using the standard git and github infrastructure. AUTHOR Marcel Gruenauer COPYRIGHT AND LICENSE This software is copyright (c) 2001 by Marcel Gruenauer. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. MANIFEST000644000765000024 71711353417342 16240 0ustar00marcelstaff000000000000Scalar-Properties-1.100860Changes INSTALL LICENSE MANIFEST MANIFEST.SKIP META.json META.yml Makefile.PL README dist.ini lib/Scalar/Properties.pm t/00-compile.t t/000-report-versions.t t/01_all.t t/author-critic.t t/perlcriticrc t/release-check-changes.t t/release-dist-manifest.t t/release-has-version.t t/release-kwalitee.t t/release-meta-yaml.t t/release-minimum-version.t t/release-pod-coverage.t t/release-pod-spell.t t/release-pod-syntax.t t/release-portability.t t/release-synopsis.t