File perl-Contextual-Return.spec of Package perl-Contextual-Return

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Contextual-Return.spec of Package perl-Contextual-Return (Revision 16e4c0521659a4514eb8c587bb5c637f)

Currently displaying revision 16e4c0521659a4514eb8c587bb5c637f , Show latest

#
# spec file for package perl-Contextual-Return
#
# 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-Contextual-Return
Version:        0.003001
Release:        1
License:        GPL-1.0+ or Artistic-1.0
%define cpan_name Contextual-Return
Summary:        Create context-senstive return values
Url:            http://search.cpan.org/dist/Contextual-Return/
Group:          Development/Libraries/Perl
Source:         http://www.cpan.org/authors/id/D/DC/DCONWAY/%{cpan_name}-%{version}.tar.gz
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Module::Build)
BuildRequires:  perl(version)
BuildRequires:  perl(Want)
Requires:       perl(version)
Requires:       perl(Want)
%{perl_requires}

%description
Usually, when you need to create a subroutine that returns different values
in different contexts (list, scalar, or void), you write something like:

sub get_server_status {
        my ($server_ID) = @_;

# Acquire server data somehow...
        my %server_data = _ascertain_server_status($server_ID);

# Return different components of that data,
        # depending on call context...
        if (wantarray()) {
            return @server_data{ qw(name uptime load users) };
        }
        if (defined wantarray()) {
            return $server_data{load};
        }
        if (!defined wantarray()) {
            carp 'Useless use of get_server_status() in void context';
            return;
        }
        else {
            croak q{Bad context! No biscuit!};
        }
    }

That works okay, but the code could certainly be more readable. In its
simplest usage, this module makes that code more readable by providing
three subroutines--'LIST()', 'SCALAR()', 'VOID()'--that are true only when
the current subroutine is called in the corresponding context:

use Contextual::Return;

sub get_server_status {
        my ($server_ID) = @_;

# Acquire server data somehow...
        my %server_data = _ascertain_server_status($server_ID);

# Return different components of that data
        # depending on call context...
        if (LIST)   { return @server_data{ qw(name uptime load users) } }
        if (SCALAR) { return $server_data{load}                         }
        if (VOID)   { print "$server_data{load}\n"                      }
        else        { croak q{Bad context! No biscuit!}                 }
    }

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

%build
%{__perl} Build.PL installdirs=vendor
./Build build flags=%{?_smp_mflags}

%check
./Build test

%install
./Build install destdir=%{buildroot} create_packlist=0
%perl_gen_filelist

%clean
%{__rm} -rf %{buildroot}

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

%changelog

Places

File perl-Contextual-Return.spec of Package perl-Contextual-Return (Revision 16e4c0521659a4514eb8c587bb5c637f)

Places