component

Documentation

Index

• Constants
• Variables
• func IsErrSetValue(err error) bool
• func IsTypedSlice(v interface{}) ([]interface{}, bool)
• type Body
  • func NewBody() *Body
  • func (b *Body) Clone() Component
  • func (b *Body) Delete(key string) error
  • func (b *Body) Iterate(callback func(key string, value interface{}) error) (errx error)
  • func (b *Body) Name() string
  • func (b *Body) Parse(req *retryablehttp.Request) (bool, error)
  • func (b *Body) Rebuild() (*retryablehttp.Request, error)
  • func (b *Body) SetValue(key string, value string) error
• type Component
  • func New(componentType string) Component
• type Cookie
  • func NewCookie() *Cookie
  • func (c *Cookie) Clone() Component
  • func (c *Cookie) Delete(key string) error
  • func (c *Cookie) Iterate(callback func(key string, value interface{}) error) (err error)
  • func (c *Cookie) Name() string
  • func (c *Cookie) Parse(req *retryablehttp.Request) (bool, error)
  • func (c *Cookie) Rebuild() (*retryablehttp.Request, error)
  • func (c *Cookie) SetValue(key string, value string) error
• type Header
  • func NewHeader() *Header
  • func (q *Header) Clone() Component
  • func (q *Header) Delete(key string) error
  • func (q *Header) Iterate(callback func(key string, value interface{}) error) (errx error)
  • func (q *Header) Name() string
  • func (q *Header) Parse(req *retryablehttp.Request) (bool, error)
  • func (q *Header) Rebuild() (*retryablehttp.Request, error)
  • func (q *Header) SetValue(key string, value string) error
• type Path
  • func NewPath() *Path
  • func (q *Path) Clone() Component
  • func (q *Path) Delete(key string) error
  • func (q *Path) Iterate(callback func(key string, value interface{}) error) (err error)
  • func (q *Path) Name() string
  • func (q *Path) Parse(req *retryablehttp.Request) (bool, error)
  • func (q *Path) Rebuild() (*retryablehttp.Request, error)
  • func (q *Path) SetValue(key string, value string) error
• type Query
  • func NewQuery() *Query
  • func (q *Query) Clone() Component
  • func (q *Query) Delete(key string) error
  • func (q *Query) Iterate(callback func(key string, value interface{}) error) (errx error)
  • func (q *Query) Name() string
  • func (q *Query) Parse(req *retryablehttp.Request) (bool, error)
  • func (q *Query) Rebuild() (*retryablehttp.Request, error)
  • func (q *Query) SetValue(key string, value string) error
• type Value
  • func NewValue(data string) *Value
  • func (v *Value) Clone() *Value
  • func (v *Value) Delete(key string) bool
  • func (v *Value) Encode() (string, error)
  • func (v *Value) Parsed() dataformat.KV
  • func (v *Value) SetParsed(data dataformat.KV, dataFormat string)
  • func (v *Value) SetParsedValue(key string, value string) bool
  • func (v *Value) String() string

Constants

const (
	// RequestBodyComponent is the name of the request body component
	RequestBodyComponent = "body"
	// RequestQueryComponent is the name of the request query component
	RequestQueryComponent = "query"
	// RequestPathComponent is the name of the request url component
	RequestPathComponent = "path"
	// RequestHeaderComponent is the name of the request header component
	RequestHeaderComponent = "header"
	// RequestCookieComponent is the name of the request cookie component
	RequestCookieComponent = "cookie"
)

Variables

var Components = []string{
	RequestBodyComponent,
	RequestQueryComponent,
	RequestPathComponent,
	RequestHeaderComponent,
	RequestCookieComponent,
}

Components is a list of all available components

var ErrKeyNotFound = errors.New("key not found")

ErrKeyNotFound is a error raised when a key is not found

var ErrSetValue = errors.New("could not set value")

ErrSetValue is a error raised when a value cannot be set

Functions

func IsErrSetValue

func IsErrSetValue(err error) bool

func IsTypedSlice

func IsTypedSlice(v interface{}) ([]interface{}, bool)

In go, []int, []string are not implictily converted to []interface{} when using type assertion and they need to be handled separately.

Types

type Body

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

Body is a component for a request body

func NewBody

func NewBody() *Body

NewBody creates a new body component

func (*Body) Clone

func (b *Body) Clone() Component

func (*Body) Delete

func (b *Body) Delete(key string) error

Delete deletes a key from the component

func (*Body) Iterate

func (b *Body) Iterate(callback func(key string, value interface{}) error) (errx error)

Iterate iterates through the component

func (*Body) Name

func (b *Body) Name() string

Name returns the name of the component

func (*Body) Parse

func (b *Body) Parse(req *retryablehttp.Request) (bool, error)

Parse parses the component and returns the parsed component

func (*Body) Rebuild

func (b *Body) Rebuild() (*retryablehttp.Request, error)

Rebuild returns a new request with the component rebuilt

func (*Body) SetValue

func (b *Body) SetValue(key string, value string) error

SetValue sets a value in the component

type Component

