Golang SDK

.github/workflows/generate_schemas.yml

@@ -63,3 +63,10 @@ jobs:
           name: sdk-schemas-json
           path: ${{ github.workspace }}/support/schemas/*
           if-no-files-found: error
+
+      - name: Upload Go schemas artifact
+        uses: actions/upload-artifact@0b7f8abb1508181956e8e162db84b466c27e18ce # v3.1.2
+        with:
+          name: schemas.go
+          path: ${{ github.workspace }}/languages/go/schema.go
+          if-no-files-found: error

.gitignore

@@ -49,3 +49,4 @@ crates/bitwarden-napi/src-ts/bitwarden_client/schemas.ts
 languages/csharp/schemas.cs
 languages/js_webassembly/bitwarden_client/schemas.ts
 languages/python/BitwardenClient/schemas.py
+languages/go/schema.go

languages/go/README.md

@@ -0,0 +1,116 @@
+# Bitwarden SDK in Go
+
+This SDK is designed to interact with Bitwarden services in Go. It includes implementations for managing projects and secrets, as well as a client interface to facilitate operations like login.
+
+## Prerequisites
+
+- Go installed
+- C environment to run CGO
+
+## Installation
+
+Download the SDK files and place them in your Go project directory.
+
+## Table of Contents
+
+- [Initialization](#initialization)
+- [Login](#login)
+- [Projects](#projects)
+- [Secrets](#secrets)
+- [Close Client](#close-client)
+
+---
+
+### Initialization
+
+To initialize the client, you need to import the SDK and create a new `BitwardenClient` instance.
+
+```go
+import "github.com/bitwarden/sdk/languages/go"
+
+settings := ClientSettings{
+  // Your settings here
+}
+lib := BitwardenLibraryImpl{}
+client := NewBitwardenClient(settings, lib)
+```
+
+---
+
+### Login
+
+To login using an access token:
+
+```go
+response := client.AccessTokenLogin("your_access_token_here")
+```
+
+---
+
+### Projects
+
+#### Create a Project
+
+```go
+response, err := client.Projects.Create("organization_id", "project_name")
+```
+
+#### List Projects
+
+```go
+response, err := client.Projects.List("organization_id")
+```
+
+#### Update a Project
+
+```go
+response, err := client.Projects.Update("project_id", "organization_id", "new_project_name")
+```
+
+#### Delete Projects
+
+```go
+response, err := client.Projects.Delete([]string{"project_id_1", "project_id_2"})
+```
+
+---
+
+### Secrets
+
+#### Create a Secret
+
+```go
+response, err := client.Secrets.Create("key", "value", "note", "organization_id", []string{"project_id"})
+```
+
+#### List Secrets
+
+```go
+response, err := client.Secrets.List("organization_id")
+```
+
+#### Update a Secret
+
+```go
+response, err := client.Secrets.Update("secret_id", "new_key", "new_value", "new_note", "organization_id", []string{"project_id"})
+```
+
+#### Delete Secrets
+
+```go
+response, err := client.Secrets.Delete([]string{"secret_id_1", "secret_id_2"})
+```
+
+---
+
+### Close Client
+
+To free up resources:
+
+```go
+client.Close()
+```
+
+---
+
+For more detailed information, refer to the code comments and method signatures.

languages/go/bitwarden_client.go

@@ -0,0 +1,50 @@
+package main
+
+import "encoding/json"
+
+type BitwardenClient struct {
+	client        ClientPointer
+	lib           BitwardenLibrary
+	commandRunner CommandRunnerInterface
+	Projects      ProjectsInterface
+	Secrets       SecretsInterface
+}
+
+func NewBitwardenClient(settings ClientSettings, lib BitwardenLibrary) *BitwardenClient {
+	settingsJSON, err := json.Marshal(settings)
+	if err != nil {
+		panic(err)
+	}
+
+	client, err := lib.Init(string(settingsJSON))
+	if err != nil {
+		panic(err)
+	}
+	runner := NewCommandRunner(client, lib)
+
+	return &BitwardenClient{
+		lib:           lib,
+		client:        client,
+		commandRunner: runner,
+		Projects:      NewProjects(runner),
+		Secrets:       NewSecrets(runner),
+	}
+}
+
+func (c *BitwardenClient) AccessTokenLogin(accessToken string) ResponseForAPIKeyLoginResponse {
+	req := AccessTokenLoginRequest{AccessToken: accessToken}
+	command := Command{AccessTokenLogin: &req}
+
+	responseStr := c.commandRunner.RunCommand(command)
+
+	var response ResponseForAPIKeyLoginResponse
+	if err := json.Unmarshal([]byte(responseStr), &response); err != nil {
+		panic(err)
+	}
+
+	return response
+}
+
+func (c *BitwardenClient) Close() {
+	c.lib.FreeMem(c.client)
+}

languages/go/bitwarden_libary.go

@@ -0,0 +1,54 @@
+//go:build !custom
+// +build !custom
+
+package main
+
+import (
+	"fmt"
+	"unsafe"
+)
+
+/*
+#cgo LDFLAGS: -lbitwarden_c
+#cgo linux LDFLAGS: -L/usr/local/lib -L/usr/lib
+#cgo darwin LDFLAGS: -L/usr/local/lib -L/usr/lib
+#include <stdlib.h>
+typedef void* ClientPtr;
+extern char* run_command(const char *command, ClientPtr client);
+extern ClientPtr init(const char *clientSettings);
+extern void free_mem(ClientPtr client);
+*/
+import "C"
+
+type ClientPointer struct {
+	Pointer C.ClientPtr
+}
+
+type BitwardenLibrary interface {
+	Init(clientSettings string) (ClientPointer, error)
+	FreeMem(client ClientPointer)
+	RunCommand(command string, client ClientPointer) (string, error)
+}
+
+type BitwardenLibraryImpl struct{}
+
+func (b *BitwardenLibraryImpl) Init(clientSettings string) (ClientPointer, error) {
+	ptr := C.init(C.CString(clientSettings))
+	if ptr == nil {
+		return ClientPointer{}, fmt.Errorf("initialization failed")
+	}
+	return ClientPointer{Pointer: ptr}, nil
+}
+
+func (b *BitwardenLibraryImpl) FreeMem(client ClientPointer) {
+	C.free_mem(client.Pointer)
+}
+
+func (b *BitwardenLibraryImpl) RunCommand(command string, client ClientPointer) (string, error) {
+	cstr := C.run_command(C.CString(command), client.Pointer)
+	if cstr == nil {
+		return "", fmt.Errorf("run command failed")
+	}
+	defer C.free(unsafe.Pointer(cstr))
+	return C.GoString(cstr), nil
+}

