sqlite3 1.5.0.rc1-x64-mingw-ucrt
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.gemtest +0 -0
- data/API_CHANGES.md +49 -0
- data/CHANGELOG.md +419 -0
- data/CONTRIBUTING.md +24 -0
- data/ChangeLog.cvs +88 -0
- data/Gemfile +3 -0
- data/LICENSE +27 -0
- data/LICENSE-DEPENDENCIES +20 -0
- data/README.md +233 -0
- data/ext/sqlite3/aggregator.c +273 -0
- data/ext/sqlite3/aggregator.h +12 -0
- data/ext/sqlite3/backup.c +168 -0
- data/ext/sqlite3/backup.h +15 -0
- data/ext/sqlite3/database.c +853 -0
- data/ext/sqlite3/database.h +17 -0
- data/ext/sqlite3/exception.c +98 -0
- data/ext/sqlite3/exception.h +8 -0
- data/ext/sqlite3/extconf.rb +159 -0
- data/ext/sqlite3/sqlite3.c +163 -0
- data/ext/sqlite3/sqlite3_ruby.h +45 -0
- data/ext/sqlite3/statement.c +442 -0
- data/ext/sqlite3/statement.h +16 -0
- data/faq/faq.md +431 -0
- data/faq/faq.rb +145 -0
- data/faq/faq.yml +426 -0
- data/lib/sqlite3/3.1/sqlite3_native.so +0 -0
- data/lib/sqlite3/constants.rb +50 -0
- data/lib/sqlite3/database.rb +741 -0
- data/lib/sqlite3/errors.rb +35 -0
- data/lib/sqlite3/pragmas.rb +595 -0
- data/lib/sqlite3/resultset.rb +187 -0
- data/lib/sqlite3/statement.rb +145 -0
- data/lib/sqlite3/translator.rb +118 -0
- data/lib/sqlite3/value.rb +57 -0
- data/lib/sqlite3/version.rb +25 -0
- data/lib/sqlite3.rb +15 -0
- data/test/helper.rb +27 -0
- data/test/test_backup.rb +33 -0
- data/test/test_collation.rb +82 -0
- data/test/test_database.rb +538 -0
- data/test/test_database_flags.rb +95 -0
- data/test/test_database_readonly.rb +36 -0
- data/test/test_database_readwrite.rb +41 -0
- data/test/test_deprecated.rb +44 -0
- data/test/test_encoding.rb +155 -0
- data/test/test_integration.rb +507 -0
- data/test/test_integration_aggregate.rb +336 -0
- data/test/test_integration_open_close.rb +30 -0
- data/test/test_integration_pending.rb +115 -0
- data/test/test_integration_resultset.rb +142 -0
- data/test/test_integration_statement.rb +194 -0
- data/test/test_result_set.rb +37 -0
- data/test/test_sqlite3.rb +25 -0
- data/test/test_statement.rb +263 -0
- data/test/test_statement_execute.rb +35 -0
- metadata +187 -0
@@ -0,0 +1,187 @@
|
|
1
|
+
require 'sqlite3/constants'
|
2
|
+
require 'sqlite3/errors'
|
3
|
+
|
4
|
+
module SQLite3
|
5
|
+
|
6
|
+
# The ResultSet object encapsulates the enumerability of a query's output.
|
7
|
+
# It is a simple cursor over the data that the query returns. It will
|
8
|
+
# very rarely (if ever) be instantiated directly. Instead, clients should
|
9
|
+
# obtain a ResultSet instance via Statement#execute.
|
10
|
+
class ResultSet
|
11
|
+
include Enumerable
|
12
|
+
|
13
|
+
class ArrayWithTypes < Array # :nodoc:
|
14
|
+
attr_accessor :types
|
15
|
+
end
|
16
|
+
|
17
|
+
class ArrayWithTypesAndFields < Array # :nodoc:
|
18
|
+
attr_writer :types
|
19
|
+
attr_writer :fields
|
20
|
+
|
21
|
+
def types
|
22
|
+
warn(<<-eowarn) if $VERBOSE
|
23
|
+
#{caller[0]} is calling #{self.class}#types. This method will be removed in
|
24
|
+
sqlite3 version 2.0.0, please call the `types` method on the SQLite3::ResultSet
|
25
|
+
object that created this object
|
26
|
+
eowarn
|
27
|
+
@types
|
28
|
+
end
|
29
|
+
|
30
|
+
def fields
|
31
|
+
warn(<<-eowarn) if $VERBOSE
|
32
|
+
#{caller[0]} is calling #{self.class}#fields. This method will be removed in
|
33
|
+
sqlite3 version 2.0.0, please call the `columns` method on the SQLite3::ResultSet
|
34
|
+
object that created this object
|
35
|
+
eowarn
|
36
|
+
@fields
|
37
|
+
end
|
38
|
+
end
|
39
|
+
|
40
|
+
# The class of which we return an object in case we want a Hash as
|
41
|
+
# result.
|
42
|
+
class HashWithTypesAndFields < Hash # :nodoc:
|
43
|
+
attr_writer :types
|
44
|
+
attr_writer :fields
|
45
|
+
|
46
|
+
def types
|
47
|
+
warn(<<-eowarn) if $VERBOSE
|
48
|
+
#{caller[0]} is calling #{self.class}#types. This method will be removed in
|
49
|
+
sqlite3 version 2.0.0, please call the `types` method on the SQLite3::ResultSet
|
50
|
+
object that created this object
|
51
|
+
eowarn
|
52
|
+
@types
|
53
|
+
end
|
54
|
+
|
55
|
+
def fields
|
56
|
+
warn(<<-eowarn) if $VERBOSE
|
57
|
+
#{caller[0]} is calling #{self.class}#fields. This method will be removed in
|
58
|
+
sqlite3 version 2.0.0, please call the `columns` method on the SQLite3::ResultSet
|
59
|
+
object that created this object
|
60
|
+
eowarn
|
61
|
+
@fields
|
62
|
+
end
|
63
|
+
|
64
|
+
def [] key
|
65
|
+
key = fields[key] if key.is_a? Numeric
|
66
|
+
super key
|
67
|
+
end
|
68
|
+
end
|
69
|
+
|
70
|
+
# Create a new ResultSet attached to the given database, using the
|
71
|
+
# given sql text.
|
72
|
+
def initialize db, stmt
|
73
|
+
@db = db
|
74
|
+
@stmt = stmt
|
75
|
+
end
|
76
|
+
|
77
|
+
# Reset the cursor, so that a result set which has reached end-of-file
|
78
|
+
# can be rewound and reiterated.
|
79
|
+
def reset( *bind_params )
|
80
|
+
@stmt.reset!
|
81
|
+
@stmt.bind_params( *bind_params )
|
82
|
+
@eof = false
|
83
|
+
end
|
84
|
+
|
85
|
+
# Query whether the cursor has reached the end of the result set or not.
|
86
|
+
def eof?
|
87
|
+
@stmt.done?
|
88
|
+
end
|
89
|
+
|
90
|
+
# Obtain the next row from the cursor. If there are no more rows to be
|
91
|
+
# had, this will return +nil+. If type translation is active on the
|
92
|
+
# corresponding database, the values in the row will be translated
|
93
|
+
# according to their types.
|
94
|
+
#
|
95
|
+
# The returned value will be an array, unless Database#results_as_hash has
|
96
|
+
# been set to +true+, in which case the returned value will be a hash.
|
97
|
+
#
|
98
|
+
# For arrays, the column names are accessible via the +fields+ property,
|
99
|
+
# and the column types are accessible via the +types+ property.
|
100
|
+
#
|
101
|
+
# For hashes, the column names are the keys of the hash, and the column
|
102
|
+
# types are accessible via the +types+ property.
|
103
|
+
def next
|
104
|
+
if @db.results_as_hash
|
105
|
+
return next_hash
|
106
|
+
end
|
107
|
+
|
108
|
+
row = @stmt.step
|
109
|
+
return nil if @stmt.done?
|
110
|
+
|
111
|
+
row = @db.translate_from_db @stmt.types, row
|
112
|
+
|
113
|
+
if row.respond_to?(:fields)
|
114
|
+
# FIXME: this can only happen if the translator returns something
|
115
|
+
# that responds to `fields`. Since we're removing the translator
|
116
|
+
# in 2.0, we can remove this branch in 2.0.
|
117
|
+
row = ArrayWithTypes.new(row)
|
118
|
+
else
|
119
|
+
# FIXME: the `fields` and `types` methods are deprecated on this
|
120
|
+
# object for version 2.0, so we can safely remove this branch
|
121
|
+
# as well.
|
122
|
+
row = ArrayWithTypesAndFields.new(row)
|
123
|
+
end
|
124
|
+
|
125
|
+
row.fields = @stmt.columns
|
126
|
+
row.types = @stmt.types
|
127
|
+
row
|
128
|
+
end
|
129
|
+
|
130
|
+
# Required by the Enumerable mixin. Provides an internal iterator over the
|
131
|
+
# rows of the result set.
|
132
|
+
def each
|
133
|
+
while node = self.next
|
134
|
+
yield node
|
135
|
+
end
|
136
|
+
end
|
137
|
+
|
138
|
+
# Provides an internal iterator over the rows of the result set where
|
139
|
+
# each row is yielded as a hash.
|
140
|
+
def each_hash
|
141
|
+
while node = next_hash
|
142
|
+
yield node
|
143
|
+
end
|
144
|
+
end
|
145
|
+
|
146
|
+
# Closes the statement that spawned this result set.
|
147
|
+
# <em>Use with caution!</em> Closing a result set will automatically
|
148
|
+
# close any other result sets that were spawned from the same statement.
|
149
|
+
def close
|
150
|
+
@stmt.close
|
151
|
+
end
|
152
|
+
|
153
|
+
# Queries whether the underlying statement has been closed or not.
|
154
|
+
def closed?
|
155
|
+
@stmt.closed?
|
156
|
+
end
|
157
|
+
|
158
|
+
# Returns the types of the columns returned by this result set.
|
159
|
+
def types
|
160
|
+
@stmt.types
|
161
|
+
end
|
162
|
+
|
163
|
+
# Returns the names of the columns returned by this result set.
|
164
|
+
def columns
|
165
|
+
@stmt.columns
|
166
|
+
end
|
167
|
+
|
168
|
+
# Return the next row as a hash
|
169
|
+
def next_hash
|
170
|
+
row = @stmt.step
|
171
|
+
return nil if @stmt.done?
|
172
|
+
|
173
|
+
# FIXME: type translation is deprecated, so this can be removed
|
174
|
+
# in 2.0
|
175
|
+
row = @db.translate_from_db @stmt.types, row
|
176
|
+
|
177
|
+
# FIXME: this can be switched to a regular hash in 2.0
|
178
|
+
row = HashWithTypesAndFields[*@stmt.columns.zip(row).flatten]
|
179
|
+
|
180
|
+
# FIXME: these methods are deprecated for version 2.0, so we can remove
|
181
|
+
# this code in 2.0
|
182
|
+
row.fields = @stmt.columns
|
183
|
+
row.types = @stmt.types
|
184
|
+
row
|
185
|
+
end
|
186
|
+
end
|
187
|
+
end
|
@@ -0,0 +1,145 @@
|
|
1
|
+
require 'sqlite3/errors'
|
2
|
+
require 'sqlite3/resultset'
|
3
|
+
|
4
|
+
class String
|
5
|
+
def to_blob
|
6
|
+
SQLite3::Blob.new( self )
|
7
|
+
end
|
8
|
+
end
|
9
|
+
|
10
|
+
module SQLite3
|
11
|
+
# A statement represents a prepared-but-unexecuted SQL query. It will rarely
|
12
|
+
# (if ever) be instantiated directly by a client, and is most often obtained
|
13
|
+
# via the Database#prepare method.
|
14
|
+
class Statement
|
15
|
+
include Enumerable
|
16
|
+
|
17
|
+
# This is any text that followed the first valid SQL statement in the text
|
18
|
+
# with which the statement was initialized. If there was no trailing text,
|
19
|
+
# this will be the empty string.
|
20
|
+
attr_reader :remainder
|
21
|
+
|
22
|
+
# Binds the given variables to the corresponding placeholders in the SQL
|
23
|
+
# text.
|
24
|
+
#
|
25
|
+
# See Database#execute for a description of the valid placeholder
|
26
|
+
# syntaxes.
|
27
|
+
#
|
28
|
+
# Example:
|
29
|
+
#
|
30
|
+
# stmt = db.prepare( "select * from table where a=? and b=?" )
|
31
|
+
# stmt.bind_params( 15, "hello" )
|
32
|
+
#
|
33
|
+
# See also #execute, #bind_param, Statement#bind_param, and
|
34
|
+
# Statement#bind_params.
|
35
|
+
def bind_params( *bind_vars )
|
36
|
+
index = 1
|
37
|
+
bind_vars.flatten.each do |var|
|
38
|
+
if Hash === var
|
39
|
+
var.each { |key, val| bind_param key, val }
|
40
|
+
else
|
41
|
+
bind_param index, var
|
42
|
+
index += 1
|
43
|
+
end
|
44
|
+
end
|
45
|
+
end
|
46
|
+
|
47
|
+
# Execute the statement. This creates a new ResultSet object for the
|
48
|
+
# statement's virtual machine. If a block was given, the new ResultSet will
|
49
|
+
# be yielded to it; otherwise, the ResultSet will be returned.
|
50
|
+
#
|
51
|
+
# Any parameters will be bound to the statement using #bind_params.
|
52
|
+
#
|
53
|
+
# Example:
|
54
|
+
#
|
55
|
+
# stmt = db.prepare( "select * from table" )
|
56
|
+
# stmt.execute do |result|
|
57
|
+
# ...
|
58
|
+
# end
|
59
|
+
#
|
60
|
+
# See also #bind_params, #execute!.
|
61
|
+
def execute( *bind_vars )
|
62
|
+
reset! if active? || done?
|
63
|
+
|
64
|
+
bind_params(*bind_vars) unless bind_vars.empty?
|
65
|
+
@results = ResultSet.new(@connection, self)
|
66
|
+
|
67
|
+
step if 0 == column_count
|
68
|
+
|
69
|
+
yield @results if block_given?
|
70
|
+
@results
|
71
|
+
end
|
72
|
+
|
73
|
+
# Execute the statement. If no block was given, this returns an array of
|
74
|
+
# rows returned by executing the statement. Otherwise, each row will be
|
75
|
+
# yielded to the block.
|
76
|
+
#
|
77
|
+
# Any parameters will be bound to the statement using #bind_params.
|
78
|
+
#
|
79
|
+
# Example:
|
80
|
+
#
|
81
|
+
# stmt = db.prepare( "select * from table" )
|
82
|
+
# stmt.execute! do |row|
|
83
|
+
# ...
|
84
|
+
# end
|
85
|
+
#
|
86
|
+
# See also #bind_params, #execute.
|
87
|
+
def execute!( *bind_vars, &block )
|
88
|
+
execute(*bind_vars)
|
89
|
+
block_given? ? each(&block) : to_a
|
90
|
+
end
|
91
|
+
|
92
|
+
# Returns true if the statement is currently active, meaning it has an
|
93
|
+
# open result set.
|
94
|
+
def active?
|
95
|
+
!done?
|
96
|
+
end
|
97
|
+
|
98
|
+
# Return an array of the column names for this statement. Note that this
|
99
|
+
# may execute the statement in order to obtain the metadata; this makes it
|
100
|
+
# a (potentially) expensive operation.
|
101
|
+
def columns
|
102
|
+
get_metadata unless @columns
|
103
|
+
return @columns
|
104
|
+
end
|
105
|
+
|
106
|
+
def each
|
107
|
+
loop do
|
108
|
+
val = step
|
109
|
+
break self if done?
|
110
|
+
yield val
|
111
|
+
end
|
112
|
+
end
|
113
|
+
|
114
|
+
# Return an array of the data types for each column in this statement. Note
|
115
|
+
# that this may execute the statement in order to obtain the metadata; this
|
116
|
+
# makes it a (potentially) expensive operation.
|
117
|
+
def types
|
118
|
+
must_be_open!
|
119
|
+
get_metadata unless @types
|
120
|
+
@types
|
121
|
+
end
|
122
|
+
|
123
|
+
# Performs a sanity check to ensure that the statement is not
|
124
|
+
# closed. If it is, an exception is raised.
|
125
|
+
def must_be_open! # :nodoc:
|
126
|
+
if closed?
|
127
|
+
raise SQLite3::Exception, "cannot use a closed statement"
|
128
|
+
end
|
129
|
+
end
|
130
|
+
|
131
|
+
private
|
132
|
+
# A convenience method for obtaining the metadata about the query. Note
|
133
|
+
# that this will actually execute the SQL, which means it can be a
|
134
|
+
# (potentially) expensive operation.
|
135
|
+
def get_metadata
|
136
|
+
@columns = Array.new(column_count) do |column|
|
137
|
+
column_name column
|
138
|
+
end
|
139
|
+
@types = Array.new(column_count) do |column|
|
140
|
+
val = column_decltype(column)
|
141
|
+
val.nil? ? nil : val.downcase
|
142
|
+
end
|
143
|
+
end
|
144
|
+
end
|
145
|
+
end
|
@@ -0,0 +1,118 @@
|
|
1
|
+
require 'time'
|
2
|
+
require 'date'
|
3
|
+
|
4
|
+
module SQLite3
|
5
|
+
|
6
|
+
# The Translator class encapsulates the logic and callbacks necessary for
|
7
|
+
# converting string data to a value of some specified type. Every Database
|
8
|
+
# instance may have a Translator instance, in order to assist in type
|
9
|
+
# translation (Database#type_translation).
|
10
|
+
#
|
11
|
+
# Further, applications may define their own custom type translation logic
|
12
|
+
# by registering translator blocks with the corresponding database's
|
13
|
+
# translator instance (Database#translator).
|
14
|
+
class Translator
|
15
|
+
|
16
|
+
# Create a new Translator instance. It will be preinitialized with default
|
17
|
+
# translators for most SQL data types.
|
18
|
+
def initialize
|
19
|
+
@translators = Hash.new( proc { |type,value| value } )
|
20
|
+
@type_name_cache = {}
|
21
|
+
register_default_translators
|
22
|
+
end
|
23
|
+
|
24
|
+
# Add a new translator block, which will be invoked to process type
|
25
|
+
# translations to the given type. The type should be an SQL datatype, and
|
26
|
+
# may include parentheses (i.e., "VARCHAR(30)"). However, any parenthetical
|
27
|
+
# information is stripped off and discarded, so type translation decisions
|
28
|
+
# are made solely on the "base" type name.
|
29
|
+
#
|
30
|
+
# The translator block itself should accept two parameters, "type" and
|
31
|
+
# "value". In this case, the "type" is the full type name (including
|
32
|
+
# parentheses), so the block itself may include logic for changing how a
|
33
|
+
# type is translated based on the additional data. The "value" parameter
|
34
|
+
# is the (string) data to convert.
|
35
|
+
#
|
36
|
+
# The block should return the translated value.
|
37
|
+
def add_translator( type, &block ) # :yields: type, value
|
38
|
+
warn(<<-eowarn) if $VERBOSE
|
39
|
+
#{caller[0]} is calling `add_translator`.
|
40
|
+
Built in translators are deprecated and will be removed in version 2.0.0
|
41
|
+
eowarn
|
42
|
+
@translators[ type_name( type ) ] = block
|
43
|
+
end
|
44
|
+
|
45
|
+
# Translate the given string value to a value of the given type. In the
|
46
|
+
# absence of an installed translator block for the given type, the value
|
47
|
+
# itself is always returned. Further, +nil+ values are never translated,
|
48
|
+
# and are always passed straight through regardless of the type parameter.
|
49
|
+
def translate( type, value )
|
50
|
+
unless value.nil?
|
51
|
+
# FIXME: this is a hack to support Sequel
|
52
|
+
if type && %w{ datetime timestamp }.include?(type.downcase)
|
53
|
+
@translators[ type_name( type ) ].call( type, value.to_s )
|
54
|
+
else
|
55
|
+
@translators[ type_name( type ) ].call( type, value )
|
56
|
+
end
|
57
|
+
end
|
58
|
+
end
|
59
|
+
|
60
|
+
# A convenience method for working with type names. This returns the "base"
|
61
|
+
# type name, without any parenthetical data.
|
62
|
+
def type_name( type )
|
63
|
+
@type_name_cache[type] ||= begin
|
64
|
+
type = "" if type.nil?
|
65
|
+
type = $1 if type =~ /^(.*?)\(/
|
66
|
+
type.upcase
|
67
|
+
end
|
68
|
+
end
|
69
|
+
private :type_name
|
70
|
+
|
71
|
+
# Register the default translators for the current Translator instance.
|
72
|
+
# This includes translators for most major SQL data types.
|
73
|
+
def register_default_translators
|
74
|
+
[ "time",
|
75
|
+
"timestamp" ].each { |type| add_translator( type ) { |t, v| Time.parse( v ) } }
|
76
|
+
|
77
|
+
add_translator( "date" ) { |t,v| Date.parse(v) }
|
78
|
+
add_translator( "datetime" ) { |t,v| DateTime.parse(v) }
|
79
|
+
|
80
|
+
[ "decimal",
|
81
|
+
"float",
|
82
|
+
"numeric",
|
83
|
+
"double",
|
84
|
+
"real",
|
85
|
+
"dec",
|
86
|
+
"fixed" ].each { |type| add_translator( type ) { |t,v| v.to_f } }
|
87
|
+
|
88
|
+
[ "integer",
|
89
|
+
"smallint",
|
90
|
+
"mediumint",
|
91
|
+
"int",
|
92
|
+
"bigint" ].each { |type| add_translator( type ) { |t,v| v.to_i } }
|
93
|
+
|
94
|
+
[ "bit",
|
95
|
+
"bool",
|
96
|
+
"boolean" ].each do |type|
|
97
|
+
add_translator( type ) do |t,v|
|
98
|
+
!( v.strip.gsub(/00+/,"0") == "0" ||
|
99
|
+
v.downcase == "false" ||
|
100
|
+
v.downcase == "f" ||
|
101
|
+
v.downcase == "no" ||
|
102
|
+
v.downcase == "n" )
|
103
|
+
end
|
104
|
+
end
|
105
|
+
|
106
|
+
add_translator( "tinyint" ) do |type, value|
|
107
|
+
if type =~ /\(\s*1\s*\)/
|
108
|
+
value.to_i == 1
|
109
|
+
else
|
110
|
+
value.to_i
|
111
|
+
end
|
112
|
+
end
|
113
|
+
end
|
114
|
+
private :register_default_translators
|
115
|
+
|
116
|
+
end
|
117
|
+
|
118
|
+
end
|
@@ -0,0 +1,57 @@
|
|
1
|
+
require 'sqlite3/constants'
|
2
|
+
|
3
|
+
module SQLite3
|
4
|
+
|
5
|
+
class Value
|
6
|
+
attr_reader :handle
|
7
|
+
|
8
|
+
def initialize( db, handle )
|
9
|
+
@driver = db.driver
|
10
|
+
@handle = handle
|
11
|
+
end
|
12
|
+
|
13
|
+
def null?
|
14
|
+
type == :null
|
15
|
+
end
|
16
|
+
|
17
|
+
def to_blob
|
18
|
+
@driver.value_blob( @handle )
|
19
|
+
end
|
20
|
+
|
21
|
+
def length( utf16=false )
|
22
|
+
if utf16
|
23
|
+
@driver.value_bytes16( @handle )
|
24
|
+
else
|
25
|
+
@driver.value_bytes( @handle )
|
26
|
+
end
|
27
|
+
end
|
28
|
+
|
29
|
+
def to_f
|
30
|
+
@driver.value_double( @handle )
|
31
|
+
end
|
32
|
+
|
33
|
+
def to_i
|
34
|
+
@driver.value_int( @handle )
|
35
|
+
end
|
36
|
+
|
37
|
+
def to_int64
|
38
|
+
@driver.value_int64( @handle )
|
39
|
+
end
|
40
|
+
|
41
|
+
def to_s( utf16=false )
|
42
|
+
@driver.value_text( @handle, utf16 )
|
43
|
+
end
|
44
|
+
|
45
|
+
def type
|
46
|
+
case @driver.value_type( @handle )
|
47
|
+
when Constants::ColumnType::INTEGER then :int
|
48
|
+
when Constants::ColumnType::FLOAT then :float
|
49
|
+
when Constants::ColumnType::TEXT then :text
|
50
|
+
when Constants::ColumnType::BLOB then :blob
|
51
|
+
when Constants::ColumnType::NULL then :null
|
52
|
+
end
|
53
|
+
end
|
54
|
+
|
55
|
+
end
|
56
|
+
|
57
|
+
end
|
@@ -0,0 +1,25 @@
|
|
1
|
+
module SQLite3
|
2
|
+
|
3
|
+
VERSION = "1.5.0.rc1"
|
4
|
+
|
5
|
+
module VersionProxy
|
6
|
+
|
7
|
+
MAJOR = 1
|
8
|
+
MINOR = 5
|
9
|
+
TINY = 0
|
10
|
+
BUILD = "rc1"
|
11
|
+
|
12
|
+
STRING = [ MAJOR, MINOR, TINY, BUILD ].compact.join( "." )
|
13
|
+
#:beta-tag:
|
14
|
+
|
15
|
+
VERSION = ::SQLite3::VERSION
|
16
|
+
end
|
17
|
+
|
18
|
+
def self.const_missing(name)
|
19
|
+
return super unless name == :Version
|
20
|
+
warn(<<-eowarn) if $VERBOSE
|
21
|
+
#{caller[0]}: SQLite::Version will be removed in sqlite3-ruby version 2.0.0
|
22
|
+
eowarn
|
23
|
+
VersionProxy
|
24
|
+
end
|
25
|
+
end
|
data/lib/sqlite3.rb
ADDED
@@ -0,0 +1,15 @@
|
|
1
|
+
# support multiple ruby version (fat binaries under windows)
|
2
|
+
begin
|
3
|
+
RUBY_VERSION =~ /(\d+\.\d+)/
|
4
|
+
require "sqlite3/#{$1}/sqlite3_native"
|
5
|
+
rescue LoadError
|
6
|
+
require 'sqlite3/sqlite3_native'
|
7
|
+
end
|
8
|
+
|
9
|
+
require 'sqlite3/database'
|
10
|
+
require 'sqlite3/version'
|
11
|
+
|
12
|
+
module SQLite3
|
13
|
+
# Was sqlite3 compiled with thread safety on?
|
14
|
+
def self.threadsafe?; threadsafe > 0; end
|
15
|
+
end
|
data/test/helper.rb
ADDED
@@ -0,0 +1,27 @@
|
|
1
|
+
require 'sqlite3'
|
2
|
+
require 'minitest/autorun'
|
3
|
+
|
4
|
+
if ENV['GITHUB_ACTIONS'] == 'true' || ENV['CI']
|
5
|
+
$VERBOSE = nil
|
6
|
+
end
|
7
|
+
|
8
|
+
puts "info: sqlite3-ruby version: #{SQLite3::VERSION}/#{SQLite3::VersionProxy::STRING}"
|
9
|
+
puts "info: sqlite3 version: #{SQLite3::SQLITE_VERSION}/#{SQLite3::SQLITE_LOADED_VERSION}"
|
10
|
+
puts "info: sqlcipher?: #{SQLite3.sqlcipher?}"
|
11
|
+
puts "info: threadsafe?: #{SQLite3.threadsafe?}"
|
12
|
+
|
13
|
+
unless RUBY_VERSION >= "1.9"
|
14
|
+
require 'iconv'
|
15
|
+
end
|
16
|
+
|
17
|
+
module SQLite3
|
18
|
+
class TestCase < Minitest::Test
|
19
|
+
alias :assert_not_equal :refute_equal
|
20
|
+
alias :assert_not_nil :refute_nil
|
21
|
+
alias :assert_raise :assert_raises
|
22
|
+
|
23
|
+
def assert_nothing_raised
|
24
|
+
yield
|
25
|
+
end
|
26
|
+
end
|
27
|
+
end
|
data/test/test_backup.rb
ADDED
@@ -0,0 +1,33 @@
|
|
1
|
+
require 'helper'
|
2
|
+
|
3
|
+
module SQLite3
|
4
|
+
class TestBackup < SQLite3::TestCase
|
5
|
+
def setup
|
6
|
+
@sdb = SQLite3::Database.new(':memory:')
|
7
|
+
@ddb = SQLite3::Database.new(':memory:')
|
8
|
+
@sdb.execute('CREATE TABLE foo (idx, val);');
|
9
|
+
@data = ('A'..'Z').map{|x|x * 40}
|
10
|
+
@data.each_with_index do |v, i|
|
11
|
+
@sdb.execute('INSERT INTO foo (idx, val) VALUES (?, ?);', [i, v])
|
12
|
+
end
|
13
|
+
end
|
14
|
+
|
15
|
+
def test_backup_step
|
16
|
+
b = SQLite3::Backup.new(@ddb, 'main', @sdb, 'main')
|
17
|
+
while b.step(1) == SQLite3::Constants::ErrorCode::OK
|
18
|
+
assert_not_equal(0, b.remaining)
|
19
|
+
end
|
20
|
+
assert_equal(0, b.remaining)
|
21
|
+
b.finish
|
22
|
+
assert_equal(@data.length, @ddb.execute('SELECT * FROM foo;').length)
|
23
|
+
end
|
24
|
+
|
25
|
+
def test_backup_all
|
26
|
+
b = SQLite3::Backup.new(@ddb, 'main', @sdb, 'main')
|
27
|
+
assert_equal(SQLite3::Constants::ErrorCode::DONE, b.step(-1))
|
28
|
+
assert_equal(0, b.remaining)
|
29
|
+
b.finish
|
30
|
+
assert_equal(@data.length, @ddb.execute('SELECT * FROM foo;').length)
|
31
|
+
end
|
32
|
+
end if defined?(SQLite3::Backup)
|
33
|
+
end
|
@@ -0,0 +1,82 @@
|
|
1
|
+
# -*- coding: utf-8 -*-
|
2
|
+
|
3
|
+
require 'helper'
|
4
|
+
|
5
|
+
module SQLite3
|
6
|
+
class TestCollation < SQLite3::TestCase
|
7
|
+
class Comparator
|
8
|
+
attr_reader :calls
|
9
|
+
def initialize
|
10
|
+
@calls = []
|
11
|
+
end
|
12
|
+
|
13
|
+
def compare left, right
|
14
|
+
@calls << [left, right]
|
15
|
+
left <=> right
|
16
|
+
end
|
17
|
+
end
|
18
|
+
|
19
|
+
def setup
|
20
|
+
@db = SQLite3::Database.new(':memory:')
|
21
|
+
@create = "create table ex(id int, data string)"
|
22
|
+
@db.execute(@create);
|
23
|
+
[ [1, 'hello'], [2, 'world'] ].each do |vals|
|
24
|
+
@db.execute('insert into ex (id, data) VALUES (?, ?)', vals)
|
25
|
+
end
|
26
|
+
end
|
27
|
+
|
28
|
+
def test_custom_collation
|
29
|
+
comparator = Comparator.new
|
30
|
+
|
31
|
+
@db.collation 'foo', comparator
|
32
|
+
|
33
|
+
assert_equal comparator, @db.collations['foo']
|
34
|
+
@db.execute('select data from ex order by 1 collate foo')
|
35
|
+
assert_equal 1, comparator.calls.length
|
36
|
+
end
|
37
|
+
|
38
|
+
def test_remove_collation
|
39
|
+
comparator = Comparator.new
|
40
|
+
|
41
|
+
@db.collation 'foo', comparator
|
42
|
+
@db.collation 'foo', nil
|
43
|
+
|
44
|
+
assert_nil @db.collations['foo']
|
45
|
+
assert_raises(SQLite3::SQLException) do
|
46
|
+
@db.execute('select data from ex order by 1 collate foo')
|
47
|
+
end
|
48
|
+
end
|
49
|
+
|
50
|
+
if RUBY_VERSION >= '1.9.1'
|
51
|
+
def test_encoding
|
52
|
+
comparator = Comparator.new
|
53
|
+
@db.collation 'foo', comparator
|
54
|
+
@db.execute('select data from ex order by 1 collate foo')
|
55
|
+
|
56
|
+
a, b = *comparator.calls.first
|
57
|
+
|
58
|
+
assert_equal Encoding.find('UTF-8'), a.encoding
|
59
|
+
assert_equal Encoding.find('UTF-8'), b.encoding
|
60
|
+
end
|
61
|
+
|
62
|
+
def test_encoding_default_internal
|
63
|
+
warn_before = $-w
|
64
|
+
$-w = false
|
65
|
+
before_enc = Encoding.default_internal
|
66
|
+
|
67
|
+
Encoding.default_internal = 'EUC-JP'
|
68
|
+
comparator = Comparator.new
|
69
|
+
@db.collation 'foo', comparator
|
70
|
+
@db.execute('select data from ex order by 1 collate foo')
|
71
|
+
|
72
|
+
a, b = *comparator.calls.first
|
73
|
+
|
74
|
+
assert_equal Encoding.find('EUC-JP'), a.encoding
|
75
|
+
assert_equal Encoding.find('EUC-JP'), b.encoding
|
76
|
+
ensure
|
77
|
+
Encoding.default_internal = before_enc
|
78
|
+
$-w = warn_before
|
79
|
+
end
|
80
|
+
end
|
81
|
+
end
|
82
|
+
end
|