httpheaders

func CallHeaders ¶ added in v0.36.0

func CallHeaders(headers map[string]string) (map[string]string, bool)

CallHeaders resolves per-call headers. It returns the headers map and true if per-call headers should be applied, or nil and false if the client-level headers should be used as-is.

func CallUserAgent ¶

func CallUserAgent(callUA string) (string, bool)

CallUserAgent resolves the User-Agent for a single API call. It returns the resolved UA string and true if a per-call override should be applied, or empty string and false if the client-level UA should be used as-is.

func DefaultUserAgent ¶

func DefaultUserAgent(version string) string

DefaultUserAgent returns the default User-Agent string for the SDK. The result is "Charm Fantasy/<version>".

func ResolveHeaders ¶

func ResolveHeaders(headers map[string]string, explicitUA, defaultUA string) map[string]string

ResolveHeaders returns a new header map, with a User-Agent field.

Setting the value via WithUserAgent() takes precedence, however the user agent can also be set via HTTP headers (i.e. WithHeaders()). Otherwise, the default user agent will be used, i.e. Charm Fantasy/0.11.0.

Also note that the input map is never mutated.