2020-02-16 22:42:04 +01:00
# pq - A pure Go postgres driver for Go's database/sql package
2020-04-22 12:16:38 +02:00
[![GoDoc ](https://godoc.org/github.com/lib/pq?status.svg )](https://pkg.go.dev/github.com/lib/pq?tab=doc)
2020-02-16 22:42:04 +01: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-04-22 12:16:38 +02:00
## Tests
2020-02-16 22:42:04 +01:00
2020-04-22 12:16:38 +02:00
`go test` is used for testing. See [TESTS.md ](TESTS.md ) for more details.
2020-02-16 22:42:04 +01:00
2020-04-22 12:16:38 +02:00
## Status
2020-02-16 22:42:04 +01:00
2020-04-22 12:16:38 +02: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.