languages/go/bitwarden_libary_custom.go

@@ -0,0 +1,54 @@
+//go:build custom
+// +build custom
+
+package main
+
+import (
+	"fmt"
+	"unsafe"
+)
+
+/*
+#cgo LDFLAGS: -lbitwarden_c
+#cgo linux LDFLAGS: -L/usr/local/lib -L/usr/lib
+#cgo darwin LDFLAGS: -L/usr/local/lib -L/usr/lib
+#include <stdlib.h>
+typedef void* ClientPtr;
+extern char* run_command(const char *command, ClientPtr client);
+extern ClientPtr init(const char *clientSettings);
+extern void free_mem(ClientPtr client);
+*/
+import "C"
+
+type ClientPointer struct {
+	Pointer C.ClientPtr
+}
+
+type BitwardenLibrary interface {
+	Init(clientSettings string) (ClientPointer, error)
+	FreeMem(client ClientPointer)
+	RunCommand(command string, client ClientPointer) (string, error)
+}
+
+type BitwardenLibraryImpl struct{}
+
+func (b *BitwardenLibraryImpl) Init(clientSettings string) (ClientPointer, error) {
+	ptr := C.init(C.CString(clientSettings))
+	if ptr == nil {
+		return ClientPointer{}, fmt.Errorf("initialization failed")
+	}
+	return ClientPointer{Pointer: ptr}, nil
+}
+
+func (b *BitwardenLibraryImpl) FreeMem(client ClientPointer) {
+	C.free_mem(client.Pointer)
+}
+
+func (b *BitwardenLibraryImpl) RunCommand(command string, client ClientPointer) (string, error) {
+	cstr := C.run_command(C.CString(command), client.Pointer)
+	if cstr == nil {
+		return "", fmt.Errorf("run command failed")
+	}
+	defer C.free(unsafe.Pointer(cstr))
+	return C.GoString(cstr), nil
+}

languages/go/build.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+if [ -n "$BITWARDEN_LIB_PATH" ]; then
+    sed "s/{{.LibPath}}/$BITWARDEN_LIB_PATH/g" bitwarden_library.go > bitwarden_library.go
+    go build -tags custom
+else
+    go build
+fi

languages/go/command_runner.go

@@ -0,0 +1,35 @@
+package main
+
+import (
+	"encoding/json"
+)
+
+type CommandRunnerInterface interface {
+	RunCommand(command Command) string
+}
+
+type CommandRunner struct {
+	client ClientPointer
+	lib    BitwardenLibrary
+}
+
+func NewCommandRunner(client ClientPointer, lib BitwardenLibrary) *CommandRunner {
+	return &CommandRunner{
+		client: client,
+		lib:    lib,
+	}
+}
+
+func (c *CommandRunner) RunCommand(command Command) string {
+	commandJSON, err := json.Marshal(command)
+	if err != nil {
+		panic(err)
+	}
+
+	responseStr, err := c.lib.RunCommand(string(commandJSON), c.client)
+	if err != nil {
+		panic(err)
+	}
+
+	return responseStr
+}

languages/go/go.mod

@@ -0,0 +1,5 @@
+module github.com/bitwarden/sdk/languages/go
+
+go 1.20
+
+require github.com/gofrs/uuid v4.4.0+incompatible

languages/go/go.sum

@@ -0,0 +1,2 @@
+github.com/gofrs/uuid v4.4.0+incompatible h1:3qXRTX8/NbyulANqlc0lchS1gqAVxRgsuW1YrTJupqA=
+github.com/gofrs/uuid v4.4.0+incompatible/go.mod h1:b2aQJv3Z4Fp6yNu3cdSllBxTCLRxnplIgP/c0N/04lM=