pg 1.2.3 → 1.3.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (103) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/.appveyor.yml +36 -0
  4. data/.gems +6 -0
  5. data/.github/workflows/binary-gems.yml +86 -0
  6. data/.github/workflows/source-gem.yml +130 -0
  7. data/.gitignore +13 -0
  8. data/.hgsigs +34 -0
  9. data/.hgtags +41 -0
  10. data/.irbrc +23 -0
  11. data/.pryrc +23 -0
  12. data/.tm_properties +21 -0
  13. data/.travis.yml +49 -0
  14. data/Gemfile +14 -0
  15. data/History.rdoc +95 -7
  16. data/Manifest.txt +0 -1
  17. data/README.rdoc +7 -6
  18. data/Rakefile +27 -138
  19. data/Rakefile.cross +6 -5
  20. data/certs/ged.pem +24 -0
  21. data/ext/errorcodes.def +8 -0
  22. data/ext/errorcodes.txt +3 -1
  23. data/ext/extconf.rb +91 -19
  24. data/ext/gvl_wrappers.c +4 -0
  25. data/ext/gvl_wrappers.h +23 -0
  26. data/ext/pg.c +59 -4
  27. data/ext/pg.h +18 -1
  28. data/ext/pg_coder.c +82 -28
  29. data/ext/pg_connection.c +673 -493
  30. data/ext/pg_copy_coder.c +45 -16
  31. data/ext/pg_record_coder.c +39 -11
  32. data/ext/pg_result.c +61 -31
  33. data/ext/pg_text_decoder.c +1 -1
  34. data/ext/pg_text_encoder.c +6 -6
  35. data/ext/pg_tuple.c +47 -21
  36. data/ext/pg_type_map.c +41 -8
  37. data/ext/pg_type_map_all_strings.c +14 -1
  38. data/ext/pg_type_map_by_class.c +49 -24
  39. data/ext/pg_type_map_by_column.c +64 -28
  40. data/ext/pg_type_map_by_mri_type.c +47 -18
  41. data/ext/pg_type_map_by_oid.c +52 -23
  42. data/ext/pg_type_map_in_ruby.c +50 -19
  43. data/ext/pg_util.c +2 -2
  44. data/lib/pg/basic_type_map_based_on_result.rb +47 -0
  45. data/lib/pg/basic_type_map_for_queries.rb +193 -0
  46. data/lib/pg/basic_type_map_for_results.rb +81 -0
  47. data/lib/pg/basic_type_registry.rb +296 -0
  48. data/lib/pg/coder.rb +1 -1
  49. data/lib/pg/connection.rb +588 -58
  50. data/lib/pg/version.rb +4 -0
  51. data/lib/pg.rb +47 -32
  52. data/misc/openssl-pg-segfault.rb +31 -0
  53. data/misc/postgres/History.txt +9 -0
  54. data/misc/postgres/Manifest.txt +5 -0
  55. data/misc/postgres/README.txt +21 -0
  56. data/misc/postgres/Rakefile +21 -0
  57. data/misc/postgres/lib/postgres.rb +16 -0
  58. data/misc/ruby-pg/History.txt +9 -0
  59. data/misc/ruby-pg/Manifest.txt +5 -0
  60. data/misc/ruby-pg/README.txt +21 -0
  61. data/misc/ruby-pg/Rakefile +21 -0
  62. data/misc/ruby-pg/lib/ruby/pg.rb +16 -0
  63. data/pg.gemspec +32 -0
  64. data/sample/array_insert.rb +20 -0
  65. data/sample/async_api.rb +106 -0
  66. data/sample/async_copyto.rb +39 -0
  67. data/sample/async_mixed.rb +56 -0
  68. data/sample/check_conn.rb +21 -0
  69. data/sample/copydata.rb +71 -0
  70. data/sample/copyfrom.rb +81 -0
  71. data/sample/copyto.rb +19 -0
  72. data/sample/cursor.rb +21 -0
  73. data/sample/disk_usage_report.rb +177 -0
  74. data/sample/issue-119.rb +94 -0
  75. data/sample/losample.rb +69 -0
  76. data/sample/minimal-testcase.rb +17 -0
  77. data/sample/notify_wait.rb +72 -0
  78. data/sample/pg_statistics.rb +285 -0
  79. data/sample/replication_monitor.rb +222 -0
  80. data/sample/test_binary_values.rb +33 -0
  81. data/sample/wal_shipper.rb +434 -0
  82. data/sample/warehouse_partitions.rb +311 -0
  83. data.tar.gz.sig +0 -0
  84. metadata +76 -217
  85. metadata.gz.sig +0 -0
  86. data/ChangeLog +0 -0
  87. data/lib/pg/basic_type_mapping.rb +0 -522
  88. data/spec/data/expected_trace.out +0 -26
  89. data/spec/data/random_binary_data +0 -0
  90. data/spec/helpers.rb +0 -380
  91. data/spec/pg/basic_type_mapping_spec.rb +0 -630
  92. data/spec/pg/connection_spec.rb +0 -1949
  93. data/spec/pg/connection_sync_spec.rb +0 -41
  94. data/spec/pg/result_spec.rb +0 -681
  95. data/spec/pg/tuple_spec.rb +0 -333
  96. data/spec/pg/type_map_by_class_spec.rb +0 -138
  97. data/spec/pg/type_map_by_column_spec.rb +0 -226
  98. data/spec/pg/type_map_by_mri_type_spec.rb +0 -136
  99. data/spec/pg/type_map_by_oid_spec.rb +0 -149
  100. data/spec/pg/type_map_in_ruby_spec.rb +0 -164
  101. data/spec/pg/type_map_spec.rb +0 -22
  102. data/spec/pg/type_spec.rb +0 -1123
  103. data/spec/pg_spec.rb +0 -50
data/ext/pg_connection.c CHANGED
@@ -12,6 +12,7 @@
12
12
 
13
13
  VALUE rb_cPGconn;
14
14
  static ID s_id_encode;
15
+ static ID s_id_autoclose_set;
15
16
  static VALUE sym_type, sym_format, sym_value;
16
17
  static VALUE sym_symbol, sym_string, sym_static_symbol;
17
18
 
@@ -20,7 +21,9 @@ static PQnoticeProcessor default_notice_processor = NULL;
20
21
 
21
22
  static VALUE pgconn_finish( VALUE );
22
23
  static VALUE pgconn_set_default_encoding( VALUE self );
24
+ static VALUE pgconn_wait_for_flush( VALUE self );
23
25
  static void pgconn_set_internal_encoding_index( VALUE );
26
+ static const rb_data_type_t pg_connection_type;
24
27
 
25
28
  /*
26
29
  * Global functions
@@ -33,7 +36,7 @@ t_pg_connection *
33
36
  pg_get_connection( VALUE self )
34
37
  {
35
38
  t_pg_connection *this;
36
- Data_Get_Struct( self, t_pg_connection, this);
39
+ TypedData_Get_Struct( self, t_pg_connection, &pg_connection_type, this);
37
40
 
38
41
  return this;
39
42
  }
@@ -46,7 +49,7 @@ static t_pg_connection *
46
49
  pg_get_connection_safe( VALUE self )
47
50
  {
48
51
  t_pg_connection *this;
49
- Data_Get_Struct( self, t_pg_connection, this);
52
+ TypedData_Get_Struct( self, t_pg_connection, &pg_connection_type, this);
50
53
 
51
54
  if ( !this->pgconn )
52
55
  rb_raise( rb_eConnectionBad, "connection is closed" );
@@ -65,7 +68,7 @@ PGconn *
65
68
  pg_get_pgconn( VALUE self )
66
69
  {
67
70
  t_pg_connection *this;
68
- Data_Get_Struct( self, t_pg_connection, this);
71
+ TypedData_Get_Struct( self, t_pg_connection, &pg_connection_type, this);
69
72
 
70
73
  if ( !this->pgconn )
71
74
  rb_raise( rb_eConnectionBad, "connection is closed" );
@@ -145,16 +148,31 @@ static const char *pg_cstr_enc(VALUE str, int enc_idx){
145
148
  * GC Mark function
146
149
  */
147
150
  static void
148
- pgconn_gc_mark( t_pg_connection *this )
151
+ pgconn_gc_mark( void *_this )
149
152
  {
150
- rb_gc_mark( this->socket_io );
151
- rb_gc_mark( this->notice_receiver );
152
- rb_gc_mark( this->notice_processor );
153
- rb_gc_mark( this->type_map_for_queries );
154
- rb_gc_mark( this->type_map_for_results );
155
- rb_gc_mark( this->trace_stream );
156
- rb_gc_mark( this->encoder_for_put_copy_data );
157
- rb_gc_mark( this->decoder_for_get_copy_data );
153
+ t_pg_connection *this = (t_pg_connection *)_this;
154
+ rb_gc_mark_movable( this->socket_io );
155
+ rb_gc_mark_movable( this->notice_receiver );
156
+ rb_gc_mark_movable( this->notice_processor );
157
+ rb_gc_mark_movable( this->type_map_for_queries );
158
+ rb_gc_mark_movable( this->type_map_for_results );
159
+ rb_gc_mark_movable( this->trace_stream );
160
+ rb_gc_mark_movable( this->encoder_for_put_copy_data );
161
+ rb_gc_mark_movable( this->decoder_for_get_copy_data );
162
+ }
163
+
164
+ static void
165
+ pgconn_gc_compact( void *_this )
166
+ {
167
+ t_pg_connection *this = (t_pg_connection *)_this;
168
+ pg_gc_location( this->socket_io );
169
+ pg_gc_location( this->notice_receiver );
170
+ pg_gc_location( this->notice_processor );
171
+ pg_gc_location( this->type_map_for_queries );
172
+ pg_gc_location( this->type_map_for_results );
173
+ pg_gc_location( this->trace_stream );
174
+ pg_gc_location( this->encoder_for_put_copy_data );
175
+ pg_gc_location( this->decoder_for_get_copy_data );
158
176
  }
159
177
 
160
178
 
@@ -162,11 +180,15 @@ pgconn_gc_mark( t_pg_connection *this )
162
180
  * GC Free function
163
181
  */
164
182
  static void
165
- pgconn_gc_free( t_pg_connection *this )
183
+ pgconn_gc_free( void *_this )
166
184
  {
185
+ t_pg_connection *this = (t_pg_connection *)_this;
167
186
  #if defined(_WIN32)
168
- if ( RTEST(this->socket_io) )
169
- rb_w32_unwrap_io_handle( this->ruby_sd );
187
+ if ( RTEST(this->socket_io) ) {
188
+ if( rb_w32_unwrap_io_handle(this->ruby_sd) ){
189
+ rb_warn("pg: Could not unwrap win32 socket handle by garbage collector");
190
+ }
191
+ }
170
192
  #endif
171
193
  if (this->pgconn != NULL)
172
194
  PQfinish( this->pgconn );
@@ -174,6 +196,29 @@ pgconn_gc_free( t_pg_connection *this )
174
196
  xfree(this);
175
197
  }
176
198
 
199
+ /*
200
+ * Object Size function
201
+ */
202
+ static size_t
203
+ pgconn_memsize( const void *_this )
204
+ {
205
+ const t_pg_connection *this = (const t_pg_connection *)_this;
206
+ return sizeof(*this);
207
+ }
208
+
209
+ static const rb_data_type_t pg_connection_type = {
210
+ "PG::Connection",
211
+ {
212
+ pgconn_gc_mark,
213
+ pgconn_gc_free,
214
+ pgconn_memsize,
215
+ pg_compact_callback(pgconn_gc_compact),
216
+ },
217
+ 0,
218
+ 0,
219
+ 0,
220
+ };
221
+
177
222
 
178
223
  /**************************************************************************
179
224
  * Class Methods
@@ -189,7 +234,7 @@ static VALUE
189
234
  pgconn_s_allocate( VALUE klass )
190
235
  {
191
236
  t_pg_connection *this;
192
- VALUE self = Data_Make_Struct( klass, t_pg_connection, pgconn_gc_mark, pgconn_gc_free, this );
237
+ VALUE self = TypedData_Make_Struct( klass, t_pg_connection, &pg_connection_type, this );
193
238
 
194
239
  this->pgconn = NULL;
195
240
  this->socket_io = Qnil;
@@ -204,65 +249,13 @@ pgconn_s_allocate( VALUE klass )
204
249
  return self;
205
250
  }
206
251
 
207
-
208
- /*
209
- * Document-method: new
210
- *
211
- * call-seq:
212
- * PG::Connection.new -> conn
213
- * PG::Connection.new(connection_hash) -> conn
214
- * PG::Connection.new(connection_string) -> conn
215
- * PG::Connection.new(host, port, options, tty, dbname, user, password) -> conn
216
- *
217
- * Create a connection to the specified server.
218
- *
219
- * +connection_hash+ must be a ruby Hash with connection parameters.
220
- * See the {list of valid parameters}[https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-PARAMKEYWORDS] in the PostgreSQL documentation.
221
- *
222
- * There are two accepted formats for +connection_string+: plain <code>keyword = value</code> strings and URIs.
223
- * See the documentation of {connection strings}[https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING].
224
- *
225
- * The positional parameter form has the same functionality except that the missing parameters will always take on default values. The parameters are:
226
- * [+host+]
227
- * server hostname
228
- * [+port+]
229
- * server port number
230
- * [+options+]
231
- * backend options
232
- * [+tty+]
233
- * (ignored in newer versions of PostgreSQL)
234
- * [+dbname+]
235
- * connecting database name
236
- * [+user+]
237
- * login user name
238
- * [+password+]
239
- * login password
240
- *
241
- * Examples:
242
- *
243
- * # Connect using all defaults
244
- * PG::Connection.new
245
- *
246
- * # As a Hash
247
- * PG::Connection.new( :dbname => 'test', :port => 5432 )
248
- *
249
- * # As a String
250
- * PG::Connection.new( "dbname=test port=5432" )
251
- *
252
- * # As an Array
253
- * PG::Connection.new( nil, 5432, nil, nil, 'test', nil, nil )
254
- *
255
- * If the Ruby default internal encoding is set (i.e., <code>Encoding.default_internal != nil</code>), the
256
- * connection will have its +client_encoding+ set accordingly.
257
- *
258
- * Raises a PG::Error if the connection fails.
259
- */
260
252
  static VALUE
