perl-Collection/perl-Collection.spec

#
# spec file for package perl-Collection
#
# Copyright (c) 2015 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 http://bugs.opensuse.org/
#


Name:           perl-Collection
Version:        0.58
Release:        0
%define cpan_name Collection
Summary:        CRUD framework
License:        Artistic-1.0 or GPL-1.0+
Group:          Development/Libraries/Perl
Url:            http://search.cpan.org/dist/Collection/
Source0:        http://www.cpan.org/authors/id/Z/ZA/ZAG/%{cpan_name}-%{version}.tar.gz
Source1:        cpanspec.yml
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Flow) >= 0.6
BuildRequires:  perl(JSON::XS) >= 2.29
BuildRequires:  perl(Module::Build) >= 0.380000
BuildRequires:  perl(String::CRC32) >= 1.4
Requires:       perl(Flow) >= 0.6
Requires:       perl(JSON::XS) >= 2.29
Requires:       perl(String::CRC32) >= 1.4
%{perl_requires}

%description
A collection - sometimes called a container - is simply an object that
groups multiple elements into a single unit. _Collection_ are used to
store, retrieve, manipulate, and communicate aggregate data.

The primary advantages of a _Collection_ framework are that it reduces
programming effort by providing useful data structures and algorithms so
you don't have to write them yourself.

The _Collection_ framework consists of:

* * Wrapper Implementations - Add functionality, such as mirroring and lazy
  load, to other implementations.

* * Algorithms - methods that perform useful functions, such as caching.

This module has a task - to be a base class for ather Collections. You can
inherit the methods *_create*, *_delete*, *_fetch*, *_store* and may be
*_prepare_record* for new source of data. As you see this is similar to
*CRUD* (Create - Read - Update- Delete).

Sample:

        my $col = new MyCollection:: <some params>;
        #fetch objects or data by keys
        my $data = $col->fetch(1,2,3,4,5);
        #do something
        foreach my $item ( values %$data) {
            $_->attr->{inc} ++
        }
        #You can use "lazy" functionality
        my $not_actualy_fetch = $col->get_lazy(6,7,8,9);
        #store changed data or objects
        $col->store;
        #free memory
        $col->release;

Sample from the Collection::AutoSQL manpage:

 my $beers = new Collection::AutoSQL::
  dbh     => $dbh,          #database connect
  table   => 'beers',       #table name
  field   => 'bid',         #key field (IDs), usually primary,autoincrement
  cut_key => 1;             #delete field 'bid' from readed records,
    
    my $heineken = $beers->fetch_one(1);
    #SELECT * FROM beers WHERE bid in (1)

Sample from the Collection::Memcached manpage:

    use Collection::Memcached;
    use Cache::Memcached;
    $memd = new Cache::Memcached {
    'servers' => [ "127.0.0.1:11211" ],
    'debug' => 0,
    'compress_threshold' => 10_000,
  };
  my $collection = new Collection::Memcached:: $memd;
  my $collection_prefix = new Collection::Memcached:: $memd, 'prefix';

%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 README scripts

%changelog