README for MQdb.pm MQdb.pm is a base toolkit for working with relational databases in the context of a federation of object databases. It provides some base federation support and a variation on an Object-relational-mapped template model. Currently it supports mysql, oracle, and sqlite. In theory it can also be used as a base object class for federation without using relational databases. Refer to the pod for full documentation and an example script, or to the following mirrors: 1/ http://search.cpan.org/perldoc?MQdb 2/ http://search.cpan.org/~jms copyright (c) 2006-2009 Jessica Severin CONTACT POINT ------------- jessica.severin@gmail.com http://search.cpan.org/~jms LICENSE ------- * Software License Agreement (BSD License) * MappedQueryDB [MQdb] system * copyright (c) 2006-2009 Jessica Severin * All rights reserved. * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of Jessica Severin nor the * names of its contributors may be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. OVERVIEW -------- MQdb.pm is a base toolkit for working with relational databases in the context of a federation of object databases. It provides some base federation support and a variation on other Object-relational-mapped template systems. VERSION ------- 0.951 Thursday April 2, 2009 DOCUMENTATION ------------- The following documentation is available: pod in perldoc format (type perldoc MQdb::... on command line) INSTALLATION INSTRUCTIONS ------------------------- ***THERE ARE TWO WAYS TO IMPLEMENT MQdb MODULE IN PERL*** 1/ Systems with CPAN support (all Unix/Linux/BSD/Mac): ----------------------------------------------------- Install the new distribution via the Perl CPAN module: In a shell: /home/somewhere% perl -MCPAN -e"install MQdb" 2/ The hard way (requires make or nmake, tar, gunzip, and gcc): --------------------------------------------------------------- This method was tested in Irix, FreeBSD, Cygwin, debian linux, and Mac OSX Hard-headed users can directly get the distribution from First download the source. Then, in a shell: /home/somewhere% tar -xzvf MQdb-0.951.tar.gz cd MQdb-0.951 make make install KNOWN BUGS & ISSUES ------------------- none at this time. COMMENTS/FEEDBACK ----------------- Please email your feedback, comments, questions to the email address at the top of this document. I will do my best to answer promptly. Jessica Severin