pg 1.1.3 → 1.4.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +0 -0
- data/.appveyor.yml +36 -0
- data/.gems +6 -0
- data/.github/workflows/binary-gems.yml +86 -0
- data/.github/workflows/source-gem.yml +129 -0
- data/.gitignore +13 -0
- data/.hgsigs +34 -0
- data/.hgtags +41 -0
- data/.irbrc +23 -0
- data/.pryrc +23 -0
- data/.tm_properties +21 -0
- data/.travis.yml +49 -0
- data/Gemfile +14 -0
- data/History.rdoc +291 -6
- data/Manifest.txt +3 -3
- data/README-Windows.rdoc +4 -4
- data/README.ja.rdoc +1 -2
- data/README.rdoc +51 -15
- data/Rakefile +31 -140
- data/Rakefile.cross +60 -56
- data/certs/ged.pem +24 -0
- data/certs/larskanis-2022.pem +26 -0
- data/ext/errorcodes.def +76 -0
- data/ext/errorcodes.rb +0 -0
- data/ext/errorcodes.txt +21 -2
- data/ext/extconf.rb +101 -26
- data/ext/gvl_wrappers.c +4 -0
- data/ext/gvl_wrappers.h +23 -0
- data/ext/pg.c +190 -122
- data/ext/pg.h +43 -17
- data/ext/pg_binary_decoder.c +20 -16
- data/ext/pg_binary_encoder.c +13 -12
- data/ext/pg_coder.c +95 -29
- data/ext/pg_connection.c +1214 -919
- data/ext/pg_copy_coder.c +50 -18
- data/ext/pg_record_coder.c +521 -0
- data/ext/pg_result.c +344 -153
- data/ext/pg_text_decoder.c +15 -9
- data/ext/pg_text_encoder.c +185 -53
- data/ext/pg_tuple.c +63 -35
- data/ext/pg_type_map.c +42 -9
- data/ext/pg_type_map_all_strings.c +19 -5
- data/ext/pg_type_map_by_class.c +54 -24
- data/ext/pg_type_map_by_column.c +73 -34
- data/ext/pg_type_map_by_mri_type.c +48 -19
- data/ext/pg_type_map_by_oid.c +55 -25
- data/ext/pg_type_map_in_ruby.c +51 -20
- data/ext/{util.c → pg_util.c} +7 -7
- data/ext/{util.h → pg_util.h} +0 -0
- data/lib/pg/basic_type_map_based_on_result.rb +47 -0
- data/lib/pg/basic_type_map_for_queries.rb +193 -0
- data/lib/pg/basic_type_map_for_results.rb +81 -0
- data/lib/pg/basic_type_registry.rb +301 -0
- data/lib/pg/binary_decoder.rb +1 -0
- data/lib/pg/coder.rb +23 -2
- data/lib/pg/connection.rb +669 -71
- data/lib/pg/constants.rb +1 -0
- data/lib/pg/exceptions.rb +8 -1
- data/lib/pg/result.rb +13 -1
- data/lib/pg/text_decoder.rb +2 -3
- data/lib/pg/text_encoder.rb +8 -18
- data/lib/pg/type_map_by_column.rb +2 -1
- data/lib/pg/version.rb +4 -0
- data/lib/pg.rb +48 -33
- data/misc/openssl-pg-segfault.rb +31 -0
- data/misc/postgres/History.txt +9 -0
- data/misc/postgres/Manifest.txt +5 -0
- data/misc/postgres/README.txt +21 -0
- data/misc/postgres/Rakefile +21 -0
- data/misc/postgres/lib/postgres.rb +16 -0
- data/misc/ruby-pg/History.txt +9 -0
- data/misc/ruby-pg/Manifest.txt +5 -0
- data/misc/ruby-pg/README.txt +21 -0
- data/misc/ruby-pg/Rakefile +21 -0
- data/misc/ruby-pg/lib/ruby/pg.rb +16 -0
- data/pg.gemspec +32 -0
- data/rakelib/task_extension.rb +46 -0
- data/sample/array_insert.rb +20 -0
- data/sample/async_api.rb +102 -0
- data/sample/async_copyto.rb +39 -0
- data/sample/async_mixed.rb +56 -0
- data/sample/check_conn.rb +21 -0
- data/sample/copydata.rb +71 -0
- data/sample/copyfrom.rb +81 -0
- data/sample/copyto.rb +19 -0
- data/sample/cursor.rb +21 -0
- data/sample/disk_usage_report.rb +177 -0
- data/sample/issue-119.rb +94 -0
- data/sample/losample.rb +69 -0
- data/sample/minimal-testcase.rb +17 -0
- data/sample/notify_wait.rb +72 -0
- data/sample/pg_statistics.rb +285 -0
- data/sample/replication_monitor.rb +222 -0
- data/sample/test_binary_values.rb +33 -0
- data/sample/wal_shipper.rb +434 -0
- data/sample/warehouse_partitions.rb +311 -0
- data.tar.gz.sig +0 -0
- metadata +94 -237
- metadata.gz.sig +0 -0
- data/ChangeLog +0 -6595
- data/lib/pg/basic_type_mapping.rb +0 -459
- data/spec/data/expected_trace.out +0 -26
- data/spec/data/random_binary_data +0 -0
- data/spec/helpers.rb +0 -381
- data/spec/pg/basic_type_mapping_spec.rb +0 -508
- data/spec/pg/connection_spec.rb +0 -1849
- data/spec/pg/connection_sync_spec.rb +0 -41
- data/spec/pg/result_spec.rb +0 -491
- data/spec/pg/tuple_spec.rb +0 -280
- data/spec/pg/type_map_by_class_spec.rb +0 -138
- data/spec/pg/type_map_by_column_spec.rb +0 -222
- data/spec/pg/type_map_by_mri_type_spec.rb +0 -136
- data/spec/pg/type_map_by_oid_spec.rb +0 -149
- data/spec/pg/type_map_in_ruby_spec.rb +0 -164
- data/spec/pg/type_map_spec.rb +0 -22
- data/spec/pg/type_spec.rb +0 -949
- data/spec/pg_spec.rb +0 -50
data/History.rdoc
CHANGED
@@ -1,3 +1,288 @@
|
|
1
|
+
== v1.4.3 [2022-08-09] Lars Kanis <lars@greiz-reinsdorf.de>
|
2
|
+
|
3
|
+
- Avoid memory bloat possible in put_copy_data in pg-1.4.0 to 1.4.2. #473
|
4
|
+
- Use Encoding::BINARY for JOHAB, removing some useless code. #472
|
5
|
+
|
6
|
+
|
7
|
+
== v1.4.2 [2022-07-27] Lars Kanis <lars@greiz-reinsdorf.de>
|
8
|
+
|
9
|
+
Bugfixes:
|
10
|
+
|
11
|
+
- Properly handle empty host parameter when connecting. #471
|
12
|
+
- Update Windows fat binary gem to OpenSSL-1.1.1q.
|
13
|
+
|
14
|
+
|
15
|
+
== v1.4.1 [2022-06-24] Lars Kanis <lars@greiz-reinsdorf.de>
|
16
|
+
|
17
|
+
Bugfixes:
|
18
|
+
|
19
|
+
- Fix another ruby-2.7 keyword warning. #465
|
20
|
+
- Allow PG::Error to be created without arguments. #466
|
21
|
+
|
22
|
+
|
23
|
+
== v1.4.0 [2022-06-20] Lars Kanis <lars@greiz-reinsdorf.de>
|
24
|
+
|
25
|
+
Added:
|
26
|
+
|
27
|
+
- Add PG::Connection#hostaddr, present since PostgreSQL-12. #453
|
28
|
+
- Add PG::Connection.conninfo_parse to wrap PQconninfoParse. #453
|
29
|
+
|
30
|
+
Bugfixes:
|
31
|
+
|
32
|
+
- Try IPv6 and IPv4 addresses, if DNS resolves to both. #452
|
33
|
+
- Re-add block-call semantics to PG::Connection.new accidently removed in pg-1.3.0. #454
|
34
|
+
- Handle client error after all data consumed in #copy_data for output. #455
|
35
|
+
- Avoid spurious keyword argument warning on Ruby 2.7. #456
|
36
|
+
- Change connection setup to respect connect_timeout parameter. #459
|
37
|
+
- Fix indefinite hang in case of connection error on Windows #458
|
38
|
+
- Set connection attribute of PG::Error in various places where it was missing. #461
|
39
|
+
- Fix transaction leak on early break/return. #463
|
40
|
+
- Update Windows fat binary gem to OpenSSL-1.1.1o and PostgreSQL-14.4.
|
41
|
+
|
42
|
+
Enhancements:
|
43
|
+
|
44
|
+
- Don't flush at each put_copy_data call, but flush at get_result. #462
|
45
|
+
|
46
|
+
|
47
|
+
== v1.3.5 [2022-03-31] Lars Kanis <lars@greiz-reinsdorf.de>
|
48
|
+
|
49
|
+
Bugfixes:
|
50
|
+
|
51
|
+
- Handle PGRES_COMMAND_OK in pgresult_stream_any. #447
|
52
|
+
Fixes usage when trying to stream the result of a procedure call that returns no results.
|
53
|
+
|
54
|
+
Enhancements:
|
55
|
+
|
56
|
+
- Rename BasicTypeRegistry#define_default_types to #register_default_types to use a more consistent terminology.
|
57
|
+
Keeping define_default_types for compatibility.
|
58
|
+
- BasicTypeRegistry: return self instead of objects by accident.
|
59
|
+
This allows call chaining.
|
60
|
+
- Add some April fun. #449
|
61
|
+
|
62
|
+
Documentation:
|
63
|
+
- Refine documentation of conn.socket_io and conn.connect_poll
|
64
|
+
|
65
|
+
|
66
|
+
== v1.3.4 [2022-03-10] Lars Kanis <lars@greiz-reinsdorf.de>
|
67
|
+
|
68
|
+
Bugfixes:
|
69
|
+
|
70
|
+
- Don't leak IO in case of connection errors. #439
|
71
|
+
Previously it was kept open until the PG::Connection was garbage collected.
|
72
|
+
- Fix a performance regession in conn.get_result noticed in single row mode. #442
|
73
|
+
- Fix occasional error Errno::EBADF (Bad file descriptor) while connecting. #444
|
74
|
+
- Fix compatibility of res.stream_each* methods with Fiber.scheduler. #446
|
75
|
+
- Remove FL_TEST and FL_SET, which are MRI-internal. #437
|
76
|
+
|
77
|
+
Enhancements:
|
78
|
+
|
79
|
+
- Allow pgresult_stream_any to be used by sequel_pg. #443
|
80
|
+
|
81
|
+
|
82
|
+
== v1.3.3 [2022-02-22] Lars Kanis <lars@greiz-reinsdorf.de>
|
83
|
+
|
84
|
+
Bugfixes:
|
85
|
+
|
86
|
+
- Fix omission of the third digit of IPv4 addresses in connection URI. #435
|
87
|
+
- Fix wrong permission of certs/larskanis-2022.pem in the pg-1.3.2.gem. #432
|
88
|
+
|
89
|
+
|
90
|
+
== v1.3.2 [2022-02-14] Lars Kanis <lars@greiz-reinsdorf.de>
|
91
|
+
|
92
|
+
Bugfixes:
|
93
|
+
|
94
|
+
- Cancel only active query after failing transaction. #430
|
95
|
+
This avoids an incompatibility with pgbouncer since pg-1.3.0.
|
96
|
+
- Fix String objects with non-applied encoding when using COPY or record decoders. #427
|
97
|
+
- Update Windows fat binary gem to PostgreSQL-14.2.
|
98
|
+
|
99
|
+
Enhancements:
|
100
|
+
|
101
|
+
- Improve extconf.rb checks to reduces the number of compiler calls.
|
102
|
+
- Add a check for PGRES_PIPELINE_SYNC, to make sure the library version and the header files are PostgreSQL-14+. #429
|
103
|
+
|
104
|
+
|
105
|
+
== v1.3.1 [2022-02-01] Michael Granger <ged@FaerieMUD.org>
|
106
|
+
|
107
|
+
Bugfixes:
|
108
|
+
|
109
|
+
- Fix wrong handling of socket writability on Windows introduced in #417.
|
110
|
+
This caused starvation in conn.put_copy_data.
|
111
|
+
- Fix error in PG.version_string(true). #419
|
112
|
+
- Fix a regression in pg 1.3.0 where Ruby 2.x busy-looping any fractional seconds for every wait. #420
|
113
|
+
|
114
|
+
Enhancements:
|
115
|
+
|
116
|
+
- Raise an error when conn.copy_data is used in nonblocking mode.
|
117
|
+
|
118
|
+
|
119
|
+
== v1.3.0 [2022-01-20] Michael Granger <ged@FaerieMUD.org>
|
120
|
+
|
121
|
+
Install Enhancements:
|
122
|
+
- Print some install help if libpq wasn't found. #396
|
123
|
+
This should help to pick the necessary package without googling.
|
124
|
+
- Update Windows fat binary gem to OpenSSL-1.1.1m and PostgreSQL-14.1.
|
125
|
+
- Add binary Windows gems for Ruby 3.0 and 3.1.
|
126
|
+
- Make the library path of libpq available in ruby as PG::POSTGRESQL_LIB_PATH and add it to the search paths on Windows similar to +rpath+ on Unix systems. #373
|
127
|
+
- Fall back to pkg-config if pg_config is not found. #380
|
128
|
+
- Add option to extconf.rb to disable nogvl-wrapping of libpq functions.
|
129
|
+
All methods (except PG::Connection.ping) are nonblocking now, so that GVL unlock is in theory no longer necessary.
|
130
|
+
However it can have some advantage in concurrency, so that GVL unlock is still enabled by default.
|
131
|
+
Use:
|
132
|
+
- gem inst pg -- --disable-gvl-unlock
|
133
|
+
|
134
|
+
API Enhancements:
|
135
|
+
- Add full compatibility to Fiber.scheduler introduced in Ruby-3.0. #397
|
136
|
+
- Add async_connect and async_send methods and add specific specs for Fiber.scheduler #342
|
137
|
+
- Add async_get_result and async_get_last_result
|
138
|
+
- Add async_get_copy_data
|
139
|
+
- Implement async_put_copy_data/async_put_copy_end
|
140
|
+
- Implement async_reset method using the nonblocking libpq API
|
141
|
+
- Add async_set_client_encoding which is compatible to scheduler
|
142
|
+
- Add async_cancel as a nonblocking version of conn#cancel
|
143
|
+
- Add async_encrypt_password
|
144
|
+
- Run Connection.ping in a second thread.
|
145
|
+
- Make discard_results scheduler friendly
|
146
|
+
- Do all socket waiting through the conn.socket_io object.
|
147
|
+
- Avoid PG.connect blocking while address resolution by automatically providing the +hostaddr+ parameter and resolving in Ruby instead of libpq.
|
148
|
+
- On Windows Fiber.scheduler support requires Ruby-3.1+.
|
149
|
+
It is also only partly usable since may ruby IO methods are not yet scheduler aware on Windows.
|
150
|
+
- Add support for pipeline mode of PostgreSQL-14. #401
|
151
|
+
- Allow specification of multiple hosts in PostgreSQL URI. #387
|
152
|
+
- Add new method conn.backend_key - used to implement our own cancel method.
|
153
|
+
|
154
|
+
Type cast enhancements:
|
155
|
+
- Add PG::BasicTypeMapForQueries::BinaryData for encoding of bytea columns. #348
|
156
|
+
- Reduce time to build coder maps and permit to reuse them for several type maps per PG::BasicTypeRegistry::CoderMapsBundle.new(conn) . #376
|
157
|
+
- Make BasicTypeRegistry a class and use a global default instance of it.
|
158
|
+
Now a local type registry can be instanciated and given to the type map, to avoid changing shared global states.
|
159
|
+
- Allow PG::BasicTypeMapForQueries to take a Proc as callback for undefined types.
|
160
|
+
|
161
|
+
Other Enhancements:
|
162
|
+
- Convert all PG classes implemented in C to TypedData objects. #349
|
163
|
+
- Support ObjectSpace.memsize_of(obj) on all classes implemented in C. #393
|
164
|
+
- Make all PG objects implemented in C memory moveable and therefore GC.compact friendly. #349
|
165
|
+
- Update errorcodes and error classes to PostgreSQL-14.0.
|
166
|
+
- Add PG::CONNECTION_* constants for conn.status of newer PostgreSQL versions.
|
167
|
+
- Add better support for logical replication. #339
|
168
|
+
- Change conn.socket_io to read+write mode and to a BasicSocket object instead of IO.
|
169
|
+
- Use rb_io_wait() and the conn.socket_io object if available for better compatibility to Fiber.scheduler .
|
170
|
+
Fall back to rb_wait_for_single_fd() on ruby < 3.0.
|
171
|
+
- On Windows use a specialized wait function as a workaround for very poor performance of rb_io_wait(). #416
|
172
|
+
|
173
|
+
Bugfixes:
|
174
|
+
- Release GVL while calling PQping which is a blocking method, but it didn't release GVL so far.
|
175
|
+
- Fix Connection#transaction to no longer block on interrupts, for instance when pressing Ctrl-C and cancel a running query. #390
|
176
|
+
- Avoid casting of OIDs to fix compat with Redshift database. #369
|
177
|
+
- Call conn.block before each conn.get_result call to avoid possible blocking in case of a slow network and multiple query results.
|
178
|
+
- Sporadic Errno::ENOTSOCK when using conn.socket_io on Windows #398
|
179
|
+
|
180
|
+
Deprecated:
|
181
|
+
- Add deprecation warning to PG::BasicTypeRegistry.register_type and siblings.
|
182
|
+
|
183
|
+
Removed:
|
184
|
+
- Remove support of ruby-2.2, 2.3 and 2.4. Minimum is ruby-2.5 now.
|
185
|
+
- Remove support for PostgreSQL-9.2. Minimum is PostgreSQL-9.3 now.
|
186
|
+
- Remove constant PG::REVISION, which was broken since pg-1.1.4.
|
187
|
+
|
188
|
+
Repository:
|
189
|
+
- Replace Hoe by Bundler for gem packaging
|
190
|
+
- Add Github Actions CI and testing of source and binary gems.
|
191
|
+
|
192
|
+
|
193
|
+
== v1.2.3 [2020-03-18] Michael Granger <ged@FaerieMUD.org>
|
194
|
+
|
195
|
+
Bugfixes:
|
196
|
+
|
197
|
+
- Fix possible segfault at `PG::Coder#encode`, `decode` or their implicit calls through
|
198
|
+
a typemap after GC.compact. #327
|
199
|
+
- Fix possible segfault in `PG::TypeMapByClass` after GC.compact. #328
|
200
|
+
|
201
|
+
|
202
|
+
== v1.2.2 [2020-01-06] Michael Granger <ged@FaerieMUD.org>
|
203
|
+
|
204
|
+
Enhancements:
|
205
|
+
|
206
|
+
- Add a binary gem for Ruby 2.7.
|
207
|
+
|
208
|
+
|
209
|
+
== v1.2.1 [2020-01-02] Michael Granger <ged@FaerieMUD.org>
|
210
|
+
|
211
|
+
Enhancements:
|
212
|
+
|
213
|
+
- Added internal API for sequel_pg compatibility.
|
214
|
+
|
215
|
+
|
216
|
+
== v1.2.0 [2019-12-20] Michael Granger <ged@FaerieMUD.org>
|
217
|
+
|
218
|
+
Repository:
|
219
|
+
- Our primary repository has been moved to Github https://github.com/ged/ruby-pg .
|
220
|
+
Most of the issues from https://bitbucket.org/ged/ruby-pg have been migrated. #43
|
221
|
+
|
222
|
+
API enhancements:
|
223
|
+
- Add PG::Result#field_name_type= and siblings to allow symbols to be used as field names. #306
|
224
|
+
- Add new methods for error reporting:
|
225
|
+
- PG::Connection#set_error_context_visibility
|
226
|
+
- PG::Result#verbose_error_message
|
227
|
+
- PG::Result#result_verbose_error_message (alias)
|
228
|
+
- Update errorcodes and error classes to PostgreSQL-12.0.
|
229
|
+
- New constants: PG_DIAG_SEVERITY_NONLOCALIZED, PQERRORS_SQLSTATE, PQSHOW_CONTEXT_NEVER, PQSHOW_CONTEXT_ERRORS, PQSHOW_CONTEXT_ALWAYS
|
230
|
+
|
231
|
+
Type cast enhancements:
|
232
|
+
- Add PG::TextEncoder::Record and PG::TextDecoder::Record for en/decoding of Composite Types. #258, #36
|
233
|
+
- Add PG::BasicTypeRegistry.register_coder to register instances instead of classes.
|
234
|
+
This is useful to register parametrized en/decoders like PG::TextDecoder::Record .
|
235
|
+
- Add PG::BasicTypeMapForQueries#encode_array_as= to switch between various interpretations of ruby arrays.
|
236
|
+
- Add Time, Array<Time>, Array<BigDecimal> and Array<IPAddr> encoders to PG::BasicTypeMapForQueries
|
237
|
+
- Exchange sprintf based float encoder by very fast own implementation with more natural format. #301
|
238
|
+
- Define encode and decode methods only in en/decoders that implement it, so that they can be queried by respond_to? .
|
239
|
+
- Improve PG::TypeMapByColumn#inspect
|
240
|
+
- Accept Integer and Float as input to TextEncoder::Numeric . #310
|
241
|
+
|
242
|
+
Other enhancements:
|
243
|
+
- Allocate the data part and the ruby object of PG::Result in one step, so that we don't need to check for valid data.
|
244
|
+
This removes PG::Result.allocate and PG::Result.new, which were callable but without any practical use. #42
|
245
|
+
- Make use of PQresultMemorySize() of PostgreSQL-12 and fall back to our internal estimator.
|
246
|
+
- Improve performance of PG::Result#stream_each_tuple .
|
247
|
+
- Store client encoding in data part of PG::Connection and PG::Result objects, so that we no longer use ruby's internal encoding bits. #280
|
248
|
+
- Update Windows fat binary gem to OpenSSL-1.1.1d and PostgreSQL-12.1.
|
249
|
+
- Add support for TruffleRuby. It is regularly tested as part of our CI.
|
250
|
+
- Enable +frozen_string_literal+ in all pg's ruby files
|
251
|
+
|
252
|
+
Bugfixes:
|
253
|
+
- Update the license in gemspec to "BSD-2-Clause".
|
254
|
+
It was incorrectly labeled "BSD-3-Clause". #40
|
255
|
+
- Respect PG::Coder#flags in PG::Coder#to_h.
|
256
|
+
- Fix PG::Result memsize reporting after #clear.
|
257
|
+
- Release field names to GC on PG::Result#clear.
|
258
|
+
- Fix double free in PG::Result#stream_each_tuple when an exception is raised in the block.
|
259
|
+
- Fix PG::Result#stream_each_tuple to deliver typemapped values.
|
260
|
+
- Fix encoding of Array<unknown> with PG::BasicTypeMapForQueries
|
261
|
+
|
262
|
+
Deprecated:
|
263
|
+
- Add a deprecation warning to PG::Connection#socket .
|
264
|
+
|
265
|
+
Removed:
|
266
|
+
- Remove PG::Connection#guess_result_memsize= which was temporary added in pg-1.1.
|
267
|
+
- Remove PG::Result.allocate and PG::Result.new (see enhancements).
|
268
|
+
- Remove support of tainted objects. #307
|
269
|
+
- Remove support of ruby-2.0 and 2.1. Minimum is ruby-2.2 now.
|
270
|
+
|
271
|
+
Documentation:
|
272
|
+
- Update description of connection params. See PG::Connection.new
|
273
|
+
- Link many method descriptions to corresponding libpq's documentation.
|
274
|
+
- Update sync_* and async_* query method descriptions and document the aliases.
|
275
|
+
The primary documentation is now at the async_* methods which are the default since pg-1.1.
|
276
|
+
- Fix documentation of many constants
|
277
|
+
|
278
|
+
|
279
|
+
== v1.1.4 [2019-01-08] Michael Granger <ged@FaerieMUD.org>
|
280
|
+
|
281
|
+
- Fix PG::BinaryDecoder::Timestamp on 32 bit systems. # 284
|
282
|
+
- Add new error-codes of PostgreSQL-11.
|
283
|
+
- Add ruby-2.6 support for Windows fat binary gems and remove ruby-2.0 and 2.1.
|
284
|
+
|
285
|
+
|
1
286
|
== v1.1.3 [2018-09-06] Michael Granger <ged@FaerieMUD.org>
|
2
287
|
|
3
288
|
- Revert opimization that was sometimes causing EBADF in rb_wait_for_single_fd().
|
@@ -24,10 +309,10 @@ Deprecated (disable warnings per PG_SKIP_DEPRECATION_WARNING=1):
|
|
24
309
|
- Forwarding conn.async_exec_params to conn.async_exec is deprecated.
|
25
310
|
|
26
311
|
PG::Connection enhancements:
|
27
|
-
- Provide PG::Connection#sync_* and PG::Connection#async_* query methods for explicit calling
|
312
|
+
- Provide PG::Connection#sync_* and PG::Connection#async_* query methods for explicit calling synchronous or asynchronous libpq API.
|
28
313
|
- Make PG::Connection#exec and siblings switchable between sync and async API per PG::Connection.async_api= and change the default to async flavors.
|
29
314
|
- Add async flavors of exec_params, prepare, exec_prepared, describe_prepared and describe_portal.
|
30
|
-
They are identical to their
|
315
|
+
They are identical to their synchronous counterpart, but make use of PostgreSQL's async API.
|
31
316
|
- Replace `rb_thread_fd_select()` by faster `rb_wait_for_single_fd()` in `conn.block` and `conn.async_exec` .
|
32
317
|
- Add PG::Connection#discard_results .
|
33
318
|
- Raise an ArgumentError for strings containing zero bytes by #escape, #escape_literal, #escape_identifier, #quote_ident and PG::TextEncoder::Identifier. These methods previously truncated strings.
|
@@ -182,7 +467,7 @@ Bugfixes:
|
|
182
467
|
- Revert addition of PG::Connection#hostaddr [#202].
|
183
468
|
- Fix decoding of fractional timezones and timestamps [#203]
|
184
469
|
- Fixes for non-C99 compilers
|
185
|
-
- Avoid possible symbol name clash when linking
|
470
|
+
- Avoid possible symbol name clash when linking against static libpq.
|
186
471
|
|
187
472
|
|
188
473
|
== v0.18.1 [2015-01-05] Michael Granger <ged@FaerieMUD.org>
|
@@ -218,7 +503,7 @@ Enhancements:
|
|
218
503
|
Bugfixes:
|
219
504
|
|
220
505
|
- Fix compatibility with signal handlers defined in Ruby. This reverts
|
221
|
-
|
506
|
+
cancellation of queries running on top of the blocking libpq API (like
|
222
507
|
Connection#exec) in case of signals. As an alternative the #async_exec
|
223
508
|
can be used, which is reverted to use the non-blocking API, again.
|
224
509
|
- Wrap PQcancel to be called without GVL. It internally waits for
|
@@ -296,7 +581,7 @@ Enhancements:
|
|
296
581
|
|
297
582
|
- Tested under Ruby 2.0.0p0.
|
298
583
|
- Add single row mode of PostgreSQL 9.2.
|
299
|
-
- Set fallback_application_name to
|
584
|
+
- Set fallback_application_name to program name $0. Thanks to Will Leinweber
|
300
585
|
for the patch.
|
301
586
|
- Release Ruby's GVL while calls to blocking libpq functions to allow better
|
302
587
|
concurrency in threaded applications.
|
@@ -304,7 +589,7 @@ Enhancements:
|
|
304
589
|
- Make use of rb_thread_fd_select() on Ruby 1.9 and avoid deprecated
|
305
590
|
rb_thread_select().
|
306
591
|
- Add an example of how to insert array data using a prepared statement (#145).
|
307
|
-
- Add
|
592
|
+
- Add continuous integration tests on travis-ci.org.
|
308
593
|
- Add PG::Result#each_row for iterative over result sets by row. Thanks to
|
309
594
|
Aaron Patterson for the patch.
|
310
595
|
- Add a PG::Connection#socket_io method for fetching a (non-autoclosing) IO
|
data/Manifest.txt
CHANGED
@@ -1,6 +1,5 @@
|
|
1
1
|
.gemtest
|
2
2
|
BSDL
|
3
|
-
ChangeLog
|
4
3
|
Contributors.rdoc
|
5
4
|
History.rdoc
|
6
5
|
LICENSE
|
@@ -26,6 +25,7 @@ ext/pg_coder.c
|
|
26
25
|
ext/pg_connection.c
|
27
26
|
ext/pg_copy_coder.c
|
28
27
|
ext/pg_errors.c
|
28
|
+
ext/pg_record_coder.c
|
29
29
|
ext/pg_result.c
|
30
30
|
ext/pg_text_decoder.c
|
31
31
|
ext/pg_text_encoder.c
|
@@ -37,8 +37,8 @@ ext/pg_type_map_by_column.c
|
|
37
37
|
ext/pg_type_map_by_mri_type.c
|
38
38
|
ext/pg_type_map_by_oid.c
|
39
39
|
ext/pg_type_map_in_ruby.c
|
40
|
-
ext/
|
41
|
-
ext/
|
40
|
+
ext/pg_util.c
|
41
|
+
ext/pg_util.h
|
42
42
|
ext/vc/pg.sln
|
43
43
|
ext/vc/pg_18/pg.vcproj
|
44
44
|
ext/vc/pg_19/pg_19.vcproj
|
data/README-Windows.rdoc
CHANGED
@@ -35,8 +35,8 @@ Binary gems for windows can be built on Linux, OS-X and even on Windows
|
|
35
35
|
with the help of docker. This is how regular windows gems are built for
|
36
36
|
rubygems.org .
|
37
37
|
|
38
|
-
To do this, install boot2docker
|
39
|
-
or
|
38
|
+
To do this, install boot2docker {on Windows}[https://github.com/boot2docker/windows-installer/releases]
|
39
|
+
or {on OS X}[https://github.com/boot2docker/osx-installer/releases] and make
|
40
40
|
sure it is started. A native Docker installation is best on Linux.
|
41
41
|
|
42
42
|
Then run:
|
@@ -50,7 +50,7 @@ containing binaries for all supported ruby versions.
|
|
50
50
|
|
51
51
|
== Reporting Problems
|
52
52
|
|
53
|
-
If you have any problems you can submit them via
|
54
|
-
|
53
|
+
If you have any problems you can submit them via {the project's
|
54
|
+
issue-tracker}[https://github.com/ged/ruby-pg/issues]. And submit questions, problems, or
|
55
55
|
solutions, so that it can be improved.
|
56
56
|
|
data/README.ja.rdoc
CHANGED
data/README.rdoc
CHANGED
@@ -1,8 +1,8 @@
|
|
1
1
|
= pg
|
2
2
|
|
3
|
-
home :: https://
|
4
|
-
mirror :: https://github.com/ged/ruby-pg
|
3
|
+
home :: https://github.com/ged/ruby-pg
|
5
4
|
docs :: http://deveiate.org/code/pg
|
5
|
+
clog :: link:/History.rdoc
|
6
6
|
|
7
7
|
{<img src="https://badges.gitter.im/Join%20Chat.svg" alt="Join the chat at https://gitter.im/ged/ruby-pg">}[https://gitter.im/ged/ruby-pg?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge]
|
8
8
|
|
@@ -11,7 +11,7 @@ docs :: http://deveiate.org/code/pg
|
|
11
11
|
|
12
12
|
Pg is the Ruby interface to the {PostgreSQL RDBMS}[http://www.postgresql.org/].
|
13
13
|
|
14
|
-
It works with {PostgreSQL 9.
|
14
|
+
It works with {PostgreSQL 9.3 and later}[http://www.postgresql.org/support/versioning/].
|
15
15
|
|
16
16
|
A small example usage:
|
17
17
|
|
@@ -25,22 +25,22 @@ A small example usage:
|
|
25
25
|
puts " PID | User | Query"
|
26
26
|
result.each do |row|
|
27
27
|
puts " %7d | %-16s | %s " %
|
28
|
-
row.values_at('
|
28
|
+
row.values_at('pid', 'usename', 'query')
|
29
29
|
end
|
30
30
|
end
|
31
31
|
|
32
32
|
== Build Status
|
33
33
|
|
34
|
-
{<img src="https://
|
35
|
-
{<img src="https://ci.appveyor.com/api/projects/status/
|
36
|
-
|
34
|
+
{<img src="https://github.com/ged/ruby-pg/actions/workflows/source-gem.yml/badge.svg?branch=master" alt="Build Status Github Actions" />}[https://github.com/ged/ruby-pg/actions/workflows/source-gem.yml]
|
35
|
+
{<img src="https://ci.appveyor.com/api/projects/status/gjx5axouf3b1wicp?svg=true" alt="Build Status Appveyor" />}[https://ci.appveyor.com/project/ged/ruby-pg-9j8l3]
|
36
|
+
{<img src="https://app.travis-ci.com/larskanis/ruby-pg.svg?branch=master" alt="Build Status" />}[https://app.travis-ci.com/larskanis/ruby-pg]
|
37
37
|
|
38
38
|
== Requirements
|
39
39
|
|
40
|
-
* Ruby 2.
|
41
|
-
* PostgreSQL 9.
|
40
|
+
* Ruby 2.4 or newer
|
41
|
+
* PostgreSQL 9.3.x or later (with headers, -dev packages, etc).
|
42
42
|
|
43
|
-
It usually
|
43
|
+
It usually works with earlier versions of Ruby/PostgreSQL as well, but those are
|
44
44
|
not regularly tested.
|
45
45
|
|
46
46
|
|
@@ -78,7 +78,7 @@ There's also {a Google+ group}[http://goo.gl/TFy1U] and a
|
|
78
78
|
want to chat about something.
|
79
79
|
|
80
80
|
If you want to install as a signed gem, the public certs of the gem signers
|
81
|
-
can be found in {the `certs` directory}[https://
|
81
|
+
can be found in {the `certs` directory}[https://github.com/ged/ruby-pg/tree/master/certs]
|
82
82
|
of the repository.
|
83
83
|
|
84
84
|
|
@@ -118,6 +118,30 @@ to build composite types by assigning an element encoder/decoder.
|
|
118
118
|
PG::Coder objects can be used to set up a PG::TypeMap or alternatively
|
119
119
|
to convert single values to/from their string representation.
|
120
120
|
|
121
|
+
The following PostgreSQL column types are supported by ruby-pg (TE = Text Encoder, TD = Text Decoder, BE = Binary Encoder, BD = Binary Decoder):
|
122
|
+
* Integer: {TE}[rdoc-ref:PG::TextEncoder::Integer], {TD}[rdoc-ref:PG::TextDecoder::Integer], {BD}[rdoc-ref:PG::BinaryDecoder::Integer] 💡 No links? Switch to {here}[https://deveiate.org/code/pg/README_rdoc.html#label-Type+Casts] 💡
|
123
|
+
* BE: {Int2}[rdoc-ref:PG::BinaryEncoder::Int2], {Int4}[rdoc-ref:PG::BinaryEncoder::Int4], {Int8}[rdoc-ref:PG::BinaryEncoder::Int8]
|
124
|
+
* Float: {TE}[rdoc-ref:PG::TextEncoder::Float], {TD}[rdoc-ref:PG::TextDecoder::Float], {BD}[rdoc-ref:PG::BinaryDecoder::Float]
|
125
|
+
* Numeric: {TE}[rdoc-ref:PG::TextEncoder::Numeric], {TD}[rdoc-ref:PG::TextDecoder::Numeric]
|
126
|
+
* Boolean: {TE}[rdoc-ref:PG::TextEncoder::Boolean], {TD}[rdoc-ref:PG::TextDecoder::Boolean], {BE}[rdoc-ref:PG::BinaryEncoder::Boolean], {BD}[rdoc-ref:PG::BinaryDecoder::Boolean]
|
127
|
+
* String: {TE}[rdoc-ref:PG::TextEncoder::String], {TD}[rdoc-ref:PG::TextDecoder::String], {BE}[rdoc-ref:PG::BinaryEncoder::String], {BD}[rdoc-ref:PG::BinaryDecoder::String]
|
128
|
+
* Bytea: {TE}[rdoc-ref:PG::TextEncoder::Bytea], {TD}[rdoc-ref:PG::TextDecoder::Bytea], {BE}[rdoc-ref:PG::BinaryEncoder::Bytea], {BD}[rdoc-ref:PG::BinaryDecoder::Bytea]
|
129
|
+
* Base64: {TE}[rdoc-ref:PG::TextEncoder::ToBase64], {TD}[rdoc-ref:PG::TextDecoder::FromBase64], {BE}[rdoc-ref:PG::BinaryEncoder::FromBase64], {BD}[rdoc-ref:PG::BinaryDecoder::ToBase64]
|
130
|
+
* Timestamp:
|
131
|
+
* TE: {local}[rdoc-ref:PG::TextEncoder::TimestampWithoutTimeZone], {UTC}[rdoc-ref:PG::TextEncoder::TimestampUtc], {with-TZ}[rdoc-ref:PG::TextEncoder::TimestampWithTimeZone]
|
132
|
+
* TD: {local}[rdoc-ref:PG::TextDecoder::TimestampLocal], {UTC}[rdoc-ref:PG::TextDecoder::TimestampUtc], {UTC-to-local}[rdoc-ref:PG::TextDecoder::TimestampUtcToLocal]
|
133
|
+
* BD: {local}[rdoc-ref:PG::BinaryDecoder::TimestampLocal], {UTC}[rdoc-ref:PG::BinaryDecoder::TimestampUtc], {UTC-to-local}[rdoc-ref:PG::BinaryDecoder::TimestampUtcToLocal]
|
134
|
+
* Date: {TE}[rdoc-ref:PG::TextEncoder::Date], {TD}[rdoc-ref:PG::TextDecoder::Date]
|
135
|
+
* JSON and JSONB: {TE}[rdoc-ref:PG::TextEncoder::JSON], {TD}[rdoc-ref:PG::TextDecoder::JSON]
|
136
|
+
* Inet: {TE}[rdoc-ref:PG::TextEncoder::Inet], {TD}[rdoc-ref:PG::TextDecoder::Inet]
|
137
|
+
* Array: {TE}[rdoc-ref:PG::TextEncoder::Array], {TD}[rdoc-ref:PG::TextDecoder::Array]
|
138
|
+
* Composite Type (also called "Row" or "Record"): {TE}[rdoc-ref:PG::TextEncoder::Record], {TD}[rdoc-ref:PG::TextDecoder::Record]
|
139
|
+
|
140
|
+
The following text formats can also be encoded although they are not used as column type:
|
141
|
+
* COPY input and output data: {TE}[rdoc-ref:PG::TextEncoder::CopyRow], {TD}[rdoc-ref:PG::TextDecoder::CopyRow]
|
142
|
+
* Literal for insertion into SQL string: {TE}[rdoc-ref:PG::TextEncoder::QuotedLiteral]
|
143
|
+
* SQL-Identifier: {TE}[rdoc-ref:PG::TextEncoder::Identifier], {TD}[rdoc-ref:PG::TextDecoder::Identifier]
|
144
|
+
|
121
145
|
=== PG::TypeMap and derivations (ext/pg_type_map*.c, lib/pg/type_map*.rb)
|
122
146
|
|
123
147
|
A TypeMap defines which value will be converted by which encoder/decoder.
|
@@ -129,11 +153,23 @@ A type map can be assigned per connection or per query respectively per
|
|
129
153
|
result set. Type maps can also be used for COPY in and out data streaming.
|
130
154
|
See PG::Connection#copy_data .
|
131
155
|
|
156
|
+
The following base type maps are available:
|
157
|
+
* PG::TypeMapAllStrings - encodes and decodes all values to and from strings (default)
|
158
|
+
* PG::TypeMapByClass - selects encoder based on the class of the value to be sent
|
159
|
+
* PG::TypeMapByColumn - selects encoder and decoder by column order
|
160
|
+
* PG::TypeMapByOid - selects decoder by PostgreSQL type OID
|
161
|
+
* PG::TypeMapInRuby - define a custom type map in ruby
|
162
|
+
|
163
|
+
The following type maps are prefilled with type mappings from the PG::BasicTypeRegistry :
|
164
|
+
* PG::BasicTypeMapForResults - a PG::TypeMapByOid prefilled with decoders for common PostgreSQL column types
|
165
|
+
* PG::BasicTypeMapBasedOnResult - a PG::TypeMapByOid prefilled with encoders for common PostgreSQL column types
|
166
|
+
* PG::BasicTypeMapForQueries - a PG::TypeMapByClass prefilled with encoders for common Ruby value classes
|
167
|
+
|
168
|
+
|
132
169
|
== Contributing
|
133
170
|
|
134
|
-
To report bugs, suggest features, or check out the source with
|
135
|
-
{check out the project page}[
|
136
|
-
Git, there's also a {Github mirror}[https://github.com/ged/ruby-pg].
|
171
|
+
To report bugs, suggest features, or check out the source with Git,
|
172
|
+
{check out the project page}[https://github.com/ged/ruby-pg].
|
137
173
|
|
138
174
|
After checking out the source, run:
|
139
175
|
|
@@ -148,7 +184,7 @@ Lars Kanis <lars@greiz-reinsdorf.de>.
|
|
148
184
|
|
149
185
|
== Copying
|
150
186
|
|
151
|
-
Copyright (c) 1997-
|
187
|
+
Copyright (c) 1997-2019 by the authors.
|
152
188
|
|
153
189
|
* Jeff Davis <ruby-pg@j-davis.com>
|
154
190
|
* Guy Decoux (ts) <decoux@moulon.inra.fr>
|