#
# spec file for package perl-utf8-all
#
# 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 utf8-all
Name:           perl-utf8-all
Version:        0.24.0
Release:        0
# 0.024 -> normalize -> 0.24.0
%define cpan_version 0.024
License:        Artistic-1.0 OR GPL-1.0-or-later
Summary:        Turn on Unicode - all of it
URL:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/H/HA/HAYOBAAN/%{cpan_name}-%{cpan_version}.tar.gz
Source1:        cpanspec.yml
Source100:      README.md
BuildArch:      noarch
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Import::Into)
BuildRequires:  perl(PerlIO::utf8_strict)
BuildRequires:  perl(Test::Exception)
BuildRequires:  perl(Test::Fatal)
BuildRequires:  perl(Test::More) >= 0.96
BuildRequires:  perl(Test::Warn)
BuildRequires:  perl(autodie)
BuildRequires:  perl(feature)
BuildRequires:  perl(parent)
BuildRequires:  perl(version) >= 0.77
Requires:       perl(Import::Into)
Requires:       perl(PerlIO::utf8_strict)
Requires:       perl(feature)
Requires:       perl(parent)
Provides:       perl(utf8::all) = %{version}
%undefine       __perllib_provides
%{perl_requires}

%description
The 'use utf8' pragma tells the Perl parser to allow UTF-8 in the program
text in the current lexical scope. This also means that you can now use
literal Unicode characters as part of strings, variable names, and regular
expressions.

'utf8::all' goes further:

  * 'charnames' are imported so '\N{...}' sequences can be used to compile
Unicode characters based on names.

  * On Perl 'v5.11.0' or higher, the 'use feature 'unicode_strings'' is
enabled.

  * 'use feature fc' and 'use feature unicode_eval' are enabled on Perl
'5.16.0' and higher.

  * Filehandles are opened with UTF-8 encoding turned on by default (including
'STDIN', 'STDOUT', and 'STDERR' when 'utf8::all' is used from the 'main'
package). Meaning that they automatically convert UTF-8 octets to
characters and vice versa. If you _don't_ want UTF-8 for a particular
filehandle, you'll have to set 'binmode $filehandle'.

  * '@ARGV' gets converted from UTF-8 octets to Unicode characters (when
'utf8::all' is used from the 'main' package). This is similar to the
behaviour of the '-CA' perl command-line switch (see perlrun).

  * 'readdir', 'readlink', 'readpipe' (including the 'qx//' and backtick
operators), and 'glob' (including the '<>' operator) now all work with and
return Unicode characters instead of (UTF-8) octets (again only when
'utf8::all' is used from the 'main' package).

%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 Changes README README.mkdn
%license LICENSE

%changelog