motion-sqlite3 0.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 60363684d12e16e0ccb74acc26918d1548972762
+  data.tar.gz: b79313617ce0179fc585320b48d22d6d765a34c9
+SHA512:
+  metadata.gz: cc32f386588abeaf391a715d1f65deb5e359ed50f3fac8eebbc8be52ddc7bd4a17704f31c8c6279086d956392e847efcaa3d08bc75c23783906b354f2006b6e0
+  data.tar.gz: 0c1aed2f2d261d4f72a2b1397df1aeec5a54c30fd4973f2d7768ff355c57c9bd8d9fbc3b2a4782bd09c1977bb209f8b505ccd38fe9a8361c3a98a820dfcbcec4

data/.gitignore

@@ -0,0 +1,17 @@
+.repl_history
+build
+tags
+app/pixate_code.rb
+resources/*.nib
+resources/*.momd
+resources/*.storyboardc
+vendor/sqlite3/build-*
+.DS_Store
+nbproject
+.redcar
+#*#
+*~
+*.sw[po]
+.eprj
+.sass-cache
+.idea

data/.rvmrc

@@ -0,0 +1,4 @@
+rvm ruby-1.9.3-p194@rubymotion --create
+
+[[ -s "config/rvm_env.sh" ]] && . "config/rvm_env.sh"
+[[ -s ".rvm_env" ]] && . ".rvm_env"

data/Gemfile

@@ -0,0 +1,10 @@
+# A sample Gemfile
+source "https://rubygems.org"
+
+gem 'rake', '~> 0.9.0'
+
+gem 'cocoapods'#, '~> 0.16.0'
+gem 'motion-cocoapods'#, '~> 1.2.1'
+
+gem 'guard-motion'
+gem 'rb-fsevent', '~> 0.9.1'

data/Gemfile.lock

@@ -0,0 +1,74 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (3.2.11)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    addressable (2.3.2)
+    cocoapods (0.16.1)
+      activesupport (~> 3.2.6)
+      colored (~> 1.2)
+      escape (~> 0.0.4)
+      faraday (~> 0.8.1)
+      json (~> 1.7.3)
+      octokit (~> 1.7)
+      open4 (~> 1.3.0)
+      rake (~> 0.9.4)
+      xcodeproj (~> 0.4.1)
+    coderay (1.0.8)
+    colored (1.2)
+    escape (0.0.4)
+    faraday (0.8.4)
+      multipart-post (~> 1.1)
+    faraday_middleware (0.9.0)
+      faraday (>= 0.7.4, < 0.9)
+    guard (1.6.2)
+      listen (>= 0.6.0)
+      lumberjack (>= 1.0.2)
+      pry (>= 0.9.10)
+      terminal-table (>= 1.4.3)
+      thor (>= 0.14.6)
+    guard-motion (0.1.1)
+      guard (>= 1.1.0)
+      rake (>= 0.9)
+    hashie (1.2.0)
+    i18n (0.6.1)
+    json (1.7.6)
+    listen (0.7.2)
+    lumberjack (1.0.2)
+    method_source (0.8.1)
+    motion-cocoapods (1.2.1)
+      cocoapods (>= 0.14.0)
+    multi_json (1.5.0)
+    multipart-post (1.1.5)
+    netrc (0.7.7)
+    octokit (1.22.0)
+      addressable (~> 2.2)
+      faraday (~> 0.8)
+      faraday_middleware (~> 0.9)
+      hashie (~> 1.2)
+      multi_json (~> 1.3)
+      netrc (~> 0.7.7)
+    open4 (1.3.0)
+    pry (0.9.11.4)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rake (0.9.6)
+    rb-fsevent (0.9.3)
+    slop (3.4.3)
+    terminal-table (1.4.5)
+    thor (0.17.0)
+    xcodeproj (0.4.2)
+      activesupport (~> 3.2.6)
+      colored (~> 1.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cocoapods
+  guard-motion
+  motion-cocoapods
+  rake (~> 0.9.0)
+  rb-fsevent (~> 0.9.1)

data/Guardfile

@@ -0,0 +1,9 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'motion', :all_after_pass => false do
+  watch(%r{^spec/.+_spec\.rb$})
+
+  # RubyMotion gem example
+  watch(%r{^lib/[^/]+/(.+)\.rb$})     { |m| "./spec/#{m[1]}_spec.rb" }
+end

data/README.md

@@ -0,0 +1,56 @@
+Introduction
+------------
+This is a tiny wrapper around the SQLite C API that's written in RubyMotion. It is intentionally bare so as to limit the surface area of code that interacts with the raw C API (misuse of the C API can cause resource leaks and seg faults). Think of it more as a driver for SQLite than anything else.
+
+Whenever possible, it uses Ruby idioms like blocks and exceptions.
+
+Sample code
+-----------
+
+#### DB in memory
+
+```ruby
+db = SQLite3::Database.new(":memory:")
+db.execute("CREATE TABLE test (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER)")
+db.execute("INSERT INTO test (name, age) VALUES (?, ?)", ["brad", 28])
+db.execute("INSERT INTO test (name, age) VALUES (?, ?)", ["sparky", 24])
+
+rows = []
+db.execute("SELECT * FROM test") do |row|
+  rows << row
+end
+
+rows.should == [
+  { id: 1, name: "brad", age: 28 },
+  { id: 2, name: "sparky", age: 24 }
+]
+```
+
+#### DB in your resources folder
+
+```ruby
+# File is stored in your /project/resources/ folder
+db = SQLite3::Database.new(File.join(App.resources_path, "my_db.sqlite"))
+
+rows = []
+db.execute("SELECT * FROM test ORDER BY id") do |row|
+	rows << row
+end
+```
+
+*this code assumes you're using BubbleWrap for access to `App.resources_path`.
+
+Usage
+----------
+* Pass a filename to the constructor, or ":memory:". The database is held open for the lifetime of the object.
+* Use `execute` to run SQL statements. All SQL statements are first prepared, and parameters can be passed as an Array or a Hash. If a Hash is passed, then the SQLite named parameter syntax is assumed to be in use.
+* Use `execute_debug` to see the SQL statement and paramaters passed in the REPL. You should not use this method in production.
+* Use `execute_scalar` to run SQL statements and return the first column of the first row. This is useful for queries like `SELECT COUNT(*) FROM posts`.
+
+Caveats
+-------
+* The way it links with libsqlite3.dylib is hacky: a blank .m file in the vendor folder. Will need to fix this.
+
+Status
+----------
+Still in early stages. I'm hacking on it.

data/Rakefile

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project/template/ios'
+
+require "bundler/gem_tasks"
+require "bundler/setup"
+Bundler.require :default
+
+Motion::Project::App.setup do |app|
+  app.name = 'motion-sqlite3'
+
+  base_dir = File.dirname(__FILE__)
+  app.files += Dir.glob(File.join(base_dir, "lib/motion-sqlite3/**/*.rb"))
+
+  if ENV["DEFAULT_PROVISIONING_PROFILE"]
+    app.provisioning_profile = ENV["DEFAULT_PROVISIONING_PROFILE"]
+  end
+
+  app.libs << "/usr/lib/libsqlite3.dylib"
+  app.vendor_project('vendor/sqlite3', :static, :products => [])
+end

