pgx/README.md

pgx

Experimental PostgreSQL client library for Go

Usage

TODO

Development

ERB Templating

Sometimes Go code can be repetitive especially with dealing with functions that only differ in the type (e.g. ReadInt16, ReadInt32, ReadInt64). Some of this repetition can be eliminated by using a template preprocessor. pgx uses Ruby erb templates. Files that end in .go.erb are used to produce the corresponding .go files. These files are automatically automatically processed with rake.

Prerequisites:

• Ruby
• Rake

To automatically process .go.erb files and run the tests:

jack@hk-47~/dev/pgx$ rake test

Testing

To setup the test environment run the test_setup.sql script as a user that can create users and databases. To successfully run the connection tests for various means of authentication you must include the following in your pg_hba.conf.

local  pgx_test  pgx_none  trust
local  pgx_test  pgx_pw    password
local  pgx_test  pgx_md5   md5