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
-------------
[email protected] <Jessica Severin>
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.954 Wednesday June 3, 2009
0.953 Friday April 17, 2009
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.954.tar.gz
cd MQdb-0.954
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 <
[email protected]>