data/app/app_delegate.rb

@@ -0,0 +1,5 @@
+class AppDelegate
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    true
+  end
+end

data/lib/motion-sqlite3.rb

@@ -0,0 +1,16 @@
+require 'motion-sqlite3/version'
+
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+Motion::Project::App.setup do |app|
+  Dir.glob(File.join(File.dirname(__FILE__), "motion-sqlite3/**/*.rb")).each do |file|
+    app.files.unshift(file)
+  end
+
+  app.libs << "/usr/lib/libsqlite3.dylib"
+
+  vendor_dir = File.expand_path(File.join(File.dirname(__FILE__), "../vendor/sqlite3"))
+  app.vendor_project(vendor_dir, :static, :products => [])  
+end

data/lib/motion-sqlite3/database.rb

@@ -0,0 +1,62 @@
+module SQLite3
+  class Database
+    def initialize(filename)
+      @handle = Pointer.new(::Sqlite3.type)
+
+      result = sqlite3_open(filename, @handle)
+      raise SQLite3Error, sqlite3_errmsg(@handle.value) if result != SQLITE_OK
+    end
+
+    def execute(sql, params = nil, &block)
+      raise ArgumentError if sql.nil?
+
+      #puts "*** #{sql}"
+      #puts "    #{params.inspect}" if params
+
+      prepare(sql, params) do |statement|
+        results = statement.execute
+
+        if block_given?
+          results.each do |result|
+            yield result
+          end
+        else
+          rows = []
+
+          results.each do |result|
+            rows << result
+          end
+
+          rows
+        end
+      end
+    end
+
+    def execute_debug(*args, &block)
+      puts "*** #{args[0]}"
+      puts "    #{args[1].inspect}" if args[1]
+
+      execute(*args, &block)
+    end
+
+    def execute_scalar(*args)
+      execute(*args).first.values.first
+    end
+
+    private
+
+    def prepare(sql, params, &block)
+      statement = Statement.new(@handle, sql, params)
+      result = nil
+
+      begin
+        result = yield statement
+
+      ensure
+        statement.finalize
+      end
+
+      result
+    end
+  end
+end

