protopatch

type Container interface {

	// IsReadOnly reports wether underlying container value is read only.
	IsReadOnly() bool

	// Self returns underlying container value. For messages it returns its proto.Message value. For lists and maps it returns List and Map interfaces accordingly.
	Self() any

	// Get returns value associated with the given field / index / key. It returns error if the field / index / key is not found. For scalar types and messages it returns its value. For lists and maps it returns List and Map interfaces accordingly.
	Get(string) (any, error)

	// GetCopy returns a copy of value associated with the given field / index / key. It returns error if the field / index / key is not found. For scalar types and messages it returns its value. For lists and maps it returns List and Map interfaces accordingly.
	GetCopy(string) (any, error)

	// GetNew returns a zero value of the type of value associated with the given field / index / key. It returns error if the field is not found or if index / key is malformed. For scalar types and messages it returns its zero value. For lists and maps it returns List and Map interfaces accordingly without any elements.
	GetNew(string) (any, error)

	// Mutable is a mutable variant of Get method - it returns value associated with the given field / index / key. It returns error if the container is read-only or the field / index / key is not found. For scalar types and messages it returns its value. For lists and maps it returns List and Map interfaces accordingly.
	Mutable(string) (any, error)

	// Access descends into the given field / index / key and returns a new container for that value. It returns error if the field / index / key is not found or is not associated with a composite type.
	Access(string) (Container, error)

	// AccessMutable is a mutable variant of Access method - it descends into the given field / index / key and returns a new container for that value. It returns error if the container is read-only, if the field / index / key is not found or is not associated with a composite type.
	AccessMutable(string) (Container, error)

	// Set stores the provided value under the associated field / index / key. It returns error if the container is read-only, if the field / index / key is not found or if the value has wrong type. When the provided value is nil, it clears the associated field / index / key.
	Set(string, any) error

	// Append adds the provided value to the end of a list. It returns error if the container is read-only, if the container is not a list or if the value has wrong type.
	Append(any) error

	// Insert adds the provided value at specified position to a list or map. It returns error if the container is read-only, if the container is not a list or map container, if the index is not found or if the value has wrong type.
	Insert(string, any) error
}

type ContainerTransformer interface {
	// TransformContainer performs container transformation as needed. Returned value must be a valid container or function should return an error. If transformation is not defined for the given container function should return an unwrapped ErrNoContainerTransformationDefined error.
	TransformContainer(container Container) (Container, error)
}

type ContainerTransformerFunc func(container Container) (Container, error)

type Converter interface {
	// Convert performs type conversion to type of first provided item from the second provided value. Returned value must be of first item type or function should return an error. If conversion is not defined for provided types Convert function should return an unwrapped ErrNoConversionDefined error.
	Convert(to, from any) (any, error)
}

type ConverterFunc func(to, from any) (any, error)

type ErrInPath struct {
	Path  string
	Cause error
}

type ErrNotFound struct {
	Kind  string // "field", "index" or "key"
	Value string
}

type ErrOperationFailed struct {
	Op    string
	Cause error
}

type List = protoops.List

type Map = protoops.Map

type Option interface {
	// contains filtered or unexported methods
}

type Path string

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