sqlite3-ruby 1.2.5-x86-mswin32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (44) hide show
  1. data/ChangeLog.cvs +88 -0
  2. data/History.txt +68 -0
  3. data/LICENSE +27 -0
  4. data/Manifest.txt +41 -0
  5. data/README.txt +56 -0
  6. data/Rakefile +5 -0
  7. data/ext/sqlite3_api/extconf.rb +10 -0
  8. data/ext/sqlite3_api/sqlite3_api.i +362 -0
  9. data/ext/sqlite3_api/sqlite3_api_wrap.c +5018 -0
  10. data/faq/faq.rb +145 -0
  11. data/faq/faq.yml +426 -0
  12. data/lib/1.8/sqlite3_api.so +0 -0
  13. data/lib/1.9/sqlite3_api.so +0 -0
  14. data/lib/sqlite3.rb +1 -0
  15. data/lib/sqlite3/constants.rb +49 -0
  16. data/lib/sqlite3/database.rb +721 -0
  17. data/lib/sqlite3/driver/dl/api.rb +152 -0
  18. data/lib/sqlite3/driver/dl/driver.rb +307 -0
  19. data/lib/sqlite3/driver/native/driver.rb +219 -0
  20. data/lib/sqlite3/errors.rb +68 -0
  21. data/lib/sqlite3/pragmas.rb +271 -0
  22. data/lib/sqlite3/resultset.rb +180 -0
  23. data/lib/sqlite3/statement.rb +231 -0
  24. data/lib/sqlite3/translator.rb +109 -0
  25. data/lib/sqlite3/value.rb +57 -0
  26. data/lib/sqlite3/version.rb +16 -0
  27. data/setup.rb +1333 -0
  28. data/tasks/benchmark.rake +9 -0
  29. data/tasks/faq.rake +9 -0
  30. data/tasks/gem.rake +32 -0
  31. data/tasks/native.rake +35 -0
  32. data/tasks/vendor_sqlite3.rake +104 -0
  33. data/test/bm.rb +140 -0
  34. data/test/driver/dl/tc_driver.rb +292 -0
  35. data/test/helper.rb +67 -0
  36. data/test/native-vs-dl.rb +126 -0
  37. data/test/test_database.rb +217 -0
  38. data/test/test_errors.rb +17 -0
  39. data/test/test_integration.rb +542 -0
  40. data/test/test_integration_open_close.rb +30 -0
  41. data/test/test_integration_pending.rb +111 -0
  42. data/test/test_integration_resultset.rb +159 -0
  43. data/test/test_integration_statement.rb +195 -0
  44. metadata +143 -0