data/lib/motion-sqlite3/error.rb

@@ -0,0 +1,4 @@
+module SQLite3
+  class SQLite3Error < RuntimeError
+  end
+end

data/lib/motion-sqlite3/result_set.rb

@@ -0,0 +1,57 @@
+module SQLite3
+  class ResultSet
+    def initialize(statement, handle)
+      @statement = statement
+      @handle = handle
+    end
+
+    def each(&block)
+      until @statement.done?
+        yield current_row
+
+        @statement.step
+      end
+    end
+
+    private
+
+    def columns
+      @result_columns ||= begin
+        columns = {}
+
+        count = sqlite3_column_count(@handle.value)
+        0.upto(count-1) do |i|
+          name = sqlite3_column_name(@handle.value, i).to_sym
+          type = sqlite3_column_type(@handle.value, i)
+
+          columns[name] = ColumnMetadata.new(i, type)
+        end
+
+        columns
+      end
+    end
+
+    def current_row
+      row = {}
+
+      columns.each do |name, metadata|
+        case metadata.type
+        when SQLITE_NULL
+          row[name] = nil
+        when SQLITE_TEXT
+          row[name] = sqlite3_column_text(@handle.value, metadata.index)
+        when SQLITE_BLOB
+          row[name] = NSData.dataWithBytes(sqlite3_column_blob(@handle.value, metadata.index), length: sqlite3_column_bytes(@handle.value, metadata.index))
+        when SQLITE_INTEGER
+          row[name] = sqlite3_column_int(@handle.value, metadata.index)
+        when SQLITE_FLOAT
+          row[name] = sqlite3_column_double(@handle.value, metadata.index)
+        end
+      end
+
+      row
+    end
+  end
+
+  class ColumnMetadata < Struct.new(:index, :type); end
+end

data/lib/motion-sqlite3/statement.rb

@@ -0,0 +1,86 @@
+module SQLite3
+  class Statement
+    def initialize(db, sql, params)
+      @db = db
+      @handle = Pointer.new(::Sqlite3_stmt.type)
+      @result = nil
+
+      prepare(sql)
+      bind(params)
+    end
+
+    def done?
+      @result == SQLITE_DONE
+    end
+
+    def execute
+      step
+
+      ResultSet.new(self, @handle)
+    end
+
+    def finalize
+      sqlite3_finalize(@handle.value)
+    end
+
+    def step
+      @result = sqlite3_step(@handle.value)
+      unless @result == SQLITE_DONE || @result == SQLITE_ROW
+        raise SQLite3Error, sqlite3_errmsg(@db.value)
+      end
+    end
+
+    private
+
+    def bind(params)
+      case params
+      when Hash
+        params.each { |name, value| bind_parameter(name, value) }
+      when Array
+        params.each_with_index { |value, i| bind_parameter(i+1, value) }
+      end
+    end
+
+    def bind_parameter(name, value)
+      index = column_index(name)
+
+      case value
+      when NilClass
+        result = sqlite3_bind_null(@handle.value, index)
+      when String
+        result = sqlite3_bind_text(@handle.value, index, value, -1, lambda { |arg| })
+      when Integer
+        result = sqlite3_bind_int(@handle.value, index, value)
+      when Float
+        result = sqlite3_bind_double(@handle.value, index, value)
+      when NSData
+        result = sqlite3_bind_blob(@handle.value, index, value.bytes, value.length, lambda { |arg| })
+      else
+        raise SQLite3Error, "unable to bind #{value} to #{name}: unexpected type #{value.class}"
+      end
+
+      raise SQLite3Error, sqlite3_errmsg(@db.value) if result != SQLITE_OK
+    end
+
+    def column_index(name)
+      index = 0
+
+      case name
+      when String, Symbol
+        index = sqlite3_bind_parameter_index(@handle.value, ":#{name}")
+        raise SQLite3Error, "couldn't find index for #{name}!" if index == 0
+
+      when Integer
+        index = name
+      end
+
+      index
+    end
+
+    def prepare(sql)
+      remainder = Pointer.new(:string)
+      result = sqlite3_prepare_v2(@db.value, sql, -1, @handle, remainder)
+      raise SQLite3Error, sqlite3_errmsg(@db.value) if result != SQLITE_OK
+    end
+  end
+end