Merge branch 'main' into ta/O11Y-339/basic-android-obs-client-squash

Author: tanderson-ld

.github/workflows/go-plugin.yml

@@ -0,0 +1,50 @@
+name: Go Observability Plugin
+
+on:
+    push:
+        branches: ['main']
+    pull_request:
+        types: [opened, synchronize]
+        paths:
+            - 'go/**'
+            - '.github/workflows/go-plugin.yml'
+            # - 'e2e/tests/**'
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+jobs:
+    build:
+        permissions:
+            contents: read
+        name: Quality Check and Publish
+        runs-on: ubuntu-latest
+        defaults:
+            run:
+                working-directory: ./go
+        steps:
+            - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+              with:
+                  token: ${{ secrets.GITHUB_TOKEN }}
+
+            - uses: actions/setup-go@d35c59abb061a4a6fb18e82ac0862c26744d6ab5
+              with:
+                  go-version-file: './go/go.mod'
+                  cache-dependency-path: './go/go.sum'
+
+            - name: Install dependencies
+              run: make install
+
+            - name: Format check
+              run: make format
+
+            - name: Run linter
+              uses: golangci/golangci-lint-action@4afd733a84b1f43292c63897423277bb7f4313a9
+              with:
+                  args: -v --config ./.golangci.yaml
+                  working-directory: go
+                  version: latest
+
+            - name: Test
+              run: make test
+
+            - name: Build
+              run: make build

go/.gitignore

@@ -0,0 +1 @@
+coverage.html

go/.golangci.yaml

@@ -0,0 +1,55 @@
+version: '2'
+run:
+    tests: false
+linters:
+    enable:
+        - bodyclose
+        - dupl
+        - gochecknoglobals
+        - gochecknoinits
+        - goconst
+        - gocritic
+        - gocyclo
+        - godox
+        - gosec
+        - lll
+        - misspell
+        - nakedret
+        - nolintlint
+        - prealloc
+        - revive
+        - staticcheck
+        - unconvert
+        - unparam
+        - whitespace
+    settings:
+        revive:
+            rules:
+                - name: exported
+                  arguments:
+                      - disableStutteringCheck
+    exclusions:
+        generated: lax
+        paths:
+            - third_party$
+            - builtin$
+            - examples$
+issues:
+    max-same-issues: 1000
+formatters:
+    enable:
+        - gofmt
+        - goimports
+    settings:
+        gofmt:
+            simplify: false
+        goimports:
+            local-prefixes:
+                - gopkg.in/launchdarkly
+                - github.com/launchdarkly
+    exclusions:
+        generated: lax
+        paths:
+            - third_party$
+            - builtin$
+            - examples$

go/CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+All notable changes to the LaunchDarkly Observability SDK for Go will be documented in this file.

go/Makefile

@@ -0,0 +1,43 @@
+.PHONY: help install lint test build clean format
+
+# Default target
+help:
+	@echo "Available targets:"
+	@echo "  install  - Install dependencies using go mod"
+	@echo "  lint     - Run golangci-lint"
+	@echo "  format   - Format code using gofmt"
+	@echo "  test     - Run tests with coverage"
+	@echo "  build    - Build the package"
+	@echo "  clean    - Clean build artifacts"
+	@echo "  all      - Run install, lint, test, and build"
+
+# Install dependencies
+install:
+	go mod download
+	go mod tidy
+
+# Run linting with golangci-lint
+lint:
+	golangci-lint run
+
+# Format code with gofmt
+format:
+	gofmt -s -w .
+
+# Run tests with coverage
+test:
+	go test -v -race -coverprofile=coverage.out -covermode=atomic ./...
+	go tool cover -html=coverage.out -o coverage.html
+	go tool cover -func=coverage.out
+
+# Build the package
+build:
+	go build -v ./...
+
+# Clean build artifacts
+clean:
+	go clean
+	rm -f coverage.out coverage.html
+
+# Run all checks (install, lint, test, build)
+all: install lint test build 

go/README.md

