config

README

Config

Services have specific endpoints per region. Thisconfig API helps you discover the available services and their settings. Since the data is machine readable this enables auto configuration of endpoints.

Canonical source

The canonical source for configuration is: https://github.com/philips-software/go-hsdp-api/blob/master/config/hsdp.toml

Example

Determine the IAM base URL of a region and environment

package main

import (
	"fmt"

	"github.com/philips-software/go-hsdp-api/config"
)

func main() {
	c, err := config.New()
	if err != nil {
		fmt.Printf("error loading: %v\n", err)
		return
	}
	baseIAMURLInUSEastClientTest, err := c.Region("us-east").Env("client-test").Service("iam").String("url")
	if err != nil {
		fmt.Printf("not found: %v\n", err)
		return
	}
	fmt.Printf("IAM Base URL: %s\n", baseIAMURLInUSEastClientTest)
}

Documentation

Overview

Code generated for package config by go-bindata DO NOT EDIT. (@generated) sources: hsdp.toml

Index

• Constants
• Variables
• func Asset(name string) ([]byte, error)
• func AssetDir(name string) ([]string, error)
• func AssetInfo(name string) (os.FileInfo, error)
• func AssetNames() []string
• func MustAsset(name string) []byte
• type Config
  • func New(opts ...OptionFunc) (*Config, error)
  • func (c *Config) Env(environment string) *Config
  • func (c *Config) Region(region string) *Config
  • func (c *Config) Regions() []string
  • func (c *Config) Service(service string) *Service
  • func (c *Config) Services() []string
• type OptionFunc
  • func FromReader(reader io.Reader) OptionFunc
  • func WithEnv(env string) OptionFunc
  • func WithRegion(region string) OptionFunc
• type Service
  • func (s *Service) Available() bool
  • func (s *Service) GetInt(key string) (int, error)
  • func (s *Service) GetString(key string) (string, error)
  • func (s *Service) Keys() []string

Constants

const (
	// CanonicalURL is the source of truth
	CanonicalURL = "https://raw.githubusercontent.com/philips-software/go-hsdp-api/master/config/hsdp.toml"
)

Variables

var (
	ErrMissingConfig                     = errors.New("missing config")
	ErrNotFound                          = errors.New("not found")
	ErrUnreachableOrOutdatedConfigSource = errors.New("unreachable or outdated config source")
)

Functions

func Asset

func Asset(name string) ([]byte, error)

Asset loads and returns the asset for the given name. It returns an error if the asset could not be found or could not be loaded.

func AssetDir

func AssetDir(name string) ([]string, error)

AssetDir returns the file names below a certain directory embedded in the file by go-bindata. For example if you run go-bindata on data/... and data contains the following hierarchy:

data/
  foo.txt
  img/
    a.png
    b.png

then AssetDir("data") would return []string{"foo.txt", "img"} AssetDir("data/img") would return []string{"a.png", "b.png"} AssetDir("foo.txt") and AssetDir("notexist") would return an error AssetDir("") will return []string{"data"}.

func AssetInfo

func AssetInfo(name string) (os.FileInfo, error)

AssetInfo loads and returns the asset info for the given name. It returns an error if the asset could not be found or could not be loaded.

func AssetNames

func AssetNames() []string

AssetNames returns the names of the assets.

func MustAsset

func MustAsset(name string) []byte

MustAsset is like Asset but panics when Asset would return an error. It simplifies safe initialization of global variables.

Types

type Config

type Config struct {
	// contains filtered or unexported fields
}

Config holds the state of a Config instance

func New

func New(opts ...OptionFunc) (*Config, error)

New returns a Config Instance. You can pass a list OptionFunc to cater the Config to your needs

func (*Config) Env

func (c *Config) Env(environment string) *Config

Env returns a new Config instance with environment set

func (*Config) Region

func (c *Config) Region(region string) *Config

Region returns a new Config instance with region set

func (*Config) Regions

func (c *Config) Regions() []string

Regions returns the known regions

func (*Config) Service

func (c *Config) Service(service string) *Service

Service returns an instance scoped to the service in the region and environment

func (*Config) Services

func (c *Config) Services() []string

Services returns a list of available services in the region

type OptionFunc

type OptionFunc func(*Config) error

func FromReader

func FromReader(reader io.Reader) OptionFunc

FromReader option specifies the toml source to read If this option is not provided the canonical source hosted on Github will be used. See CanonicalURL

func WithEnv

func WithEnv(env string) OptionFunc

WithEnv sets the environment of the newly created Config instance

func WithRegion

func WithRegion(region string) OptionFunc

WithRegion sets the region of the newly created Config instance

type Service

type Service struct {
	// contains filtered or unexported fields
}

Service holds the relevant toml data for a service

func (*Service) Available

func (s *Service) Available() bool

Available returns true if the Service exists and has data

func (*Service) GetInt

func (s *Service) GetInt(key string) (int, error)

GetInt returns the int key of the Service

func (*Service) GetString

func (s *Service) GetString(key string) (string, error)

String returns the string key of the Service

func (*Service) Keys

func (s *Service) Keys() []string

Keys returns the list of available keys for Service