Connectors: Go tutorial - update per review

Author: andreyaksenov

doc/code_snippets/snippets/connectors/go/go.mod

@@ -3,8 +3,10 @@ module example/hello
 go 1.22.3
 
 require (
-        github.com/tarantool/go-iproto v1.0.0 // indirect
-        github.com/tarantool/go-tarantool/v2 v2.1.0 // indirect
-        github.com/vmihailenco/msgpack/v5 v5.3.5 // indirect
-        github.com/vmihailenco/tagparser/v2 v2.0.0 // indirect
+	github.com/google/uuid v1.3.0 // indirect
+	github.com/shopspring/decimal v1.3.1 // indirect
+	github.com/tarantool/go-iproto v1.0.0 // indirect
+	github.com/tarantool/go-tarantool/v2 v2.1.0 // indirect
+	github.com/vmihailenco/msgpack/v5 v5.3.5 // indirect
+	github.com/vmihailenco/tagparser/v2 v2.0.0 // indirect
 )

doc/code_snippets/snippets/connectors/go/go.sum

@@ -1,5 +1,9 @@
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/google/uuid v1.3.0 h1:t6JiXgmwXMjEs8VusXIJk2BXHsn+wx8BZdTaoZ5fu7I=
+github.com/google/uuid v1.3.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/shopspring/decimal v1.3.1 h1:2Usl1nmF/WZucqkFZhnfFYxxxu8LG21F6nPQBE5gKV8=
+github.com/shopspring/decimal v1.3.1/go.mod h1:DKyhrW/HYNuLGql+MJL6WCR6knT2jwCFRcu2hWCYk4o=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/tarantool/go-iproto v1.0.0 h1:quC4hdFhCuFYaCqOFgUxH2foRkhAy+TlEy7gQLhdVjw=

doc/code_snippets/snippets/connectors/go/hello.go

@@ -4,6 +4,9 @@ import (
 	"context"
 	"fmt"
 	"github.com/tarantool/go-tarantool/v2"
+	_ "github.com/tarantool/go-tarantool/v2/datetime"
+	_ "github.com/tarantool/go-tarantool/v2/decimal"
+	_ "github.com/tarantool/go-tarantool/v2/uuid"
 	"time"
 )
 
