data_objects 0.2.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Yehuda Katz
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,4 @@
+do_sqlite3
+=================
+
+A plugin for the Merb framework that provides ....

data/Rakefile

@@ -0,0 +1,33 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+
+GEM = "data_objects"
+VERSION = "0.2.0"
+AUTHOR = "Yehuda Katz"
+EMAIL = "wycats@gmail.com"
+HOMEPAGE = "http://dataobjects.devjavu.com"
+SUMMARY = "The Core DataObjects class"
+
+spec = Gem::Specification.new do |s|
+  s.name = GEM
+  s.version = VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "LICENSE", 'TODO']
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.require_path = 'lib'
+  s.autorequire = GEM
+  s.files = %w(LICENSE README Rakefile TODO) + Dir.glob("{lib,specs}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{GEM}-#{VERSION}}
+end

data/TODO

@@ -0,0 +1,5 @@
+TODO:
+Fix LICENSE with your name
+Fix Rakefile with your name and contact info
+Add your code to lib/do_sqlite3.rb
+Add your Merb rake tasks to lib/do_sqlite3/merbtasks.rb

data/lib/data_objects.rb

@@ -0,0 +1,345 @@
+require 'date'
+require 'logger'
+
+# Thanks http://www.rubyweeklynews.org/20051120
+class DateTime
+ def to_time
+   Time.mktime(year, mon, day, hour, min, sec)
+ end
+ 
+ def to_date
+   Date.new(year, mon, day)
+ end
+end
+
+class Time
+  def to_datetime
+    DateTime.civil(year, mon, day, hour, min, sec)
+  end
+  
+  def to_s_db
+    strftime("%Y-%m-%d %X")
+  end
+end
+
+module DataObject
+  STATE_OPEN   = 0
+  STATE_CLOSED = 1
+
+  class Connection
+
+    attr_reader :timeout, :database, :datasource, :server_version, :state
+    
+    def initialize(connection_string)
+    end
+    
+    def logger
+      @logger || @logger = Logger.new(nil)
+    end
+    
+    def logger=(value)
+      @logger = value
+    end
+    
+    def begin_transaction
+      # TODO: Hook this up
+      Transaction.new
+    end
+    
+    def change_database(database_name)
+      raise NotImplementedError
+    end
+    
+    def open
+      raise NotImplementedError
+    end
+    
+    def close
+      raise NotImplementedError
+    end
+    
+    def create_command(text)
+      Command.new(self, text)
+    end
+    
+    def closed?
+      @state == STATE_CLOSED
+    end
+    
+  end
+  
+  class Transaction
+    
+    attr_reader :connection
+    
+    def initialize(conn)
+      @connection = conn
+    end
+    
+    # Commits the transaction
+    def commit
+      raise NotImplementedError
+    end
+    
+    # Rolls back the transaction
+    def rollback(savepoint = nil)
+      raise NotImplementedError
+    end
+    
+    # Creates a savepoint for rolling back later (not commonly supported)
+    def save(name)
+      raise NotImplementedError
+    end
+    
+  end
+  
+  class Reader
+    include Enumerable
+    
+    attr_reader :field_count, :records_affected, :fields
+    
+    def each
+      raise NotImplementedError
+    end
+    
+    def has_rows?
+      @has_rows
+    end
+    
+    def current_row
+      ret = []
+      field_count.times do |i|
+        ret[i] = item(i)
+      end
+      ret
+    end
+    
+    def open?
+      @state != STATE_CLOSED
+    end
+    
+    def close        
+      real_close
+      @reader = nil
+      @state = STATE_CLOSED
+      true
+    end
+    
+    def real_close
+      raise NotImplementedError
+    end
+    
+    # retrieves the Ruby data type for a particular column number
+    def data_type_name(col)
+      raise ReaderClosed, "You cannot ask for metadata once the reader is closed" if state_closed?      
+    end
+    
+    # retrieves the name of a particular column number
+    def name(col)
+      raise ReaderClosed, "You cannot ask for metadata once the reader is closed" if state_closed?      
+    end
+    
+    # retrives the index of the column with a particular name
+    def get_index(name)
+      raise ReaderClosed, "You cannot ask for metadata once the reader is closed" if state_closed?
+    end
+    
+    def item(idx)
+      raise ReaderClosed, "You cannot ask for information once the reader is closed" if state_closed?
+    end
+
+    # returns an array of hashes containing the following information
+    #            
+    # name:         the column name
+    # index:        the index of the column
+    # max_size:     the maximum allowed size of the data in the column
+    # precision:    the precision (for column types that support it)
+    # scale:        the scale (for column types that support it)
+    # unique:       boolean specifying whether the values must be unique
+    # key:          boolean specifying whether this column is, or is part
+    #               of, the primary key
+    # catalog:      the name of the database this column is part of
+    # base_name:    the original name of the column (if AS was used,
+    #               this will provide the original name)
+    # schema:       the name of the schema (if supported)
+    # table:        the name of the table this column is part of
+    # data_type:    the name of the Ruby data type used
+    # allow_null:   boolean specifying whether nulls are allowed
+    # db_type:      the type specified by the DB
+    # aliased:      boolean specifying whether the column has been
+    #               renamed using AS
+    # calculated:   boolean specifying whether the field is calculated
+    # serial:       boolean specifying whether the field is a serial
+    #               column
+    # blob:         boolean specifying whether the field is a BLOB
+    # readonly:     boolean specifying whether the field is readonly
+    def get_schema
+      raise ReaderClosed, "You cannot ask for metadata once the reader is closed" if state_closed?
+    end
+    
+    # specifies whether the column identified by the passed in index
+    # is null.
+    def null?(idx)
+      raise ReaderClosed, "You cannot ask for column information once the reader is closed" if state_closed?
+    end
+    
+    # Consumes the next result. Returns true if a result is consumed and
+    # false if none is
+    def next
+      raise ReaderClosed, "You cannot increment the cursor once the reader is closed" if state_closed?
+    end
+    
+    protected
+    def state_closed?
+      @state == STATE_CLOSED
+    end
+    
+    def native_type
+      raise ReaderClosed, "You cannot check the type of a column once the reader is closed" if state_closed?
+    end
+    
+  end
+  
+  class ResultData
+    
+    def initialize(conn, affected_rows, last_insert_row = nil)
+      @conn, @affected_rows, @last_insert_row = conn, affected_rows, last_insert_row
+    end
+  
+    attr_reader :affected_rows, :last_insert_row
+    alias_method :to_i, :affected_rows
+    
+  end
+  
+  class Schema < Array
+    
+  end
+  
+  class Command
+    
+    attr_reader :text, :timeout, :connection
+    
+    # initialize creates a new Command object
+    def initialize(connection, text)
+      @connection, @text = connection, text
+    end
+    
+    def execute_non_query(*args)
+      raise LostConnectionError, "the connection to the database has been lost" if @connection.closed?
+    end
+    
+    def execute_reader(*args)
+      raise LostConnectionError, "the connection to the database has been lost" if @connection.closed?
+    end
+    
+    def prepare
+      raise NotImplementedError
+    end
+    
+    # Escape a string of SQL with a set of arguments.
+    # The first argument is assumed to be the SQL to escape,
+    # the remaining arguments (if any) are assumed to be
+    # values to escape and interpolate.
+    #
+    # ==== Examples
+    #   escape_sql("SELECT * FROM zoos")
+    #   # => "SELECT * FROM zoos"
+    # 
+    #   escape_sql("SELECT * FROM zoos WHERE name = ?", "Dallas")
+    #   # => "SELECT * FROM zoos WHERE name = `Dallas`"
+    #
+    #   escape_sql("SELECT * FROM zoos WHERE name = ? AND acreage > ?", "Dallas", 40)
+    #   # => "SELECT * FROM zoos WHERE name = `Dallas` AND acreage > 40"
+    # 
+    # ==== Warning
+    # This method is meant mostly for adapters that don't support
+    # bind-parameters.
+    def escape_sql(args)
+      sql = text.dup
+    
+      unless args.empty?
+        sql.gsub!(/\?/) do |x|
+          quote_value(args.shift)
+        end
+      end
+      
+      sql
+    end
+    
+    def quote_value(value)
+      return 'NULL' if value.nil?
+
+      case value
+        when Numeric then quote_numeric(value)
+        when String then quote_string(value)
+        when Class then quote_class(value)
+        when Time then quote_time(value)
+        when DateTime then quote_datetime(value)
+        when Date then quote_date(value)
+        when TrueClass, FalseClass then quote_boolean(value)
+        when Array then quote_array(value)
+        when Symbol then quote_symbol(value)
+        else 
+          if value.respond_to?(:to_sql)
+            value.to_sql
+          else
+            raise "Don't know how to quote #{value.inspect}"
+          end
+      end
+    end
+    
+    def quote_symbol(value)
+      quote_string(value.to_s)
+    end
+    
+    def quote_numeric(value)
+      value.to_s
+    end
+    
+    def quote_string(value)
+      "'#{value.gsub("'", "''")}'"
+    end
+    
+    def quote_class(value)
+      "'#{value.name}'"
+    end
+    
+    def quote_time(value)
+      "'#{value.xmlschema}'"
+    end
+    
+    def quote_datetime(value)
+      "'#{value.dup}'"
+    end
+    
+    def quote_date(value)
+      "'#{value.strftime("%Y-%m-%d")}'"
+    end
+    
+    def quote_boolean(value)
+      value.to_s.upcase
+    end
+    
+    def quote_array(value)
+      "(#{value.map { |entry| quote_value(entry) }.join(', ')})"
+    end
+    
+  end
+  
+  class NotImplementedError < StandardError; end
+  
+  class ConnectionFailed < StandardError; end
+  
+  class ReaderClosed < StandardError; end
+  
+  class ReaderError < StandardError; end
+  
+  class QueryError < StandardError; end
+  
+  class NoInsertError < StandardError; end
+  
+  class LostConnectionError < StandardError; end
+  
+  class UnknownError < StandardError; end
+  
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: data_objects
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+date: 2007-11-11 00:00:00 -08:00
+summary: The Core DataObjects class
+require_paths: 
+- lib
+email: wycats@gmail.com
+homepage: http://dataobjects.devjavu.com
+rubyforge_project: 
+description: The Core DataObjects class
+autorequire: data_objects
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Yehuda Katz
+files: 
+- LICENSE
+- README
+- Rakefile
+- TODO
+- lib/data_objects.rb
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+- TODO
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+