rdo 0.0.1

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require "rspec"
+require "rdo"
+
+Dir[File.expand_path("../support/**/*.rb", __FILE__)].each do |file|
+  require file
+end
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+end

data/spec/support/driver_with_everything.rb

@@ -0,0 +1,38 @@
+require "rdo"
+
+module RDO
+  class DriverWithEverything < Driver
+    class Executor
+      def execute(*args)
+        Result.new([])
+      end
+    end
+
+    def open
+      @open = true
+    end
+
+    def open?
+      !!@open
+    end
+
+    def close
+      !(@open = false)
+    end
+
+    def execute(stmt, *args)
+      Result.new([])
+    end
+
+    def prepare(stmt)
+      Statement.new(Executor.new)
+    end
+
+    def quote(str)
+      "quoted"
+    end
+  end
+
+  Connection.register_driver(:rdo_with_all, DriverWithEverything)
+end
+

data/spec/support/driver_without_statements.rb

@@ -0,0 +1,23 @@
+require "rdo"
+
+module RDO
+  class DriverWithoutStatements < Driver
+    def open
+      @open = true
+    end
+
+    def open?
+      !!@open
+    end
+
+    def close
+      !(@open = false)
+    end
+
+    def execute(stmt, *args)
+      Result.new([])
+    end
+  end
+
+  Connection.register_driver(:rdo_without_stmt, DriverWithoutStatements)
+end

data/util/macros.h

