r5539 - in /packages/libdata-serializer-perl/branches/upstream/current: ./ examples/ lib/Data/ lib/Data/Serializer/ lib/Data/Serializer/Data/ lib/Data/Serializer/PHP/ lib/Data/Serializer/XML/ t/
eloy at users.alioth.debian.org
eloy at users.alioth.debian.org
Wed May 30 14:44:18 UTC 2007
Author: eloy
Date: Wed May 30 14:44:17 2007
New Revision: 5539
URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=5539
Log:
[svn-upgrade] Integrating new upstream version, libdata-serializer-perl (0.41)
Added:
packages/libdata-serializer-perl/branches/upstream/current/examples/
packages/libdata-serializer-perl/branches/upstream/current/examples/README
packages/libdata-serializer-perl/branches/upstream/current/t/10-01-Pod.t
packages/libdata-serializer-perl/branches/upstream/current/t/10-02-Pod-Coverage.t
Modified:
packages/libdata-serializer-perl/branches/upstream/current/Changes
packages/libdata-serializer-perl/branches/upstream/current/MANIFEST
packages/libdata-serializer-perl/branches/upstream/current/META.yml
packages/libdata-serializer-perl/branches/upstream/current/Makefile.PL
packages/libdata-serializer-perl/branches/upstream/current/README
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Cookbook.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Denter.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Dumper.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Taxi.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/FreezeThaw.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/PHP/Serialization.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Storable.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Dumper.pm
packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Simple.pm
Modified: packages/libdata-serializer-perl/branches/upstream/current/Changes
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/Changes?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/Changes (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/Changes Wed May 30 14:44:17 2007
@@ -1,4 +1,14 @@
Revision history for Perl extension Data::Serializer
+
+0.41 Wed May 17 2007
+ - Bowing to peer pressure and adding in the Test::Pod stuff in production, this means adding a prereq of Test::More
+ - Updated Data::Serializer::Cookbook
+ - Added an examples/ dir to the distribution
+ - put a copy of the Cookbook in the examples dir via pod2text as README
+ - Would be happy to add user submitted examples (send to neil at neely.cx)
+
+0.40 Wed May 16 2007
+ - Updated contact information to be neil at neely.cx, this is a purely cosmetic change
0.39 Mon Mar 5 10:39:00 MST 2007
- Left "use File::Slurp" inside of Serializer.pm from some testing, removed this needless dependency
Modified: packages/libdata-serializer-perl/branches/upstream/current/MANIFEST
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/MANIFEST?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/MANIFEST (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/MANIFEST Wed May 30 14:44:17 2007
@@ -42,5 +42,8 @@
t/07-03-SHA-256-Digest.t
t/08-Store-Retrieve.t
t/09-Feature-Combos.t
+t/10-01-Pod.t
+t/10-02-Pod-Coverage.t
t/serializer-testlib
+examples/README
META.yml Module meta-data (added by MakeMaker)
Modified: packages/libdata-serializer-perl/branches/upstream/current/META.yml
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/META.yml?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/META.yml (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/META.yml Wed May 30 14:44:17 2007
@@ -1,13 +1,17 @@
-# http://module-build.sourceforge.net/META-spec.html
-#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
-name: Data-Serializer
-version: 0.39
-version_from: lib/Data/Serializer.pm
-installdirs: site
-requires:
+--- #YAML:1.0
+name: Data-Serializer
+version: 0.41
+abstract: ~
+license: perl
+generated_by: ExtUtils::MakeMaker version 6.32
+distribution_type: module
+requires:
Data::Dumper: 2.08
Digest::SHA: 0
IO::File: 0
-
-distribution_type: module
-generated_by: ExtUtils::MakeMaker version 6.23
+ Test::More: 0
+meta-spec:
+ url: http://module-build.sourceforge.net/META-spec-v1.2.html
+ version: 1.2
+author:
+ - Neil Neely (neil at neely.cx)
Modified: packages/libdata-serializer-perl/branches/upstream/current/Makefile.PL
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/Makefile.PL?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/Makefile.PL (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/Makefile.PL Wed May 30 14:44:17 2007
@@ -7,11 +7,13 @@
'NAME' => 'Data::Serializer',
'DISTNAME' => 'Data-Serializer',
'VERSION_FROM' => 'lib/Data/Serializer.pm', # finds $VERSION
- 'AUTHOR' => 'Neil Neely (neil at frii.net)',
+ 'AUTHOR' => 'Neil Neely (neil at neely.cx)',
+ 'LICENSE' => 'perl',
'PREREQ_PM' => {
'IO::File' => 0,
'Digest::SHA' => 0,
'Data::Dumper' => 2.08,
+ 'Test::More' => 0,
},
'dist' => {'COMPRESS'=>'gzip -9f', 'SUFFIX' => 'gz',
'ZIP'=>'/usr/bin/zip','ZIPFLAGS'=>'-rl'}
Modified: packages/libdata-serializer-perl/branches/upstream/current/README
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/README?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/README (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/README Wed May 30 14:44:17 2007
@@ -212,9 +212,11 @@
With perl attributes in 5.8, this should probably be deprecated.
AUTHOR
- Neil Neely <neil at frii.net>.
+ Neil Neely <neil at neely.cx>.
Feature requests are certainly welcome.
+
+ http://neil-neely.blogspot.com/
BUGS
Please report all bugs here:
Added: packages/libdata-serializer-perl/branches/upstream/current/examples/README
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/examples/README?rev=5539&op=file
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/examples/README (added)
+++ packages/libdata-serializer-perl/branches/upstream/current/examples/README Wed May 30 14:44:17 2007
@@ -1,0 +1,120 @@
+NAME
+ Cookbook - Examples of how to use Data::Serializer
+
+DESCRIPTION
+ Data::Serializer::Cookbook is a collection of solutions for using
+ Data::Serializer.
+
+CONVENTIONS
+ Unless otherwise specified, all examples can be assumed to begin with:
+
+ use Data::Serializer;
+
+ my $serializer = Data::Serializer->new();
+
+ Some examples will show different arguments to the new method, where
+ specified simply use that line instead of the simple form above.
+
+Encrypting your data
+ You wish to encrypt your data structure, so that it can only be decoded
+ by someone who shares the same key.
+
+ Solution
+ $serializer->secret('mysecret');
+
+ my $encrypted_hashref = $serializer->serializer($hash);
+
+ ... (in other program) ...
+
+ $serializer->secret('mysecret');
+
+ my $clear_hash = $serializer->deserializer($encrypted_hash);
+
+ Note: You will have to have the Crypt::CBC module installed for this to
+ work.
+
+Compressing your data
+ You wish to compress your data structure to cut down on how much disk
+ space it will take up.
+
+ Solution
+ $serializer->compress(1);
+
+ my $compressed_hashref = $serializer->serializer($hash);
+
+ ... (in other program) ...
+
+ my $clear_hash = $serializer->deserializer($compressed_hash);
+
+ Note: You will have to have the Compress::Zlib module installed for this
+ to work. Your mileage will vary dramatically depending on what
+ serializer you use. Some serializers are already fairly compact.
+
+You want to read in data serialized outside of Data::Serializer
+ You need to write a program that can read in data serialized in a format
+ other than Data::Serializer. For example you need to be able to be able
+ to process data serialized by XML::Dumper.
+
+ Solution
+ $serializer->serializer('XML::Dumper');
+
+ my $hash_ref = $serializer->raw_deserialize($xml_data);
+
+You want to write serialized data in a form understood outside of Data::Serializer
+ You need to write a program that can write out data in a format other
+ than Data::Serializer. Or said more generically you need to write out
+ data in the format native to the underlying serializer. For our example
+ we will be exporting data using XML::Dumper format.
+
+ Solution
+ $serializer->serializer('XML::Dumper');
+
+ my $xml_data = $serializer->raw_serialize($hash_ref);
+
+You want to convert data between two different serializers native formats
+ You have data serialized by php that you want to convert to xml for use
+ by other programs.
+
+ Solution
+ my $xml_serializer = Data::Serializer->(serializer => 'XML::Dumper');
+
+ my $php_serializer = Data::Serializer->(serializer => 'PHP::Serialization');
+
+ my $hash_ref = $php_serializer->raw_deserialize($php_data);
+
+ my $xml_data = $xml_serializer->raw_serialize($hash_ref);
+
+Keeping data persistent between executions of a program.
+ You have a program that you run every 10 minutes, it uses SNMP to pull
+ some counters from one of your routers. You want your program to keep
+ the counters from the last run so that it can see how much traffic has
+ passed over a link since it last ran.
+
+ Solution
+ # path to store our serialized data
+ # be paranoid, use full paths
+ my $last_run_datafile = '/full/path/to/file/lastrun.data';
+
+ #We keep our data as a hash reference
+ my $last_data = $serializer->retrieve($last_run_datafile);
+
+ #Pull in our new data through 'pull_data()';
+ my $new_data = query_router($router);
+
+ #run comparison code
+ run_comparison($last_data,$new_data);
+
+ $serializer->store($new_data);
+
+AUTHOR
+ Neil Neely <neil at neely.cx>.
+
+COPYRIGHT
+ Copyright (c) 2001-2007 Neil Neely. All rights reserved.
+
+ This program is free software; you can redistribute it and/or modify it
+ under the same terms as Perl itself.
+
+SEE ALSO
+ Data::Serializer(3)
+
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer.pm Wed May 30 14:44:17 2007
@@ -17,7 +17,7 @@
@EXPORT = qw( );
@EXPORT_OK = qw( );
-$VERSION = '0.39';
+$VERSION = '0.41';
# Preloaded methods go here.
{
@@ -462,9 +462,11 @@
=head1 AUTHOR
-Neil Neely <F<neil at frii.net>>.
+Neil Neely <F<neil at neely.cx>>.
Feature requests are certainly welcome.
+
+http://neil-neely.blogspot.com/
=head1 BUGS
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Cookbook.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Cookbook.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Cookbook.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Cookbook.pm Wed May 30 14:44:17 2007
@@ -140,49 +140,21 @@
=head1 AUTHOR
-Neil Neely <F<neil at frii.net>>.
+Neil Neely <F<neil at neely.cx>>.
=head1 COPYRIGHT
-Copyright (c) 2001-2004 Neil Neely. All rights reserved.
+Copyright (c) 2001-2007 Neil Neely. All rights reserved.
This program is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.
-=head1 DEDICATION
-
-This module is dedicated to my beautiful wife Erica,
-because a woman of such quality deserves a dedication.
=head1 SEE ALSO
=over 4
-=item L<Data::Dumper(3)>
-
-=item L<Data::Denter(3)>
-
-=item L<Storable(3)>
-
-=item L<FreezeThaw(3)>
-
-=item L<Config::General(3)>
-
-=item L<YAML(3)>
-
-=item L<PHP::Serialization(3)>
-
-=item L<XML::Dumper(3)>
-
-=item L<Compress::Zlib(3)>
-
-=item L<Digest(3)>
-
-=item L<Crypt(3)>
-
-=item L<MIME::Base64(3)>
-
-=item L<Tie::Transient(3)>
+=item L<Data::Serializer(3)>
=back
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Denter.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Denter.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Denter.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Denter.pm Wed May 30 14:44:17 2007
@@ -44,7 +44,7 @@
=head1 AUTHOR
-Neil Neely <neil at frii.net>
+Neil Neely <neil at neely.cx>
=head1 COPYRIGHT
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Dumper.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Dumper.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Dumper.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Dumper.pm Wed May 30 14:44:17 2007
@@ -43,7 +43,7 @@
=head1 AUTHOR
-Neil Neely <neil at frii.net>
+Neil Neely <neil at neely.cx>
=head1 COPYRIGHT
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Taxi.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Taxi.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Taxi.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Data/Taxi.pm Wed May 30 14:44:17 2007
@@ -41,7 +41,7 @@
=head1 AUTHOR
-Neil Neely <neil at frii.net>
+Neil Neely <neil at neely.cx>
=head1 COPYRIGHT
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/FreezeThaw.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/FreezeThaw.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/FreezeThaw.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/FreezeThaw.pm Wed May 30 14:44:17 2007
@@ -41,7 +41,7 @@
=head1 AUTHOR
-Neil Neely <neil at frii.net>
+Neil Neely <neil at neely.cx>
=head1 COPYRIGHT
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/PHP/Serialization.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/PHP/Serialization.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/PHP/Serialization.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/PHP/Serialization.pm Wed May 30 14:44:17 2007
@@ -41,7 +41,7 @@
=head1 AUTHOR
-Neil Neely <neil at frii.net>
+Neil Neely <neil at neely.cx>
=head1 COPYRIGHT
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Storable.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Storable.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Storable.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/Storable.pm Wed May 30 14:44:17 2007
@@ -41,7 +41,7 @@
=head1 AUTHOR
-Neil Neely <neil at frii.net>
+Neil Neely <neil at neely.cx>
=head1 COPYRIGHT
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Dumper.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Dumper.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Dumper.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Dumper.pm Wed May 30 14:44:17 2007
@@ -45,7 +45,7 @@
=head1 AUTHOR
-Neil Neely <neil at frii.net>
+Neil Neely <neil at neely.cx>
=head1 COPYRIGHT
Modified: packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Simple.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Simple.pm?rev=5539&op=diff
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Simple.pm (original)
+++ packages/libdata-serializer-perl/branches/upstream/current/lib/Data/Serializer/XML/Simple.pm Wed May 30 14:44:17 2007
@@ -45,7 +45,7 @@
=head1 AUTHOR
-Neil Neely <neil at frii.net>
+Neil Neely <neil at neely.cx>
=head1 COPYRIGHT
Added: packages/libdata-serializer-perl/branches/upstream/current/t/10-01-Pod.t
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/t/10-01-Pod.t?rev=5539&op=file
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/t/10-01-Pod.t (added)
+++ packages/libdata-serializer-perl/branches/upstream/current/t/10-01-Pod.t Wed May 30 14:44:17 2007
@@ -1,0 +1,4 @@
+use Test::More;
+eval "use Test::Pod 1.00";
+plan skip_all => "Test::Pod 1.00 required for testing POD" if $@;
+all_pod_files_ok();
Added: packages/libdata-serializer-perl/branches/upstream/current/t/10-02-Pod-Coverage.t
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libdata-serializer-perl/branches/upstream/current/t/10-02-Pod-Coverage.t?rev=5539&op=file
==============================================================================
--- packages/libdata-serializer-perl/branches/upstream/current/t/10-02-Pod-Coverage.t (added)
+++ packages/libdata-serializer-perl/branches/upstream/current/t/10-02-Pod-Coverage.t Wed May 30 14:44:17 2007
@@ -1,0 +1,6 @@
+use Test::More;
+eval "use Test::Pod::Coverage 1.00";
+plan skip_all => "Test::Pod::Coverage 1.00 required for testing POD coverage" if $@;
+all_pod_coverage_ok();
+
+
More information about the Pkg-perl-cvs-commits
mailing list