Files
perl-POE-Component-Generic/perl-POE-Component-Generic.spec
2025-08-12 18:16:40 +02:00

95 lines
3.5 KiB
RPMSpec

#
# spec file for package perl-POE-Component-Generic
#
# 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 POE-Component-Generic
Name: perl-POE-Component-Generic
Version: 0.140.300
Release: 0
%define cpan_version 0.1403
License: Artistic-1.0 OR GPL-1.0-or-later
Summary: Generic non-blocking POE interface to any OO-module
URL: https://metacpan.org/release/%{cpan_name}
Source0: https://cpan.metacpan.org/authors/id/G/GW/GWYN/%{cpan_name}-%{cpan_version}.tar.gz
Source100: README.md
BuildArch: noarch
BuildRequires: perl
BuildRequires: perl-macros
BuildRequires: perl(Devel::Symdump) >= 2
BuildRequires: perl(POE) >= 1.311
Requires: perl(Devel::Symdump) >= 2
Requires: perl(POE) >= 1.311
Provides: perl(POE::Component::Generic) = %{version}
Provides: perl(POE::Component::Generic::Child)
Provides: perl(POE::Component::Generic::Net::SSH2) = 0.140.0
Provides: perl(POE::Component::Generic::Net::SSH2::Child)
Provides: perl(POE::Component::Generic::Object) = 0.140.0
%undefine __perllib_provides
%{perl_requires}
%description
POE::Component::Generic is a POE component that provides a non-blocking
wrapper around any object. This allows you to build a POE component from
existing code with minimal effort.
The following documentation is a tad opaque and complicated. This is
unavoidable; the problem POE::Component::Generic solves is complicated.
POE::Component::Generic works by forking a child process with
POE::Wheel::Run and creating the blocking object in the child process.
Method calls on the object are then serialised and sent to the child
process to be handled by the object there. The returned value is serialised
and sent to the parent process, where it is posted back to the caller as a
POE event.
Communication is done via the child's 'STDIN' and 'STDOUT'. This means that
all method arguments and return values must survive serialisation. If you
need to pass coderefs or other data that can't be serialised, use callbacks
or postbacks.
If you want to have multiple objects within a single child process, you
will have to create factories that create the objects.
Method calls are wrapped in 'eval' in the child process so that errors may
be propagated back to your session. See OUTPUT.
Output to 'STDERR' in the child, that is from your object, is shown only if
debug or verbose is set. 'STDOUT' in the child, that is from your object,
is redirected to STDERR and will be shown in the same circomstances.
%prep
%autosetup -n %{cpan_name}-%{cpan_version}
find . -type f ! -path "*/t/*" ! -name "*.pl" ! -path "*/bin/*" ! -path "*/script/*" ! -path "*/scripts/*" ! -name "configure" -print0 | xargs -0 chmod 644
%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 example README TODO
%changelog