@@ -0,0 +1,49 @@
+LaunchDarkly Observability SDK for Go
+===========================
+
+[![Actions Status][goplugin-sdk-ci-badge]][goplugin-sdk-ci]
+
+
+# Early Access Preview️
+
+**NB: APIs are subject to change until a 1.x version is released.**
+
+## Install
+
+```shell
+go get github.com/launchdarkly/observability-sdk/go
+```
+
+Install the plugin when configuring your LaunchDarkly SDK.
+
+```go
+// TODO: Add code sample for Go observability plugin configuration
+```
+
+LaunchDarkly overview
+-------------------------
+[LaunchDarkly](https://www.launchdarkly.com) is a feature management platform that serves trillions of feature flags daily to help teams build better software, faster. [Get started](https://docs.launchdarkly.com/home/getting-started) using LaunchDarkly today!
+
+[![Twitter Follow](https://img.shields.io/twitter/follow/launchdarkly.svg?style=social&label=Follow&maxAge=2592000)](https://twitter.com/intent/follow?screen_name=launchdarkly)
+
+## Contributing
+
+We encourage pull requests and other contributions from the community. Check out our [contributing guidelines](CONTRIBUTING.md) for instructions on how to contribute to this SDK.
+
+## About LaunchDarkly
+
+* LaunchDarkly is a continuous delivery platform that provides feature flags as a service and allows developers to iterate quickly and safely. We allow you to easily flag your features and manage them from the LaunchDarkly dashboard.  With LaunchDarkly, you can:
+    * Roll out a new feature to a subset of your users (like a group of users who opt-in to a beta tester group), gathering feedback and bug reports from real-world use cases.
+    * Gradually roll out a feature to an increasing percentage of users, and track the effect that the feature has on key metrics (for instance, how likely is a user to complete a purchase if they have feature A versus feature B?).
+    * Turn off a feature that you realize is causing performance problems in production, without needing to re-deploy, or even restart the application with a changed configuration file.
+    * Grant access to certain features based on user attributes, like payment plan (eg: users on the ‘gold’ plan get access to more features than users in the ‘silver’ plan). Disable parts of your application to facilitate maintenance, without taking everything offline.
+* LaunchDarkly provides feature flag SDKs for a wide variety of languages and technologies. Check out [our documentation](https://docs.launchdarkly.com/docs) for a complete list.
+* Explore LaunchDarkly
+    * [launchdarkly.com](https://www.launchdarkly.com/ "LaunchDarkly Main Website") for more information
+    * [docs.launchdarkly.com](https://docs.launchdarkly.com/  "LaunchDarkly Documentation") for our documentation and SDK reference guides
+    * [apidocs.launchdarkly.com](https://apidocs.launchdarkly.com/  "LaunchDarkly API Documentation") for our API documentation
+    * [launchdarkly.com/blog](https://launchdarkly.com/blog/  "LaunchDarkly Blog Documentation") for the latest product updates
+
+
+[goplugin-sdk-ci-badge]: https://github.com/launchdarkly/observability-sdk/actions/workflows/go-plugin.yml/badge.svg
+[goplugin-sdk-ci]: https://github.com/launchdarkly/observability-sdk/actions/workflows/go-plugin.yml

go/go.mod

@@ -0,0 +1,3 @@
+module github.com/launchdarkly/observability-sdk/go
+
+go 1.24.3

go/observability.go

@@ -0,0 +1,45 @@
+// Package observability provides LaunchDarkly observability functionality for Go applications.
+//
+// This package is currently in early access preview. APIs are subject to change
+// until a 1.x version is released.
+package observability
+
+// observabilityConfig holds configuration for the observability plugin.
+type observabilityConfig struct {
+	serviceName    string
+	serviceVersion string
+}
+
+// Option is a function that configures the observability plugin.
+type Option func(*observabilityConfig)
+
+// WithServiceName sets the service name for the observability plugin.
+func WithServiceName(serviceName string) Option {
+	return func(c *observabilityConfig) {
+		c.serviceName = serviceName
+	}
+}
+
+// WithServiceVersion sets the service version for the observability plugin.
+func WithServiceVersion(serviceVersion string) Option {
+	return func(c *observabilityConfig) {
+		c.serviceVersion = serviceVersion
+	}
+}
+
+// ObservabilityPlugin represents the LaunchDarkly observability plugin.
+type ObservabilityPlugin struct {
+	config observabilityConfig
+}
+
+// NewObservabilityPlugin creates a new observability plugin with the given configuration.
+func NewObservabilityPlugin(opts ...Option) *ObservabilityPlugin {
+	config := observabilityConfig{}
+	for _, opt := range opts {
+		opt(&config)
+	}
+
+	return &ObservabilityPlugin{
+		config: config,
+	}
+}

go/observability_test.go

@@ -0,0 +1,60 @@
+package observability
+
+import (
+	"testing"
+)
+
+func TestNewObservabilityPlugin(t *testing.T) {
+	expectedServiceName := "test-service"
+	expectedServiceVersion := "1.0.0"
+
+	plugin := NewObservabilityPlugin(WithServiceName(expectedServiceName), WithServiceVersion(expectedServiceVersion))
+
+	if plugin == nil {
+		t.Fatal("Expected plugin to be created, got nil")
+	}
+
+	if plugin.config.serviceName != expectedServiceName {
+		t.Errorf("Expected service name %s, got %s", expectedServiceName, plugin.config.serviceName)
+	}
+
+	if plugin.config.serviceVersion != expectedServiceVersion {
+		t.Errorf("Expected service version %s, got %s", expectedServiceVersion, plugin.config.serviceVersion)
+	}
+}
+
+func TestNewObservabilityPlugin_WithDefaults(t *testing.T) {
+	plugin := NewObservabilityPlugin()
+
+	if plugin == nil {
+		t.Fatal("Expected plugin to be created, got nil")
+	}
+
+	// Test that default values are empty strings
+	if plugin.config.serviceName != "" {
+		t.Errorf("Expected empty service name, got %s", plugin.config.serviceName)
+	}
+
+	if plugin.config.serviceVersion != "" {
+		t.Errorf("Expected empty service version, got %s", plugin.config.serviceVersion)
+	}
+}
+
+func TestNewObservabilityPlugin_WithPartialOptions(t *testing.T) {
+	expectedServiceName := "partial-service"
+
+	plugin := NewObservabilityPlugin(WithServiceName(expectedServiceName))
+
+	if plugin == nil {
+		t.Fatal("Expected plugin to be created, got nil")
+	}
+
+	if plugin.config.serviceName != expectedServiceName {
+		t.Errorf("Expected service name %s, got %s", expectedServiceName, plugin.config.serviceName)
+	}
+
+	// Service version should be empty when not provided
+	if plugin.config.serviceVersion != "" {
+		t.Errorf("Expected empty service version, got %s", plugin.config.serviceVersion)
+	}
+}