* Guile-PG 0.37 available
@ 2008-05-24 5:19 Thien-Thi Nguyen
0 siblings, 0 replies; only message in thread
From: Thien-Thi Nguyen @ 2008-05-24 5:19 UTC (permalink / raw
To: guile-sources; +Cc: guile-user
release notes:
Saw a patch floating around to adapt Guile-PG to Guile versions
other than 1.4.x, so some of that is included in this release,
as the first step towards full Guile 1.8.x support. If you're
interested in full Guile 1.8.x support appearing sooner, why not
consider funding its development/testing/maintenance?
thi
README excerpt:
Guile-PG is a collection of modules for Guile allowing access to
the PostgreSQL RDBMS from Scheme programs.
The low-level module `(database postgres)' provides an almost
one-to-one correspondence with the PostgreSQL "libpq" C library
interface. Other higher-level modules, typically named
`(database postgres-FOO)', provide abstractions and convenience
procedures.
This is alpha code (pre 1.0 release). It has bugs, and the
interfaces may change from version to version.
NEWS excerpt:
- 0.37 | 2008-05-24
- Configuration change: search $prefix for PostgreSQL headers/libs
Previously, the configure script would look in the "normal"
system directories (e.g., /usr/include and /usr/lib) for
PostgreSQL headers and libraries, by default. Now, it looks
under $prefix/include and $prefix/lib, respectively.
This means that the common (for ttn) case where all three packages
(Guile, PostgreSQL, Guile-PG) are installed under the same prefix
(e.g., ~/local) requires one less command-line option to the
configure script. In any case, `--with-libpq' and friends are
still available for specifying dirs directly (see README).
- Change to pg-get-connection
This proc now returns #f if its arg's connection is no longer live.
You should probably avoid it altogether; see following NEWS item.
- Planned modesty
Currently, Guile-PG exposes some accounting (implementation) details
that it shouldn't. These are the "serial number" of connection and
result objects, and the link between a result object the connection
object where it originated. These details WILL BE REMOVED after
2008-10-01; do NOT rely on them. Practically speaking, this means
`pg-get-connection' will be deleted and the external representation
for the objects will drop the "N" field:
until 2008-10-01: #<PG-CONN:N:...> and #<PG-RESULT:N:...>
after 2008-10-01: #<PG-CONN:...> and #<PG-RESULT:...>
To achieve `pg-get-connection' functionality, in most cases, it's
enough to simply save the connection object used to make the request
in the first place.
;; migration strategy: use connection object directly
(define RES (pg-exec CONN ...))
(eq? (pg-get-connection RES) CONN)
=> #t
In other cases, probably the next best solution is to define an
object property for the association.
;; migration strategy: define/maintain/consult object property
(define res-conns (make-object-property))
(define (conn-saving-exec conn query)
(let ((res (pg-exec conn query)))
(set! (res-conns res) conn)
res))
(define RES (conn-saving-exec CONN ...))
(eq? (pg-get-connection RES) (res-conns RES))
=> #t
- Tests issue SQL commands directly to CREATE and DROP the test database
Previously "make check" required the commands createdb(1) and
dropdb(1) (or destroydb(1) for older PostgreSQL versions) to be
installed on the system. Now, the test infrastructure uses Guile-PG
module (database postgres) to connect to "template1" and issues SQL
commands "CREATE DATABASE" and "DROP DATABASE" directly.
[ttn musing ...] This change unfortunately does not remove a long-
standing unexplained phenomenon: although the procs for doing the
create/drop (now) take care to `pg-finish' the connection to
template1 (see test/testing.scm, last page), it seems PostgreSQL
does not synchronously "finish" internally using template1. This
explains the (previously one `sleep' and now) two `usleep' calls,
which ideally would not be necessary. Perhaps after the planned
modesty occurs (see above), things will be more deterministic?
- New (database postgres-meta) proc: information-schema-names
- New (database postgres-meta) proc: information-schema-coldefs
These procs describe Guile-PG's "standard introspection" support,
as specified in the PostgreSQL 7.4.19 documentation (chapter 32,
"The Information Schema").
Additionally, loading the module defines type converters for
`cardinal_number', `character_data' and `sql_identifier'. The
`time_stamp' type converter does not seem to be used and is not
provided.
- New pgtable-manager (and -worker) command: #:finish
This closes the (internal) connection and arranges for all future
invocations of the closure to signal a "dead connection" error.
- Proc `gxrepl' closes connection when done
- New support for #:FOO-all combiners in `parse+make-SELECT-tree'
This (database postgres-qcons) proc now supports #:union-all,
#:intersect-all and #:except-all, as combiners.
- Maintenance uses autoconf 2.62, automake 1.10.1, libtool 2.2.2
tarball, prettified source, etc, in dir:
http://www.gnuvola.org/software/guile-pg/
atom feed:
http://www.gnuvola.org/NEWS.xml.gz
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2008-05-24 5:19 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-05-24 5:19 Guile-PG 0.37 available Thien-Thi Nguyen
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).