type Component interface {
	// Name returns the name of the component
	Name() string
	// Parse parses the component and returns the
	// parsed component
	Parse(req *retryablehttp.Request) (bool, error)
	// Iterate iterates over all values of a component
	// ex in case of query component, it will iterate over each query parameter
	// depending on the rule if mode is single
	// request is rebuilt for each value in this callback
	// and in case of multiple, request will be rebuilt after iteration of all values
	Iterate(func(key string, value interface{}) error) error
	// SetValue sets a value in the component
	// for a key
	//
	// After calling setValue for mutation, the value must be
	// called again so as to reset the body to its original state.
	SetValue(key string, value string) error
	// Delete deletes a key from the component
	// If it is applicable
	Delete(key string) error
	// Rebuild returns a new request with the
	// component rebuilt
	Rebuild() (*retryablehttp.Request, error)
	// Clones current state of this component
	Clone() Component
}

Component is a component for a request

func New

func New(componentType string) Component

New creates a new component for a componentType

type Cookie

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

Cookie is a component for a request cookie

func NewCookie

func NewCookie() *Cookie

NewCookie creates a new cookie component

func (*Cookie) Clone

func (c *Cookie) Clone() Component

Clone clones current state of this component

func (*Cookie) Delete

func (c *Cookie) Delete(key string) error

Delete deletes a key from the component

func (*Cookie) Iterate

func (c *Cookie) Iterate(callback func(key string, value interface{}) error) (err error)

Iterate iterates through the component

func (*Cookie) Name

func (c *Cookie) Name() string

Name returns the name of the component

func (*Cookie) Parse

func (c *Cookie) Parse(req *retryablehttp.Request) (bool, error)

Parse parses the component and returns the parsed component

func (*Cookie) Rebuild

func (c *Cookie) Rebuild() (*retryablehttp.Request, error)

Rebuild returns a new request with the component rebuilt

func (*Cookie) SetValue

func (c *Cookie) SetValue(key string, value string) error

SetValue sets a value in the component for a key

type Header

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

Header is a component for a request header

func NewHeader

func NewHeader() *Header

NewHeader creates a new header component

func (*Header) Clone

func (q *Header) Clone() Component

Clones current state of this component

func (*Header) Delete

func (q *Header) Delete(key string) error

Delete deletes a key from the component

func (*Header) Iterate

func (q *Header) Iterate(callback func(key string, value interface{}) error) (errx error)

Iterate iterates through the component

func (*Header) Name

func (q *Header) Name() string

Name returns the name of the component

func (*Header) Parse

func (q *Header) Parse(req *retryablehttp.Request) (bool, error)

Parse parses the component and returns the parsed component

func (*Header) Rebuild

func (q *Header) Rebuild() (*retryablehttp.Request, error)

Rebuild returns a new request with the component rebuilt

func (*Header) SetValue

func (q *Header) SetValue(key string, value string) error

SetValue sets a value in the component for a key

type Path

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

Path is a component for a request Path

func NewPath

func NewPath() *Path

NewPath creates a new URL component

func (*Path) Clone

func (q *Path) Clone() Component

Clones current state to a new component

func (*Path) Delete

func (q *Path) Delete(key string) error

Delete deletes a key from the component

func (*Path) Iterate

func (q *Path) Iterate(callback func(key string, value interface{}) error) (err error)

Iterate iterates through the component

func (*Path) Name

func (q *Path) Name() string

Name returns the name of the component

func (*Path) Parse

func (q *Path) Parse(req *retryablehttp.Request) (bool, error)

Parse parses the component and returns the parsed component

func (*Path) Rebuild

func (q *Path) Rebuild() (*retryablehttp.Request, error)

Rebuild returns a new request with the component rebuilt

func (*Path) SetValue

func (q *Path) SetValue(key string, value string) error

SetValue sets a value in the component for a key

type Query

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

Query is a component for a request query

func NewQuery

func NewQuery() *Query

NewQuery creates a new query component

func (*Query) Clone

func (q *Query) Clone() Component

Clones current state to a new component

func (*Query) Delete

func (q *Query) Delete(key string) error

Delete deletes a key from the component

func (*Query) Iterate

func (q *Query) Iterate(callback func(key string, value interface{}) error) (errx error)

Iterate iterates through the component

func (*Query) Name

func (q *Query) Name() string

Name returns the name of the component

func (*Query) Parse

func (q *Query) Parse(req *retryablehttp.Request) (bool, error)

Parse parses the component and returns the parsed component

func (*Query) Rebuild

func (q *Query) Rebuild() (*retryablehttp.Request, error)

Rebuild returns a new request with the component rebuilt

func (*Query) SetValue

func (q *Query) SetValue(key string, value string) error

SetValue sets a value in the component for a key

type Value

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

Value is a value component containing a single parameter for the component

It is a type of container that is used to represent all the data values that are used in a request.

func NewValue

func NewValue(data string) *Value

NewValue returns a new value component

func (*Value) Clone

func (v *Value) Clone() *Value

Clones current state of this value

func (*Value) Delete

func (v *Value) Delete(key string) bool

Delete removes a key from the parsed value

func (*Value) Encode

func (v *Value) Encode() (string, error)

Encode encodes the value into a string using the dataformat and encoding

func (*Value) Parsed

func (v *Value) Parsed() dataformat.KV

Parsed returns the parsed value

func (*Value) SetParsed

func (v *Value) SetParsed(data dataformat.KV, dataFormat string)

SetParsed sets the parsed value map

func (*Value) SetParsedValue

func (v *Value) SetParsedValue(key string, value string) bool

SetParsedValue sets the parsed value for a key in the parsed map

func (*Value) String

func (v *Value) String() string

String returns the string representation of the value