@@ -0,0 +1,219 @@
1
+ # support multiple ruby version (fat binaries under windows)
2
+ begin
3
+ require 'sqlite3_api'
4
+ rescue LoadError
5
+ if RUBY_PLATFORM =~ /mingw|mswin/ then
6
+ RUBY_VERSION =~ /(\d+.\d+)/
7
+ require "#{$1}/sqlite3_api"
8
+ end
9
+ end
10
+
11
+ module SQLite3 ; module Driver ; module Native
12
+
13
+ class Driver
14
+
15
+ def initialize
16
+ @callback_data = Hash.new
17
+ @authorizer = Hash.new
18
+ @busy_handler = Hash.new
19
+ @trace = Hash.new
20
+ end
21
+
22
+ def complete?( sql, utf16=false )
23
+ API.send( utf16 ? :sqlite3_complete16 : :sqlite3_complete, sql ) != 0
24
+ end
25
+
26
+ def busy_handler( db, data=nil, &block )
27
+ if block
28
+ cb = API::CallbackData.new
29
+ cb.proc = block
30
+ cb.data = data
31
+ result = API.sqlite3_busy_handler( db, API::Sqlite3_ruby_busy_handler, cb )
32
+ # Reference the Callback object so that
33
+ # it is not deleted by the GC
34
+ @busy_handler[db] = cb
35
+ else
36
+ # Unreference the callback *after* having removed it
37
+ # from sqlite
38
+ result = API.sqlite3_busy_handler( db, nil, nil )
39
+ @busy_handler.delete(db)
40
+ end
41
+
42
+ result
43
+ end
44
+
45
+ def set_authorizer( db, data=nil, &block )
46
+ if block
47
+ cb = API::CallbackData.new
48
+ cb.proc = block
49
+ cb.data = data
50
+ result = API.sqlite3_set_authorizer( db, API::Sqlite3_ruby_authorizer, cb )
51
+ @authorizer[db] = cb # see comments in busy_handler
52
+ else
53
+ result = API.sqlite3_set_authorizer( db, nil, nil )
54
+ @authorizer.delete(db) # see comments in busy_handler
55
+ end
56
+
57
+ result
58
+ end
59
+
60
+ def trace( db, data=nil, &block )
61
+ if block
62
+ cb = API::CallbackData.new
63
+ cb.proc = block
64
+ cb.data = data
65
+ result = API.sqlite3_trace( db, API::Sqlite3_ruby_trace, cb )
66
+ @trace[db] = cb # see comments in busy_handler
67
+ else
68
+ result = API.sqlite3_trace( db, nil, nil )
69
+ @trace.delete(db) # see comments in busy_handler
70
+ end
71
+
72
+ result
73
+ end
74
+
75
+ def open( filename, utf16=false )
76
+ API.send( utf16 ? :sqlite3_open16 : :sqlite3_open, filename )
77
+ end
78
+
79
+ def errmsg( db, utf16=false )
80
+ API.send( utf16 ? :sqlite3_errmsg16 : :sqlite3_errmsg, db )
81
+ end
82
+
83
+ def prepare( db, sql, utf16=false )
84
+ API.send( ( utf16 ? :sqlite3_prepare16 : :sqlite3_prepare ),
85
+ db, sql )
86
+ end
87
+
88
+ def bind_text( stmt, index, value, utf16=false )
89
+ API.send( ( utf16 ? :sqlite3_bind_text16 : :sqlite3_bind_text ),
90
+ stmt, index, value.to_s )
91
+ end
92
+
93
+ def column_name( stmt, index, utf16=false )
94
+ API.send( ( utf16 ? :sqlite3_column_name16 : :sqlite3_column_name ),
95
+ stmt, index )
96
+ end
97
+
98
+ def column_decltype( stmt, index, utf16=false )
99
+ API.send(
100
+ ( utf16 ? :sqlite3_column_decltype16 : :sqlite3_column_decltype ),
101
+ stmt, index )
102
+ end
103
+
104
+ def column_text( stmt, index, utf16=false )
105
+ API.send( ( utf16 ? :sqlite3_column_text16 : :sqlite3_column_text ),
106
+ stmt, index )
107
+ end
108
+
109
+ def create_function( db, name, args, text, cookie, func, step, final )
110
+ if func || ( step && final )
111
+ cb = API::CallbackData.new
112
+ cb.proc = cb.proc2 = nil
113
+ cb.data = cookie
114
+ end
115
+
116
+ if func
117
+ cb.proc = func
118
+
119
+ func = API::Sqlite3_ruby_function_step
120
+ step = final = nil
121
+ elsif step && final
122
+ cb.proc = step
123
+ cb.proc2 = final
124
+
125
+ func = nil
126
+ step = API::Sqlite3_ruby_function_step
127
+ final = API::Sqlite3_ruby_function_final
128
+ end
129
+
130
+ result = API.sqlite3_create_function( db, name, args, text, cb, func, step, final )
131
+
132
+ # see comments in busy_handler
133
+ if cb
134
+ @callback_data[ name ] = cb
135
+ else
136
+ @callback_data.delete( name )
137
+ end
138
+
139
+ return result
140
+ end
141
+
142
+ def value_text( value, utf16=false )
143
+ method = case utf16
144
+ when nil, false then :sqlite3_value_text
145
+ when :le then :sqlite3_value_text16le
146
+ when :be then :sqlite3_value_text16be
147
+ else :sqlite3_value_text16
148
+ end
149
+
150
+ API.send( method, value )
151
+ end
152
+
153
+ def result_text( context, result, utf16=false )
154
+ method = case utf16
155
+ when nil, false then :sqlite3_result_text
156
+ when :le then :sqlite3_result_text16le
157
+ when :be then :sqlite3_result_text16be
158
+ else :sqlite3_result_text16
159
+ end
160
+
161
+ API.send( method, context, result.to_s )
162
+ end
163
+
164
+ def result_error( context, value, utf16=false )
165
+ API.send( ( utf16 ? :sqlite3_result_error16 : :sqlite3_result_error ),
166
+ context, value )
167
+ end
168
+
169
+ def self.api_delegate( name )
170
+ eval "def #{name} (*args) API.sqlite3_#{name}( *args ) ; end"
171
+ end
172
+
173
+ api_delegate :libversion
174
+ api_delegate :close
175
+ api_delegate :last_insert_rowid
176
+ api_delegate :changes
177
+ api_delegate :total_changes
178
+ api_delegate :interrupt
179
+ api_delegate :busy_timeout
180
+ api_delegate :errcode
181
+ api_delegate :bind_blob
182
+ api_delegate :bind_double
183
+ api_delegate :bind_int
184
+ api_delegate :bind_int64
185
+ api_delegate :bind_null
186
+ api_delegate :bind_parameter_count
187
+ api_delegate :bind_parameter_name
188
+ api_delegate :bind_parameter_index
189
+ api_delegate :column_count
190
+ api_delegate :step
191
+ api_delegate :data_count
192
+ api_delegate :column_blob
193
+ api_delegate :column_bytes
194
+ api_delegate :column_bytes16
195
+ api_delegate :column_double
196
+ api_delegate :column_int
197
+ api_delegate :column_int64
198
+ api_delegate :column_type
199
+ api_delegate :finalize
200
+ api_delegate :reset
201
+ api_delegate :aggregate_count
202
+ api_delegate :value_blob
203
+ api_delegate :value_bytes
204
+ api_delegate :value_bytes16
205
+ api_delegate :value_double
206
+ api_delegate :value_int
207
+ api_delegate :value_int64
208
+ api_delegate :value_type
209
+ api_delegate :result_blob
210
+ api_delegate :result_double
211
+ api_delegate :result_int
212
+ api_delegate :result_int64
213
+ api_delegate :result_null
214
+ api_delegate :result_value
215
+ api_delegate :aggregate_context
216
+
217
+ end
218
+
219
+ end ; end ; end
@@ -0,0 +1,68 @@
1
+ require 'sqlite3/constants'
2
+
3
+ module SQLite3
4
+
5
+ class Exception < ::StandardError
6
+ @code = 0
7
+
8
+ # The numeric error code that this exception represents.
9
+ def self.code
10
+ @code
11
+ end
12
+
13
+ # A convenience for accessing the error code for this exception.
14
+ def code
15
+ self.class.code
16
+ end
17
+ end
18
+
19
+ class SQLException < Exception; end
20
+ class InternalException < Exception; end
21
+ class PermissionException < Exception; end
22
+ class AbortException < Exception; end
23
+ class BusyException < Exception; end
24
+ class LockedException < Exception; end
25
+ class MemoryException < Exception; end
26
+ class ReadOnlyException < Exception; end
27
+ class InterruptException < Exception; end
28
+ class IOException < Exception; end
29
+ class CorruptException < Exception; end
30
+ class NotFoundException < Exception; end
31
+ class FullException < Exception; end
32
+ class CantOpenException < Exception; end
33
+ class ProtocolException < Exception; end
34
+ class EmptyException < Exception; end
35
+ class SchemaChangedException < Exception; end
36
+ class TooBigException < Exception; end
37
+ class ConstraintException < Exception; end
38
+ class MismatchException < Exception; end
39
+ class MisuseException < Exception; end
40
+ class UnsupportedException < Exception; end
41
+ class AuthorizationException < Exception; end
42
+ class FormatException < Exception; end
43
+ class RangeException < Exception; end
44
+ class NotADatabaseException < Exception; end
45
+
46
+ EXCEPTIONS = [
47
+ nil,
48
+ SQLException, InternalException, PermissionException,
49
+ AbortException, BusyException, LockedException, MemoryException,
50
+ ReadOnlyException, InterruptException, IOException, CorruptException,
51
+ NotFoundException, FullException, CantOpenException, ProtocolException,
52
+ EmptyException, SchemaChangedException, TooBigException,
53
+ ConstraintException, MismatchException, MisuseException,
54
+ UnsupportedException, AuthorizationException, FormatException,
55
+ RangeException, NotADatabaseException
56
+ ].each_with_index { |e,i| e.instance_variable_set( :@code, i ) if e }
57
+
58
+ module Error
59
+ def check( result, db=nil, msg=nil )
60
+ unless result == Constants::ErrorCode::OK
61
+ msg = ( msg ? msg + ": " : "" ) + db.errmsg if db
62
+ raise(( EXCEPTIONS[result] || SQLite3::Exception ), msg)
63
+ end
64
+ end
65
+ module_function :check
66
+ end
67
+
68
+ end
@@ -0,0 +1,271 @@
1
+ require 'sqlite3/errors'
2
+
3
+ module SQLite3
4
+
5
+ # This module is intended for inclusion solely by the Database class. It
6
+ # defines convenience methods for the various pragmas supported by SQLite3.
7
+ #
8
+ # For a detailed description of these pragmas, see the SQLite3 documentation
9
+ # at http://sqlite.org/pragma.html.
10
+ module Pragmas
11
+
12
+ # Returns +true+ or +false+ depending on the value of the named pragma.
13
+ def get_boolean_pragma( name )
14
+ get_first_value( "PRAGMA #{name}" ) != "0"
15
+ end
16
+ private :get_boolean_pragma
17
+
18
+ # Sets the given pragma to the given boolean value. The value itself
19
+ # may be +true+ or +false+, or any other commonly used string or
20
+ # integer that represents truth.
21
+ def set_boolean_pragma( name, mode )
22
+ case mode
23
+ when String
24
+ case mode.downcase
25
+ when "on", "yes", "true", "y", "t"; mode = "'ON'"
26
+ when "off", "no", "false", "n", "f"; mode = "'OFF'"
27
+ else
28
+ raise Exception,
29
+ "unrecognized pragma parameter #{mode.inspect}"
30
+ end
31
+ when true, 1
32
+ mode = "ON"
33
+ when false, 0, nil
34
+ mode = "OFF"
35
+ else
36
+ raise Exception,
37
+ "unrecognized pragma parameter #{mode.inspect}"
38
+ end
39
+
40
+ execute( "PRAGMA #{name}=#{mode}" )
41
+ end
42
+ private :set_boolean_pragma
43
+
44
+ # Requests the given pragma (and parameters), and if the block is given,
45
+ # each row of the result set will be yielded to it. Otherwise, the results
46
+ # are returned as an array.
47
+ def get_query_pragma( name, *parms, &block ) # :yields: row
48
+ if parms.empty?
49
+ execute( "PRAGMA #{name}", &block )
50
+ else
51
+ args = "'" + parms.join("','") + "'"
52
+ execute( "PRAGMA #{name}( #{args} )", &block )
53
+ end
54
+ end
55
+ private :get_query_pragma
56
+
57
+ # Return the value of the given pragma.
58
+ def get_enum_pragma( name )
59
+ get_first_value( "PRAGMA #{name}" )
60
+ end
61
+ private :get_enum_pragma
62
+
63
+ # Set the value of the given pragma to +mode+. The +mode+ parameter must
64
+ # conform to one of the values in the given +enum+ array. Each entry in
65
+ # the array is another array comprised of elements in the enumeration that
66
+ # have duplicate values. See #synchronous, #default_synchronous,
67
+ # #temp_store, and #default_temp_store for usage examples.
68
+ def set_enum_pragma( name, mode, enums )
69
+ match = enums.find { |p| p.find { |i| i.to_s.downcase == mode.to_s.downcase } }
70
+ raise Exception,
71
+ "unrecognized #{name} #{mode.inspect}" unless match
72
+ execute( "PRAGMA #{name}='#{match.first.upcase}'" )
73
+ end
74
+ private :set_enum_pragma
75
+
76
+ # Returns the value of the given pragma as an integer.
77
+ def get_int_pragma( name )
78
+ get_first_value( "PRAGMA #{name}" ).to_i
79
+ end
80
+ private :get_int_pragma
81
+
82
+ # Set the value of the given pragma to the integer value of the +value+
83
+ # parameter.
84
+ def set_int_pragma( name, value )
85
+ execute( "PRAGMA #{name}=#{value.to_i}" )
86
+ end
87
+ private :set_int_pragma
88
+
89
+ # The enumeration of valid synchronous modes.
90
+ SYNCHRONOUS_MODES = [ [ 'full', 2 ], [ 'normal', 1 ], [ 'off', 0 ] ]
91
+
92
+ # The enumeration of valid temp store modes.
93
+ TEMP_STORE_MODES = [ [ 'default', 0 ], [ 'file', 1 ], [ 'memory', 2 ] ]
94
+
95
+ # Does an integrity check on the database. If the check fails, a
96
+ # SQLite3::Exception will be raised. Otherwise it
97
+ # returns silently.
98
+ def integrity_check
99
+ execute( "PRAGMA integrity_check" ) do |row|
100
+ raise Exception, row[0] if row[0] != "ok"
101
+ end
102
+ end
103
+
104
+ def auto_vacuum
105
+ get_boolean_pragma "auto_vacuum"
106
+ end
107
+
108
+ def auto_vacuum=( mode )
109
+ set_boolean_pragma "auto_vacuum", mode
110
+ end
111
+
112
+ def schema_cookie
113
+ get_int_pragma "schema_cookie"
114
+ end
115
+
116
+ def schema_cookie=( cookie )
117
+ set_int_pragma "schema_cookie", cookie
118
+ end
119
+
120
+ def user_cookie
121
+ get_int_pragma "user_cookie"
122
+ end
123
+
124
+ def user_cookie=( cookie )
125
+ set_int_pragma "user_cookie", cookie
126
+ end
127
+
128
+ def cache_size
129
+ get_int_pragma "cache_size"
130
+ end
131
+
132
+ def cache_size=( size )
133
+ set_int_pragma "cache_size", size
134
+ end
135
+
136
+ def default_cache_size
137
+ get_int_pragma "default_cache_size"
138
+ end
139
+
140
+ def default_cache_size=( size )
141
+ set_int_pragma "default_cache_size", size
142
+ end
143
+
144
+ def default_synchronous
145
+ get_enum_pragma "default_synchronous"
146
+ end
147
+
148
+ def default_synchronous=( mode )
149
+ set_enum_pragma "default_synchronous", mode, SYNCHRONOUS_MODES
150
+ end
151
+
152
+ def synchronous
153
+ get_enum_pragma "synchronous"
154
+ end
155
+
156
+ def synchronous=( mode )
157
+ set_enum_pragma "synchronous", mode, SYNCHRONOUS_MODES
158
+ end
159
+
160
+ def default_temp_store
161
+ get_enum_pragma "default_temp_store"
162
+ end
163
+
164
+ def default_temp_store=( mode )
165
+ set_enum_pragma "default_temp_store", mode, TEMP_STORE_MODES
166
+ end
167
+
168
+ def temp_store
169
+ get_enum_pragma "temp_store"
170
+ end
171
+
172
+ def temp_store=( mode )
173
+ set_enum_pragma "temp_store", mode, TEMP_STORE_MODES
174
+ end
175
+
176
+ def full_column_names
177
+ get_boolean_pragma "full_column_names"
178
+ end
179
+
180
+ def full_column_names=( mode )
181
+ set_boolean_pragma "full_column_names", mode
182
+ end
183
+
184
+ def parser_trace
185
+ get_boolean_pragma "parser_trace"
186
+ end
187
+
188
+ def parser_trace=( mode )
189
+ set_boolean_pragma "parser_trace", mode
190
+ end
191
+
192
+ def vdbe_trace
193
+ get_boolean_pragma "vdbe_trace"
194
+ end
195
+
196
+ def vdbe_trace=( mode )
197
+ set_boolean_pragma "vdbe_trace", mode
198
+ end
199
+
200
+ def database_list( &block ) # :yields: row
201
+ get_query_pragma "database_list", &block
202
+ end
203
+
204
+ def foreign_key_list( table, &block ) # :yields: row
205
+ get_query_pragma "foreign_key_list", table, &block
206
+ end
207
+
208
+ def index_info( index, &block ) # :yields: row
209
+ get_query_pragma "index_info", index, &block
210
+ end
211
+
212
+ def index_list( table, &block ) # :yields: row
213
+ get_query_pragma "index_list", table, &block
214
+ end
215
+
216
+ def table_info( table, &block ) # :yields: row
217
+ columns, *rows = execute2("PRAGMA table_info(#{table})")
218
+
219
+ needs_tweak_default = version_compare(driver.libversion, "3.3.7") > 0
220
+
221
+ result = [] unless block_given?
222
+ rows.each do |row|
223
+ new_row = {}
224
+ columns.each_with_index do |name, index|
225
+ new_row[name] = row[index]
226
+ end
227
+
228
+ tweak_default(new_row) if needs_tweak_default
229
+
230
+ if block_given?
231
+ yield new_row
232
+ else
233
+ result << new_row
234
+ end
235
+ end
236
+
237
+ result
238
+ end
239
+
240
+ private
241
+
242
+ # Compares two version strings
243
+ def version_compare(v1, v2)
244
+ v1 = v1.split(".").map { |i| i.to_i }
245
+ v2 = v2.split(".").map { |i| i.to_i }
246
+ parts = [v1.length, v2.length].max
247
+ v1.push 0 while v1.length < parts
248
+ v2.push 0 while v2.length < parts
249
+ v1.zip(v2).each do |a,b|
250
+ return -1 if a < b
251
+ return 1 if a > b
252
+ end
253
+ return 0
254
+ end
255
+
256
+ # Since SQLite 3.3.8, the table_info pragma has returned the default
257
+ # value of the row as a quoted SQL value. This method essentially
258
+ # unquotes those values.
259
+ def tweak_default(hash)
260
+ case hash["dflt_value"]
261
+ when /^null$/i
262
+ hash["dflt_value"] = nil
263
+ when /^'(.*)'$/
264
+ hash["dflt_value"] = $1.gsub(/''/, "'")
265
+ when /^"(.*)"$/
266
+ hash["dflt_value"] = $1.gsub(/""/, '"')
267
+ end
268
+ end
269
+ end
270
+
271
+ end