mysqlplus

An enhanced mysql driver with an async interface, threaded access support, and encoding awareness for Ruby 1.9

Go to file

Roger Pack 3198fc25e7 add docu on how to use within rails--hopefully this is right		2009-01-31 20:15:37 +00:00
ext	improve extconf glob to find osx stock installs (/usr/local/mysql-5.0.51b-osx10.5-x86/bin/mysql_config)	2009-01-25 13:00:28 -08: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	remove misleading comments from tests	2009-01-25 13:00:34 -08: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	Use TCP_NODELAY if supported; Remove file descriptor ops from the tight loop; Cleanup timeout assignment; Split the threaded test suite in native and c to avoid a large number of active Threads affecting results.Add experimental Mysql#socket_type which typically returns 'socket (x)', but may be helpful for debugging purposes.	2008-09-10 00:33:18 +01: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.