From 38bb24a0494d83e0e7cff82848f3082e5a569ece Mon Sep 17 00:00:00 2001
From: Andy Stark <andrew.stark@redis.com>
Date: Tue, 1 Oct 2024 16:30:29 +0100
Subject: [PATCH] DOC-4322 added HSET/HGET command page examples

---
 doctests/cmds_hash_test.go | 133 +++++++++++++++++++++++++++++++++++++
 1 file changed, 133 insertions(+)
 create mode 100644 doctests/cmds_hash_test.go

diff --git a/doctests/cmds_hash_test.go b/doctests/cmds_hash_test.go
new file mode 100644
index 000000000..f9630a9de
--- /dev/null
+++ b/doctests/cmds_hash_test.go
@@ -0,0 +1,133 @@
+// EXAMPLE: cmds_hash
+// HIDE_START
+package example_commands_test
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/redis/go-redis/v9"
+)
+
+// HIDE_END
+
+func ExampleClient_hset() {
+	ctx := context.Background()
+
+	rdb := redis.NewClient(&redis.Options{
+		Addr:     "localhost:6379",
+		Password: "", // no password docs
+		DB:       0,  // use default DB
+	})
+
+	// REMOVE_START
+	rdb.Del(ctx, "myhash")
+	// REMOVE_END
+
+	// STEP_START hset
+	res1, err := rdb.HSet(ctx, "myhash", "field1", "Hello").Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(res1) // >>> 1
+
+	res2, err := rdb.HGet(ctx, "myhash", "field1").Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(res2) // >>> Hello
+
+	res3, err := rdb.HSet(ctx, "myhash",
+		"field2", "Hi",
+		"field3", "World",
+	).Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(res3) // >>> 2
+
+	res4, err := rdb.HGet(ctx, "myhash", "field2").Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(res4) // >>> Hi
+
+	res5, err := rdb.HGet(ctx, "myhash", "field3").Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(res5) // >>> World
+
+	res6, err := rdb.HGetAll(ctx, "myhash").Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(res6)
+	// >>> map[field1:Hello field2:Hi field3:World]
+	// STEP_END
+
+	// Output:
+	// 1
+	// Hello
+	// 2
+	// Hi
+	// World
+	// map[field1:Hello field2:Hi field3:World]
+}
+
+func ExampleClient_hget() {
+	ctx := context.Background()
+
+	rdb := redis.NewClient(&redis.Options{
+		Addr:     "localhost:6379",
+		Password: "", // no password docs
+		DB:       0,  // use default DB
+	})
+
+	// REMOVE_START
+	rdb.Del(ctx, "myhash")
+	// REMOVE_END
+
+	// STEP_START hget
+	res7, err := rdb.HSet(ctx, "myhash", "field1", "foo").Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(res7) // >>> 1
+
+	res8, err := rdb.HGet(ctx, "myhash", "field1").Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(res8) // >>> foo
+
+	res9, err := rdb.HGet(ctx, "myhash", "field2").Result()
+
+	if err != nil {
+		fmt.Println(err)
+	}
+
+	fmt.Println(res9) // >>> <empty string>
+	// STEP_END
+
+	// Output:
+	// 1
+	// foo
+	// redis: nil
+}