Bleemeo Go

Go library for interacting with the Bleemeo API

Requirements

• Go1.19 or later
• An account on Bleemeo

Installation

On your existing Go project, run:

go get -u github.com/bleemeo/bleemeo-go

If you start a new project, use go mod init to bootstrap the Go project:

go mod init github.com/my-username/my-project

Then do the first command.

Documentation

The Go library documentation can be found here.

Some examples of library usage can be found in examples.

Basic usage

Listing the first 10 agents in your account:

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"
	"net/url"

	"github.com/bleemeo/bleemeo-go"
)

func main() {
	client, err := bleemeo.NewClient(bleemeo.WithConfigurationFromEnv())
	if err != nil {
		log.Fatalln("Failed to initialize client:", err)
	}

	defer func() {
		err := client.Logout(context.Background())
		if err != nil {
			log.Fatalln("Logout:", err)
		}
	}()

	const pageSize = 10

	page, err := client.GetPage(context.Background(), bleemeo.ResourceAgent, 1, pageSize, url.Values{"active": {"true"}})
	if err != nil {
		log.Fatalln("Failed to list agents:", err)
	}

	for _, row := range page.Results {
		var agentObj struct {
			ID          string `json:"id"`
			FQDN        string `json:"fqdn"`
			DisplayName string `json:"display_name"`
		}

		err = json.Unmarshal(row, &agentObj)
		if err != nil {
			log.Fatalln("Failed to unmarshal agent:", err)
		}

		fmt.Printf("* Agent %s (fqdn = %s, id = %s)\n", agentObj.DisplayName, agentObj.FQDN, agentObj.ID)
	}
}

Save this file in list-agents.go.

If not already in an existing Go project, create the project:

go mod init github.com/my-username/my-project

Run with:

go get -u github.com/bleemeo/bleemeo-go
[email protected] BLEEMEO_PASSWORD=password go run list-agents.go

More examples can be found in examples

To run an example, from a clone of this repository run the following:

[email protected] BLEEMEO_PASSWORD=password go run ./examples/list_metrics/

Environment

At least the following options must be configured (as environment variables or with options):

• Credentials OR initial refresh token
• All other configuration options are optional and may be omitted

Ways to provide those options are referenced in the Configuration section.

Configuration

For environment variables to be taken into account, the option WithConfigurationFromEnv() must be provided.