File Coverage

blib/lib/DBA.pm
Criterion Covered Total %
statement 9 9 100.0
branch n/a
condition n/a
subroutine 3 3 100.0
pod n/a
total 12 12 100.0


line stmt bran cond sub pod time code
1             package DBA;
2              
3 1     1   22307 use 5.008003;
  1         3  
  1         38  
4 1     1   5 use strict;
  1         1  
  1         31  
5 1     1   4 use warnings;
  1         6  
  1         63  
6              
7             our $VERSION = '0.02';
8              
9              
10             1;
11              
12             =head1 NAME
13              
14             DBA - This module is just a placeholder on the top level DBA namespace.
15              
16             =head1 SYNOPSIS
17              
18             Do not use this module directly. It currently does absolutely nothing. I don't
19             expect it will do anything any time soon either.
20              
21             =head1 DESCRIPTION
22              
23             This module is here only as a place holder and to describe the intended purpose
24             of modules that should be found under it. It may some day provide some extremely
25             basic methods, config handling or such that it turns out are common to most
26             projects under it, but it's unlikely there will be much in common.
27              
28             This name space root was decided on as a result of discussions on the
29             module-authors mailing list at perl.org Emodule-authors@perl.orgE
30             regarding my MySQL backup project originally proposed as MySQL::Backup.
31             (http://www.nntp.perl.org/group/perl.module-authors/2964)
32              
33             There was moderate interest in the module on concept. A few people were
34             interested in seeing the module become a base package for backing up other
35             RDBMS types as well. After a little thinking I concluded this was something I
36             could reasonably achieve, and so I suggested the DBA top name space with my
37             project falling under DBA::Backup. Tim Bunce responded (excerpted):
38              
39             "... a DBA namespace sounds reasonable as a home for cross-database
40             DBA support modules. I'd recommend a structure like this:
41              
42             DBA:: -- front-end module
43             DBA::::* -- support modules
44             DBA::::Plugin:: -- back-end modules
45              
46             ...
47              
48             You'll either end up with a lowest-common-denominator approach that
49             has too little functionality, or have so many database-specific
50             flags an options and whatnot that there's little benefit in having
51             a "common API".
52              
53             Having said that, I'd be happy to see this happen if it did :)"
54              
55             So here it is. I decided not to bother with ::Plugin portion, at least in the
56             Backup project, since all activities
57             in this area will require RDBMS specific drivers and, unlike DBI drivers, they
58             will not be in a separate namespace. Have fun, and I hope you find something
59             useful in here!
60              
61             =head1 HISTORY
62              
63             =over 8
64              
65             =item 0.01
66              
67             Original version, just documentation.
68              
69             =item 0.02
70              
71             Added mailing list information.
72              
73             =back
74              
75             =head1 SEE ALSO
76              
77             The mailing list for the DBA modules is perl-dba@fini.net. See
78             http://lists.fini.net/mailman/listinfo/perl-dba to subscribe.
79              
80             =head1 AUTHOR
81              
82             Sean Quinlan, Egilant@gmail.comE
83              
84             =head1 COPYRIGHT AND LICENSE
85              
86             Copyright (C) 2004 by Sean Quinlan
87              
88             This library is free software; you can redistribute it and/or modify
89             it under the same terms as Perl itself, either Perl version 5.8.3 or,
90             at your option, any later version of Perl 5 you may have available.
91              
92              
93             =cut