readme: move schema example to tests

- Make example executable
- Add a description with steps how to run example manually

Author: ligurio

README.md

@@ -23,7 +23,6 @@ faster than other packages according to public benchmarks.
 * [API reference](#api-reference)
 * [Walking\-through example](#walking-through-example)
 * [Help](#help)
-* [Schema](#schema)
 * [Custom (un)packing and typed selects and function calls](#custom-unpacking-and-typed-selects-and-function-calls)
 * [Options](#options)
 * [Tests](#tests)
@@ -171,34 +170,6 @@ To contact `go-tarantool` developers on any problems, create an issue at
 The developers of the [Tarantool server](http://github.com/tarantool/tarantool)
 will also be happy to provide advice or receive feedback.
 
-## Schema
-
-```go
-    // save Schema to local variable to avoid races
-    schema := client.Schema
-
-    // access Space objects by name or id
-    space1 := schema.Spaces["some_space"]
-    space2 := schema.SpacesById[20] // it's a map
-    fmt.Printf("Space %d %s %s\n", space1.Id, space1.Name, space1.Engine)
-    fmt.Printf("Space %d %d\n", space1.FieldsCount, space1.Temporary)
-
-    // access index information by name or id
-    index1 := space1.Indexes["some_index"]
-    index2 := space1.IndexesById[2] // it's a map
-    fmt.Printf("Index %d %s\n", index1.Id, index1.Name)
-
-    // access index fields information by index
-    indexField1 := index1.Fields[0] // it's a slice
-    indexField2 := index1.Fields[1] // it's a slice
-    fmt.Printf("IndexFields %s %s\n", indexField1.Name, indexField1.Type)
-
-    // access space fields information by name or id (index)
-    spaceField1 := space.Fields["some_field"]
-    spaceField2 := space.FieldsById[3]
-    fmt.Printf("SpaceField %s %s\n", spaceField1.Name, spaceField1.Type)
-```
-
 ## Custom (un)packing and typed selects and function calls
 
 You can specify custom pack/unpack functions for your types. This will allow you

example_schema_test.go

@@ -0,0 +1,70 @@
+// Start Tarantool instance before example execution:
+// Terminal 1:
+// $ TT_LISTEN=3013 TT_WORK_DIR=$(mktemp -d -t 'tarantool.XXX') tarantool config.lua
+//
+// Terminal 2:
+// $ go test -v example_schema_test.go
+package tarantool_test
+
+import (
+	"fmt"
+	"log"
+	"time"
+
+	"github.com/tarantool/go-tarantool"
+)
+
+func Example_schema() {
+	server := "127.0.0.1:3013"
+	opts := tarantool.Opts{
+		Timeout:       500 * time.Millisecond,
+		Reconnect:     1 * time.Second,
+		MaxReconnects: 3,
+		User:          "test",
+		Pass:          "test",
+	}
+	client, err := tarantool.Connect(server, opts)
+	if err != nil {
+		log.Fatalf("Failed to connect: %s", err.Error())
+	}
+
+	// Save Schema to local variable to avoid races
+	schema := client.Schema
+	if schema.SpacesById == nil {
+		log.Fatalf("schema.SpacesById is nil")
+	}
+	if schema.Spaces == nil {
+		log.Fatalf("schema.Spaces is nil")
+	}
+
+	// Access Space objects by name or id
+	space1 := schema.Spaces["test"]
+	space2 := schema.SpacesById[514] // it's a map
+	fmt.Printf("Space 1 ID %d %s %s\n", space1.Id, space1.Name, space1.Engine)
+	fmt.Printf("Space 1 ID %d %t\n", space1.FieldsCount, space1.Temporary)
+
+	// Access index information by name or id
+	index1 := space1.Indexes["primary"]
+	index2 := space2.IndexesById[3] // it's a map
+	fmt.Printf("Index %d %s\n", index1.Id, index1.Name)
+
+	// Access index fields information by index
+	indexField1 := index1.Fields[0] // It's a slice
+	indexField2 := index2.Fields[1] // It's a slice
+	fmt.Println(indexField1, indexField2)
+
+	// Access space fields information by name or id (index)
+	spaceField1 := space2.Fields["name0"]
+	spaceField2 := space2.FieldsById[3]
+	fmt.Printf("SpaceField 1 %s %s\n", spaceField1.Name, spaceField1.Type)
+	fmt.Printf("SpaceField 2 %s %s\n", spaceField2.Name, spaceField2.Type)
+
+	// Output:
+	// Space 1 ID 512 test memtx
+	// Space 1 ID 0 false
+	// Index 0 primary
+	// &{0 unsigned} &{2 string}
+	// SpaceField 1 name0 unsigned
+	// SpaceField 2 name3 unsigned
+
+}