File perl-Object-InsideOut.spec of Package perl-Object-InsideOut

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Object-InsideOut.spec of Package perl-Object-InsideOut

#
# spec file for package perl-Object-InsideOut
#
# Copyright (c) 2018 SUSE LINUX 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 https://bugs.opensuse.org/
#

Name:           perl-Object-InsideOut
Version:        4.05
Release:        0
%define cpan_name Object-InsideOut
Summary:        Comprehensive inside-out object support module
License:        Artistic-1.0 OR GPL-1.0-or-later
Group:          Development/Libraries/Perl
Url:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/J/JD/JDHEDDEN/%{cpan_name}-%{version}.tar.gz
Source1:        cpanspec.yml
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Exception::Class) >= 1.22
BuildRequires:  perl(Module::Build)
BuildRequires:  perl(Scalar::Util) >= 1.5
BuildRequires:  perl(Test::More) >= 0.98
Requires:       perl(Exception::Class) >= 1.22
Requires:       perl(Scalar::Util) >= 1.5
Requires:       perl(Test::More) >= 0.98
Recommends:     perl(Math::Random::MT::Auto) >= 6.18
Recommends:     perl(Want) >= 0.21
%{perl_requires}

%description
This module provides comprehensive support for implementing classes using
the inside-out object model.

Object::InsideOut implements inside-out objects as anonymous scalar
references that are blessed into a class with the scalar containing the ID
for the object (usually a sequence number). For Perl 5.8.3 and later, the
scalar reference is set as *read-only* to prevent _accidental_
modifications to the ID. Object data (i.e., fields) are stored within the
class's package in either arrays indexed by the object's ID, or hashes
keyed to the object's ID.

The virtues of the inside-out object model over the _blessed hash_ object
model have been extolled in detail elsewhere. See the informational links
under "SEE ALSO". Briefly, inside-out objects offer the following
advantages over _blessed hash_ objects:

* * Encapsulation

Object data is enclosed within the class's code and is accessible only
through the class-defined interface.

* * Field Name Collision Avoidance

Inheritance using _blessed hash_ classes can lead to conflicts if any
classes use the same name for a field (i.e., hash key). Inside-out objects
are immune to this problem because object data is stored inside each
class's package, and not in the object itself.

* * Compile-time Name Checking

A common error with _blessed hash_ classes is the misspelling of field
names:

$obj->{'coment'} = 'Say what?';   # Should be 'comment' not 'coment'

As there is no compile-time checking on hash keys, such errors do not
usually manifest themselves until runtime.

With inside-out objects, _text_ hash keys are not used for accessing field
data. Field names and the data index (i.e., $$self) are checked by the Perl
compiler such that any typos are easily caught using 'perl -c'.

$coment[$$self] = $value;    # Causes a compile-time error
    # or with hash-based fields
 $comment{$$self} = $value;   # Also causes a compile-time error

Object::InsideOut offers all the capabilities of other inside-out object
modules with the following additional key advantages:

* * Speed

When using arrays to store object data, Object::InsideOut objects are as
much as 40% faster than _blessed hash_ objects for fetching and setting
data, and even with hashes they are still several percent faster than
_blessed hash_ objects.

* * Threads

Object::InsideOut is thread safe, and thoroughly supports sharing objects
between threads using threads::shared.

* * Flexibility

Allows control over object ID specification, accessor naming, parameter
name matching, and much more.

* * Runtime Support

Supports classes that may be loaded at runtime (i.e., using 'eval { require
...; };'). This makes it usable from within mod_perl, as well. Also
supports additions to class hierarchies, and dynamic creation of object
fields during runtime.

* * Exception Objects

Object::InsideOut uses Exception::Class for handling errors in an
OO-compatible manner.

* * Object Serialization

Object::InsideOut has built-in support for object dumping and reloading
that can be accomplished in either an automated fashion or through the use
of class-supplied subroutines. Serialization using Storable is also
supported.

* * Foreign Class Inheritance

Object::InsideOut allows classes to inherit from foreign (i.e.,
non-Object::InsideOut) classes, thus allowing you to sub-class other Perl
class, and access their methods from your own objects.

* * Introspection

Obtain constructor parameters and method metadata for Object::InsideOut
classes.

%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

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

%changelog

Places

File perl-Object-InsideOut.spec of Package perl-Object-InsideOut

Places