@@ -27,23 +30,26 @@ func main() {
 
 	// Interacting with the database
 	// Insert data
-	tuple1, err := conn.Do(
-		tarantool.NewInsertRequest("bands").
-			Tuple([]interface{}{1, "Roxette", 1986}),
-	).Get()
-	tuple2, err := conn.Do(
-		tarantool.NewInsertRequest("bands").
-			Tuple([]interface{}{2, "Scorpions", 1965}),
-	).Get()
-	tuple3, err := conn.Do(
-		tarantool.NewInsertRequest("bands").
-			Tuple([]interface{}{3, "Ace of Base", 1987}),
-	).Get()
-	tuple4, err := conn.Do(
-		tarantool.NewInsertRequest("bands").
-			Tuple([]interface{}{4, "The Beatles", 1960}),
-	).Get()
-	fmt.Println("Inserted tuples: ", tuple1, tuple2, tuple3, tuple4)
+	tuples := [][]interface{}{
+		{1, "Roxette", 1986},
+		{2, "Scorpions", 1965},
+		{3, "Ace of Base", 1987},
+		{4, "The Beatles", 1960},
+	}
+	var futures []*tarantool.Future
+	for _, tuple := range tuples {
+		request := tarantool.NewInsertRequest("bands").Tuple(tuple)
+		futures = append(futures, conn.Do(request))
+	}
+	fmt.Println("Inserted tuples:")
+	for _, future := range futures {
+		result, err := future.Get()
+		if err != nil {
+			fmt.Println("Got an error:", err)
+		} else {
+			fmt.Println(result)
+		}
+	}
 
 	// Select by primary key
 	data, err := conn.Do(
@@ -52,6 +58,9 @@ func main() {
 			Iterator(tarantool.IterEq).
 			Key([]interface{}{uint(1)}),
 	).Get()
+	if err != nil {
+		fmt.Println("Got an error:", err)
+	}
 	fmt.Println("Tuple selected the primary key value:", data)
 
 	// Select by secondary key
@@ -62,6 +71,9 @@ func main() {
 			Iterator(tarantool.IterEq).
 			Key([]interface{}{"The Beatles"}),
 	).Get()
+	if err != nil {
+		fmt.Println("Got an error:", err)
+	}
 	fmt.Println("Tuple selected the secondary key value:", data)
 
 	// Update
@@ -70,6 +82,9 @@ func main() {
 			Key(tarantool.IntKey{2}).
 			Operations(tarantool.NewOperations().Assign(1, "Pink Floyd")),
 	).Get()
+	if err != nil {
+		fmt.Println("Got an error:", err)
+	}
 	fmt.Println("Updated tuple:", data)
 
 	// Upsert
@@ -78,25 +93,37 @@ func main() {
 			Tuple([]interface{}{uint(5), "The Rolling Stones", 1962}).
 			Operations(tarantool.NewOperations().Assign(1, "The Doors")),
 	).Get()
+	if err != nil {
+		fmt.Println("Got an error:", err)
+	}
 
 	// Replace
 	data, err = conn.Do(
 		tarantool.NewReplaceRequest("bands").
 			Tuple([]interface{}{1, "Queen", 1970}),
 	).Get()
+	if err != nil {
+		fmt.Println("Got an error:", err)
+	}
 	fmt.Println("Replaced tuple:", data)
 
 	// Delete
 	data, err = conn.Do(
 		tarantool.NewDeleteRequest("bands").
 			Key([]interface{}{uint(5)}),
 	).Get()
+	if err != nil {
+		fmt.Println("Got an error:", err)
+	}
 	fmt.Println("Deleted tuple:", data)
 
 	// Call
 	data, err = conn.Do(
 		tarantool.NewCallRequest("get_bands_older_than").Args([]interface{}{1966}),
 	).Get()
+	if err != nil {
+		fmt.Println("Got an error:", err)
+	}
 	fmt.Println("Stored procedure result:", data)
 
 	// Close connection

doc/how-to/getting_started_go.rst

@@ -38,6 +38,8 @@ Now you can create a client Go application that makes requests to this database.
 Developing a client application
 -------------------------------
 
+Before you start, make sure you have `Go installed <https://go.dev/doc/install>`__ on your computer.
+
 .. _getting_started_go_create_client_app:
 
 Creating an application
@@ -61,8 +63,8 @@ Creating an application
 
 .. _getting_started_go_import_:
 
-Importing 'go-tarantool'
-~~~~~~~~~~~~~~~~~~~~~~~~
+Importing 'go-tarantool' packages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In the ``hello.go`` file, declare a ``main`` package and import the following packages:
 
@@ -72,11 +74,13 @@ In the ``hello.go`` file, declare a ``main`` package and import the following pa
     :end-before: func main()
     :dedent:
 
+The packages for external MsgPack types, such as ``datetime``, ``decimal``, or ``uuid``, are required to parse these types in a response.
+
 
 .. _getting_started_go_creating_connection:
 
-Creating a connection
-~~~~~~~~~~~~~~~~~~~~~
+Connecting to the database
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 1.  Declare the ``main()`` function:
 
@@ -114,11 +118,18 @@ Add the following code to insert four tuples into the ``bands`` space:
 ..  literalinclude:: /code_snippets/snippets/connectors/go/hello.go
     :language: go
     :start-at: // Insert data
-    :end-at: Inserted tuples:
+    :end-before: // Select by primary key
     :dedent:
 
-The ``NewInsertRequest()`` method creates an insert request object that is executed by the connection.
+This code makes insert requests asynchronously:
+
+-   The ``Future`` structure is used as a handle for asynchronous requests.
+-   The ``NewInsertRequest()`` method creates an insert request object that is executed by the connection.
+
+..  NOTE::
 
+    Making requests asynchronously is the recommended way to perform data operations.
+    Further requests in this tutorial are made synchronously.
 
 
 .. _getting_started_go_querying_data:
@@ -157,7 +168,7 @@ Updating data
     :end-at: Updated tuple
     :dedent:
 
-``NewUpsertRequest()`` can be used to update an existing tuple or inserts a new one.
+``NewUpsertRequest()`` can be used to update an existing tuple or insert a new one.
 In the example below, a new tuple is inserted:
 
 ..  literalinclude:: /code_snippets/snippets/connectors/go/hello.go
@@ -231,18 +242,24 @@ The ``CloseGraceful()`` method can be used to close the connection when it is no
 Starting a client application
 -----------------------------
 
-1.  Execute the ``go get`` command to update dependencies in the ``go.mod`` file:
+1.  Execute the following ``go get`` commands to update dependencies in the ``go.mod`` file:
 
     .. code-block:: console
 
         $ go get github.com/tarantool/go-tarantool/v2
+        $ go get github.com/tarantool/go-tarantool/v2/decimal
+        $ go get github.com/tarantool/go-tarantool/v2/uuid
 
 2.  To run the resulting application, execute the ``go run`` command in the application directory:
 
     .. code-block:: console
 
         $ go run .
-        Inserted tuples:  [[1 Roxette 1986]] [[2 Scorpions 1965]] [[3 Ace of Base 1987]] [[4 The Beatles 1960]]
+        Inserted tuples:
+        [[1 Roxette 1986]]
+        [[2 Scorpions 1965]]
+        [[3 Ace of Base 1987]]
+        [[4 The Beatles 1960]]
         Tuple selected the primary key value: [[1 Roxette 1986]]
         Tuple selected the secondary key value: [[4 The Beatles 1960]]
         Updated tuple: [[2 Pink Floyd 1965]]
@@ -258,7 +275,7 @@ Starting a client application
 Feature comparison
 ------------------
 
-There are two more connectors from the open source community:
+There are two more connectors from the open-source community:
 
 *   `viciious/go-tarantool <https://github.com/viciious/go-tarantool>`_
 

doc/how-to/getting_started_net_box.rst

@@ -22,7 +22,7 @@ This section describes the :ref:`configuration <configuration_file>` of a sample
     :language: yaml
     :dedent:
 
--   The configuration contains one instance that listens incoming requests on the ``127.0.0.1:3301`` address.
+-   The configuration contains one instance that listens for incoming requests on the ``127.0.0.1:3301`` address.
 -   ``sampleuser`` has :ref:`privileges <authentication-owners_privileges>` to select and modify data in the ``bands`` space and execute the ``get_bands_older_than`` stored function. This user can be used to connect to the instance remotely.
 -   ``myapp.lua`` defines how data is stored in a database and includes a stored function.