261
- pgconn_init(int argc, VALUE *argv, VALUE self)
253
+ pgconn_s_sync_connect(int argc, VALUE *argv, VALUE klass)
262
254
  {
263
255
  t_pg_connection *this;
264
256
  VALUE conninfo;
265
257
  VALUE error;
258
+ VALUE self = pgconn_s_allocate( klass );
266
259
 
267
260
  this = pg_get_connection( self );
268
261
  conninfo = rb_funcall2( rb_cPGconn, rb_intern("parse_connect_args"), argc, argv );
@@ -335,34 +328,14 @@ pgconn_s_connect_start( int argc, VALUE *argv, VALUE klass )
335
328
  return rb_conn;
336
329
  }
337
330
 
338
- /*
339
- * call-seq:
340
- * PG::Connection.ping(connection_hash) -> Integer
341
- * PG::Connection.ping(connection_string) -> Integer
342
- * PG::Connection.ping(host, port, options, tty, dbname, login, password) -> Integer
343
- *
344
- * Check server status.
345
- *
346
- * See PG::Connection.new for a description of the parameters.
347
- *
348
- * Returns one of:
349
- * [+PQPING_OK+]
350
- * server is accepting connections
351
- * [+PQPING_REJECT+]
352
- * server is alive but rejecting connections
353
- * [+PQPING_NO_RESPONSE+]
354
- * could not establish connection
355
- * [+PQPING_NO_ATTEMPT+]
356
- * connection not attempted (bad params)
357
- */
358
331
  static VALUE
359
- pgconn_s_ping( int argc, VALUE *argv, VALUE klass )
332
+ pgconn_s_sync_ping( int argc, VALUE *argv, VALUE klass )
360
333
  {
361
334
  PGPing ping;
362
335
  VALUE conninfo;
363
336
 
364
337
  conninfo = rb_funcall2( klass, rb_intern("parse_connect_args"), argc, argv );
365
- ping = PQping( StringValueCStr(conninfo) );
338
+ ping = gvl_PQping( StringValueCStr(conninfo) );
366
339
 
367
340
  return INT2FIX((int)ping);
368
341
  }
@@ -405,30 +378,8 @@ pgconn_s_conndefaults(VALUE self)
405
378
 
406
379
 
407
380
  #ifdef HAVE_PQENCRYPTPASSWORDCONN
408
- /*
409
- * call-seq:
410
- * conn.encrypt_password( password, username, algorithm=nil ) -> String
411
- *
412
- * This function is intended to be used by client applications that wish to send commands like <tt>ALTER USER joe PASSWORD 'pwd'</tt>.
413
- * It is good practice not to send the original cleartext password in such a command, because it might be exposed in command logs, activity displays, and so on.
414
- * Instead, use this function to convert the password to encrypted form before it is sent.
415
- *
416
- * The +password+ and +username+ arguments are the cleartext password, and the SQL name of the user it is for.
417
- * +algorithm+ specifies the encryption algorithm to use to encrypt the password.
418
- * Currently supported algorithms are +md5+ and +scram-sha-256+ (+on+ and +off+ are also accepted as aliases for +md5+, for compatibility with older server versions).
419
- * Note that support for +scram-sha-256+ was introduced in PostgreSQL version 10, and will not work correctly with older server versions.
420
- * If algorithm is omitted or +nil+, this function will query the server for the current value of the +password_encryption+ setting.
421
- * That can block, and will fail if the current transaction is aborted, or if the connection is busy executing another query.
422
- * If you wish to use the default algorithm for the server but want to avoid blocking, query +password_encryption+ yourself before calling #encrypt_password, and pass that value as the algorithm.
423
- *
424
- * Return value is the encrypted password.
425
- * The caller can assume the string doesn't contain any special characters that would require escaping.
426
- *
427
- * Available since PostgreSQL-10.
428
- * See also corresponding {libpq function}[https://www.postgresql.org/docs/current/libpq-misc.html#LIBPQ-PQENCRYPTPASSWORDCONN].
429
- */
430
381
  static VALUE
431
- pgconn_encrypt_password(int argc, VALUE *argv, VALUE self)
382
+ pgconn_sync_encrypt_password(int argc, VALUE *argv, VALUE self)
432
383
  {
433
384
  char *encrypted = NULL;
434
385
  VALUE rval = Qnil;
@@ -523,6 +474,11 @@ pgconn_connect_poll(VALUE self)
523
474
  {
524
475
  PostgresPollingStatusType status;
525
476
  status = gvl_PQconnectPoll(pg_get_pgconn(self));
477
+
478
+ if ( status == PGRES_POLLING_FAILED ) {
479
+ pgconn_close_socket_io(self);
480
+ }
481
+
526
482
  return INT2FIX((int)status);
527
483
  }
528
484
 
@@ -559,15 +515,8 @@ pgconn_finished_p( VALUE self )
559
515
  }
560
516
 
561
517
 
562
- /*
563
- * call-seq:
564
- * conn.reset()
565
- *
566
- * Resets the backend connection. This method closes the
567
- * backend connection and tries to re-connect.
568
- */
569
518
  static VALUE
570
- pgconn_reset( VALUE self )
519
+ pgconn_sync_reset( VALUE self )
571
520
  {
572
521
  pgconn_close_socket_io( self );
573
522
  gvl_PQreset( pg_get_pgconn(self) );
@@ -606,6 +555,11 @@ pgconn_reset_poll(VALUE self)
606
555
  {
607
556
  PostgresPollingStatusType status;
608
557
  status = gvl_PQresetPoll(pg_get_pgconn(self));
558
+
559
+ if ( status == PGRES_POLLING_FAILED ) {
560
+ pgconn_close_socket_io(self);
561
+ }
562
+
609
563
  return INT2FIX((int)status);
610
564
  }
611
565
 
@@ -676,21 +630,19 @@ static VALUE
676
630
  pgconn_port(VALUE self)
677
631
  {
678
632
  char* port = PQport(pg_get_pgconn(self));
679
- return INT2NUM(atol(port));
633
+ return INT2NUM(atoi(port));
680
634
  }
681
635
 
682
636
  /*
683
637
  * call-seq:
684
638
  * conn.tty()
685
639
  *
686
- * Returns the connected pgtty. (Obsolete)
640
+ * Obsolete function.
687
641
  */
688
642
  static VALUE
689
643
  pgconn_tty(VALUE self)
690
644
  {
691
- char *tty = PQtty(pg_get_pgconn(self));
692
- if (!tty) return Qnil;
693
- return rb_str_new2(tty);
645
+ return rb_str_new2("");
694
646
  }
695
647
 
696
648
  /*
@@ -708,7 +660,6 @@ pgconn_options(VALUE self)
708
660
  }
709
661
 
710
662
 
711
- #ifdef HAVE_PQCONNINFO
712
663
  /*
713
664
  * call-seq:
714
665
  * conn.conninfo -> hash
@@ -728,14 +679,17 @@ pgconn_conninfo( VALUE self )
728
679
 
729
680
  return array;
730
681
  }
731
- #endif
732
682
 
733
683
 
734
684
  /*
735
685
  * call-seq:
736
686
  * conn.status()
737
687
  *
738
- * Returns status of connection : CONNECTION_OK or CONNECTION_BAD
688
+ * Returns the status of the connection, which is one:
689
+ * PG::Constants::CONNECTION_OK
690
+ * PG::Constants::CONNECTION_BAD
691
+ *
692
+ * ... and other constants of kind PG::Constants::CONNECTION_*
739
693
  */
740
694
  static VALUE
741
695
  pgconn_status(VALUE self)
@@ -823,7 +777,10 @@ pgconn_server_version(VALUE self)
823
777
  * call-seq:
824
778
  * conn.error_message -> String
825
779
  *
826
- * Returns the error message about connection.
780
+ * Returns the error message most recently generated by an operation on the connection.
781
+ *
782
+ * Nearly all libpq functions will set a message for conn.error_message if they fail.
783
+ * Note that by libpq convention, a nonempty error_message result can consist of multiple lines, and will include a trailing newline.
827
784
  */
828
785
  static VALUE
829
786
  pgconn_error_message(VALUE self)
@@ -878,8 +835,8 @@ pgconn_socket_io(VALUE self)
878
835
  {
879
836
  int sd;
880
837
  int ruby_sd;
881
- ID id_autoclose = rb_intern("autoclose=");
882
838
  t_pg_connection *this = pg_get_connection_safe( self );
839
+ VALUE cSocket;
883
840
  VALUE socket_io = this->socket_io;
884
841
 
885
842
  if ( !RTEST(socket_io) ) {
@@ -888,15 +845,19 @@ pgconn_socket_io(VALUE self)
888
845
 
889
846
  #ifdef _WIN32
890
847
  ruby_sd = rb_w32_wrap_io_handle((HANDLE)(intptr_t)sd, O_RDWR|O_BINARY|O_NOINHERIT);
848
+ if( ruby_sd == -1 ){
849
+ rb_raise(rb_eConnectionBad, "Could not wrap win32 socket handle");
850
+ }
891
851
  this->ruby_sd = ruby_sd;
892
852
  #else
893
853
  ruby_sd = sd;
894
854
  #endif
895
855
 
896
- socket_io = rb_funcall( rb_cIO, rb_intern("for_fd"), 1, INT2NUM(ruby_sd) );
856
+ cSocket = rb_const_get(rb_cObject, rb_intern("BasicSocket"));
857
+ socket_io = rb_funcall( cSocket, rb_intern("for_fd"), 1, INT2NUM(ruby_sd));
897
858
 
898
859
  /* Disable autoclose feature */
899
- rb_funcall( socket_io, id_autoclose, 1, Qfalse );
860
+ rb_funcall( socket_io, s_id_autoclose_set, 1, Qfalse );
900
861
 
901
862
  this->socket_io = socket_io;
902
863
  }
@@ -918,6 +879,51 @@ pgconn_backend_pid(VALUE self)
918
879
  return INT2NUM(PQbackendPID(pg_get_pgconn(self)));
919
880
  }
920
881
 
882
+ typedef struct
883
+ {
884
+ struct sockaddr_storage addr;
885
+ socklen_t salen;
886
+ } SockAddr;
887
+
888
+ /* Copy of struct pg_cancel from libpq-int.h
889
+ *
890
+ * See https://github.com/postgres/postgres/blame/master/src/interfaces/libpq/libpq-int.h#L577-L586
891
+ */
892
+ struct pg_cancel
893
+ {
894
+ SockAddr raddr; /* Remote address */
895
+ int be_pid; /* PID of backend --- needed for cancels */
896
+ int be_key; /* key of backend --- needed for cancels */
897
+ };
898
+
899
+ /*
900
+ * call-seq:
901
+ * conn.backend_key() -> Integer
902
+ *
903
+ * Returns the key of the backend server process for this connection.
904
+ * This key can be used to cancel queries on the server.
905
+ */
906
+ static VALUE
907
+ pgconn_backend_key(VALUE self)
908
+ {
909
+ int be_key;
910
+ struct pg_cancel *cancel;
911
+ PGconn *conn = pg_get_pgconn(self);
912
+
913
+ cancel = (struct pg_cancel*)PQgetCancel(conn);
914
+ if(cancel == NULL)
915
+ rb_raise(rb_ePGerror,"Invalid connection!");
916
+
917
+ if( cancel->be_pid != PQbackendPID(conn) )
918
+ rb_raise(rb_ePGerror,"Unexpected binary struct layout - please file a bug report at ruby-pg!");
919
+
920
+ be_key = cancel->be_key;
921
+
922
+ PQfreeCancel(cancel);
923
+
924
+ return INT2NUM(be_key);
925
+ }
926
+
921
927
  /*
922
928
  * call-seq:
923
929
  * conn.connection_needs_password() -> Boolean
@@ -948,7 +954,7 @@ pgconn_connection_used_password(VALUE self)
948
954
  /* :TODO: get_ssl */
949
955
 
950
956
 
951
- static VALUE pgconn_exec_params( int, VALUE *, VALUE );
957
+ static VALUE pgconn_sync_exec_params( int, VALUE *, VALUE );
952
958
 
953
959
  /*
954
960
  * call-seq:
@@ -962,11 +968,11 @@ static VALUE pgconn_exec_params( int, VALUE *, VALUE );
962
968
  * However #async_exec has two advantages:
963
969
  *
964
970
  * 1. #async_exec can be aborted by signals (like Ctrl-C), while #exec blocks signal processing until the query is answered.
965
- * 2. Ruby VM gets notified about IO blocked operations.
966
- * It can therefore schedule things like garbage collection, while queries are running like in this proposal: https://bugs.ruby-lang.org/issues/14723
971
+ * 2. Ruby VM gets notified about IO blocked operations and can pass them through <tt>Fiber.scheduler</tt>.
972
+ * So only <tt>async_*</tt> methods are compatible to event based schedulers like the async gem.
967
973
  */
968
974
  static VALUE
969
- pgconn_exec(int argc, VALUE *argv, VALUE self)
975
+ pgconn_sync_exec(int argc, VALUE *argv, VALUE self)
970
976
  {
971
977
  t_pg_connection *this = pg_get_connection_safe( self );
972
978
  PGresult *result = NULL;
@@ -987,7 +993,7 @@ pgconn_exec(int argc, VALUE *argv, VALUE self)
987
993
  pg_deprecated(0, ("forwarding exec to exec_params is deprecated"));
988
994
 
989
995
  /* Otherwise, just call #exec_params instead for backward-compatibility */
990
- return pgconn_exec_params( argc, argv, self );
996
+ return pgconn_sync_exec_params( argc, argv, self );
991
997
 
992
998
  }
993
999
 
@@ -1019,7 +1025,7 @@ struct query_params_data {
1019
1025
  * Filled by alloc_query_params()
1020
1026
  */
1021
1027
 
1022
- /* Wraps the pointer of allocated memory, if function parameters dont't
1028
+ /* Wraps the pointer of allocated memory, if function parameters don't
1023
1029
  * fit in the memory_pool below.
1024
1030
  */
1025
1031
  VALUE heap_pool;
@@ -1037,7 +1043,7 @@ struct query_params_data {
1037
1043
  Oid *types;
1038
1044
 
1039
1045
  /* This array takes the string values for the timeframe of the query,
1040
- * if param value convertion is required
1046
+ * if param value conversion is required
1041
1047
  */
1042
1048
  VALUE gc_array;
1043
1049
 
@@ -1051,8 +1057,9 @@ struct query_params_data {
1051
1057
  };
1052
1058
 
1053
1059
  static void
1054
- free_typecast_heap_chain(struct linked_typecast_data *chain_entry)
1060
+ free_typecast_heap_chain(void *_chain_entry)
1055
1061
  {
1062
+ struct linked_typecast_data *chain_entry = (struct linked_typecast_data *)_chain_entry;
1056
1063
  while(chain_entry){
1057
1064
  struct linked_typecast_data *next = chain_entry->next;
1058
1065
  xfree(chain_entry);
@@ -1060,6 +1067,18 @@ free_typecast_heap_chain(struct linked_typecast_data *chain_entry)
1060
1067
  }
1061
1068
  }
1062
1069
 
1070
+ static const rb_data_type_t pg_typecast_buffer_type = {
1071
+ "PG::Connection typecast buffer chain",
1072
+ {
1073
+ (RUBY_DATA_FUNC) NULL,
1074
+ free_typecast_heap_chain,
1075
+ (size_t (*)(const void *))NULL,
1076
+ },
1077
+ 0,
1078
+ 0,
1079
+ RUBY_TYPED_FREE_IMMEDIATELY,
1080
+ };
1081
+
1063
1082
  static char *
1064
1083
  alloc_typecast_buf( VALUE *typecast_heap_chain, int len )
1065
1084
  {
@@ -1070,17 +1089,28 @@ alloc_typecast_buf( VALUE *typecast_heap_chain, int len )
1070
1089
  /* Did we already wrap a memory chain per T_DATA object? */
1071
1090
  if( NIL_P( *typecast_heap_chain ) ){
1072
1091
  /* Leave free'ing of the buffer chain to the GC, when paramsData has left the stack */
1073
- *typecast_heap_chain = Data_Wrap_Struct( rb_cObject, NULL, free_typecast_heap_chain, allocated );
1092
+ *typecast_heap_chain = TypedData_Wrap_Struct( rb_cObject, &pg_typecast_buffer_type, allocated );
1074
1093
  allocated->next = NULL;
1075
1094
  } else {
1076
1095
  /* Append to the chain */
1077
- allocated->next = DATA_PTR( *typecast_heap_chain );
1078
- DATA_PTR( *typecast_heap_chain ) = allocated;
1096
+ allocated->next = RTYPEDDATA_DATA( *typecast_heap_chain );
1097
+ RTYPEDDATA_DATA( *typecast_heap_chain ) = allocated;
1079
1098
  }
1080
1099
 
1081
1100
  return &allocated->data[0];
1082
1101
  }
1083
1102
 
1103
+ static const rb_data_type_t pg_query_heap_pool_type = {
1104
+ "PG::Connection query heap pool",
1105
+ {
1106
+ (RUBY_DATA_FUNC) NULL,
1107
+ RUBY_TYPED_DEFAULT_FREE,
1108
+ (size_t (*)(const void *))NULL,
1109
+ },
1110
+ 0,
1111
+ 0,
1112
+ RUBY_TYPED_FREE_IMMEDIATELY,
1113
+ };
1084
1114
 
1085
1115
  static int
1086
1116
  alloc_query_params(struct query_params_data *paramsData)
@@ -1095,7 +1125,7 @@ alloc_query_params(struct query_params_data *paramsData)
1095
1125
 
1096
1126
  Check_Type(paramsData->params, T_ARRAY);
1097
1127
 
1098
- p_typemap = DATA_PTR( paramsData->typemap );
1128
+ p_typemap = RTYPEDDATA_DATA( paramsData->typemap );
1099
1129
  p_typemap->funcs.fit_to_query( paramsData->typemap, paramsData->params );
1100
1130
 
1101
1131
  paramsData->heap_pool = Qnil;
@@ -1114,7 +1144,7 @@ alloc_query_params(struct query_params_data *paramsData)
1114
1144
  /* Allocate one combined memory pool for all possible function parameters */
1115
1145
  memory_pool = (char*)xmalloc( required_pool_size );
1116
1146
  /* Leave free'ing of the buffer to the GC, when paramsData has left the stack */
1117
- paramsData->heap_pool = Data_Wrap_Struct( rb_cObject, NULL, -1, memory_pool );
1147
+ paramsData->heap_pool = TypedData_Wrap_Struct( rb_cObject, &pg_query_heap_pool_type, memory_pool );
1118
1148
  required_pool_size = 0;
1119
1149
  }else{
1120
1150
  /* Use stack memory for function parameters */
@@ -1227,12 +1257,11 @@ pgconn_query_assign_typemap( VALUE self, struct query_params_data *paramsData )
1227
1257
  /* Use default typemap for queries. It's type is checked when assigned. */
1228
1258
  paramsData->typemap = pg_get_connection(self)->type_map_for_queries;
1229
1259
  }else{
1260
+ t_typemap *tm;
1261
+ UNUSED(tm);
1262
+
1230
1263
  /* Check type of method param */
1231
- if ( !rb_obj_is_kind_of(paramsData->typemap, rb_cTypeMap) ) {
1232
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::TypeMap)",
1233
- rb_obj_classname( paramsData->typemap ) );
1234
- }
1235
- Check_Type( paramsData->typemap, T_DATA );
1264
+ TypedData_Get_Struct(paramsData->typemap, t_typemap, &pg_typemap_type, tm);
1236
1265
  }
