client

type ApiVersion struct {
	Major int
	Minor int
}

type ApiVersionInfo struct {
	Version ApiVersion       `json:"id"`
	Links   []ApiVersionLink `json:"links"`
	Status  string           `json:"status"`
}

type ApiVersionLink struct {
	Href string `json:"href"`
	Rel  string `json:"rel"`
}

type AuthenticatingClient interface {
	Client

	// SetVersionDiscoveryDisabled enables or disables API version
	// discovery on a per service basis. Discovery is enabled by
	// default. If enabled, the client will attempt to list all
	// versions available for a service and use the best match.
	// Otherwise, any API version specified in an SendRequest or
	// MakeServiceURL call will be ignored, and the service
	// catalogue endpoint URL will be used directly.
	SetVersionDiscoveryDisabled(string, bool)

	// SetRequiredServiceTypes sets the service types that the
	// openstack must provide.
	SetRequiredServiceTypes(requiredServiceTypes []string)

	// Authenticate authenticates the client with the OpenStack
	// identity service.
	Authenticate() error

	// IsAuthenticated reports whether the client is
	// authenticated.
	IsAuthenticated() bool

	// Token returns the authentication token. If the client
	// is not yet authenticated, this will return an empty
	// string.
	Token() string

	// UserId returns the user ID for authentication.
	UserId() string

	// TenantId returns the tenant ID for authentication.
	TenantId() string

	// EndpointsForRegion returns the service catalog URLs
	// for the specified region.
	EndpointsForRegion(region string) identity.ServiceURLs

	// IdentityAuthOptions returns a list of valid auth options
	// for the given openstack or error if fetching fails.
	IdentityAuthOptions() (identity.AuthOptions, error)
}

type Client interface {
	SendRequest(method, svcType, svcVersion, apiCall string, requestData *goosehttp.RequestData) (err error)
	// MakeServiceURL prepares a full URL to a service endpoint, with optional
	// URL parts.
	MakeServiceURL(serviceType, apiVersion string, parts []string) (string, error)
}

type Option func(*options)