Golang

This is a Go client library for interacting with the TempDB server. It provides an interface to connect, store, retrieve, and manage data within a TempDB database.

Installation

To use this client in your Go project, run:

go get github.com/tempdb-labs/tempdb-go/lib

Usage

Here's an example of how to use the TempDB Go client:

package main

import (
	"log"
	tempdb "github.com/tempdb-labs/tempdb-go/lib"
)

func main() {
	client, err := tempdb.NewClient(tempdb.Config{
		Addr: "tempdb1.tempdb.xyz:8081",
		URL:  "tempdb://admin:admin@users:kv",
	})
	if err != nil {
		log.Fatalf("Failed to get client: %v", err)
	}
	defer client.Close()

	user := map[string]interface{}{
		"name":    "Thembinkosi",
		"surname": "Mkhonta",
		"preferences": map[string]interface{}{
			"mode":          "dark",
			"notifications": "no",
		},
	}

	result, err := client.Store("user_01", user)
	if err != nil {
		log.Printf("Failed to store user: %v", err)
		return
	}

	log.Printf("User stored successfully: %v", result)
}

Other functions

• Data Storage: Use Store to add structured data into TempDB.

• Data Retrieval: Use GetByKey to fetch data by its key.

• Session Management: Includes commands for creating, fetching, modifying, and deleting sessions.

• Batch Operations: Use StoreBatch to insert multiple entries at once, or importing a CSV or JSON file.

Example for Data Retrieval

getProductInfo, err := client.Get("user_01")
if err != nil {
	log.Printf("Failed to get product: %v", err)
} else {
	log.Printf("Product data: %v", getProductInfo)
}

Session Management Example

sessionID, err := client.SetEx("<user_id>", <"session_ttl">, <"session_metadata"> )
if err != nil {
	log.Printf("Failed to create session: %v", err)
}

Refer to the library source code for further details on all available commands and their usage.