1237
1266
  }
1238
1267
 
@@ -1246,7 +1275,7 @@ pgconn_query_assign_typemap( VALUE self, struct query_params_data *paramsData )
1246
1275
  * It's not recommended to use explicit sync or async variants but #exec_params instead, unless you have a good reason to do so.
1247
1276
  */
1248
1277
  static VALUE
1249
- pgconn_exec_params( int argc, VALUE *argv, VALUE self )
1278
+ pgconn_sync_exec_params( int argc, VALUE *argv, VALUE self )
1250
1279
  {
1251
1280
  t_pg_connection *this = pg_get_connection_safe( self );
1252
1281
  PGresult *result = NULL;
@@ -1266,7 +1295,7 @@ pgconn_exec_params( int argc, VALUE *argv, VALUE self )
1266
1295
  */
1267
1296
  if ( NIL_P(paramsData.params) ) {
1268
1297
  pg_deprecated(1, ("forwarding exec_params to exec is deprecated"));
1269
- return pgconn_exec( 1, argv, self );
1298
+ return pgconn_sync_exec( 1, argv, self );
1270
1299
  }
1271
1300
  pgconn_query_assign_typemap( self, &paramsData );
1272
1301
 
@@ -1297,7 +1326,7 @@ pgconn_exec_params( int argc, VALUE *argv, VALUE self )
1297
1326
  * It's not recommended to use explicit sync or async variants but #prepare instead, unless you have a good reason to do so.
1298
1327
  */
1299
1328
  static VALUE
1300
- pgconn_prepare(int argc, VALUE *argv, VALUE self)
1329
+ pgconn_sync_prepare(int argc, VALUE *argv, VALUE self)
1301
1330
  {
1302
1331
  t_pg_connection *this = pg_get_connection_safe( self );
1303
1332
  PGresult *result = NULL;
@@ -1346,7 +1375,7 @@ pgconn_prepare(int argc, VALUE *argv, VALUE self)
1346
1375
  * It's not recommended to use explicit sync or async variants but #exec_prepared instead, unless you have a good reason to do so.
1347
1376
  */
1348
1377
  static VALUE
1349
- pgconn_exec_prepared(int argc, VALUE *argv, VALUE self)
1378
+ pgconn_sync_exec_prepared(int argc, VALUE *argv, VALUE self)
1350
1379
  {
1351
1380
  t_pg_connection *this = pg_get_connection_safe( self );
1352
1381
  PGresult *result = NULL;
@@ -1391,7 +1420,7 @@ pgconn_exec_prepared(int argc, VALUE *argv, VALUE self)
1391
1420
  * It's not recommended to use explicit sync or async variants but #describe_prepared instead, unless you have a good reason to do so.
1392
1421
  */
1393
1422
  static VALUE
1394
- pgconn_describe_prepared(VALUE self, VALUE stmt_name)
1423
+ pgconn_sync_describe_prepared(VALUE self, VALUE stmt_name)
1395
1424
  {
1396
1425
  PGresult *result;
1397
1426
  VALUE rb_pgresult;
@@ -1419,7 +1448,7 @@ pgconn_describe_prepared(VALUE self, VALUE stmt_name)
1419
1448
  * It's not recommended to use explicit sync or async variants but #describe_portal instead, unless you have a good reason to do so.
1420
1449
  */
1421
1450
  static VALUE
1422
- pgconn_describe_portal(self, stmt_name)
1451
+ pgconn_sync_describe_portal(self, stmt_name)
1423
1452
  VALUE self, stmt_name;
1424
1453
  {
1425
1454
  PGresult *result;
@@ -1454,6 +1483,9 @@ pgconn_describe_portal(self, stmt_name)
1454
1483
  * * +PGRES_NONFATAL_ERROR+
1455
1484
  * * +PGRES_FATAL_ERROR+
1456
1485
  * * +PGRES_COPY_BOTH+
1486
+ * * +PGRES_SINGLE_TUPLE+
1487
+ * * +PGRES_PIPELINE_SYNC+
1488
+ * * +PGRES_PIPELINE_ABORTED+
1457
1489
  */
1458
1490
  static VALUE
1459
1491
  pgconn_make_empty_pgresult(VALUE self, VALUE status)
@@ -1750,6 +1782,7 @@ pgconn_send_query(int argc, VALUE *argv, VALUE self)
1750
1782
  rb_iv_set(error, "@connection", self);
1751
1783
  rb_exc_raise(error);
1752
1784
  }
1785
+ pgconn_wait_for_flush( self );
1753
1786
  return Qnil;
1754
1787
  }
1755
1788
 
@@ -1779,7 +1812,7 @@ pgconn_send_query(int argc, VALUE *argv, VALUE self)
1779
1812
  * or, it may be a String. If it is a string, that is equivalent to the hash:
1780
1813
  * { :value => <string value>, :type => 0, :format => 0 }
1781
1814
  *
1782
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
1815
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
1783
1816
  * inside the SQL query. The 0th element of the +params+ array is bound
1784
1817
  * to $1, the 1st element is bound to $2, etc. +nil+ is treated as +NULL+.
1785
1818
  *
@@ -1827,6 +1860,7 @@ pgconn_send_query_params(int argc, VALUE *argv, VALUE self)
1827
1860
  rb_iv_set(error, "@connection", self);
1828
1861
  rb_exc_raise(error);
1829
1862
  }
1863
+ pgconn_wait_for_flush( self );
1830
1864
  return Qnil;
1831
1865
  }
1832
1866
 
@@ -1847,7 +1881,7 @@ pgconn_send_query_params(int argc, VALUE *argv, VALUE self)
1847
1881
  *
1848
1882
  * For example: "SELECT $1::int"
1849
1883
  *
1850
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
1884
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
1851
1885
  * inside the SQL query.
1852
1886
  */
1853
1887
  static VALUE
@@ -1890,6 +1924,7 @@ pgconn_send_prepare(int argc, VALUE *argv, VALUE self)
1890
1924
  rb_iv_set(error, "@connection", self);
1891
1925
  rb_exc_raise(error);
1892
1926
  }
1927
+ pgconn_wait_for_flush( self );
1893
1928
  return Qnil;
1894
1929
  }
1895
1930
 
@@ -1911,7 +1946,7 @@ pgconn_send_prepare(int argc, VALUE *argv, VALUE self)
1911
1946
  * or, it may be a String. If it is a string, that is equivalent to the hash:
1912
1947
  * { :value => <string value>, :format => 0 }
1913
1948
  *
1914
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
1949
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
1915
1950
  * inside the SQL query. The 0th element of the +params+ array is bound
1916
1951
  * to $1, the 1st element is bound to $2, etc. +nil+ is treated as +NULL+.
1917
1952
  *
@@ -1941,7 +1976,6 @@ pgconn_send_query_prepared(int argc, VALUE *argv, VALUE self)
1941
1976
 
1942
1977
  if(NIL_P(paramsData.params)) {
1943
1978
  paramsData.params = rb_ary_new2(0);
1944
- resultFormat = 0;
1945
1979
  }
1946
1980
  pgconn_query_assign_typemap( self, &paramsData );
1947
1981
 
@@ -1959,6 +1993,7 @@ pgconn_send_query_prepared(int argc, VALUE *argv, VALUE self)
1959
1993
  rb_iv_set(error, "@connection", self);
1960
1994
  rb_exc_raise(error);
1961
1995
  }
1996
+ pgconn_wait_for_flush( self );
1962
1997
  return Qnil;
1963
1998
  }
1964
1999
 
@@ -1980,6 +2015,7 @@ pgconn_send_describe_prepared(VALUE self, VALUE stmt_name)
1980
2015
  rb_iv_set(error, "@connection", self);
1981
2016
  rb_exc_raise(error);
1982
2017
  }
2018
+ pgconn_wait_for_flush( self );
1983
2019
  return Qnil;
1984
2020
  }
1985
2021
 
@@ -2002,28 +2038,13 @@ pgconn_send_describe_portal(VALUE self, VALUE portal)
2002
2038
  rb_iv_set(error, "@connection", self);
