go-turso

Golang client for interacting with the Turso Platform API.

Currently supports the following endpoints:

1. Organizations: List
2. Groups: List, Get, Create, Delete
3. Databases: List, Get, Create, Delete
4. Database Locations: Add, Remove
5. Database Tokens: Create

Usage

go get github.com/theopenlane/go-turso

package main

import (
    "context"
    "fmt"
    "log"
    "os"

    "github.com/theopenlane/go-turso"
)

func main() {
    // setup the configuration
    apiToken := os.Getenv("TURSO_API_TOKEN")
    config := turso.Config{
        Token:   apiToken,
        BaseURL: "https://api.turso.tech",
        OrgName: "theopenlane",
    }

    // create the Turso Client
    tc, err := turso.NewClient(config)
    if err != nil {
        log.Fatalf("failed to initialize turso client", "error", err)
    }

    // List All Groups
    groups, err := tc.Group.ListGroups(context.Background())
    if err != nil {
        fmt.Println("error listing groups:", err)

        return
    }

    for _, group := range groups.Groups {
        fmt.Println("Group:", group.Name)
    }

    // List All Databases
    databases, err := tc.Database.ListDatabases(context.Background())
    if err != nil {
        fmt.Println("error listing databases:", err)

        return
    }

    for _, database := range databases.Databases {
        fmt.Println("Database:", database.Name)
    }

    // List All Organizations
    orgs, err := tc.Organization.ListOrganizations(context.Background())
    if err != nil {
        fmt.Println("error listing organizations:", err)

        return
    }

    for _, org := range *orgs {
        fmt.Println("Organization:", org.Name, org.Slug)
    }

    // Create a new Group
    g := turso.CreateGroupRequest{
        Name:     "test-group",
        Location: "ord",
    }

    group, err := tc.Group.CreateGroup(context.Background(), g)
    if err != nil {
        fmt.Println("error creating group:", err)
    }

    fmt.Println("Group Created:", group.Group.Name, group.Group.Locations)

    // Delete the Group
    deletedGroup, err := tc.Group.DeleteGroup(context.Background(), g.Name)
    if err != nil {
        fmt.Println("error deleting group:", err)
    }

    fmt.Println("Group Deleted:", deletedGroup.Group.Name, deletedGroup.Group.Locations)

    // Create a new Database
    d := turso.CreateDatabaseRequest{
        Group:    "default",
        IsSchema: false,
        Name:     "test-database",
    }

    database, err := tc.Database.CreateDatabase(context.Background(), d)
    if err != nil {
        fmt.Println("error creating database:", err)
    }

    fmt.Println("Database Created:", database.Database.Name)

    // Delete the Database
    deletedDatabase, err := tc.Database.DeleteDatabase(context.Background(), d.Name)
    if err != nil {
        fmt.Println("error deleting database:", err)
    }

    fmt.Println("Database Deleted:", deletedDatabase.Database)
}

References

1. Turso Platform API