examples: Add the authors example (#241)

* examples: Add the authors example

Taken from the existing code in the README

* Use sql.NullString

Author: kyleconroy

README.md

@@ -97,17 +97,17 @@ if err != nil {
 fmt.Println(authors)
 
 // create an author
-insertedAuthor, err := db.CreateAuthor(ctx, &db.CreateAuthorParams{
+insertedAuthor, err := db.CreateAuthor(ctx, db.CreateAuthorParams{
         Name: "Brian Kernighan",
-        Bio: "Co-author of The C Programming Language and The Go Programming Language",
+        Bio:  sql.NullString{String: "Co-author of The C Programming Language and The Go Programming Language", Valid: true},
 })
 if err != nil {
         return err
 }
 fmt.Println(insertedAuthor)
 
 // get the author we just inserted
-fetchedAuthor, err = db.GetAuthor(ctx, author.ID)
+fetchedAuthor, err := db.GetAuthor(ctx, insertedAuthor.ID)
 if err != nil {
         return err
 }

examples/authors/db.go

@@ -0,0 +1,41 @@
+package authors
+
+import (
+	"context"
+	"database/sql"
+	"testing"
+
+	"github.com/kyleconroy/sqlc/internal/sqltest"
+)
+
+func TestAuthors(t *testing.T) {
+	sdb, cleanup := sqltest.PostgreSQL(t, "schema.sql")
+	defer cleanup()
+
+	ctx := context.Background()
+	db := New(sdb)
+
+	// list all authors
+	authors, err := db.ListAuthors(ctx)
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Log(authors)
+
+	// create an author
+	insertedAuthor, err := db.CreateAuthor(ctx, CreateAuthorParams{
+		Name: "Brian Kernighan",
+		Bio:  sql.NullString{String: "Co-author of The C Programming Language and The Go Programming Language", Valid: true},
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Log(insertedAuthor)
+
+	// get the author we just inserted
+	fetchedAuthor, err := db.GetAuthor(ctx, insertedAuthor.ID)
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Log(fetchedAuthor)
+}

examples/authors/db_test.go

@@ -0,0 +1,19 @@
+-- name: GetAuthor :one
+SELECT * FROM authors
+WHERE id = $1 LIMIT 1;
+
+-- name: ListAuthors :many
+SELECT * FROM authors
+ORDER BY name;
+
+-- name: CreateAuthor :one
+INSERT INTO authors (
+          name, bio
+) VALUES (
+  $1, $2
+)
+RETURNING *;
+
+-- name: DeleteAuthor :exec
+DELETE FROM authors
+WHERE id = $1;

examples/authors/models.go

@@ -0,0 +1,5 @@
+CREATE TABLE authors (
+          id   BIGSERIAL PRIMARY KEY,
+          name text      NOT NULL,
+          bio  text
+);

examples/authors/query.sql

@@ -9,7 +9,6 @@ import (
 	"github.com/kyleconroy/sqlc/internal/sqltest"
 
 	"github.com/google/go-cmp/cmp"
-	_ "github.com/lib/pq"
 )
 
 func runOnDeckQueries(t *testing.T, q *Queries) {

examples/authors/query.sql.go

@@ -1,6 +1,12 @@
 {
   "version": "1",
   "packages": [
+    {
+      "path": "authors",
+      "schema": "authors/schema.sql",
+      "queries": "authors/query.sql",
+      "engine": "postgresql"
+    },
     {
       "path": "ondeck",
       "schema": "ondeck/schema",

examples/authors/schema.sql

@@ -8,18 +8,25 @@ import (
 	"os"
 	"path/filepath"
 	"testing"
+	"time"
 
 	"github.com/kyleconroy/sqlc/internal/dinosql"
 
 	_ "github.com/lib/pq"
 )
 
+func init() {
+	rand.Seed(time.Now().UnixNano())
+}
+
+var letterRunes = []rune("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ")
+
 func id() string {
-	bytes := make([]byte, 10)
-	for i := 0; i < 10; i++ {
-		bytes[i] = byte(65 + rand.Intn(25)) // A=65 and Z = 65+25
+	b := make([]rune, 10)
+	for i := range b {
+		b[i] = letterRunes[rand.Intn(len(letterRunes))]
 	}
-	return string(bytes)
+	return string(b)
 }
 
 func PostgreSQL(t *testing.T, migrations string) (*sql.DB, func()) {
@@ -55,7 +62,7 @@ func PostgreSQL(t *testing.T, migrations string) (*sql.DB, func()) {
 		t.Fatal(err)
 	}
 
-	schema := "dinotest_" + id()
+	schema := "sqltest_" + id()
 
 	// For each test, pick a new schema name at random.
 	// `foo` is used here only as an example