Improve quickstart

Author: mlafeldt

README.md

@@ -14,74 +14,66 @@ You can use it to:
 - Read and write Arrow, Parquet, JSON, and CSV formats natively.
 - Create DuckDB extensions in Rust with custom scalar and table functions.
 
-## Quick start
+## Quickstart
 
-```rust
-use duckdb::{params, Connection, Result};
+Create a new project and add the `duckdb` crate:
+
+```shell
+cargo new quack-in-rust
+cd quack-in-rust
+cargo add duckdb -F bundled
+```
 
-// In your project, we need to keep the arrow version same as the version used in duckdb.
-// Refer to https://github.com/duckdb/duckdb-rs/issues/92
-// You can either:
-use duckdb::arrow::record_batch::RecordBatch;
-// Or in your Cargo.toml, use * as the version; features can be toggled according to your needs
-// arrow = { version = "*", default-features = false, features = ["prettyprint"] }
-// Then you can:
-// use arrow::record_batch::RecordBatch;
+Update `src/main.rs` with the following code:
 
-use duckdb::arrow::util::pretty::print_batches;
+```rust
+use duckdb::{params, Connection, Result};
 
-#[derive(Debug)]
-struct Person {
+struct Duck {
     id: i32,
     name: String,
-    data: Option<Vec<u8>>,
 }
 
 fn main() -> Result<()> {
     let conn = Connection::open_in_memory()?;
 
+    conn.execute(
+        "CREATE TABLE ducks (id INTEGER PRIMARY KEY, name TEXT)",
+        [], // empty list of parameters
+    )?;
+
     conn.execute_batch(
-        r"CREATE SEQUENCE seq;
-          CREATE TABLE person (
-                  id              INTEGER PRIMARY KEY DEFAULT NEXTVAL('seq'),
-                  name            TEXT NOT NULL,
-                  data            BLOB
-                  );
-        ")?;
-
-    let me = Person {
-        id: 0,
-        name: "Steven".to_string(),
-        data: None,
-    };
+        r#"
+        INSERT INTO ducks (id, name) VALUES (1, 'Donald Duck');
+        INSERT INTO ducks (id, name) VALUES (2, 'Scrooge McDuck');
+        "#,
+    )?;
+
     conn.execute(
-        "INSERT INTO person (name, data) VALUES (?, ?)",
-        params![me.name, me.data],
+        "INSERT INTO ducks (id, name) VALUES (?, ?)",
+        params![3, "Darkwing Duck"],
     )?;
 
-    // query table by rows
-    let mut stmt = conn.prepare("SELECT id, name, data FROM person")?;
-    let person_iter = stmt.query_map([], |row| {
-        Ok(Person {
-            id: row.get(0)?,
-            name: row.get(1)?,
-            data: row.get(2)?,
-        })
-    })?;
-
-    for person in person_iter {
-        let p = person.unwrap();
-        println!("ID: {}", p.id);
-        println!("Found person {:?}", p);
+    let ducks = conn
+        .prepare("FROM ducks")?
+        .query_map([], |row| {
+            Ok(Duck {
+                id: row.get(0)?,
+                name: row.get(1)?,
+            })
+        })?
+        .collect::<Result<Vec<_>>>()?;
+
+    for duck in ducks {
+        println!("{}) {}", duck.id, duck.name);
     }
 
-    // query table by arrow
-    let rbs: Vec<RecordBatch> = stmt.query_arrow([])?.collect();
-    print_batches(&rbs).unwrap();
     Ok(())
 }
 ```
 
+Execute the program with `cargo run` and watch DuckDB in action!
+
 ## Examples
 
 The following [examples](crates/duckdb/examples) demonstrate various features and use cases of duckdb-rs: