11# Rust-Postgres
22A native PostgreSQL driver for Rust.
33
4- [ Documentation] ( https://sfackler.github.io/rust-postgres/doc/v0.11.11 /postgres )
4+ [ Documentation] ( https://sfackler.github.io/rust-postgres/doc/v0.12.0 /postgres )
55
66[ ![ Build Status] ( https://travis-ci.org/sfackler/rust-postgres.png?branch=master )] ( https://travis-ci.org/sfackler/rust-postgres ) [ ![ Latest Version] ( https://img.shields.io/crates/v/postgres.svg )] ( https://crates.io/crates/postgres )
77
88You can integrate Rust-Postgres into your project through the [ releases on crates.io] ( https://crates.io/crates/postgres ) :
99``` toml
10- # Cargo.toml
1110[dependencies ]
12- postgres = " 0.11 "
11+ postgres = " 0.12 "
1312```
1413
1514## Overview
1615Rust-Postgres is a pure-Rust frontend for the popular PostgreSQL database.
1716``` rust
1817extern crate postgres;
1918
20- use postgres :: {Connection , SslMode };
19+ use postgres :: {Connection , TlsMode };
2120
2221struct Person {
2322 id : i32 ,
@@ -26,7 +25,7 @@ struct Person {
2625}
2726
2827fn main () {
29- let conn = Connection :: connect (" postgres://postgres@localhost" SslMode :: None ). unwrap ();
28+ let conn = Connection :: connect (" postgres://postgres@localhost" TlsMode :: None ). unwrap ();
3029 conn . execute (" CREATE TABLE person (
3130 id SERIAL PRIMARY KEY,
3231 name VARCHAR NOT NULL,
@@ -51,7 +50,7 @@ fn main() {
5150```
5251
5352## Requirements
54- * ** Rust** - Rust-Postgres is developed against the 1.9 release of Rust
53+ * ** Rust** - Rust-Postgres is developed against the 1.10 release of Rust
5554 available on http://www.rust-lang.org . It should also compile against more
5655 recent releases.
5756
@@ -65,19 +64,18 @@ fn main() {
6564Connect to a Postgres server using the standard URI format:
6665``` rust
6766let conn = try ! (Connection :: connect (" postgres://user:pass@host:port/database?arg1=val1&arg2=val2"
68- SslMode :: None ));
67+ TlsMode :: None ));
6968```
7069` pass ` may be omitted if not needed. ` port ` defaults to ` 5432 ` and ` database `
7170defaults to the value of ` user ` if not specified. The driver supports ` trust ` ,
7271` password ` , and ` md5 ` authentication.
7372
74- Unix domain sockets can be used as well by activating the ` unix_socket ` or
75- ` nightly ` features. The ` host ` portion of the URI should be set to the absolute
76- path to the directory containing the socket file. Since ` / ` is a reserved
77- character in URLs, the path should be URL encoded. If Postgres stored its socket
78- files in ` /run/postgres ` , the connection would then look like:
73+ Unix domain sockets can be used as well. The ` host ` portion of the URI should
74+ be set to the absolute path to the directory containing the socket file. Since
75+ ` / ` is a reserved character in URLs, the path should be URL encoded. If Postgres
76+ stored its socket files in ` /run/postgres ` , the connection would then look like:
7977``` rust
80- let conn = try ! (Connection :: connect (" postgres://postgres@%2Frun%2Fpostgres" SslMode :: None ));
78+ let conn = try ! (Connection :: connect (" postgres://postgres@%2Frun%2Fpostgres" TlsMode :: None ));
8179```
8280Paths which contain non-UTF8 characters can be handled in a different manner;
8381see the documentation for details.
@@ -182,7 +180,7 @@ types. The driver currently supports the following conversions:
182180 </tr>
183181 <tr>
184182 <td>str/String</td>
185- <td>VARCHAR, CHAR(n), TEXT, CITEXT</td>
183+ <td>VARCHAR, CHAR(n), TEXT, CITEXT, NAME </td>
186184 </tr>
187185 <tr>
188186 <td>[u8]/Vec<u8></td>
@@ -285,42 +283,36 @@ crate.
285283
286284## Optional features
287285
288- ### Unix socket connections
289-
290- Support for connections through Unix domain sockets is provided optionally by
291- either the ` unix_socket ` or ` nightly ` features. It is only available on "unixy"
292- platforms such as OSX, BSD and Linux.
293-
294286### UUID type
295287
296288[ UUID] ( http://www.postgresql.org/docs/9.4/static/datatype-uuid.html ) support is
297- provided optionally by the ` uuid ` feature, which adds ` ToSql ` and ` FromSql `
289+ provided optionally by the ` with- uuid` feature, which adds ` ToSql ` and ` FromSql `
298290implementations for ` uuid ` 's ` Uuid ` type.
299291
300292### JSON/JSONB types
301293
302294[ JSON and JSONB] ( http://www.postgresql.org/docs/9.4/static/datatype-json.html )
303- support is provided optionally by the ` rustc-serialize ` feature, which adds
295+ support is provided optionally by the ` with- rustc-serialize` feature, which adds
304296` ToSql ` and ` FromSql ` implementations for ` rustc-serialize ` 's ` Json ` type, and
305- the ` serde_json ` feature, which adds implementations for ` serde_json ` 's ` Value `
306- type.
297+ the ` with- serde_json` feature, which adds implementations for ` serde_json ` 's
298+ ` Value ` type.
307299
308300### TIMESTAMP/TIMESTAMPTZ/DATE/TIME types
309301
310302[ Date and Time] ( http://www.postgresql.org/docs/9.1/static/datatype-datetime.html )
311- support is provided optionally by the ` time ` feature, which adds ` ToSql ` and
312- ` FromSql ` implementations for ` time ` 's ` Timespec ` type, or the ` chrono `
303+ support is provided optionally by the ` with- time` feature, which adds ` ToSql `
304+ and ` FromSql ` implementations for ` time ` 's ` Timespec ` type, or the ` with- chrono`
313305feature, which adds ` ToSql ` and ` FromSql ` implementations for ` chrono ` 's
314306` DateTime ` , ` NaiveDateTime ` , ` NaiveDate ` and ` NaiveTime ` types.
315307
316308### BIT/VARBIT types
317309
318310[ BIT and VARBIT] ( http://www.postgresql.org/docs/9.4/static/datatype-bit.html )
319- support is provided optionally by the ` bit-vec ` feature, which adds ` ToSql ` and
320- ` FromSql ` implementations for ` bit-vec ` 's ` BitVec ` type.
311+ support is provided optionally by the ` with- bit-vec` feature, which adds ` ToSql `
312+ and ` FromSql ` implementations for ` bit-vec ` 's ` BitVec ` type.
321313
322314### MACADDR type
323315
324316[ MACADDR] ( http://www.postgresql.org/docs/9.4/static/datatype-net-types.html#DATATYPE-MACADDR )
325- support is provided optionally by the ` eui48 ` feature, which adds ` ToSql ` and
326- ` FromSql ` implementations for ` eui48 ` 's ` MacAddress ` type.
317+ support is provided optionally by the ` with- eui48` feature, which adds ` ToSql `
318+ and ` FromSql ` implementations for ` eui48 ` 's ` MacAddress ` type.
0 commit comments