Author: timbo
Date: Mon Feb 19 08:45:56 2007
New Revision: 9139
Modified:
dbi/trunk/Changes
dbi/trunk/lib/DBD/Gofer.pm
dbi/trunk/lib/DBD/Gofer/Policy/Base.pm
dbi/trunk/lib/DBD/Gofer/Policy/classic.pm
dbi/trunk/lib/DBD/Gofer/Policy/pedantic.pm
dbi/trunk/lib/DBD/Gofer/Policy/rush.pm
dbi/trunk/lib/DBD/Gofer/Transport/Base.pm
dbi/trunk/lib/DBD/Gofer/Transport/http.pm
dbi/trunk/lib/DBD/Gofer/Transport/null.pm
dbi/trunk/lib/DBD/Gofer/Transport/pipeone.pm
dbi/trunk/lib/DBD/Gofer/Transport/stream.pm
dbi/trunk/lib/DBI/Gofer/Execute.pm
dbi/trunk/lib/DBI/Gofer/Request.pm
dbi/trunk/lib/DBI/Gofer/Response.pm
dbi/trunk/lib/DBI/Gofer/Transport/Base.pm
dbi/trunk/lib/DBI/Gofer/Transport/mod_perl.pm
dbi/trunk/lib/DBI/Gofer/Transport/pipeone.pm
dbi/trunk/lib/DBI/Gofer/Transport/stream.pm
Log:
Make classic the default policy instead of pedantic.
Throw an author/copyright notice into modules that don't have one.
Modified: dbi/trunk/Changes
==============================================================================
--- dbi/trunk/Changes (original)
+++ dbi/trunk/Changes Mon Feb 19 08:45:56 2007
@@ -7,14 +7,12 @@
=cut
Add attr-passthru to prepare()?
-Terminology
-routing %dsn_attr to both transport and DBD::Gofer + warn about unknown ones.
+Terminology for client and server ends
I could make the short transport/policy name do a lookup in both
DBD::Gofer::Transport and DBIx::Gofer::Transport.
Document user/passwd issues at the various levels of the stack
-Make new connection and retry if send request fails - build into architecture?
-=head2 Changes in DBI 1.54 (svn rev 9118), 16th February 2007
+=head2 Changes in DBI 1.54 (svn rev 9138), 19th February 2007
NOTE: This release includes the 'next big thing' for DBI: DBD::Gofer.
Take a look!
Modified: dbi/trunk/lib/DBD/Gofer.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer.pm (original)
+++ dbi/trunk/lib/DBD/Gofer.pm Mon Feb 19 08:45:56 2007
@@ -116,7 +116,7 @@
}
if (not ref $go_attr{go_policy}) { # if not a policy object already
- my $policy_class = $go_attr{go_policy} || 'pedantic';
+ my $policy_class = $go_attr{go_policy} || 'classic';
$policy_class = "DBD::Gofer::Policy::$policy_class"
unless $policy_class =~ /::/;
_load_class($policy_class)
@@ -807,6 +807,14 @@
XXX
+policy=pedantic is most transparent but slow
+
+policy=classic is a reasonable compromise, and is the default
+
+policy=rush is fastest but may require code changes in application
+
+See L<DBD::Gofer::Policy::Base> for more information.
+
=head1 AUTHOR AND COPYRIGHT
The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
@@ -824,22 +832,17 @@
L<DBI::Gofer::Request>, L<DBI::Gofer::Response>, L<DBI::Gofer::Execute>.
-L<DBI::Gofer::Transport::Base>
+L<DBI::Gofer::Transport::Base>, L<DBD::Gofer::Policy::Base>.
L<DBI>
-
=head1 TODO
Random brain dump...
-Add policy mechanism
-
-Add mecahism for transports to list config params
-and for Gofer to apply any that match
-(and warn if any left over?)
+Document policy mechanism
-Test existing compiled drivers (ie DBD::mysql) for binary compatibility
+Add mecahism for transports to list config params and for Gofer to apply any
that match (and warn if any left over?)
Driver-private sth attributes - set via prepare() - change DBI spec
@@ -851,7 +854,7 @@
track installed_methods and install proxies on client side after connect?
-add hooks into transport base class for checking & updating a cache
+add hooks into transport base class for checking & updating a result set cache
ie via a standard cache interface such as:
http://search.cpan.org/~robm/Cache-FastMmap/FastMmap.pm
http://search.cpan.org/~bradfitz/Cache-Memcached/lib/Cache/Memcached.pm
Modified: dbi/trunk/lib/DBD/Gofer/Policy/Base.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Policy/Base.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Policy/Base.pm Mon Feb 19 08:45:56 2007
@@ -58,3 +58,12 @@
sub DESTROY { };
1;
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
Modified: dbi/trunk/lib/DBD/Gofer/Policy/classic.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Policy/classic.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Policy/classic.pm Mon Feb 19 08:45:56 2007
@@ -31,3 +31,12 @@
1;
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
Modified: dbi/trunk/lib/DBD/Gofer/Policy/pedantic.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Policy/pedantic.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Policy/pedantic.pm Mon Feb 19 08:45:56 2007
@@ -17,3 +17,12 @@
# the 'pedantic' policy is the same as the Base policy
1;
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
Modified: dbi/trunk/lib/DBD/Gofer/Policy/rush.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Policy/rush.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Policy/rush.pm Mon Feb 19 08:45:56 2007
@@ -35,3 +35,12 @@
1;
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
Modified: dbi/trunk/lib/DBD/Gofer/Transport/Base.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Transport/Base.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Transport/Base.pm Mon Feb 19 08:45:56 2007
@@ -29,6 +29,15 @@
DBD::Gofer::Transport::Base - base class for DBD::Gofer client transports
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
=head1 SEE ALSO
L<DBD::Gofer>
Modified: dbi/trunk/lib/DBD/Gofer/Transport/http.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Transport/http.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Transport/http.pm Mon Feb 19 08:45:56 2007
@@ -114,6 +114,15 @@
Connect with DBI::Gofer servers that use http transports, i.e.,
L<DBI::Gofer::Transport::mod_perl>.
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
+
=head1 SEE ALSO
L<DBD::Gofer> and L<DBI::Gofer::Transport::mod_perl>
Modified: dbi/trunk/lib/DBD/Gofer/Transport/null.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Transport/null.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Transport/null.pm Mon Feb 19 08:45:56 2007
@@ -97,6 +97,15 @@
The C<t/85gofer.t> script in the DBI distribution includes a comparative
benchmark.
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
+
=head1 SEE ALSO
L<DBD::Gofer>
Modified: dbi/trunk/lib/DBD/Gofer/Transport/pipeone.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Transport/pipeone.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Transport/pipeone.pm Mon Feb 19 08:45:56 2007
@@ -164,6 +164,15 @@
It also provides a base class for the much more useful
L<DBD::Gofer::Transport::stream>
transport.
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
+
=head1 SEE ALSO
L<DBD::Gofer>
Modified: dbi/trunk/lib/DBD/Gofer/Transport/stream.pm
==============================================================================
--- dbi/trunk/lib/DBD/Gofer/Transport/stream.pm (original)
+++ dbi/trunk/lib/DBD/Gofer/Transport/stream.pm Mon Feb 19 08:45:56 2007
@@ -280,6 +280,14 @@
Decide on default for persistent connection - on or off? limits? ttl?
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
=head1 SEE ALSO
L<DBD::Gofer>
Modified: dbi/trunk/lib/DBI/Gofer/Execute.pm
==============================================================================
--- dbi/trunk/lib/DBI/Gofer/Execute.pm (original)
+++ dbi/trunk/lib/DBI/Gofer/Execute.pm Mon Feb 19 08:45:56 2007
@@ -357,3 +357,12 @@
1;
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
Modified: dbi/trunk/lib/DBI/Gofer/Request.pm
==============================================================================
--- dbi/trunk/lib/DBI/Gofer/Request.pm (original)
+++ dbi/trunk/lib/DBI/Gofer/Request.pm Mon Feb 19 08:45:56 2007
@@ -49,3 +49,12 @@
}
1;
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
Modified: dbi/trunk/lib/DBI/Gofer/Response.pm
==============================================================================
--- dbi/trunk/lib/DBI/Gofer/Response.pm (original)
+++ dbi/trunk/lib/DBI/Gofer/Response.pm Mon Feb 19 08:45:56 2007
@@ -75,3 +75,12 @@
1;
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
Modified: dbi/trunk/lib/DBI/Gofer/Transport/Base.pm
==============================================================================
--- dbi/trunk/lib/DBI/Gofer/Transport/Base.pm (original)
+++ dbi/trunk/lib/DBI/Gofer/Transport/Base.pm Mon Feb 19 08:45:56 2007
@@ -86,3 +86,12 @@
}
1;
+
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
Modified: dbi/trunk/lib/DBI/Gofer/Transport/mod_perl.pm
==============================================================================
--- dbi/trunk/lib/DBI/Gofer/Transport/mod_perl.pm (original)
+++ dbi/trunk/lib/DBI/Gofer/Transport/mod_perl.pm Mon Feb 19 08:45:56 2007
@@ -172,6 +172,15 @@
configurations can be mix-n-matched to create specific configurations for
specific location urls.
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
+
=head1 SEE ALSO
L<DBD::Gofer> and L<DBD::Gofer::Transport::http>.
Modified: dbi/trunk/lib/DBI/Gofer/Transport/pipeone.pm
==============================================================================
--- dbi/trunk/lib/DBI/Gofer/Transport/pipeone.pm (original)
+++ dbi/trunk/lib/DBI/Gofer/Transport/pipeone.pm Mon Feb 19 08:45:56 2007
@@ -44,5 +44,14 @@
See L<DBD::Gofer::Transport::pipeone>.
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
+
=cut
Modified: dbi/trunk/lib/DBI/Gofer/Transport/stream.pm
==============================================================================
--- dbi/trunk/lib/DBI/Gofer/Transport/stream.pm (original)
+++ dbi/trunk/lib/DBI/Gofer/Transport/stream.pm Mon Feb 19 08:45:56 2007
@@ -49,5 +49,14 @@
See L<DBD::Gofer::Transport::stream>.
+=head1 AUTHOR AND COPYRIGHT
+
+The DBD::Gofer, DBD::Gofer::* and DBI::Gofer::* modules are
+Copyright (c) 2007 Tim Bunce. Ireland. All rights reserved.
+
+You may distribute under the terms of either the GNU General Public License or
+the Artistic License, as specified in the Perl README file.
+
+
=cut
