An enhanced mysql driver with an async interface, threaded access support, and encoding awareness for Ruby 1.9
Go to file
Roger Pack c235dcdf46 overcome merge conflicts 2009-04-18 22:35:02 +00:00
ext overcome merge conflicts 2009-04-18 22:35:02 +00:00
lib add small documentation, also raise with a useful message if they require mysqlplus after mysql--don't know if that works with 1.9 but it does with 1.8.x 2009-01-29 23:53:48 +00:00
test overcome a merge conflict which wasn't one 2009-04-18 22:24:31 +00:00
README add docu on how to use within rails--hopefully this is right 2009-01-31 20:15:37 +00:00
Rakefile Experimental build && test tasks 2008-09-05 18:23:47 +01:00
TODO_LIST update some tests 2009-01-12 18:42:46 +00:00
mysqlplus.gemspec Update gemspec 2009-03-22 19:17:07 -07:00

README

== MySQLPlus

An enhanced MySQL database driver. With support for async operations and threaded database access.

== Building

  gem build mysqlplus.gemspec

  on OSX with the default mysql installed:

    sudo gem install mysqlplus-0.1.0.gem -- --with-mysql-config

  on OSX, with mysql installed by macports:

    sudo gem install mysqlplus-0.1.0.gem -- --with-mysql-config=/opt/local/lib/mysql5/bin/mysql_config

  on OSX, with x86 mysql (NOT x86_64!) installed from mysql.com:

    sudo env ARCHFLAGS="-arch i386" gem install mysqlplus-0.1.0.gem -- \
      --with-mysql-dir=/usr/local/mysql \
      --with-mysql-lib=/usr/local/mysql/lib \
      --with-mysql-include=/usr/local/mysql/include
== Using
  to use within rails
  add require 'mysqlplus' to the top of environment.rb
  this instantiates the Mysql class that you can use.
  and it will automagically use async_query instead of query, so it's a drop in replacement.

  Same with other scripts that want to use it--just require 'mysqlplus' BEFORE you require 'mysql' and it will 
  load the asynchronous version, then ignore the sequent require 'mysql' call.

=== Credits

Aman Gupta, for help in threading support and improved tests
Tomita Masahiro--since this is a fork of his already excellent mysql lib [http://www.tmtm.org/en/mysql/ruby].
Roger Pack, for helping in the file descriptor hunt :)
Lourens Naude for 1.9 integration help.

=== License
Ruby License, http://www.ruby-lang.org/en/LICENSE.txt.