component

package
v3.3.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 19, 2024 License: MIT Imports: 18 Imported by: 2

Documentation

Index

Constants

View Source 
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

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

Components is a list of all available components

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

ErrKeyNotFound is a error raised when a key is not found

View Source 
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 added in v3.2.3 

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 added in v3.2.3 

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 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 added in v3.2.3 

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 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 added in v3.2.3 

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 added in v3.2.3 

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 added in v3.2.3 

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 added in v3.2.3 

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, 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

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.