History

James Phillips 585958746a Lets the leave unit test proceed even after an EOF.		8 years ago
..
README.md	…
acl.go	…
acl_test.go	…
agent.go	Add reload/leave http endpoints (#2516 )	8 years ago
agent_test.go	Lets the leave unit test proceed even after an EOF.	8 years ago
api.go	Update client api and docs for node metadata	8 years ago
api_test.go	Merge pull request #2238 from hasyimibhar/master	8 years ago
catalog.go	Adds catalog support for node IDs.	8 years ago
catalog_test.go	Add node metadata filtering to remaining health/catalog endpoints	8 years ago
coordinate.go	…
coordinate_test.go	…
event.go	…
event_test.go	…
health.go	Return the correct type	8 years ago
health_test.go	Add node metadata filtering to remaining health/catalog endpoints	8 years ago
kv.go	fix KVOp types	8 years ago
kv_test.go	Fix race condition in TestClient_WatchList and TestClient_WatchGet	8 years ago
lock.go	Adds comment about SessionOpts.	8 years ago
lock_test.go	More flaky unit test fixes (#2449 )	8 years ago
operator.go	Fix keyring doc method wording	8 years ago
operator_test.go	Combine keyring endpoints into one	8 years ago
prepared_query.go	Add tests for node meta in prepared queries and update docs	8 years ago
prepared_query_test.go	Add tests for node meta in prepared queries and update docs	8 years ago
raw.go	…
semaphore.go	…
semaphore_test.go	…
session.go	…
session_test.go	…
snapshot.go	Adds support for snapshots and restores. (#2396 )	8 years ago
snapshot_test.go	Adds support for snapshots and restores. (#2396 )	8 years ago
status.go	…
status_test.go	…

README.md

Consul API client

This package provides the api package which attempts to provide programmatic access to the full Consul API.

Currently, all of the Consul APIs included in version 0.6.0 are supported.

Documentation

The full documentation is available on Godoc

Usage

Below is an example of using the Consul client:

// Get a new client
client, err := api.NewClient(api.DefaultConfig())
if err != nil {
    panic(err)
}

// Get a handle to the KV API
kv := client.KV()

// PUT a new KV pair
p := &api.KVPair{Key: "foo", Value: []byte("test")}
_, err = kv.Put(p, nil)
if err != nil {
    panic(err)
}

// Lookup the pair
pair, _, err := kv.Get("foo", nil)
if err != nil {
    panic(err)
}
fmt.Printf("KV: %v", pair)