2003
2039
  rb_exc_raise(error);
2004
2040
  }
2041
+ pgconn_wait_for_flush( self );
2005
2042
  return Qnil;
2006
2043
  }
2007
2044
 
2008
2045
 
2009
- /*
2010
- * call-seq:
2011
- * conn.get_result() -> PG::Result
2012
- * conn.get_result() {|pg_result| block }
2013
- *
2014
- * Blocks waiting for the next result from a call to
2015
- * #send_query (or another asynchronous command), and returns
2016
- * it. Returns +nil+ if no more results are available.
2017
- *
2018
- * Note: call this function repeatedly until it returns +nil+, or else
2019
- * you will not be able to issue further commands.
2020
- *
2021
- * If the optional code block is given, it will be passed <i>result</i> as an argument,
2022
- * and the PG::Result object will automatically be cleared when the block terminates.
2023
- * In this instance, <code>conn.exec</code> returns the value of the block.
2024
- */
2025
2046
  static VALUE
2026
- pgconn_get_result(VALUE self)
2047
+ pgconn_sync_get_result(VALUE self)
2027
2048
  {
2028
2049
  PGconn *conn = pg_get_pgconn(self);
2029
2050
  PGresult *result;
@@ -2056,6 +2077,7 @@ pgconn_consume_input(self)
2056
2077
  PGconn *conn = pg_get_pgconn(self);
2057
2078
  /* returns 0 on error */
2058
2079
  if(PQconsumeInput(conn) == 0) {
2080
+ pgconn_close_socket_io(self);
2059
2081
  error = rb_exc_new2(rb_eConnectionBad, PQerrorMessage(conn));
2060
2082
  rb_iv_set(error, "@connection", self);
2061
2083
  rb_exc_raise(error);
@@ -2068,7 +2090,7 @@ pgconn_consume_input(self)
2068
2090
  * conn.is_busy() -> Boolean
2069
2091
  *
2070
2092
  * Returns +true+ if a command is busy, that is, if
2071
- * PQgetResult would block. Otherwise returns +false+.
2093
+ * #get_result would block. Otherwise returns +false+.
2072
2094
  */
2073
2095
  static VALUE
2074
2096
  pgconn_is_busy(self)
@@ -2077,24 +2099,8 @@ pgconn_is_busy(self)
2077
2099
  return gvl_PQisBusy(pg_get_pgconn(self)) ? Qtrue : Qfalse;
2078
2100
  }
2079
2101
 
2080
- /*
2081
- * call-seq:
2082
- * conn.setnonblocking(Boolean) -> nil
2083
- *
2084
- * Sets the nonblocking status of the connection.
2085
- * In the blocking state, calls to #send_query
2086
- * will block until the message is sent to the server,
2087
- * but will not wait for the query results.
2088
- * In the nonblocking state, calls to #send_query
2089
- * will return an error if the socket is not ready for
2090
- * writing.
2091
- * Note: This function does not affect #exec, because
2092
- * that function doesn't return until the server has
2093
- * processed the query and returned the results.
2094
- * Returns +nil+.
2095
- */
2096
2102
  static VALUE
2097
- pgconn_setnonblocking(self, state)
2103
+ pgconn_sync_setnonblocking(self, state)
2098
2104
  VALUE self, state;
2099
2105
  {
2100
2106
  int arg;
@@ -2116,33 +2122,15 @@ pgconn_setnonblocking(self, state)
2116
2122
  }
2117
2123
 
2118
2124
 
2119
- /*
2120
- * call-seq:
2121
- * conn.isnonblocking() -> Boolean
2122
- *
2123
- * Returns +true+ if a command is busy, that is, if
2124
- * PQgetResult would block. Otherwise returns +false+.
2125
- */
2126
2125
  static VALUE
2127
- pgconn_isnonblocking(self)
2126
+ pgconn_sync_isnonblocking(self)
2128
2127
  VALUE self;
2129
2128
  {
2130
2129
  return PQisnonblocking(pg_get_pgconn(self)) ? Qtrue : Qfalse;
2131
2130
  }
2132
2131
 
2133
- /*
2134
- * call-seq:
2135
- * conn.flush() -> Boolean
2136
- *
2137
- * Attempts to flush any queued output data to the server.
2138
- * Returns +true+ if data is successfully flushed, +false+
2139
- * if not (can only return +false+ if connection is
2140
- * nonblocking.
2141
- * Raises PG::Error if some other failure occurred.
2142
- */
2143
2132
  static VALUE
2144
- pgconn_flush(self)
2145
- VALUE self;
2133
+ pgconn_sync_flush(VALUE self)
2146
2134
  {
2147
2135
  PGconn *conn = pg_get_pgconn(self);
2148
2136
  int ret;
@@ -2156,18 +2144,8 @@ pgconn_flush(self)
2156
2144
  return (ret) ? Qfalse : Qtrue;
2157
2145
  }
2158
2146
 
2159
- /*
2160
- * call-seq:
2161
- * conn.cancel() -> String
2162
- *
2163
- * Requests cancellation of the command currently being
2164
- * processed. (Only implemented in PostgreSQL >= 8.0)
2165
- *
2166
- * Returns +nil+ on success, or a string containing the
2167
- * error message if a failure occurs.
2168
- */
2169
2147
  static VALUE
2170
- pgconn_cancel(VALUE self)
2148
+ pgconn_sync_cancel(VALUE self)
2171
2149
  {
2172
2150
  char errbuf[256];
2173
2151
  PGcancel *cancel;
@@ -2178,7 +2156,7 @@ pgconn_cancel(VALUE self)
2178
2156
  if(cancel == NULL)
2179
2157
  rb_raise(rb_ePGerror,"Invalid connection!");
2180
2158
 
2181
- ret = gvl_PQcancel(cancel, errbuf, 256);
2159
+ ret = gvl_PQcancel(cancel, errbuf, sizeof(errbuf));
2182
2160
  if(ret == 1)
2183
2161
  retval = Qnil;
2184
2162
  else
@@ -2229,55 +2207,63 @@ pgconn_notifies(VALUE self)
2229
2207
  return hash;
2230
2208
  }
2231
2209
 
2232
- /* Win32 + Ruby 1.9+ */
2233
- #if defined( _WIN32 )
2234
- /*
2235
- * On Windows, use platform-specific strategies to wait for the socket
2236
- * instead of rb_wait_for_single_fd().
2210
+ #if defined(_WIN32)
2211
+
2212
+ /* We use a specialized implementation of rb_io_wait() on Windows.
2213
+ * This is because rb_io_wait() and rb_wait_for_single_fd() are very slow on Windows.
2237
2214
  */
2238
2215
 
2216
+ #if defined(HAVE_RUBY_FIBER_SCHEDULER_H)
2217
+ #include <ruby/fiber/scheduler.h>
2218
+ #endif
2219
+
2220
+ typedef enum {
2221
+ PG_RUBY_IO_READABLE = RB_WAITFD_IN,
2222
+ PG_RUBY_IO_WRITABLE = RB_WAITFD_OUT,
2223
+ PG_RUBY_IO_PRIORITY = RB_WAITFD_PRI,
2224
+ } pg_rb_io_event_t;
2225
+
2239
2226
  int rb_w32_wait_events( HANDLE *events, int num, DWORD timeout );
2240
2227
 
2241
- static void *
2242
- wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readable)(PGconn *) )
2243
- {
2244
- int sd = PQsocket( conn );
2245
- void *retval;
2228
+ static VALUE
2229
+ pg_rb_thread_io_wait(VALUE io, VALUE events, VALUE timeout) {
2230
+ rb_io_t *fptr;
2231
+ struct timeval ptimeout;
2232
+
2246
2233
  struct timeval aborttime={0,0}, currtime, waittime;
2247
2234
  DWORD timeout_milisec = INFINITE;
2248
- DWORD wait_ret;
2249
- WSAEVENT hEvent;
2235
+ HANDLE hEvent = WSACreateEvent();
2250
2236
 
2251
- if ( sd < 0 )
2252
- rb_raise(rb_eConnectionBad, "PQsocket() can't get socket descriptor");
2253
-
2254
- hEvent = WSACreateEvent();
2237
+ long rb_events = NUM2UINT(events);
2238
+ long w32_events = 0;
2239
+ DWORD wait_ret;
2255
2240
 
2256
- /* Check for connection errors (PQisBusy is true on connection errors) */
2257
- if( PQconsumeInput(conn) == 0 ) {
2258
- WSACloseEvent( hEvent );
2259
- rb_raise( rb_eConnectionBad, "PQconsumeInput() %s", PQerrorMessage(conn) );
2260
- }
2241
+ GetOpenFile((io), fptr);
2242
+ if( !NIL_P(timeout) ){
2243
+ ptimeout.tv_sec = (time_t)(NUM2DBL(timeout));
2244
+ ptimeout.tv_usec = (time_t)((NUM2DBL(timeout) - (double)ptimeout.tv_sec) * 1e6);
2261
2245
 
2262
- if ( ptimeout ) {
2263
2246
  gettimeofday(&currtime, NULL);
2264
- timeradd(&currtime, ptimeout, &aborttime);
2247
+ timeradd(&currtime, &ptimeout, &aborttime);
2265
2248
  }
2266
2249
 
2267
- while ( !(retval=is_readable(conn)) ) {
2268
- if ( WSAEventSelect(sd, hEvent, FD_READ|FD_CLOSE) == SOCKET_ERROR ) {
2250
+ if(rb_events & PG_RUBY_IO_READABLE) w32_events |= FD_READ | FD_ACCEPT | FD_CLOSE;
2251
+ if(rb_events & PG_RUBY_IO_WRITABLE) w32_events |= FD_WRITE | FD_CONNECT;
2252
+ if(rb_events & PG_RUBY_IO_PRIORITY) w32_events |= FD_OOB;
2253
+
2254
+ for(;;) {
2255
+ if ( WSAEventSelect(_get_osfhandle(fptr->fd), hEvent, w32_events) == SOCKET_ERROR ) {
2269
2256
  WSACloseEvent( hEvent );
2270
2257
  rb_raise( rb_eConnectionBad, "WSAEventSelect socket error: %d", WSAGetLastError() );
2271
2258
  }
2272
2259
 
2273
- if ( ptimeout ) {
2260
+ if ( !NIL_P(timeout) ) {
2274
2261
  gettimeofday(&currtime, NULL);
2275
2262
  timersub(&aborttime, &currtime, &waittime);
2276
2263
  timeout_milisec = (DWORD)( waittime.tv_sec * 1e3 + waittime.tv_usec / 1e3 );
2277
2264
  }
2278
2265
 
2279
- /* Is the given timeout valid? */
2280
- if( !ptimeout || (waittime.tv_sec >= 0 && waittime.tv_usec >= 0) ){
2266
+ if( NIL_P(timeout) || (waittime.tv_sec >= 0 && waittime.tv_usec >= 0) ){
2281
2267
  /* Wait for the socket to become readable before checking again */
2282
2268
  wait_ret = rb_w32_wait_events( &hEvent, 1, timeout_milisec );
2283
2269
  } else {
@@ -2286,9 +2272,11 @@ wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readabl
2286
2272
 
2287
2273
  if ( wait_ret == WAIT_TIMEOUT ) {
2288
2274
  WSACloseEvent( hEvent );
2289
- return NULL;
2275
+ return UINT2NUM(0);
2290
2276
  } else if ( wait_ret == WAIT_OBJECT_0 ) {
2277
+ WSACloseEvent( hEvent );
2291
2278
  /* The event we were waiting for. */
2279
+ return UINT2NUM(rb_events);
2292
2280
  } else if ( wait_ret == WAIT_OBJECT_0 + 1) {
2293
2281
  /* This indicates interruption from timer thread, GC, exception
2294
2282
  * from other threads etc... */
@@ -2300,36 +2288,75 @@ wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readabl
2300
2288
  WSACloseEvent( hEvent );
2301
2289
  rb_raise( rb_eConnectionBad, "Wait on socket abandoned (WaitForMultipleObjects)" );
2302
2290
  }
2303
-
2304
- /* Check for connection errors (PQisBusy is true on connection errors) */
2305
- if ( PQconsumeInput(conn) == 0 ) {
2306
- WSACloseEvent( hEvent );
2307
- rb_raise( rb_eConnectionBad, "PQconsumeInput() %s", PQerrorMessage(conn) );
2308
- }
2309
2291
  }
2292
+ }
2310
2293
 
2311
- WSACloseEvent( hEvent );
2312
- return retval;
2294
+ static VALUE
2295
+ pg_rb_io_wait(VALUE io, VALUE events, VALUE timeout) {
2296
+ #if defined(HAVE_RUBY_FIBER_SCHEDULER_H)
2297
+ /* We don't support Fiber.scheduler on Windows ruby-3.0 because there is no fast way to check whether a scheduler is active.
2298
+ * Fortunatelly ruby-3.1 offers a C-API for it.
2299
+ */
2300
+ VALUE scheduler = rb_fiber_scheduler_current();
2301
+
2302
+ if (!NIL_P(scheduler)) {
2303
+ return rb_io_wait(io, events, timeout);
2304
+ }
2305
+ #endif
2306
+ return pg_rb_thread_io_wait(io, events, timeout);
2313
2307
  }
2314
2308
 
2309
+ #elif defined(HAVE_RB_IO_WAIT)
2310
+
2311
+ /* Use our own function and constants names, to avoid conflicts with truffleruby-head on its road to ruby-3.0 compatibility. */
2312
+ #define pg_rb_io_wait rb_io_wait
2313
+ #define PG_RUBY_IO_READABLE RUBY_IO_READABLE
2314
+ #define PG_RUBY_IO_WRITABLE RUBY_IO_WRITABLE
2315
+ #define PG_RUBY_IO_PRIORITY RUBY_IO_PRIORITY
2316
+
2315
2317
  #else
2318
+ /* For compat with ruby < 3.0 */
2319
+
2320
+ typedef enum {
2321
+ PG_RUBY_IO_READABLE = RB_WAITFD_IN,
2322
+ PG_RUBY_IO_WRITABLE = RB_WAITFD_OUT,
2323
+ PG_RUBY_IO_PRIORITY = RB_WAITFD_PRI,
2324
+ } pg_rb_io_event_t;
2325
+
2326
+ static VALUE
2327
+ pg_rb_io_wait(VALUE io, VALUE events, VALUE timeout) {
2328
+ rb_io_t *fptr;
2329
+ struct timeval waittime;
2330
+ int res;
2331
+
2332
+ GetOpenFile((io), fptr);
2333
+ if( !NIL_P(timeout) ){
2334
+ waittime.tv_sec = (time_t)(NUM2DBL(timeout));
2335
+ waittime.tv_usec = (time_t)((NUM2DBL(timeout) - (double)waittime.tv_sec) * 1e6);
2336
+ }
2337
+ res = rb_wait_for_single_fd(fptr->fd, NUM2UINT(events), NIL_P(timeout) ? NULL : &waittime);
2316
2338
 
2317
- /* non Win32 */
2339
+ return UINT2NUM(res);
2340
+ }
2341
+ #endif
2318
2342
 
2319
2343
  static void *
2320
- wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readable)(PGconn *))
2344
+ wait_socket_readable( VALUE self, struct timeval *ptimeout, void *(*is_readable)(PGconn *))
2321
2345
  {
2322
- int sd = PQsocket( conn );
2323
- int ret;
2346
+ VALUE socket_io;
2347
+ VALUE ret;
2324
2348
  void *retval;
2325
2349
  struct timeval aborttime={0,0}, currtime, waittime;
2350
+ VALUE wait_timeout = Qnil;
2351
+ PGconn *conn = pg_get_pgconn(self);
2326
2352
 
2327
- if ( sd < 0 )
2328
- rb_raise(rb_eConnectionBad, "PQsocket() can't get socket descriptor");
2353
+ socket_io = pgconn_socket_io(self);
2329
2354
 
2330
2355
  /* Check for connection errors (PQisBusy is true on connection errors) */
2331
- if ( PQconsumeInput(conn) == 0 )
2356
+ if ( PQconsumeInput(conn) == 0 ) {
2357
+ pgconn_close_socket_io(self);
2332
2358
  rb_raise( rb_eConnectionBad, "PQconsumeInput() %s", PQerrorMessage(conn) );
2359
+ }
2333
2360
 
2334
2361
  if ( ptimeout ) {
2335
2362
  gettimeofday(&currtime, NULL);
@@ -2340,27 +2367,25 @@ wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readabl
2340
2367
  if ( ptimeout ) {
2341
2368
  gettimeofday(&currtime, NULL);
2342
2369
  timersub(&aborttime, &currtime, &waittime);
2370
+ wait_timeout = DBL2NUM((double)(waittime.tv_sec) + (double)(waittime.tv_usec) / 1000000.0);
2343
2371
  }
2344
2372
 
2345
2373
  /* Is the given timeout valid? */
2346
2374
  if( !ptimeout || (waittime.tv_sec >= 0 && waittime.tv_usec >= 0) ){
2347
2375
  /* Wait for the socket to become readable before checking again */
2348
- ret = rb_wait_for_single_fd( sd, RB_WAITFD_IN, ptimeout ? &waittime : NULL );
2376
+ ret = pg_rb_io_wait(socket_io, RB_INT2NUM(PG_RUBY_IO_READABLE), wait_timeout);
2349
2377
  } else {
2350
- ret = 0;
2351
- }
2352
-
2353
- if ( ret < 0 ){
2354
- rb_sys_fail( "rb_wait_for_single_fd()" );
2378
+ ret = Qfalse;
2355
2379
  }
2356
2380
 
2357
2381
  /* Return false if the select() timed out */
2358
- if ( ret == 0 ){
2382
+ if ( ret == Qfalse ){
2359
2383
  return NULL;
2360
2384
  }
2361
2385
 
2362
2386
  /* Check for connection errors (PQisBusy is true on connection errors) */
2363
2387
  if ( PQconsumeInput(conn) == 0 ){
2388
+ pgconn_close_socket_io(self);
2364
2389
  rb_raise( rb_eConnectionBad, "PQconsumeInput() %s", PQerrorMessage(conn) );
2365
2390
  }
2366
2391
  }
@@ -2368,8 +2393,45 @@ wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readabl
2368
2393
  return retval;
2369
2394
  }
2370
2395
 
2396
+ /*
2397
+ * call-seq:
2398
+ * conn.flush() -> Boolean
2399
+ *
2400
+ * Attempts to flush any queued output data to the server.
2401
+ * Returns +true+ if data is successfully flushed, +false+
2402
+ * if not (can only return +false+ if connection is
2403
+ * nonblocking.
2404
+ * Raises PG::Error if some other failure occurred.
2405
+ */
2406
+ static VALUE
2407
+ pgconn_async_flush(VALUE self)
2408
+ {
2409
+ while( pgconn_sync_flush(self) == Qfalse ){
2410
+ /* wait for the socket to become read- or write-ready */
2411
+ int events;
2412
+ VALUE socket_io = pgconn_socket_io(self);
2413
+ events = RB_NUM2INT(pg_rb_io_wait(socket_io, RB_INT2NUM(PG_RUBY_IO_READABLE | PG_RUBY_IO_WRITABLE), Qnil));
2371
2414
 
2372
- #endif
2415
+ if (events & PG_RUBY_IO_READABLE)
2416
+ pgconn_consume_input(self);
2417
+ }
2418
+ return Qtrue;
2419
+ }
2420
+
2421
+ static VALUE
2422
+ pgconn_wait_for_flush( VALUE self ){
2423
+ if( !pg_get_connection_safe(self)->flush_data )
2424
+ return Qnil;
2425
+
2426
+ return pgconn_async_flush(self);
2427
+ }
2428
+
2429
+ static VALUE
2430
+ pgconn_flush_data_set( VALUE self, VALUE enabled ){
2431
+ t_pg_connection *conn = pg_get_connection(self);
2432
+ conn->flush_data = RTEST(enabled);
2433
+ return enabled;
2434
+ }
2373
2435
 
2374
2436
  static void *
2375
2437
  notify_readable(PGconn *conn)
@@ -2408,7 +2470,7 @@ pgconn_wait_for_notify(int argc, VALUE *argv, VALUE self)
2408
2470
  ptimeout = &timeout;
2409
2471
  }
2410
2472
 
2411
- pnotification = (PGnotify*) wait_socket_readable( this->pgconn, ptimeout, notify_readable);
2473
+ pnotification = (PGnotify*) wait_socket_readable( self, ptimeout, notify_readable);
2412
2474
 
2413
2475
  /* Return nil if the select timed out */
2414
2476
  if ( !pnotification ) return Qnil;
@@ -2429,28 +2491,8 @@ pgconn_wait_for_notify(int argc, VALUE *argv, VALUE self)
2429
2491
  }
2430
2492
 
2431
2493
 
2432
- /*
2433
- * call-seq:
2434
- * conn.put_copy_data( buffer [, encoder] ) -> Boolean
2435
- *
2436
- * Transmits _buffer_ as copy data to the server.
2437
- * Returns true if the data was sent, false if it was
2438
- * not sent (false is only possible if the connection
2439
- * is in nonblocking mode, and this command would block).
2440
- *
2441
- * _encoder_ can be a PG::Coder derivation (typically PG::TextEncoder::CopyRow).
2442
- * This encodes the data fields given as _buffer_ from an Array of Strings to
2443
- * PostgreSQL's COPY text format inclusive proper escaping. Optionally
2444
- * the encoder can type cast the fields from various Ruby types in one step,
2445
- * if PG::TextEncoder::CopyRow#type_map is set accordingly.
2446
- *
2447
- * Raises an exception if an error occurs.
2448
- *
2449
- * See also #copy_data.
2450
- *
2451
- */
2452
2494
  static VALUE
2453
- pgconn_put_copy_data(int argc, VALUE *argv, VALUE self)
2495
+ pgconn_sync_put_copy_data(int argc, VALUE *argv, VALUE self)
2454
2496
  {
2455
2497
  int ret;
2456
2498
  int len;
@@ -2467,13 +2509,11 @@ pgconn_put_copy_data(int argc, VALUE *argv, VALUE self)
2467
2509
  if( NIL_P(this->encoder_for_put_copy_data) ){
2468
2510
  buffer = value;
2469
2511
  } else {
2470
- p_coder = DATA_PTR( this->encoder_for_put_copy_data );
2512
+ p_coder = RTYPEDDATA_DATA( this->encoder_for_put_copy_data );
2471
2513
  }
2472
- } else if( rb_obj_is_kind_of(encoder, rb_cPG_Coder) ) {
2473
- Data_Get_Struct( encoder, t_pg_coder, p_coder );
2474
2514
  } else {
2475
- rb_raise( rb_eTypeError, "wrong encoder type %s (expected some kind of PG::Coder)",
2476
- rb_obj_classname( encoder ) );
2515
+ /* Check argument type and use argument encoder */
2516
+ TypedData_Get_Struct(encoder, t_pg_coder, &pg_coder_type, p_coder);
2477
2517
  }
2478
2518
 
2479
2519
  if( p_coder ){
@@ -2507,22 +2547,8 @@ pgconn_put_copy_data(int argc, VALUE *argv, VALUE self)
2507
2547
  return (ret) ? Qtrue : Qfalse;
2508
2548
  }
2509
2549
 
2510
- /*
2511
- * call-seq:
2512
- * conn.put_copy_end( [ error_message ] ) -> Boolean
2513
- *
2514
- * Sends end-of-data indication to the server.
2515
- *
2516
- * _error_message_ is an optional parameter, and if set,
2517
- * forces the COPY command to fail with the string
2518
- * _error_message_.
2519
- *
2520
- * Returns true if the end-of-data was sent, false if it was
2521
- * not sent (false is only possible if the connection
2522
- * is in nonblocking mode, and this command would block).
2523
- */
2524
2550
  static VALUE
2525
- pgconn_put_copy_end(int argc, VALUE *argv, VALUE self)
2551
+ pgconn_sync_put_copy_end(int argc, VALUE *argv, VALUE self)
2526
2552
  {
2527
2553
  VALUE str;
2528
2554
  VALUE error;
@@ -2544,27 +2570,8 @@ pgconn_put_copy_end(int argc, VALUE *argv, VALUE self)
2544
2570
  return (ret) ? Qtrue : Qfalse;
2545
2571
  }
2546
2572
 
2547
- /*
2548
- * call-seq:
2549
- * conn.get_copy_data( [ async = false [, decoder = nil ]] ) -> Object
2550
- *
2551
- * Return one row of data, +nil+
2552
- * if the copy is done, or +false+ if the call would
2553
- * block (only possible if _async_ is true).
2554
- *
2555
- * If _decoder_ is not set or +nil+, data is returned as binary string.
2556
- *
2557
- * If _decoder_ is set to a PG::Coder derivation, the return type depends on this decoder.
2558
- * PG::TextDecoder::CopyRow decodes the received data fields from one row of PostgreSQL's
2559
- * COPY text format to an Array of Strings.
2560
- * Optionally the decoder can type cast the single fields to various Ruby types in one step,
2561
- * if PG::TextDecoder::CopyRow#type_map is set accordingly.
2562
- *
2563
- * See also #copy_data.
2564
- *
2565
- */
2566
2573
  static VALUE
2567
- pgconn_get_copy_data(int argc, VALUE *argv, VALUE self )
2574
+ pgconn_sync_get_copy_data(int argc, VALUE *argv, VALUE self )
2568
2575
  {
2569
2576
  VALUE async_in;
2570
2577
  VALUE error;
@@ -2579,13 +2586,11 @@ pgconn_get_copy_data(int argc, VALUE *argv, VALUE self )
2579
2586
 
2580
2587
  if( NIL_P(decoder) ){
2581
2588
  if( !NIL_P(this->decoder_for_get_copy_data) ){
2582
- p_coder = DATA_PTR( this->decoder_for_get_copy_data );
2589
+ p_coder = RTYPEDDATA_DATA( this->decoder_for_get_copy_data );
2583
2590
  }
2584
- } else if( rb_obj_is_kind_of(decoder, rb_cPG_Coder) ) {
2585
- Data_Get_Struct( decoder, t_pg_coder, p_coder );
2586
2591
  } else {
2587
- rb_raise( rb_eTypeError, "wrong decoder type %s (expected some kind of PG::Coder)",
2588
- rb_obj_classname( decoder ) );
2592
+ /* Check argument type and use argument decoder */
2593
+ TypedData_Get_Struct(decoder, t_pg_coder, &pg_coder_type, p_coder);
2589
2594
  }
2590
2595
 
2591
2596
  ret = gvl_PQgetCopyData(this->pgconn, &buffer, RTEST(async_in));
@@ -2830,7 +2835,7 @@ notice_processor_proxy(void *arg, const char *message)
2830
2835
  * call-seq:
2831
2836
  * conn.set_notice_processor {|message| ... } -> Proc
2832
2837
  *
2833
- * See #set_notice_receiver for the desription of what this and the
2838
+ * See #set_notice_receiver for the description of what this and the
2834
2839
  * notice_processor methods do.
2835
2840
  *
2836
2841
  * This function takes a new block to act as the notice processor and returns
@@ -2884,12 +2889,14 @@ pgconn_get_client_encoding(VALUE self)
2884
2889
 
2885
2890
  /*
2886
2891
  * call-seq:
2887
- * conn.set_client_encoding( encoding )
2892
+ * conn.sync_set_client_encoding( encoding )
2888
2893
  *
2889
- * Sets the client encoding to the _encoding_ String.
2894
+ * This function has the same behavior as #async_set_client_encoding, but is implemented using the synchronous command processing API of libpq.
2895
+ * See #async_exec for the differences between the two API variants.
2896
+ * It's not recommended to use explicit sync or async variants but #set_client_encoding instead, unless you have a good reason to do so.
2890
2897
  */
2891
2898
  static VALUE
2892
- pgconn_set_client_encoding(VALUE self, VALUE str)
2899
+ pgconn_sync_set_client_encoding(VALUE self, VALUE str)
2893
2900
  {
2894
2901
  PGconn *conn = pg_get_pgconn( self );
2895
2902
 
@@ -2903,49 +2910,6 @@ pgconn_set_client_encoding(VALUE self, VALUE str)
2903
2910
  return Qnil;
2904
2911
  }
2905
2912
 
2906
- /*
2907
- * call-seq:
2908
- * conn.transaction { |conn| ... } -> result of the block
2909
- *
2910
- * Executes a +BEGIN+ at the start of the block,
2911
- * and a +COMMIT+ at the end of the block, or
2912
- * +ROLLBACK+ if any exception occurs.
2913
- */
2914
- static VALUE
2915
- pgconn_transaction(VALUE self)
2916
- {
2917
- PGconn *conn = pg_get_pgconn(self);
2918
- PGresult *result;
2919
- VALUE rb_pgresult;
2920
- VALUE block_result = Qnil;
2921
- int status;
2922
-
2923
- if (rb_block_given_p()) {
2924
- result = gvl_PQexec(conn, "BEGIN");
2925
- rb_pgresult = pg_new_result(result, self);
2926
- pg_result_check(rb_pgresult);
2927
- block_result = rb_protect(rb_yield, self, &status);
2928
- if(status == 0) {
2929
- result = gvl_PQexec(conn, "COMMIT");
2930
- rb_pgresult = pg_new_result(result, self);
2931
- pg_result_check(rb_pgresult);
2932
- }
2933
- else {
2934
- /* exception occurred, ROLLBACK and re-raise */
2935
- result = gvl_PQexec(conn, "ROLLBACK");
2936
- rb_pgresult = pg_new_result(result, self);
2937
- pg_result_check(rb_pgresult);
2938
- rb_jump_tag(status);
2939
- }
2940
-
2941
- }
2942
- else {
2943
- /* no block supplied? */
2944
- rb_raise(rb_eArgError, "Must supply block for PG::Connection#transaction");
2945
- }
2946
- return block_result;
2947
- }
2948
-
2949
2913
 
2950
2914
  /*
2951
2915
  * call-seq:
@@ -3022,8 +2986,6 @@ get_result_readable(PGconn *conn)
3022
2986
  */
3023
2987
  static VALUE
3024
2988
  pgconn_block( int argc, VALUE *argv, VALUE self ) {
3025
- PGconn *conn = pg_get_pgconn( self );
3026
-
3027
2989
  struct timeval timeout;
3028
2990
  struct timeval *ptimeout = NULL;
3029
2991
  VALUE timeout_in;
@@ -3037,7 +2999,7 @@ pgconn_block( int argc, VALUE *argv, VALUE self ) {
3037
2999
  ptimeout = &timeout;
3038
3000
  }
3039
3001
 
3040
- ret = wait_socket_readable( conn, ptimeout, get_result_readable);
3002
+ ret = wait_socket_readable( self, ptimeout, get_result_readable);
3041
3003
 
3042
3004
  if( !ret )
3043
3005
  return Qfalse;
@@ -3046,6 +3008,42 @@ pgconn_block( int argc, VALUE *argv, VALUE self ) {
3046
3008
  }
3047
3009
 
3048
3010
 
3011
+ /*
3012
+ * call-seq:
3013
+ * conn.sync_get_last_result( ) -> PG::Result
3014
+ *
3015
+ * This function has the same behavior as #async_get_last_result, but is implemented using the synchronous command processing API of libpq.
3016
+ * See #async_exec for the differences between the two API variants.
3017
+ * It's not recommended to use explicit sync or async variants but #get_last_result instead, unless you have a good reason to do so.
3018
+ */
3019
+ static VALUE
3020
+ pgconn_sync_get_last_result(VALUE self)
3021
+ {
3022
+ PGconn *conn = pg_get_pgconn(self);
3023
+ VALUE rb_pgresult = Qnil;
3024
+ PGresult *cur, *prev;
3025
+
3026
+
3027
+ cur = prev = NULL;
3028
+ while ((cur = gvl_PQgetResult(conn)) != NULL) {
3029
+ int status;
3030
+
3031
+ if (prev) PQclear(prev);
3032
+ prev = cur;
3033
+
3034
+ status = PQresultStatus(cur);
3035
+ if (status == PGRES_COPY_OUT || status == PGRES_COPY_IN || status == PGRES_COPY_BOTH)
3036
+ break;
3037
+ }
3038
+
3039
+ if (prev) {
3040
+ rb_pgresult = pg_new_result( prev, self );
3041
+ pg_result_check(rb_pgresult);
3042
+ }
3043
+
3044
+ return rb_pgresult;
3045
+ }
3046
+
3049
3047
  /*
3050
3048
  * call-seq:
3051
3049
  * conn.get_last_result( ) -> PG::Result
@@ -3056,27 +3054,35 @@ pgconn_block( int argc, VALUE *argv, VALUE self ) {
3056
3054
  * returns the last non-NULL result, or +nil+ if no
3057
3055
  * results are available.
3058
3056
  *
3057
+ * If the last result contains a bad result_status, an
3058
+ * appropriate exception is raised.
3059
+ *
3059
3060
  * This function is similar to #get_result
3060
3061
  * except that it is designed to get one and only
3061
- * one result.
3062
+ * one result and that it checks the result state.
3062
3063
  */
3063
3064
  static VALUE
3064
- pgconn_get_last_result(VALUE self)
3065
+ pgconn_async_get_last_result(VALUE self)
3065
3066
  {
3066
3067
  PGconn *conn = pg_get_pgconn(self);
3067
3068
  VALUE rb_pgresult = Qnil;
3068
3069
  PGresult *cur, *prev;
3069
3070
 
3070
-
3071
- cur = prev = NULL;
3072
- while ((cur = gvl_PQgetResult(conn)) != NULL) {
3071
+ cur = prev = NULL;
3072
+ for(;;) {
3073
3073
  int status;
3074
3074
 
3075
+ pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3076
+
3077
+ cur = gvl_PQgetResult(conn);
3078
+ if (cur == NULL)
3079
+ break;
3080
+
3075
3081
  if (prev) PQclear(prev);
3076
3082
  prev = cur;
3077
3083
 
3078
3084
  status = PQresultStatus(cur);
3079
- if (status == PGRES_COPY_OUT || status == PGRES_COPY_IN)
3085
+ if (status == PGRES_COPY_OUT || status == PGRES_COPY_IN || status == PGRES_COPY_BOTH)
3080
3086
  break;
3081
3087
  }
3082
3088
 
@@ -3100,22 +3106,60 @@ static VALUE
3100
3106
  pgconn_discard_results(VALUE self)
3101
3107
  {
3102
3108
  PGconn *conn = pg_get_pgconn(self);
3109
+ VALUE socket_io;
3103
3110
 
3104
- PGresult *cur;
3105
- while ((cur = gvl_PQgetResult(conn)) != NULL) {
3106
- int status = PQresultStatus(cur);
3111
+ if( PQtransactionStatus(conn) == PQTRANS_IDLE ) {
3112
+ return Qnil;
3113
+ }
3114
+
3115
+ socket_io = pgconn_socket_io(self);
3116
+
3117
+ for(;;) {
3118
+ PGresult *cur;
3119
+ int status;
3120
+
3121
+ /* pgconn_block() raises an exception in case of errors.
3122
+ * To avoid this call pg_rb_io_wait() and PQconsumeInput() without rb_raise().
3123
+ */
3124
+ while( gvl_PQisBusy(conn) ){
3125
+ pg_rb_io_wait(socket_io, RB_INT2NUM(PG_RUBY_IO_READABLE), Qnil);
3126
+ if ( PQconsumeInput(conn) == 0 ) {
3127
+ pgconn_close_socket_io(self);
3128
+ return Qfalse;
3129
+ }
3130
+ }
3131
+
3132
+ cur = gvl_PQgetResult(conn);
3133
+ if( cur == NULL) break;
3134
+
3135
+ status = PQresultStatus(cur);
3107
3136
  PQclear(cur);
3108
3137
  if (status == PGRES_COPY_IN){
3109
3138
  gvl_PQputCopyEnd(conn, "COPY terminated by new PQexec");
3110
3139
  }
3111
3140
  if (status == PGRES_COPY_OUT){
3112
- char *buffer = NULL;
3113
- while( gvl_PQgetCopyData(conn, &buffer, 0) > 0)
3114
- PQfreemem(buffer);
3141
+ for(;;) {
3142
+ char *buffer = NULL;
3143
+ int st = gvl_PQgetCopyData(conn, &buffer, 1);
3144
+ if( st == 0 ) {
3145
+ /* would block -> wait for readable data */
3146
+ pg_rb_io_wait(socket_io, RB_INT2NUM(PG_RUBY_IO_READABLE), Qnil);
3147
+ if ( PQconsumeInput(conn) == 0 ) {
3148
+ pgconn_close_socket_io(self);
3149
+ return Qfalse;
3150
+ }
3151
+ } else if( st > 0 ) {
3152
+ /* some data retrieved -> discard it */
3153
+ PQfreemem(buffer);
3154
+ } else {
3155
+ /* no more data */
3156
+ break;
3157
+ }
3158
+ }
3115
3159
  }
3116
3160
  }
3117
3161
 
3118
- return Qnil;
3162
+ return Qtrue;
3119
3163
  }
3120
3164
 
3121
3165
  /*
@@ -3138,6 +3182,7 @@ pgconn_discard_results(VALUE self)
3138
3182
  * #exec is an alias for #async_exec which is almost identical to #sync_exec .
3139
3183
  * #sync_exec is implemented on the simpler synchronous command processing API of libpq, whereas
3140
3184
  * #async_exec is implemented on the asynchronous API and on ruby's IO mechanisms.
3185
+ * Only #async_exec is compatible to <tt>Fiber.scheduler</tt> based asynchronous IO processing introduced in ruby-3.0.
3141
3186
  * Both methods ensure that other threads can process while waiting for the server to
3142
3187
  * complete the request, but #sync_exec blocks all signals to be processed until the query is finished.
3143
3188
  * This is most notably visible by a delayed reaction to Control+C.
@@ -3152,8 +3197,7 @@ pgconn_async_exec(int argc, VALUE *argv, VALUE self)
3152
3197
 
3153
3198
  pgconn_discard_results( self );
3154
3199
  pgconn_send_query( argc, argv, self );
3155
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3156
- rb_pgresult = pgconn_get_last_result( self );
3200
+ rb_pgresult = pgconn_async_get_last_result( self );
3157
3201
 
3158
3202
  if ( rb_block_given_p() ) {
3159
3203
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3182,7 +3226,7 @@ pgconn_async_exec(int argc, VALUE *argv, VALUE self)
3182
3226
  * or, it may be a String. If it is a string, that is equivalent to the hash:
3183
3227
  * { :value => <string value>, :type => 0, :format => 0 }
3184
3228
  *
3185
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
3229
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
3186
3230
  * inside the SQL query. The 0th element of the +params+ array is bound
3187
3231
  * to $1, the 1st element is bound to $2, etc. +nil+ is treated as +NULL+.
3188
3232
  *
@@ -3225,8 +3269,7 @@ pgconn_async_exec_params(int argc, VALUE *argv, VALUE self)
3225
3269
  } else {
3226
3270
  pgconn_send_query_params( argc, argv, self );
3227
3271
  }
3228
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3229
- rb_pgresult = pgconn_get_last_result( self );
3272
+ rb_pgresult = pgconn_async_get_last_result( self );
3230
3273
 
3231
3274
  if ( rb_block_given_p() ) {
3232
3275
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3252,7 +3295,7 @@ pgconn_async_exec_params(int argc, VALUE *argv, VALUE self)
3252
3295
  *
3253
3296
  * For example: "SELECT $1::int"
3254
3297
  *
3255
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
3298
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
3256
3299
  * inside the SQL query.
3257
3300
  *
3258
3301
  * See also corresponding {libpq function}[https://www.postgresql.org/docs/current/libpq-exec.html#LIBPQ-PQPREPARE].
@@ -3264,8 +3307,7 @@ pgconn_async_prepare(int argc, VALUE *argv, VALUE self)
3264
3307
 
3265
3308
  pgconn_discard_results( self );
3266
3309
  pgconn_send_prepare( argc, argv, self );
3267
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3268
- rb_pgresult = pgconn_get_last_result( self );
3310
+ rb_pgresult = pgconn_async_get_last_result( self );
3269
3311
 
3270
3312
  if ( rb_block_given_p() ) {
3271
3313
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3292,7 +3334,7 @@ pgconn_async_prepare(int argc, VALUE *argv, VALUE self)
3292
3334
  * or, it may be a String. If it is a string, that is equivalent to the hash:
3293
3335
  * { :value => <string value>, :format => 0 }
3294
3336
  *
3295
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
3337
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
3296
3338
  * inside the SQL query. The 0th element of the +params+ array is bound
3297
3339
  * to $1, the 1st element is bound to $2, etc. +nil+ is treated as +NULL+.
3298
3340
  *
@@ -3318,8 +3360,7 @@ pgconn_async_exec_prepared(int argc, VALUE *argv, VALUE self)
3318
3360
 
3319
3361
  pgconn_discard_results( self );
3320
3362
  pgconn_send_query_prepared( argc, argv, self );
3321
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3322
- rb_pgresult = pgconn_get_last_result( self );
3363
+ rb_pgresult = pgconn_async_get_last_result( self );
3323
3364
 
3324
3365
  if ( rb_block_given_p() ) {
3325
3366
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3343,8 +3384,7 @@ pgconn_async_describe_portal(VALUE self, VALUE portal)
3343
3384
 
3344
3385
  pgconn_discard_results( self );
3345
3386
  pgconn_send_describe_portal( self, portal );
3346
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3347
- rb_pgresult = pgconn_get_last_result( self );
3387
+ rb_pgresult = pgconn_async_get_last_result( self );
3348
3388
 
3349
3389
  if ( rb_block_given_p() ) {
3350
3390
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3368,8 +3408,7 @@ pgconn_async_describe_prepared(VALUE self, VALUE stmt_name)
3368
3408
 
3369
3409
  pgconn_discard_results( self );
3370
3410
  pgconn_send_describe_prepared( self, stmt_name );
3371
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3372
- rb_pgresult = pgconn_get_last_result( self );
3411
+ rb_pgresult = pgconn_async_get_last_result( self );
3373
3412
 
3374
3413
  if ( rb_block_given_p() ) {
3375
3414
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3457,6 +3496,126 @@ pgconn_ssl_attribute_names(VALUE self)
3457
3496
  #endif
3458
3497
 
3459
3498
 
3499
+ #ifdef HAVE_PQENTERPIPELINEMODE
3500
+ /*
3501
+ * call-seq:
3502
+ * conn.pipeline_status -> Integer
3503
+ *
3504
+ * Returns the current pipeline mode status of the libpq connection.
3505
+ *
3506
+ * PQpipelineStatus can return one of the following values:
3507
+ *
3508
+ * * PQ_PIPELINE_ON - The libpq connection is in pipeline mode.
3509
+ * * PQ_PIPELINE_OFF - The libpq connection is not in pipeline mode.
3510
+ * * PQ_PIPELINE_ABORTED - The libpq connection is in pipeline mode and an error occurred while processing the current pipeline.
3511
+ * The aborted flag is cleared when PQgetResult returns a result of type PGRES_PIPELINE_SYNC.
3512
+ *
3513
+ * Available since PostgreSQL-14
3514
+ */
3515
+ static VALUE
3516
+ pgconn_pipeline_status(VALUE self)
3517
+ {
3518
+ int res = PQpipelineStatus(pg_get_pgconn(self));
3519
+ return INT2FIX(res);
3520
+ }
3521
+
3522
+
3523
+ /*
3524
+ * call-seq:
3525
+ * conn.enter_pipeline_mode -> nil
3526
+ *
3527
+ * Causes a connection to enter pipeline mode if it is currently idle or already in pipeline mode.
3528
+ *
3529
+ * Raises PG::Error and has no effect if the connection is not currently idle, i.e., it has a result ready, or it is waiting for more input from the server, etc.
3530
+ * This function does not actually send anything to the server, it just changes the libpq connection state.
3531
+ *
3532
+ * Available since PostgreSQL-14
3533
+ */
3534
+ static VALUE
3535
+ pgconn_enter_pipeline_mode(VALUE self)
3536
+ {
3537
+ PGconn *conn = pg_get_pgconn(self);
3538
+ int res = PQenterPipelineMode(conn);
3539
+ if( res == 1 ) {
3540
+ return Qnil;
3541
+ } else {
3542
+ rb_raise(rb_ePGerror, "%s", PQerrorMessage(conn));
3543
+ }
3544
+ }
3545
+
3546
+ /*
3547
+ * call-seq:
3548
+ * conn.exit_pipeline_mode -> nil
3549
+ *
3550
+ * Causes a connection to exit pipeline mode if it is currently in pipeline mode with an empty queue and no pending results.
3551
+ *
3552
+ * Takes no action if not in pipeline mode.
3553
+ * Raises PG::Error if the current statement isn't finished processing, or PQgetResult has not been called to collect results from all previously sent query.
3554
+ *
3555
+ * Available since PostgreSQL-14
3556
+ */
3557
+ static VALUE
3558
+ pgconn_exit_pipeline_mode(VALUE self)
3559
+ {
3560
+ PGconn *conn = pg_get_pgconn(self);
3561
+ int res = PQexitPipelineMode(conn);
3562
+ if( res == 1 ) {
3563
+ return Qnil;
3564
+ } else {
3565
+ rb_raise(rb_ePGerror, "%s", PQerrorMessage(conn));
3566
+ }
3567
+ }
3568
+
3569
+
3570
+ /*
3571
+ * call-seq:
3572
+ * conn.pipeline_sync -> nil
3573
+ *
3574
+ * Marks a synchronization point in a pipeline by sending a sync message and flushing the send buffer.
3575
+ * This serves as the delimiter of an implicit transaction and an error recovery point; see Section 34.5.1.3 of the PostgreSQL documentation.
3576
+ *
3577
+ * Raises PG::Error if the connection is not in pipeline mode or sending a sync message failed.
3578
+ *
3579
+ * Available since PostgreSQL-14
3580
+ */
3581
+ static VALUE
3582
+ pgconn_pipeline_sync(VALUE self)
3583
+ {
3584
+ PGconn *conn = pg_get_pgconn(self);
3585
+ int res = PQpipelineSync(conn);
3586
+ if( res == 1 ) {
3587
+ return Qnil;
3588
+ } else {
3589
+ rb_raise(rb_ePGerror, "%s", PQerrorMessage(conn));
3590
+ }
3591
+ }
3592
+
3593
+ /*
3594
+ * call-seq:
3595
+ * conn.pipeline_sync -> nil
3596
+ *
3597
+ * Sends a request for the server to flush its output buffer.
3598
+ *
3599
+ * The server flushes its output buffer automatically as a result of Connection#pipeline_sync being called, or on any request when not in pipeline mode.
3600
+ * This function is useful to cause the server to flush its output buffer in pipeline mode without establishing a synchronization point.
3601
+ * Note that the request is not itself flushed to the server automatically; use Connection#flush if necessary.
3602
+ *
3603
+ * Available since PostgreSQL-14
3604
+ */
3605
+ static VALUE
3606
+ pgconn_send_flush_request(VALUE self)
3607
+ {
3608
+ PGconn *conn = pg_get_pgconn(self);
3609
+ int res = PQsendFlushRequest(conn);
3610
+ if( res == 1 ) {
3611
+ return Qnil;
3612
+ } else {
3613
+ rb_raise(rb_ePGerror, "%s", PQerrorMessage(conn));
3614
+ }
3615
+ }
3616
+
3617
+ #endif
3618
+
3460
3619
  /**************************************************************************
3461
3620
  * LARGE OBJECT SUPPORT
3462
3621
  **************************************************************************/
@@ -3801,11 +3960,11 @@ static VALUE
3801
3960
  pgconn_internal_encoding_set(VALUE self, VALUE enc)
3802
3961
  {
3803
3962
  if (NIL_P(enc)) {
3804
- pgconn_set_client_encoding( self, rb_usascii_str_new_cstr("SQL_ASCII") );
3963
+ pgconn_sync_set_client_encoding( self, rb_usascii_str_new_cstr("SQL_ASCII") );
3805
3964
  return enc;
3806
3965
  }
3807
3966
  else if ( TYPE(enc) == T_STRING && strcasecmp("JOHAB", StringValueCStr(enc)) == 0 ) {
3808
- pgconn_set_client_encoding(self, rb_usascii_str_new_cstr("JOHAB"));
3967
+ pgconn_sync_set_client_encoding(self, rb_usascii_str_new_cstr("JOHAB"));
3809
3968
  return enc;
3810
3969
  }
3811
3970
  else {
@@ -3843,16 +4002,33 @@ pgconn_external_encoding(VALUE self)
3843
4002
  return rb_enc_from_encoding( enc );
3844
4003
  }
3845
4004
 
4005
+ /*
4006
+ * call-seq:
4007
+ * conn.set_client_encoding( encoding )
4008
+ *
4009
+ * Sets the client encoding to the _encoding_ String.
4010
+ */
4011
+ static VALUE
4012
+ pgconn_async_set_client_encoding(VALUE self, VALUE encname)
4013
+ {
4014
+ VALUE query_format, query;
4015
+
4016
+ Check_Type(encname, T_STRING);
4017
+ query_format = rb_str_new_cstr("set client_encoding to '%s'");
4018
+ query = rb_funcall(query_format, rb_intern("%"), 1, encname);
4019
+
4020
+ pgconn_async_exec(1, &query, self);
4021
+ pgconn_set_internal_encoding_index( self );
4022
+
4023
+ return Qnil;
4024
+ }
3846
4025
 
3847
4026
  static VALUE
3848
4027
  pgconn_set_client_encoding_async1( VALUE args )
3849
4028
  {
3850
4029
  VALUE self = ((VALUE*)args)[0];
3851
4030
  VALUE encname = ((VALUE*)args)[1];
3852
- VALUE query_format = rb_str_new_cstr("set client_encoding to '%s'");
3853
- VALUE query = rb_funcall(query_format, rb_intern("%"), 1, encname);
3854
-
3855
- pgconn_async_exec(1, &query, self);
4031
+ pgconn_async_set_client_encoding(self, encname);
3856
4032
  return 0;
3857
4033
  }
3858
4034
 
@@ -3867,9 +4043,9 @@ pgconn_set_client_encoding_async2( VALUE arg, VALUE ex )
3867
4043
 
3868
4044
 
3869
4045
  static VALUE
3870
- pgconn_set_client_encoding_async( VALUE self, const char *encname )
4046
+ pgconn_set_client_encoding_async( VALUE self, VALUE encname )
3871
4047
  {
3872
- VALUE args[] = { self, rb_str_new_cstr(encname) };
4048
+ VALUE args[] = { self, encname };
3873
4049
  return rb_rescue(pgconn_set_client_encoding_async1, (VALUE)&args, pgconn_set_client_encoding_async2, Qnil);
3874
4050
  }
3875
4051
 
@@ -3891,10 +4067,9 @@ pgconn_set_default_encoding( VALUE self )
3891
4067
 
3892
4068
  if (( enc = rb_default_internal_encoding() )) {
3893
4069
  encname = pg_get_rb_encoding_as_pg_encoding( enc );
3894
- if ( pgconn_set_client_encoding_async(self, encname) != 0 )
4070
+ if ( pgconn_set_client_encoding_async(self, rb_str_new_cstr(encname)) != 0 )
3895
4071
  rb_warning( "Failed to set the default_internal encoding to %s: '%s'",
3896
4072
  encname, PQerrorMessage(conn) );
3897
- pgconn_set_internal_encoding_index( self );
3898
4073
  return rb_enc_from_encoding( enc );
3899
4074
  } else {
3900
4075
  pgconn_set_internal_encoding_index( self );
@@ -3916,12 +4091,12 @@ static VALUE
3916
4091
  pgconn_type_map_for_queries_set(VALUE self, VALUE typemap)
3917
4092
  {
3918
4093
  t_pg_connection *this = pg_get_connection( self );
4094
+ t_typemap *tm;
4095
+ UNUSED(tm);
4096
+
4097
+ /* Check type of method param */
4098
+ TypedData_Get_Struct(typemap, t_typemap, &pg_typemap_type, tm);
3919
4099
 
3920
- if ( !rb_obj_is_kind_of(typemap, rb_cTypeMap) ) {
3921
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::TypeMap)",
3922
- rb_obj_classname( typemap ) );
3923
- }
3924
- Check_Type(typemap, T_DATA);
3925
4100
  this->type_map_for_queries = typemap;
3926
4101
 
3927
4102
  return typemap;
@@ -3956,12 +4131,10 @@ static VALUE
3956
4131
  pgconn_type_map_for_results_set(VALUE self, VALUE typemap)
3957
4132
  {
3958
4133
  t_pg_connection *this = pg_get_connection( self );
4134
+ t_typemap *tm;
4135
+ UNUSED(tm);
3959
4136
 
3960
- if ( !rb_obj_is_kind_of(typemap, rb_cTypeMap) ) {
3961
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::TypeMap)",
3962
- rb_obj_classname( typemap ) );
3963
- }
3964
- Check_Type(typemap, T_DATA);
4137
+ TypedData_Get_Struct(typemap, t_typemap, &pg_typemap_type, tm);
3965
4138
  this->type_map_for_results = typemap;
3966
4139
 
3967
4140
  return typemap;
@@ -3996,20 +4169,19 @@ pgconn_type_map_for_results_get(VALUE self)
3996
4169
  *
3997
4170
  */
3998
4171
  static VALUE
3999
- pgconn_encoder_for_put_copy_data_set(VALUE self, VALUE typemap)
4172
+ pgconn_encoder_for_put_copy_data_set(VALUE self, VALUE encoder)
4000
4173
  {
4001
4174
  t_pg_connection *this = pg_get_connection( self );
4002
4175
 
4003
- if( typemap != Qnil ){
4004
- if ( !rb_obj_is_kind_of(typemap, rb_cPG_Coder) ) {
4005
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::Coder)",
4006
- rb_obj_classname( typemap ) );
4007
- }
4008
- Check_Type(typemap, T_DATA);
4176
+ if( encoder != Qnil ){
4177
+ t_pg_coder *co;
4178
+ UNUSED(co);
4179
+ /* Check argument type */
4180
+ TypedData_Get_Struct(encoder, t_pg_coder, &pg_coder_type, co);
4009
4181
  }
4010
- this->encoder_for_put_copy_data = typemap;
4182
+ this->encoder_for_put_copy_data = encoder;
4011
4183
 
4012
- return typemap;
4184
+ return encoder;
4013
4185
  }
4014
4186
 
4015
4187
  /*
@@ -4045,20 +4217,19 @@ pgconn_encoder_for_put_copy_data_get(VALUE self)
4045
4217
  *
4046
4218
  */
4047
4219
  static VALUE
4048
- pgconn_decoder_for_get_copy_data_set(VALUE self, VALUE typemap)
4220
+ pgconn_decoder_for_get_copy_data_set(VALUE self, VALUE decoder)
4049
4221
  {
4050
4222
  t_pg_connection *this = pg_get_connection( self );
4051
4223
 
4052
- if( typemap != Qnil ){
4053
- if ( !rb_obj_is_kind_of(typemap, rb_cPG_Coder) ) {
4054
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::Coder)",
4055
- rb_obj_classname( typemap ) );
4056
- }
4057
- Check_Type(typemap, T_DATA);
4224
+ if( decoder != Qnil ){
4225
+ t_pg_coder *co;
4226
+ UNUSED(co);
4227
+ /* Check argument type */
4228
+ TypedData_Get_Struct(decoder, t_pg_coder, &pg_coder_type, co);
4058
4229
  }
4059
- this->decoder_for_get_copy_data = typemap;
4230
+ this->decoder_for_get_copy_data = decoder;
4060
4231
 
4061
- return typemap;
4232
+ return decoder;
4062
4233
  }
4063
4234
 
4064
4235
  /*
@@ -4141,6 +4312,7 @@ void
4141
4312
  init_pg_connection()
4142
4313
  {
4143
4314
  s_id_encode = rb_intern("encode");
4315
+ s_id_autoclose_set = rb_intern("autoclose=");
4144
4316
  sym_type = ID2SYM(rb_intern("type"));
4145
4317
  sym_format = ID2SYM(rb_intern("format"));
4146
4318
  sym_value = ID2SYM(rb_intern("value"));
@@ -4156,10 +4328,6 @@ init_pg_connection()
4156
4328
  /****** PG::Connection CLASS METHODS ******/
4157
4329
  rb_define_alloc_func( rb_cPGconn, pgconn_s_allocate );
4158
4330
 
4159
- SINGLETON_ALIAS(rb_cPGconn, "connect", "new");
4160
- SINGLETON_ALIAS(rb_cPGconn, "open", "new");
4161
- SINGLETON_ALIAS(rb_cPGconn, "setdb", "new");
4162
- SINGLETON_ALIAS(rb_cPGconn, "setdblogin", "new");
4163
4331
  rb_define_singleton_method(rb_cPGconn, "escape_string", pgconn_s_escape, 1);
4164
4332
  SINGLETON_ALIAS(rb_cPGconn, "escape", "escape_string");
4165
4333
  rb_define_singleton_method(rb_cPGconn, "escape_bytea", pgconn_s_escape_bytea, 1);
@@ -4168,14 +4336,14 @@ init_pg_connection()
4168
4336
  rb_define_singleton_method(rb_cPGconn, "quote_ident", pgconn_s_quote_ident, 1);
4169
4337
  rb_define_singleton_method(rb_cPGconn, "connect_start", pgconn_s_connect_start, -1);
4170
4338
  rb_define_singleton_method(rb_cPGconn, "conndefaults", pgconn_s_conndefaults, 0);
4171
- rb_define_singleton_method(rb_cPGconn, "ping", pgconn_s_ping, -1);
4339
+ rb_define_singleton_method(rb_cPGconn, "sync_ping", pgconn_s_sync_ping, -1);
4340
+ rb_define_singleton_method(rb_cPGconn, "sync_connect", pgconn_s_sync_connect, -1);
4172
4341
 
4173
4342
  /****** PG::Connection INSTANCE METHODS: Connection Control ******/
4174
- rb_define_method(rb_cPGconn, "initialize", pgconn_init, -1);
4175
4343
  rb_define_method(rb_cPGconn, "connect_poll", pgconn_connect_poll, 0);
4176
4344
  rb_define_method(rb_cPGconn, "finish", pgconn_finish, 0);
4177
4345
  rb_define_method(rb_cPGconn, "finished?", pgconn_finished_p, 0);
4178
- rb_define_method(rb_cPGconn, "reset", pgconn_reset, 0);
4346
+ rb_define_method(rb_cPGconn, "sync_reset", pgconn_sync_reset, 0);
4179
4347
  rb_define_method(rb_cPGconn, "reset_start", pgconn_reset_start, 0);
4180
4348
  rb_define_method(rb_cPGconn, "reset_poll", pgconn_reset_poll, 0);
4181
4349
  rb_define_alias(rb_cPGconn, "close", "finish");
@@ -4187,9 +4355,7 @@ init_pg_connection()
4187
4355
  rb_define_method(rb_cPGconn, "host", pgconn_host, 0);
4188
4356
  rb_define_method(rb_cPGconn, "port", pgconn_port, 0);
4189
4357
  rb_define_method(rb_cPGconn, "tty", pgconn_tty, 0);
4190
- #ifdef HAVE_PQCONNINFO
4191
4358
  rb_define_method(rb_cPGconn, "conninfo", pgconn_conninfo, 0);
4192
- #endif
4193
4359
  rb_define_method(rb_cPGconn, "options", pgconn_options, 0);
4194
4360
  rb_define_method(rb_cPGconn, "status", pgconn_status, 0);
4195
4361
  rb_define_method(rb_cPGconn, "transaction_status", pgconn_transaction_status, 0);
@@ -4200,17 +4366,18 @@ init_pg_connection()
4200
4366
  rb_define_method(rb_cPGconn, "socket", pgconn_socket, 0);
4201
4367
  rb_define_method(rb_cPGconn, "socket_io", pgconn_socket_io, 0);
4202
4368
  rb_define_method(rb_cPGconn, "backend_pid", pgconn_backend_pid, 0);
4369
+ rb_define_method(rb_cPGconn, "backend_key", pgconn_backend_key, 0);
4203
4370
  rb_define_method(rb_cPGconn, "connection_needs_password", pgconn_connection_needs_password, 0);
4204
4371
  rb_define_method(rb_cPGconn, "connection_used_password", pgconn_connection_used_password, 0);
4205
4372
  /* rb_define_method(rb_cPGconn, "getssl", pgconn_getssl, 0); */
4206
4373
 
4207
4374
  /****** PG::Connection INSTANCE METHODS: Command Execution ******/
4208
- rb_define_method(rb_cPGconn, "sync_exec", pgconn_exec, -1);
4209
- rb_define_method(rb_cPGconn, "sync_exec_params", pgconn_exec_params, -1);
4210
- rb_define_method(rb_cPGconn, "sync_prepare", pgconn_prepare, -1);
4211
- rb_define_method(rb_cPGconn, "sync_exec_prepared", pgconn_exec_prepared, -1);
4212
- rb_define_method(rb_cPGconn, "sync_describe_prepared", pgconn_describe_prepared, 1);
4213
- rb_define_method(rb_cPGconn, "sync_describe_portal", pgconn_describe_portal, 1);
4375
+ rb_define_method(rb_cPGconn, "sync_exec", pgconn_sync_exec, -1);
4376
+ rb_define_method(rb_cPGconn, "sync_exec_params", pgconn_sync_exec_params, -1);
4377
+ rb_define_method(rb_cPGconn, "sync_prepare", pgconn_sync_prepare, -1);
4378
+ rb_define_method(rb_cPGconn, "sync_exec_prepared", pgconn_sync_exec_prepared, -1);
4379
+ rb_define_method(rb_cPGconn, "sync_describe_prepared", pgconn_sync_describe_prepared, 1);
4380
+ rb_define_method(rb_cPGconn, "sync_describe_portal", pgconn_sync_describe_portal, 1);
4214
4381
 
4215
4382
  rb_define_method(rb_cPGconn, "exec", pgconn_async_exec, -1);
4216
4383
  rb_define_method(rb_cPGconn, "exec_params", pgconn_async_exec_params, -1);
@@ -4243,25 +4410,26 @@ init_pg_connection()
4243
4410
  rb_define_method(rb_cPGconn, "send_query_prepared", pgconn_send_query_prepared, -1);
4244
4411
  rb_define_method(rb_cPGconn, "send_describe_prepared", pgconn_send_describe_prepared, 1);
4245
4412
  rb_define_method(rb_cPGconn, "send_describe_portal", pgconn_send_describe_portal, 1);
4246
- rb_define_method(rb_cPGconn, "get_result", pgconn_get_result, 0);
4413
+ rb_define_method(rb_cPGconn, "sync_get_result", pgconn_sync_get_result, 0);
4247
4414
  rb_define_method(rb_cPGconn, "consume_input", pgconn_consume_input, 0);
4248
4415
  rb_define_method(rb_cPGconn, "is_busy", pgconn_is_busy, 0);
4249
- rb_define_method(rb_cPGconn, "setnonblocking", pgconn_setnonblocking, 1);
4250
- rb_define_method(rb_cPGconn, "isnonblocking", pgconn_isnonblocking, 0);
4251
- rb_define_alias(rb_cPGconn, "nonblocking?", "isnonblocking");
4252
- rb_define_method(rb_cPGconn, "flush", pgconn_flush, 0);
4416
+ rb_define_method(rb_cPGconn, "sync_setnonblocking", pgconn_sync_setnonblocking, 1);
4417
+ rb_define_method(rb_cPGconn, "sync_isnonblocking", pgconn_sync_isnonblocking, 0);
4418
+ rb_define_method(rb_cPGconn, "sync_flush", pgconn_sync_flush, 0);
4419
+ rb_define_method(rb_cPGconn, "flush", pgconn_async_flush, 0);
4420
+ rb_define_alias(rb_cPGconn, "async_flush", "flush");
4253
4421
  rb_define_method(rb_cPGconn, "discard_results", pgconn_discard_results, 0);
4254
4422
 
4255
4423
  /****** PG::Connection INSTANCE METHODS: Cancelling Queries in Progress ******/
4256
- rb_define_method(rb_cPGconn, "cancel", pgconn_cancel, 0);
4424
+ rb_define_method(rb_cPGconn, "sync_cancel", pgconn_sync_cancel, 0);
4257
4425
 
4258
4426
  /****** PG::Connection INSTANCE METHODS: NOTIFY ******/
4259
4427
  rb_define_method(rb_cPGconn, "notifies", pgconn_notifies, 0);
4260
4428
 
4261
4429
  /****** PG::Connection INSTANCE METHODS: COPY ******/
4262
- rb_define_method(rb_cPGconn, "put_copy_data", pgconn_put_copy_data, -1);
4263
- rb_define_method(rb_cPGconn, "put_copy_end", pgconn_put_copy_end, -1);
4264
- rb_define_method(rb_cPGconn, "get_copy_data", pgconn_get_copy_data, -1);
4430
+ rb_define_method(rb_cPGconn, "sync_put_copy_data", pgconn_sync_put_copy_data, -1);
4431
+ rb_define_method(rb_cPGconn, "sync_put_copy_end", pgconn_sync_put_copy_end, -1);
4432
+ rb_define_method(rb_cPGconn, "sync_get_copy_data", pgconn_sync_get_copy_data, -1);
4265
4433
 
4266
4434
  /****** PG::Connection INSTANCE METHODS: Control Functions ******/
4267
4435
  rb_define_method(rb_cPGconn, "set_error_verbosity", pgconn_set_error_verbosity, 1);
@@ -4277,16 +4445,20 @@ init_pg_connection()
4277
4445
 
4278
4446
  /****** PG::Connection INSTANCE METHODS: Other ******/
4279
4447
  rb_define_method(rb_cPGconn, "get_client_encoding", pgconn_get_client_encoding, 0);
4280
- rb_define_method(rb_cPGconn, "set_client_encoding", pgconn_set_client_encoding, 1);
4448
+ rb_define_method(rb_cPGconn, "sync_set_client_encoding", pgconn_sync_set_client_encoding, 1);
4449
+ rb_define_method(rb_cPGconn, "set_client_encoding", pgconn_async_set_client_encoding, 1);
4450
+ rb_define_alias(rb_cPGconn, "async_set_client_encoding", "set_client_encoding");
4281
4451
  rb_define_alias(rb_cPGconn, "client_encoding=", "set_client_encoding");
4282
- rb_define_method(rb_cPGconn, "transaction", pgconn_transaction, 0);
4283
4452
  rb_define_method(rb_cPGconn, "block", pgconn_block, -1);
4453
+ rb_define_private_method(rb_cPGconn, "flush_data=", pgconn_flush_data_set, 1);
4284
4454
  rb_define_method(rb_cPGconn, "wait_for_notify", pgconn_wait_for_notify, -1);
4285
4455
  rb_define_alias(rb_cPGconn, "notifies_wait", "wait_for_notify");
4286
4456
  rb_define_method(rb_cPGconn, "quote_ident", pgconn_s_quote_ident, 1);
4287
- rb_define_method(rb_cPGconn, "get_last_result", pgconn_get_last_result, 0);
4457
+ rb_define_method(rb_cPGconn, "sync_get_last_result", pgconn_sync_get_last_result, 0);
4458
+ rb_define_method(rb_cPGconn, "get_last_result", pgconn_async_get_last_result, 0);
4459
+ rb_define_alias(rb_cPGconn, "async_get_last_result", "get_last_result");
4288
4460
  #ifdef HAVE_PQENCRYPTPASSWORDCONN
4289
- rb_define_method(rb_cPGconn, "encrypt_password", pgconn_encrypt_password, -1);
4461
+ rb_define_method(rb_cPGconn, "sync_encrypt_password", pgconn_sync_encrypt_password, -1);
4290
4462
  #endif
4291
4463
 
4292
4464
  #ifdef HAVE_PQSSLATTRIBUTE
@@ -4295,6 +4467,14 @@ init_pg_connection()
4295
4467
  rb_define_method(rb_cPGconn, "ssl_attribute_names", pgconn_ssl_attribute_names, 0);
4296
4468
  #endif
4297
4469
 
4470
+ #ifdef HAVE_PQENTERPIPELINEMODE
4471
+ rb_define_method(rb_cPGconn, "pipeline_status", pgconn_pipeline_status, 0);
4472
+ rb_define_method(rb_cPGconn, "enter_pipeline_mode", pgconn_enter_pipeline_mode, 0);
4473
+ rb_define_method(rb_cPGconn, "exit_pipeline_mode", pgconn_exit_pipeline_mode, 0);
4474
+ rb_define_method(rb_cPGconn, "pipeline_sync", pgconn_pipeline_sync, 0);
4475
+ rb_define_method(rb_cPGconn, "send_flush_request", pgconn_send_flush_request, 0);
4476
+ #endif
4477
+
4298
4478
  /****** PG::Connection INSTANCE METHODS: Large Object Support ******/
4299
4479
  rb_define_method(rb_cPGconn, "lo_creat", pgconn_locreat, -1);
4300
4480
  rb_define_alias(rb_cPGconn, "locreat", "lo_creat");