@@ -0,0 +1,177 @@
+/*
+ * RDO Postgres Driver.
+ * Copyright © 2012 Chris Corbyn.
+ *
+ * See LICENSE file for details.
+ */
+
+/** -------------------------------------------------------------------------
+ * These macros are for use by RDO driver developers.
+ *
+ * They simplify the logic needed when converting types provided by the RDBMS
+ * into their equivalent Ruby types.
+ *
+ * All of these macros take a C string and return a Ruby VALUE.
+ *
+ * The actual logic for many of the conversions is handled in RDO::Util, which
+ * is written in Ruby.
+ * --------------------------------------------------------------------------
+ */
+
+/**
+ * Convert a C string to a ruby String.
+ *
+ * @param (char *) s
+ *   a C string that is valid in the default encoding
+ *
+ * @param (size_t) len
+ *   the length of the string
+ *
+ * @return VALUE (String)
+ *   a Ruby String
+ */
+#define RDO_STRING(s, len, enc) ( \
+    rb_enc_associate_index(rb_str_new(s, len), enc > 0 ? enc : 0) \
+    )
+
+/**
+ * Convert a C string to a ruby String, assuming possible NULL bytes.
+ *
+ * @param (char *) s
+ *   a C string, possibly containing nulls
+ *
+ * @param (size_t) len
+ *   the length of the string
+ *
+ * @return VALUE (String)
+ *   a Ruby String
+ */
+#define RDO_BINARY_STRING(s, len) (rb_str_new(s, len))
+
+/**
+ * Convert a C string to a Fixnum.
+ */
+#define RDO_FIXNUM(s) (rb_cstr2inum(s, 10))
+
+/**
+ * Convert a C string to a Float.
+ *
+ * This supports Infinity and NaN.
+ *
+ * @param (char *) s
+ *   a C string representing a float (e.g. "1.234")
+ *
+ * @return VALUE (Float)
+ *   a ruby Float
+ */
+#define RDO_FLOAT(s) ( \
+    rb_funcall(rb_path2class("RDO::Util"), \
+      rb_intern("float"), 1, \
+      rb_str_new2(s)) \
+    )
+
+/**
+ * Convert a C string representing a precision decimal into a BigDecimal.
+ *
+ * @param (char *) s
+ *   a C string representing a decimal ("1.245")
+ *
+ * @return VALUE (BigDecimal)
+ *   a BigDecimal representation of this string
+ *
+ * @example
+ *   RDO_DECIMAL("1.234")
+ *   => #<BigDecimal:7feb42b2b6e8,'0.1234E1',18(18)>
+ */
+#define RDO_DECIMAL(s) ( \
+    rb_funcall(rb_path2class("RDO::Util"), \
+      rb_intern("decimal"), 1, \
+      rb_str_new2(s)) \
+    )
+
+/**
+ * Convert a C string representing a date into a Date.
+ *
+ * @param (char *) s
+ *   the C string with a parseable date
+ *
+ * @return VALUE (Date)
+ *   a Date, exactly as was specified in the input
+ *
+ * @example
+ *   RDO_DATE("431-09-22 BC")
+ *   #<Date: -0430-09-22 ((1564265j,0s,0n),+0s,2299161j)>
+ */
+#define RDO_DATE(s) ( \
+    rb_funcall(rb_path2class("RDO::Util"), \
+      rb_intern("date"), 1, \
+      rb_str_new2(s)) \
+    )
+
+/**
+ * Convert a C string representing a date & time with no time zone into a DateTime.
+ *
+ * @param (char *) s
+ *   the C string with the date & time provided
+ *
+ * @return VALUE (DateTime)
+ *   a DateTime, assuming the system time zone
+ *
+ * @example
+ *   RDO_DATE_TIME_WITHOUT_ZONE("2012-09-22 04:36:12")
+ *   #<DateTime: 2012-09-22T04:36:12+10:00 ((2456192j,66972s,0n),+36000s,2299161j)>
+ */
+#define RDO_DATE_TIME_WITHOUT_ZONE(s) ( \
+    rb_funcall(rb_path2class("RDO::Util"), \
+      rb_intern("date_time_without_zone"), 1, \
+      rb_str_new2(s)) \
+    )
+
+/**
+ * Convert a C string representing a date & time that includes a time zone into a DateTime.
+ *
+ * @param (char *) s
+ *   the C string with the date & time provided, including the time zone
+ *
+ * @return VALUE (DateTime)
+ *   a DateTime, exactly as was specified in the input
+ *
+ * @example
+ *   RDO_DATE_TIME_WITHOUT_ZONE("2012-09-22 04:36:12+10:00")
+ *   #<DateTime: 2012-09-22T04:36:12+10:00 ((2456192j,66972s,0n),+36000s,2299161j)>
+ */
+#define RDO_DATE_TIME_WITH_ZONE(s) ( \
+    rb_funcall(rb_path2class("RDO::Util"), \
+      rb_intern("date_time_with_zone"), 1, \
+      rb_str_new2(s)) \
+    )
+
+/**
+ * Convert a boolean string to TrueClass/FalseClass.
+ *
+ * @param (char *) s
+ *   a C string that is either 't', 'true', 'f' or 'false'
+ *
+ * @return VALUE (TrueClass, FalseClass)
+ *   the boolean representation
+ */
+#define RDO_BOOL(s) ((s[0] == 't') ? Qtrue : Qfalse)
+
+/**
+ * Wrap the given StatementExecutor in a RDO::Statement.
+ *
+ * @param VALUE
+ *   any object that responds to #command and #execute
+ *
+ * @return VALUE
+ *   an RDO::Statement
+ */
+#define RDO_STATEMENT(executor) ( \
+    rb_funcall(rb_path2class("RDO::Statement"), \
+      rb_intern("new"), 1, executor) \
+    )
+
+/**
+ * Convenience to call #to_s on any Ruby object.
+ */
+#define RDO_OBJ_TO_S(obj) (rb_funcall(obj, rb_intern("to_s"), 0))

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: rdo
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- d11wtq
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! "== Ruby Data Objects\n\nIf you're building something in Ruby that
+  needs access to a database, you may\nopt to use an ORM like ActiveRecord, DataMapper
+  or Sequel. But if your needs\ndon't fit well with an ORM (maybe you're even writing
+  an ORM?) then you'll\nneed some other way of talking to your database.\n\nRDO provides
+  a common interface to a number of RDBMS backends, using a clean\nRuby syntax, while
+  supporting all the functionality you'd expect from a robust\ndatabase connection
+  library:\n\n  - Connect to different types of RDBMS in a consistent way\n  - Type
+  casting\n  - Safe parameterization of queries\n  - Buffered query results\n  - Fetching
+  meta data from executed commands\n  - Access RETURNING values just like any read
+  query\n  - Prepared statements (emulated where no native support exists)\n  - Simple
+  core ruby data types\n\n=== RDBMS Support\n\nSupport for each RDBMS is provided
+  in separate gems, so as to minimize the\ninstallation requirements. Many gems are
+  maintained by separate users who\nwork more closely with those RDBMS's.\n\nDue to
+  the nature of this gem, most of the nitty-gritty code is actually\nwritten in C.\n\nSee
+  the official README for full details."
+email:
+- chris@w3style.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/rdo.rb
+- lib/rdo/connection.rb
+- lib/rdo/driver.rb
+- lib/rdo/emulated_statement_executor.rb
+- lib/rdo/exception.rb
+- lib/rdo/result.rb
+- lib/rdo/statement.rb
+- lib/rdo/util.rb
+- lib/rdo/version.rb
+- rdo.gemspec
+- spec/rdo/connection_spec.rb
+- spec/rdo/driver_spec.rb
+- spec/rdo/emulated_statements_spec.rb
+- spec/rdo/result_spec.rb
+- spec/rdo/statement_spec.rb
+- spec/rdo/util_spec.rb
+- spec/spec_helper.rb
+- spec/support/driver_with_everything.rb
+- spec/support/driver_without_statements.rb
+- util/macros.h
+homepage: https://github.com/d11wtq/rdo
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: RDO—Ruby Data Objects—A robust RDBMS connection layer
+test_files:
+- spec/rdo/connection_spec.rb
+- spec/rdo/driver_spec.rb
+- spec/rdo/emulated_statements_spec.rb
+- spec/rdo/result_spec.rb
+- spec/rdo/statement_spec.rb
+- spec/rdo/util_spec.rb
+- spec/spec_helper.rb
+- spec/support/driver_with_everything.rb
+- spec/support/driver_without_statements.rb