unleash-go-sdk - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #typescript #rust #macos #kubernetes #awesome-list #vue #security #mcp #openai #open-source

unleash-go-sdk

(★ 150)

Unleash client SDK for Go

File Explorer

Download Latest Version (.zip)

- - add-to-project.yml
  - build-prs.yml
  - build.yml
- stale.yml
- api_response.go
- constraint.go
- delta.go
- delta_test.go
- feature.go
- feature_test.go
- response.go
- strategy.go
- variant.go
- variant_test.go
- context.go
- context_test.go
- - event.go
  - metrics.go
- - check.go
  - check_test.go
  - operator_cidr.go
  - operator_cidr_test.go
  - operator_date.go
  - operator_date_test.go
  - operator_in.go
  - operator_in_test.go
  - operator_num.go
  - operator_num_test.go
  - operator_regex.go
  - operator_regex_test.go
  - operator_semver.go
  - operator_semver_test.go
  - operator_str.go
  - operator_str_test.go
- - context.go
  - context_test.go
  - metric_types.go
  - metric_types_test.go
  - metrics_api.go
  - metrics_api_test.go
- - application_hostname.go
  - application_hostname_test.go
  - default.go
  - default_test.go
  - flexible_rollout.go
  - flexible_rollout_test.go
  - gradual_rollout_random.go
  - gradual_rollout_random_test.go
  - gradual_rollout_session_id.go
  - gradual_rollout_session_id_test.go
  - gradual_rollout_user_id.go
  - gradual_rollout_user_id_test.go
  - helpers.go
  - helpers_test.go
  - remote_address_test.go
  - remote_addresss.go
  - user_with_id.go
  - user_with_id_test.go
- strategy.go
.gitignore
adaptive_fetcher.go
adaptive_fetcher_test.go
benchmark_test.go
bootstrap_storage.go
client.go
client_test.go
config.go
debuglistener.go
demo_app_toggles.json
doc.go
example_bootstrap_from_file_test.go
example_custom_strategy_test.go
example_fallback_func_test.go
example_simple_usage_test.go
example_with_instance_test.go
failover.go
failover_test.go
feature_cache.go
feature_state.go
go.mod
go.sum
impact_metrics_test.go
impression.go
impression_test.go
LICENSE
Makefile
metrics.go
metrics_test.go
nooplistener.go
nooplistener_test.go
polling_fetcher.go
polling_fetcher_test.go
README.md
spec_test.go
storage.go
streaming_configuration_test.go
streaming_delta_integration_test.go
streaming_fetcher.go
streaming_fetcher_test.go
streaming_integration_test.go
unleash.go
unleash_mock.go
unleash_test.go
utils.go
utils_test.go

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Build Status](https://github.com/Unleash/unleash-go-sdk/actions/workflows/build.yml/badge.svg)](https://github.com/Unleash/unleash-go-sdk/actions/workflows/build.yml) [![GoDoc](https://pkg.go.dev/badge/github.com/Unleash/unleash-go-sdk/v6?status.svg)](https://pkg.go.dev/github.com/Unleash/unleash-go-sdk/v6) [![Go Report Card](https://goreportcard.com/badge/github.com/Unleash/unleash-go-sdk/v6)](https://goreportcard.com/report/github.com/Unleash/unleash-go-sdk/v6)
[![Coverage Status](https://coveralls.io/repos/github/Unleash/unleash-go-sdk/badge.svg?branch=v6)](https://coveralls.io/github/Unleash/unleash-go-sdk?branch=v6)

# unleash-go-sdk

The official Unleash SDK for Go. This SDK lets you evaluate feature flags in your Go services and applications.

[Unleash](https://github.com/Unleash/unleash) is an open-source feature management platform. You can use this SDK with [Unleash Enterprise](https://www.getunleash.io/pricing) or [Unleash Open Source](https://github.com/Unleash/unleash).

For complete documentation, see the [Go SDK reference](https://docs.getunleash.io/sdks/go).

## Requirements

- Go 1.23 or later (tested up to 1.26)

## Installation

Install the SDK module with `go get`:

```bash
go get github.com/Unleash/unleash-go-sdk/v6@latest
```

## Quick start

The following example initializes the SDK and checks a feature flag:

```go
package main

import (
	"net/http"

unleash "github.com/Unleash/unleash-go-sdk/v6"
)

func main() {
	err := unleash.Initialize(
		unleash.WithAppName("my-go-service"),
		unleash.WithUrl("https://<your-unleash-instance>/api/"),
		unleash.WithCustomHeaders(http.Header{"Authorization": {"<your-backend-token>"}}),
	)

if err != nil {
		panic(err)
	}

defer unleash.Close()

// Block until the SDK has fetched flag data from Unleash.
	// In production, consider using bootstrapping or event listeners instead.
	unleash.WaitForReady()

enabled := unleash.IsEnabled("my-feature", unleash.FeatureOptions{})
	if enabled {
		// new behavior
	}

variant := unleash.GetVariant("checkout-experiment", unleash.VariantOptions{})
	if variant.Name == "blue" {
		// blue variant behavior
	} else if variant.Name == "green" {
		// green variant behavior
	}
}
```

## Contributing

### Local development

Clone the repository and the [client specification](https://github.com/Unleash/client-specification) test data. The client specification defines a shared contract that all Unleash SDKs test against.

```bash
git clone https://github.com/Unleash/unleash-go-sdk.git
cd unleash-go-sdk
mkdir -p testdata
git clone https://github.com/Unleash/client-specification.git testdata/client-specification
```

To test a local application against your development copy of the SDK, add a `replace` directive to the application's `go.mod`:

```
replace github.com/Unleash/unleash-go-sdk/v6 => ../unleash-go-sdk/
```

### Running tests

Use `make` to run the test suite:

```bash
make          # vet + tests
make test-race # tests with the race detector
```

### Benchmarking

Run the feature flag evaluation benchmark:

```bash
go test -run=^$ -bench=BenchmarkFeatureToggleEvaluation -benchtime=10s
```

Example output on a MacBook Pro (M1 Pro, 2021) with 16 GB RAM:

```
goos: darwin
goarch: arm64
pkg: github.com/Unleash/unleash-go-sdk/v6
BenchmarkFeatureToggleEvaluation-8 Final Estimated Operations Per Day: 101.131 billion (1.011315e+11)
13635154 854.3 ns/op
PASS
ok github.com/Unleash/unleash-go-sdk/v6 13.388s
```

**854.3 ns/op** translates to roughly **101 billion** evaluations per day on a single CPU core.

### Code style and formatting

Use the following `make` targets to format and lint your code:

```bash
make fmt          # format code
make fmt-check    # check formatting without writing
make strict-check # vet + golint
```

### Releasing

1. Update `clientVersion` in `client.go`.
2. Create a release in GitHub with a semantic version tag.

## License

Apache-2.0