#
# spec file for package perl-Perl6-Attributes
#
# Copyright (c) 2024 SUSE LLC
#
# 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 https://bugs.opensuse.org/
#


%define cpan_name Perl6-Attributes
Name:           perl-Perl6-Attributes
Version:        0.40.0
Release:        0
# 0.04 -> normalize -> 0.40.0
%define cpan_version 0.04
License:        Artistic-1.0 OR GPL-1.0-or-later
Summary:        Perl 6-like member variable syntax
URL:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/L/LP/LPALMER/%{cpan_name}-%{cpan_version}.tar.gz
Source100:      README.md
BuildArch:      noarch
BuildRequires:  perl
BuildRequires:  perl-macros
Provides:       perl(Perl6::Attributes) = %{version}
%undefine       __perllib_provides
%{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 Perl6::Variables
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
%autosetup  -n %{cpan_name}-%{cpan_version}

%build
perl Makefile.PL INSTALLDIRS=vendor
%make_build

%check
make test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%doc README

%changelog