packages feed

BerkeleyDBXML-0.7: README

Berkeley DB / Berkeley DB XML binding for Haskell
28 Jan 2010
by Stephen Blackheath

email me: http://blacksapphire.com/antispam/
darcs repository: http://blacksapphire.com/BerkeleyDBXML/
introduction/tutorial: http://haskell.org/haskellwiki/BerkeleyDBXML


Berkeley DB XML is a powerful, fully transactional, XML-based database that uses
XQuery as its query language.  It is NOT an SQL database.  You can download it here:

http://www.oracle.com/database/berkeley-db/xml/index.html

This package provides a Haskell binding for Berkeley DB XML.  It is a tolerable
subset of the API, and I hope to improve it over time.  I have stuck closely to
the C++ API, with some minor changes where a Haskell idiom seemed appropriate.
I hope that people will develop higher level wrappers for it.  I have had great
success with the "pickler" interfaces in the HXT library.  See the adventure
example in the examples/ directory.

The binding is only about 70% complete, but it should allow you to write a fairly
serious application.  If you would like a particular part of the API added,
please contact me.

To install, use the standard Cabal install procedure:

cabal install

or

runhaskell Setup.hs install

If Berkeley DB or DB XML is not installed in the default location of /usr or
/usr/local, you will need to specify the paths in this way:

cabal install \
    --extra-include-dirs=/usr/local/dbxml-2.5.16/include/ \
    --extra-include-dirs=/usr/local/dbxml-2.5.16/include/dbxml/ \
    --extra-lib-dirs=/usr/local/dbxml-2.5.16/lib/

See the examples/ directory for examples.