datamapper / do
watch download tarball
public
Forks21Right
Watchers104Right
Description: DataObjects
Homepage: http://rubyforge.org/projects/dorb
Clone URL: git://github.com/datamapper/do.git
do /
name age
history
message
file .gitignore Sun Oct 25 07:09:42 -0700 2009 [data_objects] Enable YARD docs * Fix a couple... [myabc]
file MAVEN.markdown Wed Nov 04 10:29:43 -0800 2009 * dried up pom.xml - build tag was redundant *... [mkristian]
file README.markdown Sat Oct 17 14:48:49 -0700 2009 Unmark SQL Server as pending in README drivers ... [myabc]
file Rakefile Sat Oct 31 12:20:45 -0700 2009 Detect IronRuby implementation * Allow initial... [Alex Coles]
file TODO.markdown Thu Aug 06 23:52:14 -0700 2009 Separate out plugin section [dbussink]
directory data_objects/ Sat Nov 21 12:01:27 -0800 2009 * test URI strings and test the connection * t... [mkristian]
directory do_derby/ Sat Nov 21 12:01:27 -0800 2009 * test URI strings and test the connection * t... [mkristian]
directory do_h2/ Wed Nov 18 08:38:25 -0800 2009 Merge branch 'master' into next Conflicts: do... [myabc]
directory do_hsqldb/ Sat Nov 21 12:01:27 -0800 2009 * test URI strings and test the connection * t... [mkristian]
directory do_jdbc-tools/ Wed Nov 04 20:05:25 -0800 2009 * fixed the rails plugin version * reformated ... [mkristian]
directory do_jdbc/ Sat Nov 21 12:01:27 -0800 2009 * test URI strings and test the connection * t... [mkristian]
directory do_mysql/ Wed Nov 18 08:38:25 -0800 2009 Merge branch 'master' into next Conflicts: do... [myabc]
directory do_oracle/ Sat Nov 21 12:01:27 -0800 2009 * test URI strings and test the connection * t... [mkristian]
directory do_postgres/ Sat Nov 21 12:01:27 -0800 2009 * test URI strings and test the connection * t... [mkristian]
directory do_sqlite3/ Sat Nov 21 12:01:27 -0800 2009 * test URI strings and test the connection * t... [mkristian]
directory do_sqlserver/ Wed Nov 18 08:38:25 -0800 2009 Merge branch 'master' into next Conflicts: do... [myabc]
directory jdbc_drivers/ Sat Oct 31 14:48:01 -0700 2009 Remove unnecessary flags from install tasks * ... [myabc]
file pom.xml Thu Nov 12 15:21:17 -0800 2009 [do_jdbc] Updated Maven's configuration files ... [Piotr Gega (pietia)]
directory tasks/ Wed Nov 11 15:47:40 -0800 2009 Begin improving JRuby compilation tasks * JRub... [myabc]
README.markdown

DataObjects README

DataObjects.rb is an attempt to rewrite existing Ruby database drivers to conform to one, standard interface.

At present the following drivers are available:

Database Vendor MRI (1.8.6/7) / 1.9 JRuby
MySQL x x
Oracle x x
PostgreSQL x x
SQLite3 x x
Derby - x
H2 - x
HSQLDB - x
SQL Server pending x

There is experimental support for Rubinius.

At present, PostgreSQL, MySQL and SQLite drivers are available. More drivers are currently under development. If you feel like living on the edge, install and test drivers directly from this repository.

Introduction

To connect to and query the database, DataObjects relies on native extensions. Native extensions have been written in both C (for Ruby 1.8.6/7 (MRI), Ruby 1.9.x (YARV) and Rubinius platform) and Java (for the JRuby platform). Individual drivers may include extensions for both Ruby MRI and JRuby, or one or the other.

C extensions have been written using according to each vendor API. Java drivers use the standard JDBC API. Although there are dialectical differences between the Java drivers, the JDBC API ensures a reasonable amount of commonality. As such, the Java extensions rely on a common do_jdbc gem, which wraps code that is common to all of the Java extensions.

Installation

To install a driver from the repository cd into the driver directory and use the provided rake install task to install for the default platform.

Copyright and Licensing

Please see the copyright notices in each individual driver README.markdown or LICENSE file. Java-based drivers bundle JDBC driver JAR files, which may be provided under a license that is more restrictive than the MIT License used by the data_objects gem itself.