Bugfixes:
Handle PGRES_COMMAND_OK in pgresult_stream_any. #447 Fixes usage when trying to stream the result of a procedure call that returns no results.
Enhancements:
Rename BasicTypeRegistry#define_default_types to register_default_types to use a more consistent terminology. Keeping define_default_types for compatibility.
BasicTypeRegistry: return self instead of objects by accident. This allows call chaining.
Add some April fun. #449
Documentation:
Refine documentation of conn.socket_io and conn.connect_poll
Bugfixes:
Don’t leak IO in case of connection errors. #439 Previously it was kept open until the PG::Connection was garbage collected.
Fix a performance regession in conn.get_result noticed in single row mode. #442
Fix occasional error Errno::EBADF (Bad file descriptor) while connecting. #444
Fix compatibility of res.stream_each* methods with Fiber.scheduler. #446
Remove FL_TEST and FL_SET, which are MRI-internal. #437
Enhancements:
Allow pgresult_stream_any to be used by sequel_pg. #443
Bugfixes:
Fix omission of the third digit of IPv4 addresses in connection URI. #435
Fix wrong permission of certs/larskanis-2022.pem in the pg-1.3.2.gem. #432
Bugfixes:
Cancel only active query after failing transaction. #430 This avoids an incompatibility with pgbouncer since pg-1.3.0.
Fix String objects with non-applied encoding when using COPY or record decoders. #427
Update Windows fat binary gem to PostgreSQL-14.2.
Enhancements:
Improve extconf.rb checks to reduces the number of compiler calls.
Add a check for PGRES_PIPELINE_SYNC, to make sure the library version and the header files are PostgreSQL-14+. #429
Bugfixes:
Fix wrong handling of socket writability on Windows introduced in #417. This caused starvation in conn.put_copy_data.
Fix error in PG.version_string(true). #419
Fix a regression in pg 1.3.0 where Ruby 2.x busy-looping any fractional seconds for every wait. #420
Enhancements:
Raise an error when conn.copy_data is used in nonblocking mode.
Install Enhancements:
Print some install help if libpq wasn’t found. #396 This should help to pick the necessary package without googling.
Update Windows fat binary gem to OpenSSL-1.1.1m and PostgreSQL-14.1.
Add binary Windows gems for Ruby 3.0 and 3.1.
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
Fall back to pkg-config if pg_config is not found. #380
Add option to extconf.rb to disable nogvl-wrapping of libpq functions. All methods (except PG::Connection.ping) are nonblocking now, so that GVL unlock is in theory no longer necessary. However it can have some advantage in concurrency, so that GVL unlock is still enabled by default. Use:
gem inst pg – –disable-gvl-unlock
API Enhancements:
Add full compatibility to Fiber.scheduler introduced in Ruby-3.0. #397
Add async_connect and async_send methods and add specific specs for Fiber.scheduler #342
Add async_get_result and async_get_last_result
Add async_get_copy_data
Implement async_put_copy_data/async_put_copy_end
Implement async_reset method using the nonblocking libpq API
Add async_set_client_encoding which is compatible to scheduler
Add async_cancel as a nonblocking version of conn#cancel
Add async_encrypt_password
Run Connection.ping in a second thread.
Make discard_results scheduler friendly
Do all socket waiting through the conn.socket_io object.
Avoid PG.connect blocking while address resolution by automatically providing the hostaddr parameter and resolving in Ruby instead of libpq.
On Windows Fiber.scheduler support requires Ruby-3.1+. It is also only partly usable since may ruby IO methods are not yet scheduler aware on Windows.
Add support for pipeline mode of PostgreSQL-14. #401
Allow specification of multiple hosts in PostgreSQL URI. #387
Add new method conn.backend_key - used to implement our own cancel method.
Type cast enhancements:
Add PG::BasicTypeMapForQueries::BinaryData for encoding of bytea columns. #348
Reduce time to build coder maps and permit to reuse them for several type maps per PG::BasicTypeRegistry::CoderMapsBundle.new(conn) . #376
Make BasicTypeRegistry a class and use a global default instance of it. Now a local type registry can be instanciated and given to the type map, to avoid changing shared global states.
Allow PG::BasicTypeMapForQueries to take a Proc as callback for undefined types.
Other Enhancements:
Convert all PG classes implemented in C to TypedData objects. #349
Support ObjectSpace.memsize_of(obj) on all classes implemented in C. #393
Make all PG objects implemented in C memory moveable and therefore GC.compact friendly. #349
Update errorcodes and error classes to PostgreSQL-14.0.
Add PG::CONNECTION_* constants for conn.status of newer PostgreSQL versions.
Add better support for logical replication. #339
Change conn.socket_io to read+write mode and to a BasicSocket object instead of IO.
Use rb_io_wait() and the conn.socket_io object if available for better compatibility to Fiber.scheduler . Fall back to rb_wait_for_single_fd() on ruby < 3.0.
On Windows use a specialized wait function as a workaround for very poor performance of rb_io_wait(). #416
Bugfixes:
Release GVL while calling PQping which is a blocking method, but it didn’t release GVL so far.
Fix Connection#transaction to no longer block on interrupts, for instance when pressing Ctrl-C and cancel a running query. #390
Avoid casting of OIDs to fix compat with Redshift database. #369
Call conn.block before each conn.get_result call to avoid possible blocking in case of a slow network and multiple query results.
Sporadic Errno::ENOTSOCK when using conn.socket_io on Windows #398
Deprecated:
Add deprecation warning to PG::BasicTypeRegistry.register_type and siblings.
Removed:
Remove support of ruby-2.2, 2.3 and 2.4. Minimum is ruby-2.5 now.
Remove support for PostgreSQL-9.2. Minimum is PostgreSQL-9.3 now.
Remove constant PG::REVISION, which was broken since pg-1.1.4.
Repository:
Replace Hoe by Bundler for gem packaging
Add Github Actions CI and testing of source and binary gems.
Bugfixes:
Fix possible segfault at ‘PG::Coder#encode`, `decode` or their implicit calls through a typemap after GC.compact. #327
Fix possible segfault in ‘PG::TypeMapByClass` after GC.compact. #328
Enhancements:
Add a binary gem for Ruby 2.7.
Enhancements:
Added internal API for sequel_pg compatibility.
Repository:
Our primary repository has been moved to Github github.com/ged/ruby-pg . Most of the issues from bitbucket.org/ged/ruby-pg have been migrated. #43
API enhancements:
Add PG::Result#field_name_type= and siblings to allow symbols to be used as field names. #306
Add new methods for error reporting:
Update errorcodes and error classes to PostgreSQL-12.0.
New constants: PG_DIAG_SEVERITY_NONLOCALIZED, PQERRORS_SQLSTATE, PQSHOW_CONTEXT_NEVER, PQSHOW_CONTEXT_ERRORS, PQSHOW_CONTEXT_ALWAYS
Type cast enhancements:
Add PG::TextEncoder::Record and PG::TextDecoder::Record for en/decoding of Composite Types. #258, #36
Add PG::BasicTypeRegistry.register_coder to register instances instead of classes. This is useful to register parametrized en/decoders like PG::TextDecoder::Record .
Add PG::BasicTypeMapForQueries#encode_array_as= to switch between various interpretations of ruby arrays.
Add Time, Array<Time>, Array<BigDecimal> and Array<IPAddr> encoders to PG::BasicTypeMapForQueries
Exchange sprintf based float encoder by very fast own implementation with more natural format. #301
Define encode and decode methods only in en/decoders that implement it, so that they can be queried by respond_to? .
Improve PG::TypeMapByColumn#inspect
Accept Integer and Float as input to TextEncoder::Numeric . #310
Other enhancements:
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. This removes PG::Result.allocate and PG::Result.new, which were callable but without any practical use. #42
Make use of PQresultMemorySize() of PostgreSQL-12 and fall back to our internal estimator.
Improve performance of PG::Result#stream_each_tuple .
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
Update Windows fat binary gem to OpenSSL-1.1.1d and PostgreSQL-12.1.
Add support for TruffleRuby. It is regularly tested as part of our CI.
Enable frozen_string_literal in all pg’s ruby files
Bugfixes:
Update the license in gemspec to “BSD-2-Clause”. It was incorrectly labeled “BSD-3-Clause”. #40
Respect PG::Coder#flags in PG::Coder#to_h.
Fix PG::Result memsize reporting after clear.
Release field names to GC on PG::Result#clear.
Fix double free in PG::Result#stream_each_tuple when an exception is raised in the block.
Fix PG::Result#stream_each_tuple to deliver typemapped values.
Fix encoding of Array<unknown> with PG::BasicTypeMapForQueries
Deprecated:
Add a deprecation warning to PG::Connection#socket .
Removed:
Remove PG::Connection#guess_result_memsize= which was temporary added in pg-1.1.
Remove PG::Result.allocate and PG::Result.new (see enhancements).
Remove support of tainted objects. #307
Remove support of ruby-2.0 and 2.1. Minimum is ruby-2.2 now.
Documentation:
Update description of connection params. See PG::Connection.new
Link many method descriptions to corresponding libpq’s documentation.
Update sync_* and async_* query method descriptions and document the aliases. The primary documentation is now at the async_* methods which are the default since pg-1.1.
Fix documentation of many constants
Fix PG::BinaryDecoder::Timestamp on 32 bit systems. # 284
Add new error-codes of PostgreSQL-11.
Add ruby-2.6 support for Windows fat binary gems and remove ruby-2.0 and 2.1.
Revert opimization that was sometimes causing EBADF in rb_wait_for_single_fd().
Don’t generate aliases for JOHAB encoding. This avoids linking to deprecated/private function rb_enc(db)_alias().
Reduce deprecation warnings to only one message per deprecation.
Deprecated (disable warnings per PG_SKIP_DEPRECATION_WARNING=1):
Forwarding conn.exec to conn.exec_params is deprecated.
Forwarding conn.exec_params to conn.exec is deprecated.
Forwarding conn.async_exec to conn.async_exec_params.
Forwarding conn.send_query to conn.send_query_params is deprecated.
Forwarding conn.async_exec_params to conn.async_exec is deprecated.
PG::Connection enhancements:
Provide PG::Connection#sync_* and PG::Connection#async_* query methods for explicit calling synchronous or asynchronous libpq API.
Make PG::Connection#exec and siblings switchable between sync and async API per PG::Connection.async_api= and change the default to async flavors.
Add async flavors of exec_params, prepare, exec_prepared, describe_prepared and describe_portal. They are identical to their synchronous counterpart, but make use of PostgreSQL’s async API.
Replace ‘rb_thread_fd_select()` by faster `rb_wait_for_single_fd()` in `conn.block` and `conn.async_exec` .
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.
Result retrieval enhancements:
Add PG::Result#tuple_values to retrieve all field values of a row as array.
Add PG::Tuple, PG::Result#tuple and PG::Result#stream_each_tuple . PG::Tuple offers a way to lazy cast result values.
Estimate PG::Result size allocated by libpq and notify the garbage collector about it when running on Ruby-2.4 or newer.
Make the estimated PG::Result size available to ObjectSpace.memsize_of(result) .
Type cast enhancements:
Replace Ruby code by a faster C implementation of the SimpleDecoder’s timestamp decode functions. github #20
Interpret years with up to 7 digists and BC dates by timestamp decoder.
Add text timestamp decoders for UTC vs. local timezone variations.
Add text timestamp encoders for UTC timezone.
Add decoders for binary timestamps: PG::BinaryDecoder::Timestamp and variations.
Add PG::Coder#flags accessor to allow modifications of de- respectively encoder behaviour.
Add a flag to raise TypeError for invalid input values to PG::TextDecoder::Array .
Add a text decoder for inet/cidr written in C.
Add a numeric decoder written in C.
Ensure input text is zero terminated for text format in PG::Coder#decode .
Source code enhancements:
Fix headers and permission bits of various repository files.
Bugfixes:
Properly decode array with prepended dimensions. #272 For now dimension decorations are ignored, but a correct Array is returned.
Array-Decoder: Avoid leaking memory when an Exception is raised while parsing. Fixes #279
Deprecated:
Deprecate Ruby older than 2.2.
Deprecate Connection#socket in favor of socket_io.
Removed:
Remove compatibility code for Ruby < 2.0 and PostgreSQL < 9.2.
Remove partial compatibility with Rubinius.
Remove top-level constants PGconn, PGresult, and PGError.
Enhancements:
Update error codes to PostgreSQL-10
Update Windows binary gems to Ruby-2.5, PostgreSQL 10.1 and OpenSSL 1.1.0g.
Bugfixes:
Fix URI detection for connection strings. #265 (thanks to jjoos)
MINGW: Workaround segfault due to GCC linker error in conjunction with MSVC. This happens when linking to PostgreSQL-10.0-x64 from EnterpriseDB.
Documentation fixes:
Add PostgreSQL version since when the given function is supported. #263
Better documentation to ‘encoder` and `decoder` arguments of COPY related methods.
Enhancements:
Move add_dll_directory to the Runtime namespace for newest versions of RubyInstaller.
Deprecate PGconn, PGresult, and PGError top-level constants; a warning will be output the first time one of them is used. They will be removed in the upcoming 1.0 release.
Documentation fixes:
Update the docs for PG::Result#cmd_tuples
New Samples:
Add an example of the nicer copy_data way of doing ‘COPY`.
Enhancements:
Update error codes to PostgreSQL-9.6
Update Windows binary gems to Ruby-2.4, PostgreSQL 9.6.1 and OpenSSL 1.0.2j.
Add support for RubyInstaller2 to Windows binary gems.
Bugfixes:
Use secure JSON methods for JSON (de)serialisation. #248
Fix Result#inspect on a cleared result.
Fix test case that failed on Ruby-2.4. #255
Documentation fixes:
Talk about Integer instead of Fixnum.
Fix method signature of Coder#encode.
Deprecate Ruby 1.9
Enhancements:
Respect and convert character encoding of all strings sent to the server. #231
Add PostgreSQL-9.5 functions PQsslInUse(), PQsslAttribute() and PQsslAttributeNames().
Various documentation fixes and improvements.
Add mechanism to build without pg_config:
gem install pg -- --with-pg-config=ignore
Update Windows binary gems to Ruby-2.3, PostgreSQL 9.5.4 and OpenSSL 1.0.2f.
Add JSON coders and add them to BasicTypeMapForResults and BasicTypeMapBasedOnResult
Allow build from git per bundler.
Bugfixes:
Release GVL while calling PQsetClientEncoding(). #245
Add __EXTENSIONS__ to Solaris/SmartOS for Ruby >= 2.3.x. #236
Fix wrong exception when running SQL while in Connection#copy_data block for output
Enhancements:
Fixing compilation problems with Microsoft Visual Studio 2008. GH #10
Avoid name clash with xcode and jemalloc. PR#22, PR#23
Bugfixes:
Avoid segfault, when quote_ident or TextEncoder::Identifier is called with Array containing non-strings. #226
Enhancements:
Use rake-compiler-dock to build windows gems easily.
Add CI-tests on appveyor and fix test cases accordingly.
Bugfixes:
Fix data type resulting in wrong base64 encoding.
Change instance_of checks to kind_of for subclassing. #220
TextDecoder::Date returns an actual Ruby Date instead of a Time (thanks to Thomas Ramfjord)
Enhancements:
Allow URI connection string (thanks to Chris Bandy)
Allow Array type parameter to conn.quote_ident
Bugfixes:
Speedups and fixes for PG::TextDecoder::Identifier and quoting behavior
Revert addition of PG::Connection#hostaddr [#202].
Fix decoding of fractional timezones and timestamps [#203]
Fixes for non-C99 compilers
Avoid possible symbol name clash when linking against static libpq.
Correct the minimum compatible Ruby version to 1.9.3. #199
Bugfixes:
Fix OID to Integer mapping (it is unsigned now). #187
Fix possible segfault in conjunction with notice receiver. #185
Enhancements:
Add an extensible type cast system.
A lot of performance improvements.
Return frozen String objects for result field names.
Add PG::Result#stream_each and stream_each_row as fast helpers for the single row mode.
Add Enumerator variant to PG::Result#each and each_row.
Add PG::Connection#conninfo and hostaddr.
Add PG.init_openssl and PG.init_ssl methods.
Force zero termination for all text strings that are given to libpq. It raises an ArgumentError if the string contains a null byte.
Update Windows cross build to PostgreSQL 9.3.
Bugfixes:
Fix compatibility with signal handlers defined in Ruby. This reverts cancellation of queries running on top of the blocking libpq API (like Connection#exec) in case of signals. As an alternative the async_exec can be used, which is reverted to use the non-blocking API, again.
Wrap PQcancel to be called without GVL. It internally waits for the canceling connection.
Documentation fixes:
Fix documentation for PG::Connection::conndefaults.
Bugfixes:
Fix crash by calling PQsend* and PQisBusy without GVL (#171).
Enhancements:
Add method PG::Connection#copy_data.
Add a Gemfile to allow installation of dependencies with bundler.
Add compatibility with rake-compiler-dev-box.
Return self from PG::Result#check instead of nil. This allows to stack method calls.
Bugfixes:
Avoid warnings about uninitialized instance variables.
Use a more standard method of adding library and include directories. This fixes build on AIX (Github #7) and Solaris (#164).
Cancel the running query, if a thread is about to be killed (e.g. by CTRL-C).
Fix GVL issue with wait_for_notify/notifies and notice callbacks.
Set proper encoding on the string returned by quote_ident, escape_literal and escape_identifier (#163).
Use nil as PG::Error#result in case of a NULL-result from libpq (#166).
Recalculate the timeout of conn#wait_for_notify and conn#block in case of socket events that require re-runs of select().
Documentation fixes:
Fix non working example for PGresult#error_field.
Enhancements:
Add unique exception classes for each PostgreSQL error type (#5).
Return result of the block in conn#transaction instead of nil (#158).
Allow ‘rake compile’ and ‘rake gem’ on non mercurial repos.
Add support for PG_DIAG_*_NAME error fields of PostgreSQL-9.3 (#161).
Bugfixes:
Shorten application_name to avoid warnings about truncated identifier.
Bugfixes:
Fix segfault in PG::Result#field_values when called with non String value.
Fix encoding of messages delivered by notice callbacks.
Fix text encoding for Connection#wait_for_notify and Connection#notifies.
Fix ‘Bad file descriptor’ problems under Windows: wrong behaviour of wait_for_notify() and timeout handling of block on Ruby 1.9.
Documentation fixes:
conn#socket() can not be used with IO.for_fd() on Windows.
Enhancements:
Tested under Ruby 2.0.0p0.
Add single row mode of PostgreSQL 9.2.
Set fallback_application_name to program name $0. Thanks to Will Leinweber for the patch.
Release Ruby’s GVL while calls to blocking libpq functions to allow better concurrency in threaded applications.
Refactor different variants of waiting for the connection socket.
Make use of rb_thread_fd_select() on Ruby 1.9 and avoid deprecated rb_thread_select().
Add an example of how to insert array data using a prepared statement (#145).
Add continuous integration tests on travis-ci.org.
Add PG::Result#each_row for iterative over result sets by row. Thanks to Aaron Patterson for the patch.
Add a PG::Connection#socket_io method for fetching a (non-autoclosing) IO object for the connection’s socket.
Specs:
Fix various specs to run on older PostgreSQL and Ruby versions.
Avoid fork() in specs to allow usage on Windows and JRuby.
Important bugfix:
Fix stack overflow bug in PG::Result#values and column_values (#135). Thanks to everyone who reported the bug, and Lars Kanis especially for figuring out the problem.
PostgreSQL 9.2 beta fixes:
Recognize PGRES_SINGLE_TUPLE as OK when checking PGresult (Jeremy Evans)
Documentation fixes:
Add note about the usage scope of the result object received by the set_notice_receiver block. (Lars Kanis)
Add PGRES_COPY_BOTH to documentation of PG::Result#result_status. (Lars Kanis)
Add some documentation to PG::Result#fnumber (fix for #139)
Bugfixes:
#47, #104
New Methods for PostgreSQL 9 and async API support: PG
::library_version
::ping
escape_literal
escape_identifier
set_default_encoding
check
New Samples:
This release also comes with a collection of contributed sample scripts for doing resource-utilization reports, graphing database statistics, monitoring for replication lag, shipping WAL files for replication, automated tablespace partitioning, etc. See the samples/ directory.
Make builds against PostgreSQL earlier than 8.3 fail with a descriptive message instead of a compile failure.
Made use of a finished PG::Connection raise a PG::Error instead of a fatal error (#110).
Added missing BSDL license file (#108)
Reorganization of modules/classes to be better Ruby citizens (with backward-compatible aliases):
Created toplevel namespace ‘PG’ to correspond with the gem name.
Renamed PGconn to PG::Connection (with ::PGconn alias)
Renamed PGresult to PG::Result (with ::PGresult alias)
Renamed PGError to PG::Error (with ::PGError alias)
Declare all constants inside PG::Constants, then include them in PG::Connection and PG::Result for backward-compatibility, and in PG for convenience.
Split the extension source up by class/module.
Removed old compatibility code for PostgreSQL versions < 8.3
Documentation:
Clarified licensing, updated to Ruby 1.9’s license.
Merged authors list, added some missing people to the Contributor’s list.
Cleaned up the sample/ directory
Making contact info a bit clearer, link to the Google+ page and the mailing list
Enhancements:
Added a convenience method: PG.connect -> PG::Connection.new
Bugfixes:
Fixed LATIN5-LATIN10 Postgres<->Ruby encoding conversions
Fix for the 1.8.7 breakage introduced by the st.h fix for alternative Ruby implementations (#97 and #98). Thanks to Lars Kanis for the patch.
Encode error messages with the connection’s encoding under 1.9 (#96)
Made rake-compiler a dev dependency, as Rubygems doesn’t use the Rakefile for compiling the extension. Thanks to eolamey@bitbucket and Jeremy Evans for pointing this out.
Added an explicit include for ruby/st.h for implementations that need it (fixes #95).
PGconn#wait_for_notify
send nil as the payload argument if the NOTIFY didn’t have one.
accept a nil argument for no timeout (Sequel support)
Fixed API docs
Taint and encode event name and payload
Handle errors while rb_thread_select()ing in PGconn#block. (Brian Weaver).
Fixes for Win32 async queries (Rafał Bigaj)
Memory leak fixed: Closing opened WSA event. (rafal)
Fixes for #66 Win32 asynchronous queries hang on connection error. (rafal)
Fixed a typo in PGconn#error_message’s documentation
fixing unused variable warnings for ruby 1.9.3 (Aaron Patterson)
Build system bugfixes
Converted to Hoe
Updates for the Win32 binary gem builds (Lars Kanis)
Enhancements:
Added a PGresult#values method to fetch all result rows as an Array of Arrays. Thanks to Jason Yanowitz (JYanowitz at enovafinancial dot com) for the patch.
Bugfixes:
Add an include guard for pg.h
Simplify the common case require of the ext
Include the extconf header
Fix compatibility with versions of PostgreSQL without PQgetCancel. (fixes #36)
Fix require for natively-compiled extension under Windows. (fixes #55)
Change rb_yield_splat() to rb_yield_values() for compatibility with Rubinius. (fixes #54)
Enhancements:
Added support for the payload of NOTIFY events (w/Mahlon E. Smith)
Updated the build system with Rubygems suggestions from RubyConf 2010
Bugfixes:
Fixed issue with PGconn#wait_for_notify that caused it to miss notifications that happened after the LISTEN but before the wait_for_notify.
Bugfixes.
Bugfixes, better Windows support.