mysql_blob_streaming 1.1.3

data/README.markdown

@@ -0,0 +1,24 @@
+# A blob streaming extension for the native Ruby-MySQL adaptor.
+
+It provides the module MysqlBlobStreaming, which gives the adaptor the ability
+of streaming blobs right out of the MySQL database.
+
+(c) 2008-2012 Infopark AG. See MIT-LICENSE for licensing details.
+
+## Dependencies
+
+  * Ruby-headers
+  * MySQL-headers
+  * [Native Ruby-MySQL adaptor](http://www.tmtm.org/en/mysql/ruby)
+
+## Building
+
+    gem build mysql_blob_streaming.gemspec
+
+## Installation
+
+Install it like any other Gem:
+
+    gem install mysql_blob_streaming-X.X.X.gem
+
+Run it with root privileges if needed.

data/ext/mysql_blob_streaming/extconf.rb

@@ -0,0 +1,23 @@
+require "mkmf"
+
+additional_mysql_include_dirs = [
+    '/usr/local/mysql/include',
+    '/usr/include/mysql']
+additional_mysql_lib_dirs = additional_mysql_include_dirs.map{
+    |d| d.sub('include', 'lib')}
+
+find_header('mysql.h', *additional_mysql_include_dirs)
+find_header('errmsg.h', *additional_mysql_include_dirs)
+find_library('mysqlclient', nil, *additional_mysql_lib_dirs)
+
+# --no-undefined forces us to link against libruby
+def remove_no_undefined(ldflags)
+  ldflags.gsub("-Wl,--no-undefined", "")
+end
+
+with_ldflags("#{remove_no_undefined($LDFLAGS)}") { true }
+
+# Do NOT link against libruby
+$LIBRUBYARG = ""
+
+create_makefile("mysql_blob_streaming/mysql_blob_streaming")

data/ext/mysql_blob_streaming/mysql_blob_streaming.c

@@ -0,0 +1,98 @@
+#include <ruby.h>
+#include <stdlib.h>
+
+#include <mysql.h>
+#include <errmsg.h>
+
+struct mysql_stmt {
+    MYSQL_STMT *stmt;
+    char closed;
+    struct {
+        int n;
+        MYSQL_BIND *bind;
+        unsigned long *length;
+        MYSQL_TIME *buffer;
+    } param;
+    struct {
+        int n;
+        MYSQL_BIND *bind;
+        my_bool *is_null;
+        unsigned long *length;
+    } result;
+    MYSQL_RES *res;
+};
+
+
+static void store_buffer(struct mysql_stmt *s, int offset_index, VALUE obj)
+{
+    int status = mysql_stmt_fetch_column(s->stmt, s->result.bind, 0, offset_index);
+    if (status != 0) {
+        rb_raise(rb_eRuntimeError, "Fetching column failed");
+    }
+    if (!s->result.is_null[0]) {
+        if (s->result.bind[0].buffer_type == MYSQL_TYPE_BLOB) {
+            rb_funcall(obj, rb_intern("handle_data"), 1, rb_str_new(s->result.bind[0].buffer,
+                    s->result.bind[0].buffer_length));
+        } else {
+            rb_raise(rb_eRuntimeError, "wrong buffer_type (must be: MYSQL_TYPE_BLOB): %d",
+                    s->result.bind[0].buffer_type);
+        }
+    }
+}
+
+
+static int determine_blob_length(struct mysql_stmt *s)
+{
+    s->result.bind[0].buffer_length = 0;
+    if (mysql_stmt_bind_result(s->stmt, s->result.bind) != 0) {
+        rb_raise(rb_eRuntimeError, "Could not determine the blob length: bind failed");
+    }
+    int status = mysql_stmt_fetch(s->stmt);
+    // MYSQL_DATA_TRUNCATED is returned if MYSQL_REPORT_DATA_TRUNCATION connection option is set
+    if (status != 0 && status != MYSQL_DATA_TRUNCATED) {
+        rb_raise(rb_eRuntimeError, "Could not determine the blob length: fetch failed");
+    }
+    return *s->result.bind[0].length;
+}
+
+
+static VALUE stmt_fetch_and_write(VALUE obj, VALUE rb_buffer_length)
+{
+    int buffer_length = FIX2INT(rb_buffer_length);
+
+    if (buffer_length == 0) {
+        return 0;
+    }
+    if (buffer_length < 0) {
+        rb_raise(rb_eRuntimeError, "buffer size must be integer >= 0");
+    }
+
+    struct mysql_stmt *s = DATA_PTR(obj);
+    int blob_length = determine_blob_length(s);
+
+    s->result.bind[0].buffer_length = buffer_length;
+    if (blob_length <= s->result.bind[0].buffer_length) {
+        s->result.bind[0].buffer_length = blob_length;
+        store_buffer(s, 0, obj);
+    } else {
+        long loops = abs(blob_length / s->result.bind[0].buffer_length);
+        long i;
+        for (i = 0; i < loops; ++i) {
+            store_buffer(s, i * s->result.bind[0].buffer_length, obj);
+        }
+        int old_bufflen = s->result.bind[0].buffer_length;
+        int new_bufflen = blob_length % s->result.bind[0].buffer_length;
+        if (new_bufflen) {
+            s->result.bind[0].buffer_length = new_bufflen;
+            store_buffer(s, loops * old_bufflen, obj);
+        }
+    }
+    return Qnil;
+}
+
+
+void Init_mysql_blob_streaming()
+{
+    VALUE rb_mMysqlBlobStreaming = rb_define_module("MysqlBlobStreaming");
+    rb_define_method(rb_mMysqlBlobStreaming, "stream", stmt_fetch_and_write, 1);
+}

data/lib/mysql_blob_streaming.rb

@@ -0,0 +1 @@
+require "mysql_blob_streaming/mysql_blob_streaming"

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: mysql_blob_streaming
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: 
+  segments: 
+  - 1
+  - 1
+  - 3
+  version: 1.1.3
+platform: ruby
+authors: 
+- Infopark AG
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-07-12 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mysql
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 2
+        - 7
+        version: "2.7"
+  type: :runtime
+  version_requirements: *id001
+description: "    This GEM is required by the Infopark Rails Connector (RC) when using MySQL.\n"
+email: info@infopark.de
+executables: []
+
+extensions: 
+- ext/mysql_blob_streaming/extconf.rb
+extra_rdoc_files: 
+- README.markdown
+files: 
+- lib/mysql_blob_streaming.rb
+- ext/mysql_blob_streaming/mysql_blob_streaming.c
+- ext/mysql_blob_streaming/extconf.rb
+- README.markdown
+homepage: http://www.infopark.de/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.markdown
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 57
+      segments: 
+      - 1
+      - 8
+      - 7
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- Infopark Rails Connector (RC)
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: A blob streaming extension for the native Ruby-MySQL adapter
+test_files: []
+