README.md
1# pq - A pure Go postgres driver for Go's database/sql package
2
3[![GoDoc](https://godoc.org/github.com/lib/pq?status.svg)](https://godoc.org/github.com/lib/pq)
4[![Build Status](https://travis-ci.org/lib/pq.svg?branch=master)](https://travis-ci.org/lib/pq)
5
6## Install
7
8 go get github.com/lib/pq
9
10## Docs
11
12For detailed documentation and basic usage examples, please see the package
13documentation at <https://godoc.org/github.com/lib/pq>.
14
15## Tests
16
17`go test` is used for testing. See [TESTS.md](TESTS.md) for more details.
18
19## Features
20
21* SSL
22* Handles bad connections for `database/sql`
23* Scan `time.Time` correctly (i.e. `timestamp[tz]`, `time[tz]`, `date`)
24* Scan binary blobs correctly (i.e. `bytea`)
25* Package for `hstore` support
26* COPY FROM support
27* pq.ParseURL for converting urls to connection strings for sql.Open.
28* Many libpq compatible environment variables
29* Unix socket support
30* Notifications: `LISTEN`/`NOTIFY`
31* pgpass support
32
33## Future / Things you can help with
34
35* Better COPY FROM / COPY TO (see discussion in #181)
36
37## Thank you (alphabetical)
38
39Some of these contributors are from the original library `bmizerany/pq.go` whose
40code still exists in here.
41
42* Andy Balholm (andybalholm)
43* Ben Berkert (benburkert)
44* Benjamin Heatwole (bheatwole)
45* Bill Mill (llimllib)
46* Bjørn Madsen (aeons)
47* Blake Gentry (bgentry)
48* Brad Fitzpatrick (bradfitz)
49* Charlie Melbye (cmelbye)
50* Chris Bandy (cbandy)
51* Chris Gilling (cgilling)
52* Chris Walsh (cwds)
53* Dan Sosedoff (sosedoff)
54* Daniel Farina (fdr)
55* Eric Chlebek (echlebek)
56* Eric Garrido (minusnine)
57* Eric Urban (hydrogen18)
58* Everyone at The Go Team
59* Evan Shaw (edsrzf)
60* Ewan Chou (coocood)
61* Fazal Majid (fazalmajid)
62* Federico Romero (federomero)
63* Fumin (fumin)
64* Gary Burd (garyburd)
65* Heroku (heroku)
66* James Pozdena (jpoz)
67* Jason McVetta (jmcvetta)
68* Jeremy Jay (pbnjay)
69* Joakim Sernbrant (serbaut)
70* John Gallagher (jgallagher)
71* Jonathan Rudenberg (titanous)
72* Joël Stemmer (jstemmer)
73* Kamil Kisiel (kisielk)
74* Kelly Dunn (kellydunn)
75* Keith Rarick (kr)
76* Kir Shatrov (kirs)
77* Lann Martin (lann)
78* Maciek Sakrejda (uhoh-itsmaciek)
79* Marc Brinkmann (mbr)
80* Marko Tiikkaja (johto)
81* Matt Newberry (MattNewberry)
82* Matt Robenolt (mattrobenolt)
83* Martin Olsen (martinolsen)
84* Mike Lewis (mikelikespie)
85* Nicolas Patry (Narsil)
86* Oliver Tonnhofer (olt)
87* Patrick Hayes (phayes)
88* Paul Hammond (paulhammond)
89* Ryan Smith (ryandotsmith)
90* Samuel Stauffer (samuel)
91* Timothée Peignier (cyberdelia)
92* Travis Cline (tmc)
93* TruongSinh Tran-Nguyen (truongsinh)
94* Yaismel Miranda (ympons)
95* notedit (notedit)
96