uri

Documentation

Index

• func HasScheme(scheme, rawuri string) bool
• type URI
  • func New(scheme string, values url.Values) *URI
  • func NewFile(path string) *URI
  • func Parse(rawuri string) (*URI, error)
  • func ParseWithScheme(scheme, rawuri string) (*URI, error)
  • func (u *URI) Get(key string) string
  • func (u *URI) GetBool(key string) bool
  • func (u *URI) GetEncoded(key string) []byte
  • func (u *URI) Pin() string

Functions

func HasScheme

func HasScheme(scheme, rawuri string) bool

HasScheme returns true if the given uri has the given scheme, false otherwise.

Types

type URI

type URI struct {
	*url.URL
	Values url.Values
}

URI implements a parser for a URI format based on the the PKCS #11 URI Scheme defined in https://tools.ietf.org/html/rfc7512

These URIs will be used to define the key names in a KMS.

func New

func New(scheme string, values url.Values) *URI

New creates a new URI from a scheme and key-value pairs.

func NewFile

func NewFile(path string) *URI

NewFile creates an uri for a file.

func Parse

func Parse(rawuri string) (*URI, error)

Parse returns the URI for the given string or an error.

func ParseWithScheme

func ParseWithScheme(scheme, rawuri string) (*URI, error)

ParseWithScheme returns the URI for the given string only if it has the given scheme.

func (*URI) Get

func (u *URI) Get(key string) string

Get returns the first value in the uri with the given key, it will return empty string if that field is not present.

func (*URI) GetBool

func (u *URI) GetBool(key string) bool

GetBool returns true if a given key has the value "true". It returns false otherwise.

func (*URI) GetEncoded

func (u *URI) GetEncoded(key string) []byte

GetEncoded returns the first value in the uri with the given key, it will return empty nil if that field is not present or is empty. If the return value is hex encoded it will decode it and return it.

func (*URI) Pin

func (u *URI) Pin() string

Pin returns the pin encoded in the url. It will read the pin from the pin-value or the pin-source attributes.