2019-05-15 23:05:32 +00:00
# pq - A pure Go postgres driver for Go's database/sql package
2020-10-28 07:38:43 +00:00
[![GoDoc ](https://godoc.org/github.com/lib/pq?status.svg )](https://pkg.go.dev/github.com/lib/pq?tab=doc)
2019-05-15 23:05:32 +00:00
## Install
go get github.com/lib/pq
## Features
* SSL
* Handles bad connections for `database/sql`
* Scan `time.Time` correctly (i.e. `timestamp[tz]` , `time[tz]` , `date` )
* Scan binary blobs correctly (i.e. `bytea` )
* Package for `hstore` support
* COPY FROM support
* pq.ParseURL for converting urls to connection strings for sql.Open.
* Many libpq compatible environment variables
* Unix socket support
* Notifications: `LISTEN` /`NOTIFY`
* pgpass support
2020-10-28 07:38:43 +00:00
* GSS (Kerberos) auth
2019-05-15 23:05:32 +00:00
2020-10-28 07:38:43 +00:00
## Tests
2019-05-15 23:05:32 +00:00
2020-10-28 07:38:43 +00:00
`go test` is used for testing. See [TESTS.md ](TESTS.md ) for more details.
2019-05-15 23:05:32 +00:00
2020-10-28 07:38:43 +00:00
## Status
2019-05-15 23:05:32 +00:00
2020-10-28 07:38:43 +00:00
This package is effectively in maintenance mode and is not actively developed. Small patches and features are only rarely reviewed and merged. We recommend using [pgx ](https://github.com/jackc/pgx ) which is actively maintained.