File perl-Algorithm-FastPermute.spec of Package perl-Algorithm-FastPermute

#
# spec file for package perl-Algorithm-FastPermute
#
# 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 Algorithm-FastPermute
Name:           perl-Algorithm-FastPermute
Version:        0.999.0
Release:        0
# 0.999 -> normalize -> 0.999.0
%define cpan_version 0.999
License:        Artistic-1.0 OR GPL-1.0-or-later
Summary:        Rapid generation of permutations
URL:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/R/RO/ROBIN/%{cpan_name}-%{cpan_version}.tar.gz
BuildRequires:  perl
BuildRequires:  perl-macros
Provides:       perl(Algorithm::FastPermute) = %{version}
%undefine       __perllib_provides
%{perl_requires}

%description
Algorithm::FastPermute generates all the permutations of an array. You pass
a block of code, which will be executed for each permutation. The array
will be changed in place, and then changed back again before 'permute'
returns. During the execution of the callback, the array is read-only and
you'll get an error if you try to change its length. (You _can_ change its
elements, but the consequences are liable to confuse you and may change in
future versions.)

You have to pass an array, it can't just be a list. It *does* work with
special arrays and tied arrays, though unless you're doing something
particularly abstruse you'd be better off copying the elements into a
normal array first.

It's very fast. My tests suggest it's four or five times as fast as
Algorithm::Permute's traditional interface. If you're permuting a large
list (nine or more elements, say) then you'll appreciate this enormously.
If your lists are short then Algorithm::Permute will still finish faster
than you can blink, and you may find its interface more convenient.

In fact, the FastPermute interface (and code) is now also included in
Algorithm::Permute, so you may not need both. Enhancements and bug fixes
will appear here first, from where (at Edwin Pratomo's discretion) they'll
probably make their way into Algorithm::Permute.

The code is run inside a pseudo block, rather than as a normal subroutine.
That means you can't use 'return', and you can't jump out of it using
'goto' and so on. Also, 'caller' won't tell you anything helpful from
inside the callback. Such is the price of speed.

The order in which the permutations are generated is not guaranteed, so
don't rely on it.

%prep
%autosetup  -n %{cpan_name}-%{cpan_version}

%build
perl Makefile.PL INSTALLDIRS=vendor OPTIMIZE="%{optflags}"
%make_build

%check
make test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

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

%changelog