DBIWrapper README
Created by James Pattie, PC & Web Xperience, Inc., 11/02/2000
http://www.pcxperience.com/
mailto:james@pcxperience.com

This module allows you to abstract working with DBI databases so that
the normal program just instantiates the wrapper, specifies the database, etc.
and then calls read or write on it to work with the database.  The programmer
will still need to know how DBI returns data, etc. but won't have to work with
the setup and exection code directly.

Needed modules: DBI, DBD-{Database name}

Installation:
  untar the distribution: tar xvzf dbi_wrapper-{VERSION}.tar.gz
  perl Makefile.PL
  make
  make test
  su (if not root)
  make install

To test the program (make test), you need to create a test database called
testing_db.  For PostgreSQL you would do:
	createdb testing_db
	psql testing_db < testing_db.pgsql

If you are doing this as root, you should su to the postgres user so that the
database is created owned by postgres.

For MySQL:
  mysqladmin -p create testing_db
  mysql -p testing_db
    source testing_db.mysql

  Modify the test.pl script to use mysql instead of Pg.


Make sure to set the correct username and password that you are going to connect
as since a password is required by the DBIWrapper module.  If I don't force you
to do semi good security who is?

Note:  As of version 0.16 XML output is now possible via the readXML method.
This will return a valid XML document with the result of your SELECT statement
or the error that was encountered.

	As of version 0.17, you can parse the XML document created by readXML
via the DBIWrapper::XMLParser module.  It depends on XML::LibXML.
  libxml2 2.4.11
  File-Temp 0.12
  XML::SAX 0.03
  XML::LibXML 1.31

Note: As of version 0.19, you can optionally call the read, readXML, write,
setError methods by just passing in the value (if only dealing with one argument
otherwise you still have to pass by name.  For read, readXML and write, I assume
the single argument is the sql string to execute.

Note: As of version 0.20, there are now helper methods to convert boolean values
back and forth between what DBI is expecting and a more user readable format.
1 <=> true, 0 <=> false.

