r37882 - in /branches/upstream/libreturn-value-perl/current: Changes META.yml lib/Return/Value.pm t/perl-critic.t
nhandler-guest at users.alioth.debian.org
nhandler-guest at users.alioth.debian.org
Mon Jun 8 22:18:37 UTC 2009
Author: nhandler-guest
Date: Mon Jun 8 22:18:13 2009
New Revision: 37882
URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=37882
Log:
[svn-upgrade] Integrating new upstream version, libreturn-value-perl (1.666001)
Modified:
branches/upstream/libreturn-value-perl/current/Changes
branches/upstream/libreturn-value-perl/current/META.yml
branches/upstream/libreturn-value-perl/current/lib/Return/Value.pm
branches/upstream/libreturn-value-perl/current/t/perl-critic.t
Modified: branches/upstream/libreturn-value-perl/current/Changes
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libreturn-value-perl/current/Changes?rev=37882&op=diff
==============================================================================
--- branches/upstream/libreturn-value-perl/current/Changes (original)
+++ branches/upstream/libreturn-value-perl/current/Changes Mon Jun 8 22:18:13 2009
@@ -1,33 +1,40 @@
-1.302 2006-11-14
- perl-critic tests
- croak, not die, on invalid constructor input
+1.666001 2009-06-08
+1.666000 2009-06-08
+ formally declare Return::Value deprecated
-1.301 2006-07-28
- fix typoes in changelog and docs
- improve test coverage
+1.303 2007-04-01
+ fix test to work on 5.5
-1.30 2005-09-18 23:30
- minor POD cleanup
- added pod coverage test (kwalitee suckup)
+1.302 2006-11-14
+ perl-critic tests
+ croak, not die, on invalid constructor input
-1.28 2004-12-20 16:00
- changed bool return to just call ->bool
- (returning undef crashes 5.6.1, argh! thanks, HDP!)
+1.301 2006-07-28
+ fix typoes in changelog and docs
+ improve test coverage
-1.26 2004-12-20 16:00
- fixed: properties couldn't be undefined after defining
- "use warnings" removed from tests to keep 5.005 happy
+1.30 2005-09-18 23:30
+ minor POD cleanup
+ added pod coverage test (kwalitee suckup)
-1.24 2004-09-23 09:00
- allow omission of message
- ...even with other attributes
- 100% coverage
+1.28 2004-12-20 16:00
+ changed bool return to just call ->bool
+ (returning undef crashes 5.6.1, argh! thanks, HDP!)
-1.22 2004-08-30 19:25
- array and hash dereference will get the return data
- full test coverage
- 'type' attribute is key to success/failure
- POD improved
+1.26 2004-12-20 16:00
+ fixed: properties couldn't be undefined after defining
+ "use warnings" removed from tests to keep 5.005 happy
-1.1 2004-07-15
- Initial Revision.
+1.24 2004-09-23 09:00
+ allow omission of message
+ ...even with other attributes
+ 100% coverage
+
+1.22 2004-08-30 19:25
+ array and hash dereference will get the return data
+ full test coverage
+ 'type' attribute is key to success/failure
+ POD improved
+
+1.1 2004-07-15
+ Initial Revision.
Modified: branches/upstream/libreturn-value-perl/current/META.yml
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libreturn-value-perl/current/META.yml?rev=37882&op=diff
==============================================================================
--- branches/upstream/libreturn-value-perl/current/META.yml (original)
+++ branches/upstream/libreturn-value-perl/current/META.yml Mon Jun 8 22:18:13 2009
@@ -1,14 +1,22 @@
--- #YAML:1.0
-name: Return-Value
-version: 1.302
-abstract: Polymorphic Return Values
-license: perl
-generated_by: ExtUtils::MakeMaker version 6.31
-distribution_type: module
-requires:
- Test::More: 0.47
-meta-spec:
- url: http://module-build.sourceforge.net/META-spec-v1.2.html
- version: 1.2
+name: Return-Value
+version: 1.666001
+abstract: Polymorphic Return Values
author:
- Casey West <casey at geeknest.com>
+license: perl
+distribution_type: module
+configure_requires:
+ ExtUtils::MakeMaker: 0
+build_requires:
+ ExtUtils::MakeMaker: 0
+requires:
+ Test::More: 0.47
+no_index:
+ directory:
+ - t
+ - inc
+generated_by: ExtUtils::MakeMaker version 6.50
+meta-spec:
+ url: http://module-build.sourceforge.net/META-spec-v1.4.html
+ version: 1.4
Modified: branches/upstream/libreturn-value-perl/current/lib/Return/Value.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libreturn-value-perl/current/lib/Return/Value.pm?rev=37882&op=diff
==============================================================================
--- branches/upstream/libreturn-value-perl/current/lib/Return/Value.pm (original)
+++ branches/upstream/libreturn-value-perl/current/lib/Return/Value.pm Mon Jun 8 22:18:13 2009
@@ -3,22 +3,43 @@
package Return::Value;
# vi:et:sw=4 ts=4
-use vars qw[$VERSION @EXPORT]; ## no critic Export
-$VERSION = '1.302';
+use vars qw[$VERSION @EXPORT $NO_CLUCK]; ## no critic Export
+$VERSION = '1.666001';
@EXPORT = qw[success failure];
use base qw[Exporter];
use Carp ();
+# uncomment in June 2010
+# Carp::cluck "Return::Value is deprecated" unless $NO_CLUCK;
+
=head1 NAME
-Return::Value - Polymorphic Return Values
+Return::Value - (deprecated) polymorphic return values
=head1 VERSION
-version 1.302
-
- $Id: /my/cs/projects/return/trunk/lib/Return/Value.pm 28007 2006-11-14T22:21:03.864745Z rjbs $
+version 1.666001
+
+=head1 DO NOT USE THIS LIBRARY
+
+B<This library will begin issuing deprecation warnings in June 2010.>
+
+Return::Value was a bad idea. i'm sorry that I had it, sorry that I followed
+through, and sorry that it got used in other useful libraries. Fortunately
+there are not many things using it. One of those things is
+L<Email::Send|Email::Send> which is also deprecated in favor of
+L<Email::Sender|Email::Sender>.
+
+There's no reason to specify a new module to replace Return::Value. In
+general, routines should return values of uniform type or throw exceptions.
+Return::Value tried to be a uniform type for all routines, but has so much
+weird behavior that it ends up being confusing and not very Perl-like.
+
+Objects that are false are just a dreadful idea in almost every circumstance,
+especially when the object has useful properties.
+
+B<Please do not use this library. You will just regret it later.>
=head1 SYNOPSIS
@@ -66,7 +87,8 @@
=head1 DESCRIPTION
-Polymorphic return values are really useful. Often, we just want to know if
+Polymorphic return values are a horrible idea, but this library was written
+based on the notion that they were useful. Often, we just want to know if
something worked or not. Other times, we'd like to know what the error text
was. Still others, we may want to know what the error code was, and what the
error properties were. We don't want to handle objects or data structures for
@@ -77,8 +99,8 @@
data. In the quest to provide consistent return values, this gets confusing
between complex, informational errors and successful return values.
-This module provides these features with a simple API that should get you what
-you're looking for in each contex a return value is used in.
+This module provides these features with a simplistic API that should get you
+what you're looking for in each context a return value is used in.
=head2 Attributes
@@ -324,7 +346,7 @@
=head1 TODO
-No plans!
+Add deprecation.
=head1 AUTHORS
@@ -341,5 +363,3 @@
=cut
"This return value is true.";
-
-__END__
Modified: branches/upstream/libreturn-value-perl/current/t/perl-critic.t
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libreturn-value-perl/current/t/perl-critic.t?rev=37882&op=diff
==============================================================================
--- branches/upstream/libreturn-value-perl/current/t/perl-critic.t (original)
+++ branches/upstream/libreturn-value-perl/current/t/perl-critic.t Mon Jun 8 22:18:13 2009
@@ -1,6 +1,5 @@
#!perl
use strict;
-use warnings;
use Test::More;
if ($ENV{PERL_TEST_CRITIC}) {
More information about the Pkg-perl-cvs-commits
mailing list