pg 0.12.0 → 0.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- checksums.yaml.gz.sig +2 -0
- data/BSDL +22 -0
- data/ChangeLog +1504 -11
- data/Contributors.rdoc +7 -0
- data/History.rdoc +181 -3
- data/LICENSE +12 -14
- data/Manifest.txt +29 -15
- data/{BSD → POSTGRES} +0 -0
- data/{README.OS_X.rdoc → README-OS_X.rdoc} +0 -0
- data/{README.windows.rdoc → README-Windows.rdoc} +0 -0
- data/README.ja.rdoc +10 -3
- data/README.rdoc +54 -28
- data/Rakefile +53 -26
- data/Rakefile.cross +235 -196
- data/ext/errorcodes.def +931 -0
- data/ext/errorcodes.rb +45 -0
- data/ext/errorcodes.txt +463 -0
- data/ext/extconf.rb +37 -7
- data/ext/gvl_wrappers.c +19 -0
- data/ext/gvl_wrappers.h +211 -0
- data/ext/pg.c +317 -4277
- data/ext/pg.h +124 -21
- data/ext/pg_connection.c +3642 -0
- data/ext/pg_errors.c +89 -0
- data/ext/pg_result.c +920 -0
- data/lib/pg/connection.rb +86 -0
- data/lib/pg/constants.rb +11 -0
- data/lib/pg/exceptions.rb +11 -0
- data/lib/pg/result.rb +16 -0
- data/lib/pg.rb +26 -43
- data/sample/array_insert.rb +20 -0
- data/sample/async_api.rb +21 -24
- data/sample/async_copyto.rb +2 -2
- data/sample/async_mixed.rb +56 -0
- data/sample/check_conn.rb +21 -0
- data/sample/copyfrom.rb +1 -1
- data/sample/copyto.rb +1 -1
- data/sample/cursor.rb +2 -2
- data/sample/disk_usage_report.rb +186 -0
- data/sample/issue-119.rb +94 -0
- data/sample/losample.rb +6 -6
- data/sample/minimal-testcase.rb +17 -0
- data/sample/notify_wait.rb +51 -22
- data/sample/pg_statistics.rb +294 -0
- data/sample/replication_monitor.rb +231 -0
- data/sample/test_binary_values.rb +4 -6
- data/sample/wal_shipper.rb +434 -0
- data/sample/warehouse_partitions.rb +320 -0
- data/spec/lib/helpers.rb +70 -23
- data/spec/pg/connection_spec.rb +1128 -0
- data/spec/{pgresult_spec.rb → pg/result_spec.rb} +142 -47
- data/spec/pg_spec.rb +44 -0
- data.tar.gz.sig +0 -0
- metadata +145 -100
- metadata.gz.sig +0 -0
- data/GPL +0 -340
- data/ext/compat.c +0 -541
- data/ext/compat.h +0 -184
- data/misc/openssl-pg-segfault.rb +0 -31
- data/sample/psql.rb +0 -1181
- data/sample/psqlHelp.rb +0 -158
- data/sample/test1.rb +0 -60
- data/sample/test2.rb +0 -44
- data/sample/test4.rb +0 -71
- data/spec/m17n_spec.rb +0 -151
- data/spec/pgconn_spec.rb +0 -643
@@ -3,32 +3,40 @@
|
|
3
3
|
|
4
4
|
BEGIN {
|
5
5
|
require 'pathname'
|
6
|
-
require 'rbconfig'
|
7
6
|
|
8
|
-
basedir = Pathname( __FILE__ ).dirname.parent
|
7
|
+
basedir = Pathname( __FILE__ ).dirname.parent.parent
|
9
8
|
libdir = basedir + 'lib'
|
10
|
-
archlib = libdir + Config::CONFIG['sitearch']
|
11
9
|
|
12
10
|
$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
|
13
11
|
$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
|
14
|
-
$LOAD_PATH.unshift( archlib.to_s ) unless $LOAD_PATH.include?( archlib.to_s )
|
15
12
|
}
|
16
13
|
|
17
14
|
require 'rspec'
|
18
15
|
require 'spec/lib/helpers'
|
19
16
|
require 'pg'
|
20
17
|
|
21
|
-
describe
|
22
|
-
include PgTestingHelpers
|
18
|
+
describe PG::Result do
|
23
19
|
|
24
20
|
before( :all ) do
|
25
|
-
@conn = setup_testing_db( "
|
21
|
+
@conn = setup_testing_db( "PG_Result" )
|
26
22
|
end
|
27
23
|
|
28
24
|
before( :each ) do
|
29
25
|
@conn.exec( 'BEGIN' )
|
30
26
|
end
|
31
27
|
|
28
|
+
after( :each ) do
|
29
|
+
@conn.exec( 'ROLLBACK' )
|
30
|
+
end
|
31
|
+
|
32
|
+
after( :all ) do
|
33
|
+
teardown_testing_db( @conn )
|
34
|
+
end
|
35
|
+
|
36
|
+
|
37
|
+
#
|
38
|
+
# Examples
|
39
|
+
#
|
32
40
|
|
33
41
|
it "should act as an array of hashes" do
|
34
42
|
res = @conn.exec("SELECT 1 AS a, 2 AS b")
|
@@ -36,6 +44,13 @@ describe PGresult do
|
|
36
44
|
res[0]['b'].should== '2'
|
37
45
|
end
|
38
46
|
|
47
|
+
it "should yield a row as an array" do
|
48
|
+
res = @conn.exec("SELECT 1 AS a, 2 AS b")
|
49
|
+
list = []
|
50
|
+
res.each_row { |r| list << r }
|
51
|
+
list.should eq [['1', '2']]
|
52
|
+
end
|
53
|
+
|
39
54
|
it "should insert nil AS NULL and return NULL as nil" do
|
40
55
|
res = @conn.exec("SELECT $1::int AS n", [nil])
|
41
56
|
res[0]['n'].should be_nil()
|
@@ -51,21 +66,37 @@ describe PGresult do
|
|
51
66
|
|
52
67
|
result = exception.result
|
53
68
|
|
54
|
-
result.should be_a(
|
55
|
-
result.error_field(
|
56
|
-
result.error_field(
|
57
|
-
result.error_field(
|
69
|
+
result.should be_a( described_class() )
|
70
|
+
result.error_field( PG::PG_DIAG_SEVERITY ).should == 'ERROR'
|
71
|
+
result.error_field( PG::PG_DIAG_SQLSTATE ).should == '42P01'
|
72
|
+
result.error_field( PG::PG_DIAG_MESSAGE_PRIMARY ).
|
58
73
|
should == 'relation "nonexistant_table" does not exist'
|
59
|
-
result.error_field(
|
60
|
-
result.error_field(
|
61
|
-
result.error_field(
|
62
|
-
result.error_field(
|
63
|
-
result.error_field(
|
64
|
-
result.error_field(
|
65
|
-
result.error_field(
|
66
|
-
result.error_field(
|
67
|
-
result.error_field(
|
74
|
+
result.error_field( PG::PG_DIAG_MESSAGE_DETAIL ).should be_nil()
|
75
|
+
result.error_field( PG::PG_DIAG_MESSAGE_HINT ).should be_nil()
|
76
|
+
result.error_field( PG::PG_DIAG_STATEMENT_POSITION ).should == '15'
|
77
|
+
result.error_field( PG::PG_DIAG_INTERNAL_POSITION ).should be_nil()
|
78
|
+
result.error_field( PG::PG_DIAG_INTERNAL_QUERY ).should be_nil()
|
79
|
+
result.error_field( PG::PG_DIAG_CONTEXT ).should be_nil()
|
80
|
+
result.error_field( PG::PG_DIAG_SOURCE_FILE ).should =~ /parse_relation\.c$|namespace\.c$/
|
81
|
+
result.error_field( PG::PG_DIAG_SOURCE_LINE ).should =~ /^\d+$/
|
82
|
+
result.error_field( PG::PG_DIAG_SOURCE_FUNCTION ).should =~ /^parserOpenTable$|^RangeVarGetRelid$/
|
83
|
+
end
|
84
|
+
|
85
|
+
it "encapsulates database object names for integrity constraint violations", :postgresql_93 do
|
86
|
+
@conn.exec( "CREATE TABLE integrity (id SERIAL PRIMARY KEY)" )
|
87
|
+
exception = nil
|
88
|
+
begin
|
89
|
+
@conn.exec( "INSERT INTO integrity VALUES (NULL)" )
|
90
|
+
rescue PGError => err
|
91
|
+
exception = err
|
92
|
+
end
|
93
|
+
result = exception.result
|
68
94
|
|
95
|
+
result.error_field( PG::PG_DIAG_SCHEMA_NAME ).should == 'public'
|
96
|
+
result.error_field( PG::PG_DIAG_TABLE_NAME ).should == 'integrity'
|
97
|
+
result.error_field( PG::PG_DIAG_COLUMN_NAME ).should == 'id'
|
98
|
+
result.error_field( PG::PG_DIAG_DATATYPE_NAME ).should be_nil
|
99
|
+
result.error_field( PG::PG_DIAG_CONSTRAINT_NAME ).should be_nil
|
69
100
|
end
|
70
101
|
|
71
102
|
it "should detect division by zero as SQLSTATE 22012" do
|
@@ -73,7 +104,7 @@ describe PGresult do
|
|
73
104
|
begin
|
74
105
|
res = @conn.exec("SELECT 1/0")
|
75
106
|
rescue PGError => e
|
76
|
-
sqlstate = e.result.result_error_field(
|
107
|
+
sqlstate = e.result.result_error_field( PG::PG_DIAG_SQLSTATE ).to_i
|
77
108
|
end
|
78
109
|
sqlstate.should == 22012
|
79
110
|
end
|
@@ -81,27 +112,31 @@ describe PGresult do
|
|
81
112
|
it "should return the same bytes in binary format that are sent in binary format" do
|
82
113
|
binary_file = File.join(Dir.pwd, 'spec/data', 'random_binary_data')
|
83
114
|
bytes = File.open(binary_file, 'rb').read
|
84
|
-
res = @conn.exec('VALUES ($1::bytea)',
|
115
|
+
res = @conn.exec('VALUES ($1::bytea)',
|
85
116
|
[ { :value => bytes, :format => 1 } ], 1)
|
86
117
|
res[0]['column1'].should== bytes
|
118
|
+
res.getvalue(0,0).should == bytes
|
119
|
+
res.values[0][0].should == bytes
|
120
|
+
res.column_values(0)[0].should == bytes
|
87
121
|
end
|
88
122
|
|
89
123
|
it "should return the same bytes in binary format that are sent as inline text" do
|
90
124
|
binary_file = File.join(Dir.pwd, 'spec/data', 'random_binary_data')
|
91
|
-
|
92
|
-
out_bytes = nil
|
125
|
+
bytes = File.open(binary_file, 'rb').read
|
93
126
|
@conn.exec("SET standard_conforming_strings=on")
|
94
|
-
res = @conn.exec("VALUES ('#{
|
95
|
-
|
96
|
-
|
127
|
+
res = @conn.exec("VALUES ('#{PG::Connection.escape_bytea(bytes)}'::bytea)", [], 1)
|
128
|
+
res[0]['column1'].should == bytes
|
129
|
+
res.getvalue(0,0).should == bytes
|
130
|
+
res.values[0][0].should == bytes
|
131
|
+
res.column_values(0)[0].should == bytes
|
97
132
|
end
|
98
133
|
|
99
134
|
it "should return the same bytes in text format that are sent in binary format" do
|
100
135
|
binary_file = File.join(Dir.pwd, 'spec/data', 'random_binary_data')
|
101
136
|
bytes = File.open(binary_file, 'rb').read
|
102
|
-
res = @conn.exec('VALUES ($1::bytea)',
|
137
|
+
res = @conn.exec('VALUES ($1::bytea)',
|
103
138
|
[ { :value => bytes, :format => 1 } ])
|
104
|
-
|
139
|
+
PG::Connection.unescape_bytea(res[0]['column1']).should== bytes
|
105
140
|
end
|
106
141
|
|
107
142
|
it "should return the same bytes in text format that are sent as inline text" do
|
@@ -110,13 +145,13 @@ describe PGresult do
|
|
110
145
|
|
111
146
|
out_bytes = nil
|
112
147
|
@conn.exec("SET standard_conforming_strings=on")
|
113
|
-
res = @conn.exec("VALUES ('#{
|
114
|
-
out_bytes =
|
148
|
+
res = @conn.exec("VALUES ('#{PG::Connection.escape_bytea(in_bytes)}'::bytea)", [], 0)
|
149
|
+
out_bytes = PG::Connection.unescape_bytea(res[0]['column1'])
|
115
150
|
out_bytes.should == in_bytes
|
116
151
|
end
|
117
152
|
|
118
|
-
it "should return the parameter type of the specified prepared
|
119
|
-
query = 'SELECT * FROM pg_stat_activity WHERE user = $1::name AND
|
153
|
+
it "should return the parameter type of the specified prepared statement parameter", :postgresql_92 do
|
154
|
+
query = 'SELECT * FROM pg_stat_activity WHERE user = $1::name AND query = $2::text'
|
120
155
|
@conn.prepare( 'queryfinder', query )
|
121
156
|
res = @conn.describe_prepared( 'queryfinder' )
|
122
157
|
|
@@ -163,19 +198,19 @@ describe PGresult do
|
|
163
198
|
res.fmod( 0 ).should == 33 + 4 # Column length + varlena size (4)
|
164
199
|
end
|
165
200
|
|
166
|
-
it "should raise an exception when an invalid index is passed to
|
201
|
+
it "should raise an exception when an invalid index is passed to PG::Result#fmod" do
|
167
202
|
@conn.exec( 'CREATE TABLE fmodtest ( foo varchar(33) )' )
|
168
203
|
res = @conn.exec( 'SELECT * FROM fmodtest' )
|
169
204
|
expect { res.fmod(1) }.to raise_error( ArgumentError )
|
170
205
|
end
|
171
206
|
|
172
|
-
it "should raise an exception when an invalid (negative) index is passed to
|
207
|
+
it "should raise an exception when an invalid (negative) index is passed to PG::Result#fmod" do
|
173
208
|
@conn.exec( 'CREATE TABLE fmodtest ( foo varchar(33) )' )
|
174
209
|
res = @conn.exec( 'SELECT * FROM fmodtest' )
|
175
210
|
expect { res.fmod(-11) }.to raise_error( ArgumentError )
|
176
211
|
end
|
177
212
|
|
178
|
-
it "shouldn't raise an exception when a valid index is passed to
|
213
|
+
it "shouldn't raise an exception when a valid index is passed to PG::Result#fmod for a column with no typemod" do
|
179
214
|
@conn.exec( 'CREATE TABLE fmodtest ( foo text )' )
|
180
215
|
res = @conn.exec( 'SELECT * FROM fmodtest' )
|
181
216
|
res.fmod( 0 ).should == -1 # and it shouldn't raise an exception, either
|
@@ -189,25 +224,25 @@ describe PGresult do
|
|
189
224
|
res.ftable( 0 ).should == be_nonzero()
|
190
225
|
end
|
191
226
|
|
192
|
-
it "should raise an exception when an invalid index is passed to
|
227
|
+
it "should raise an exception when an invalid index is passed to PG::Result#ftable" do
|
193
228
|
@conn.exec( 'CREATE TABLE ftabletest ( foo text )' )
|
194
229
|
res = @conn.exec( 'SELECT * FROM ftabletest' )
|
195
230
|
|
196
231
|
expect { res.ftable(18) }.to raise_error( ArgumentError )
|
197
232
|
end
|
198
233
|
|
199
|
-
it "should raise an exception when an invalid (negative) index is passed to
|
234
|
+
it "should raise an exception when an invalid (negative) index is passed to PG::Result#ftable" do
|
200
235
|
@conn.exec( 'CREATE TABLE ftabletest ( foo text )' )
|
201
236
|
res = @conn.exec( 'SELECT * FROM ftabletest' )
|
202
237
|
|
203
238
|
expect { res.ftable(-2) }.to raise_error( ArgumentError )
|
204
239
|
end
|
205
240
|
|
206
|
-
it "shouldn't raise an exception when a valid index is passed to
|
241
|
+
it "shouldn't raise an exception when a valid index is passed to PG::Result#ftable for a " +
|
207
242
|
"column with no corresponding table" do
|
208
243
|
@conn.exec( 'CREATE TABLE ftabletest ( foo text )' )
|
209
244
|
res = @conn.exec( 'SELECT foo, LENGTH(foo) as length FROM ftabletest' )
|
210
|
-
res.ftable( 1 ).should ==
|
245
|
+
res.ftable( 1 ).should == PG::INVALID_OID # and it shouldn't raise an exception, either
|
211
246
|
end
|
212
247
|
|
213
248
|
# PQftablecol
|
@@ -219,32 +254,92 @@ describe PGresult do
|
|
219
254
|
res.ftablecol( 1 ).should == 2
|
220
255
|
end
|
221
256
|
|
222
|
-
it "should raise an exception when an invalid index is passed to
|
257
|
+
it "should raise an exception when an invalid index is passed to PG::Result#ftablecol" do
|
223
258
|
@conn.exec( 'CREATE TABLE ftablecoltest ( foo text, bar numeric )' )
|
224
259
|
res = @conn.exec( 'SELECT * FROM ftablecoltest' )
|
225
260
|
|
226
261
|
expect { res.ftablecol(32) }.to raise_error( ArgumentError )
|
227
262
|
end
|
228
263
|
|
229
|
-
it "should raise an exception when an invalid (negative) index is passed to
|
264
|
+
it "should raise an exception when an invalid (negative) index is passed to PG::Result#ftablecol" do
|
230
265
|
@conn.exec( 'CREATE TABLE ftablecoltest ( foo text, bar numeric )' )
|
231
266
|
res = @conn.exec( 'SELECT * FROM ftablecoltest' )
|
232
267
|
|
233
268
|
expect { res.ftablecol(-1) }.to raise_error( ArgumentError )
|
234
269
|
end
|
235
270
|
|
236
|
-
it "shouldn't raise an exception when a valid index is passed to
|
271
|
+
it "shouldn't raise an exception when a valid index is passed to PG::Result#ftablecol for a " +
|
237
272
|
"column with no corresponding table" do
|
238
273
|
@conn.exec( 'CREATE TABLE ftablecoltest ( foo text )' )
|
239
274
|
res = @conn.exec( 'SELECT foo, LENGTH(foo) as length FROM ftablecoltest' )
|
240
275
|
res.ftablecol(1).should == 0 # and it shouldn't raise an exception, either
|
241
276
|
end
|
242
277
|
|
243
|
-
|
244
|
-
@conn.
|
278
|
+
it "can be manually checked for failed result status (async API)" do
|
279
|
+
@conn.send_query( "SELECT * FROM nonexistant_table" )
|
280
|
+
res = @conn.get_result
|
281
|
+
expect {
|
282
|
+
res.check
|
283
|
+
}.to raise_error( PG::Error, /relation "nonexistant_table" does not exist/ )
|
245
284
|
end
|
246
285
|
|
247
|
-
|
248
|
-
|
286
|
+
it "can return the values of a single field" do
|
287
|
+
res = @conn.exec( "SELECT 1 AS x, 'a' AS y UNION ALL SELECT 2, 'b'" )
|
288
|
+
res.field_values( 'x' ).should == ['1', '2']
|
289
|
+
res.field_values( 'y' ).should == ['a', 'b']
|
290
|
+
expect{ res.field_values( '' ) }.to raise_error(IndexError)
|
291
|
+
expect{ res.field_values( :x ) }.to raise_error(TypeError)
|
292
|
+
end
|
293
|
+
|
294
|
+
it "should raise a proper exception for a nonexistant table" do
|
295
|
+
expect {
|
296
|
+
@conn.exec( "SELECT * FROM nonexistant_table" )
|
297
|
+
}.to raise_error( PG::UndefinedTable, /relation "nonexistant_table" does not exist/ )
|
298
|
+
end
|
299
|
+
|
300
|
+
it "should raise a more generic exception for an unknown SQLSTATE" do
|
301
|
+
old_error = PG::ERROR_CLASSES.delete('42P01')
|
302
|
+
begin
|
303
|
+
expect {
|
304
|
+
@conn.exec( "SELECT * FROM nonexistant_table" )
|
305
|
+
}.to raise_error{|error|
|
306
|
+
error.should be_an_instance_of(PG::SyntaxErrorOrAccessRuleViolation)
|
307
|
+
error.to_s.should match(/relation "nonexistant_table" does not exist/)
|
308
|
+
}
|
309
|
+
ensure
|
310
|
+
PG::ERROR_CLASSES['42P01'] = old_error
|
311
|
+
end
|
312
|
+
end
|
313
|
+
|
314
|
+
it "should raise a ServerError for an unknown SQLSTATE class" do
|
315
|
+
old_error1 = PG::ERROR_CLASSES.delete('42P01')
|
316
|
+
old_error2 = PG::ERROR_CLASSES.delete('42')
|
317
|
+
begin
|
318
|
+
expect {
|
319
|
+
@conn.exec( "SELECT * FROM nonexistant_table" )
|
320
|
+
}.to raise_error{|error|
|
321
|
+
error.should be_an_instance_of(PG::ServerError)
|
322
|
+
error.to_s.should match(/relation "nonexistant_table" does not exist/)
|
323
|
+
}
|
324
|
+
ensure
|
325
|
+
PG::ERROR_CLASSES['42P01'] = old_error1
|
326
|
+
PG::ERROR_CLASSES['42'] = old_error2
|
327
|
+
end
|
328
|
+
end
|
329
|
+
|
330
|
+
it "should raise a proper exception for a nonexistant schema" do
|
331
|
+
expect {
|
332
|
+
@conn.exec( "DROP SCHEMA nonexistant_schema" )
|
333
|
+
}.to raise_error( PG::InvalidSchemaName, /schema "nonexistant_schema" does not exist/ )
|
334
|
+
end
|
335
|
+
|
336
|
+
it "the raised result should be nil in case of a connection error" do
|
337
|
+
c = PGconn.connect_start( '127.0.0.1', 54320, "", "", "me", "xxxx", "somedb" )
|
338
|
+
expect {
|
339
|
+
c.exec "select 1"
|
340
|
+
}.to raise_error{|error|
|
341
|
+
error.should be_an_instance_of(PG::UnableToSend)
|
342
|
+
error.result.should == nil
|
343
|
+
}
|
249
344
|
end
|
250
345
|
end
|
data/spec/pg_spec.rb
ADDED
@@ -0,0 +1,44 @@
|
|
1
|
+
#!/usr/bin/env rspec
|
2
|
+
# encoding: utf-8
|
3
|
+
|
4
|
+
BEGIN {
|
5
|
+
require 'pathname'
|
6
|
+
|
7
|
+
basedir = Pathname( __FILE__ ).dirname.parent
|
8
|
+
libdir = basedir + 'lib'
|
9
|
+
|
10
|
+
$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
|
11
|
+
$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
|
12
|
+
}
|
13
|
+
|
14
|
+
require 'rspec'
|
15
|
+
require 'spec/lib/helpers'
|
16
|
+
require 'pg'
|
17
|
+
|
18
|
+
describe PG do
|
19
|
+
|
20
|
+
it "knows what version of the libpq library is loaded", :postgresql_91 do
|
21
|
+
PG.library_version.should be_an( Integer )
|
22
|
+
PG.library_version.should >= 90100
|
23
|
+
end
|
24
|
+
|
25
|
+
|
26
|
+
it "knows whether or not the library is threadsafe" do
|
27
|
+
PG.should be_threadsafe()
|
28
|
+
end
|
29
|
+
|
30
|
+
it "does have hierarchical error classes" do
|
31
|
+
PG::UndefinedTable.ancestors[0,4].should == [
|
32
|
+
PG::UndefinedTable,
|
33
|
+
PG::SyntaxErrorOrAccessRuleViolation,
|
34
|
+
PG::ServerError,
|
35
|
+
PG::Error]
|
36
|
+
|
37
|
+
PG::InvalidSchemaName.ancestors[0,3].should == [
|
38
|
+
PG::InvalidSchemaName,
|
39
|
+
PG::ServerError,
|
40
|
+
PG::Error]
|
41
|
+
end
|
42
|
+
|
43
|
+
end
|
44
|
+
|
data.tar.gz.sig
CHANGED
Binary file
|