Merge pull request #1 from killercup/pg-jsonb-tests

Add doc test for Jsonb type

diesel/src/pg/types/mod.rs

@@ -140,5 +140,80 @@ pub mod sql_types {
     /// - [`serde_json`][Value]
     ///
     /// [Value]: https://docs.serde.rs/serde_json/value/enum.Value.html
+    ///
+    /// # Examples
+    ///
+    /// ```rust
+    /// # #![allow(dead_code)]
+    /// extern crate serde_json;
+    /// # #[macro_use] extern crate diesel;
+    /// # include!("src/doctest_setup.rs");
+    /// #
+    /// # table! {
+    /// #     users {
+    /// #         id -> Serial,
+    /// #         name -> VarChar,
+    /// #     }
+    /// # }
+    /// #
+    /// struct Contact {
+    ///     id: i32,
+    ///     name: String,
+    ///     address: serde_json::Value,
+    /// }
+    ///
+    /// impl_Queryable! {
+    ///     struct Contact {
+    ///         id: i32,
+    ///         name: String,
+    ///         address: serde_json::Value,
+    ///     }
+    /// }
+    ///
+    /// struct NewContact {
+    ///     name: String,
+    ///     address: serde_json::Value,
+    /// }
+    ///
+    /// impl_Insertable! {
+    ///     (contacts)
+    ///     struct NewContact {
+    ///         name: String,
+    ///         address: serde_json::Value,
+    ///     }
+    /// }
+    ///
+    /// table! {
+    ///     contacts {
+    ///         id -> Integer,
+    ///         name -> VarChar,
+    ///         address -> Jsonb,
+    ///     }
+    /// }
+    ///
+    /// # fn main() {
+    /// #     use self::diesel::insert;
+    /// #     use self::contacts::dsl::*;
+    /// #     let connection = connection_no_data();
+    /// #     connection.execute("CREATE TABLE contacts (
+    /// #         id SERIAL PRIMARY KEY,
+    /// #         name VARCHAR NOT NULL,
+    /// #         address JSONB NOT NULL
+    /// #     )").unwrap();
+    /// let santas_address: serde_json::Value = serde_json::from_str(r#"{
+    ///     "street": "Article Circle Expressway 1",
+    ///     "city": "North Pole",
+    ///     "postcode": "99705",
+    ///     "state": "Alaska"
+    /// }"#).unwrap();
+    /// let new_contact = NewContact {
+    ///     name: "Claus".into(),
+    ///     address: santas_address.clone()
+    /// };
+    /// let inserted_contact = insert(&new_contact).into(contacts)
+    ///     .get_result::<Contact>(&connection).unwrap();
+    /// assert_eq!(santas_address, inserted_contact.address);
+    /// # }
+    /// ```
     #[derive(Debug, Clone, Copy, Default)] pub struct Jsonb;
 }