#
# spec file for package perl-Perl6-Attributes
#
# Copyright (c) 2011 SUSE LINUX Products GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via http://bugs.opensuse.org/
#



Name:           perl-Perl6-Attributes
Version:        0.04
Release:        1
License:        GPL+ or Artistic
%define cpan_name Perl6-Attributes
Summary:        Perl 6-like member variable syntax
Url:            http://search.cpan.org/dist/Perl6-Attributes/
Group:          Development/Libraries/Perl
Source:         http://www.cpan.org/authors/id/L/LP/LPALMER/%{cpan_name}-%{version}.tar.gz
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
%{perl_requires}

%description
I found myself annoyed when I wrote the following code in one of my recent
projects:

    sub populate {
        my ($self, $n) = @_;
        for (1..$n) {
            push @{$self->{organisms}}, Organism->new(rand($self->{width}), rand($self->{height}));
        }
    }

Three '$self's in one line! And it's really not encoding any information,
it's just clutter that results from Perl's lack of _explicit_
object-oriented support. However, Using the magic of source filters, we can
now write it:

    sub populate {
        my ($self, $n) = @_;
        for (1..$n) {
            push @.organisms, Organism->new(rand($.width), rand($.height));
        }
    }

Perl6::Attributes takes the Perl 6 secondary sigil '.' and translates it
into a hash access on '$self'. No, it doesn't support other names for your
invocant (but it could very easily; I'm just lazy), and no, it doesn't
support objects written by crazy people based on array, scalar, or (!) glob
references.

You still inflect the primary sigil, unlike in Perl 6. See the
Perl6::Variables manpage for a way to use Perl 6's uninflected sigils...
but don't expect it to work with this module.

There's also a nice little "feature" that you get for trading the ability
to name your variables the same with different sigils (by the way, you
can't do that). Say $self->{foo} is an array ref:

    @.foo;       # the array itself
    $.foo;       # the reference

Which means that even if you're using an array referentially, you can
usually avoid writing those pesky '@{}'s everywhere.

Perl6::Attributes now also translates './method' and './method(args)' to
'$self-'method> and '$self-'method(args)>.

%prep
%setup -q -n %{cpan_name}-%{version}

%build
%{__perl} Makefile.PL INSTALLDIRS=vendor
%{__make} %{?_smp_mflags}

%check
%{__make} test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc README

%changelog