transform

type BasicExpr ¶

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

support for basic expression evaluation support. NOTE: expressions must evaluate to a bool value, i.e. true or false supports

! - unary not operator

&& - binary logical and || - binary logical or == - binary equality != - binary equality negated < - binary less than > - binary greater than <= - binary less than or equal to >= - binary greater than or equal to ( ) - parentheses grouping true - boolean true constant false - boolean false constant <number constants> - number constants <string constants> - string constants ( "" ) <func calls> - converter function call, f( jsonPath, stringArgs ) where, f is a converter id, jsonPath is a json path, and args are arguments to the converter <json path resolution> - a json path.. does not support path parameters, i.e. ? conditionals and converter extensions

func NewBasicExpr(data []byte, exprStr string) (expr *BasicExpr, err error)

func (expr *BasicExpr) Eval() (val bool, err error)

type CPathSkipError ¶

type CPathSkipError string

CPathNoDefaultError thrown when a path is missing, and marked conditional, and didn't have a default set

func (c CPathSkipError) Error() string

type Config ¶

type Config struct {
	Spec    *map[string]interface{} `json:"spec"`
	Require bool                    `json:"require,omitempty"`
	InPlace bool                    `json:"inplace,omitempty"`
}

Config contains the options that dictate the behavior of a transform. The internal `spec` object can be an arbitrary json configuration for the transform.

type JSONPathConverter ¶

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

func NewJSONPathConverter(converter string) *JSONPathConverter

type JSONPathParameters ¶

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

  [jsonPath]?[conditional]|[converter]
	e.g. root.node1[1].property ? root.node0.prop1 == "true" | regex remove_commas

	the path will be broken into 3 components:
	1. the json parser path to the node value
    2. the conditional component
  	3. and a series of converter expressions to pipe the value through.

	The conditional component has 4 forms:

	root.prop1 ?
								// if the value exists, return it, otherwise skip it, regardless on
								// whether paths are required.
	root.prop1 ? defaultVal
								// if value exists, use that, otherwise return the default value. this is JSON syntax
								// so strings, will require double quotes.
	root.prop1 ? root.node1.prop2 == true :
								// if value exists, and the expression is true, return the existing value
								// if the value exists, and the expression is false, skip the existing value
								// note that the : is required here to end the expression.
	root.prop1 ? root.node1.prop2 == true : defaultValue
								// if the value exists, and the expression is true, return the existing value
								// if the value exists and the expression is false,
								// return the default value (JSON syntax)

	Conditional Expressions support  () , <, >, >=, <=, ==, !=, !, true, false, && and ||
	Conditional expressions must evaluate to a boolean true or false value.
	Identifiers in the expression are assumed to be JSON paths within the document, and will evaluate
	to their current value.  Only non composite JSON values are supported: boolean, number,
	string (i.e. not arrays or objects).

	Function calls of the form  <converter name>( json.path, "converter arguments")   are also supported, e.g.
		root.prop1 ? ston(root.node1.prop1) == 3 && regex(root.node2.prop2,"remove_commas) == "1000" :

	The converters component will define a series of value conversions

func NewJSONPathParameters(data []byte, path string) *JSONPathParameters

type JSONValue ¶

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

func GetJsonPathValue(jsonData []byte, path string) (value *JSONValue, err error)

func NewJSONValue(data []byte) (value *JSONValue, err error)

func (v *JSONValue) GetBoolValue() bool

func (v *JSONValue) GetData() []byte

func (v *JSONValue) GetFloatValue() float64

func (v *JSONValue) GetIntValue() int64

func (v *JSONValue) GetNumber() json.Number

func (v *JSONValue) GetQuotedStringValue() string

func (v *JSONValue) GetStringValue() string

func (v *JSONValue) GetType() int

func (v *JSONValue) GetValue() interface{}

func (v *JSONValue) IsBool() bool

func (v *JSONValue) IsNull() bool

func (v *JSONValue) IsNumber() bool

func (v *JSONValue) IsString() bool

func (v *JSONValue) SetFloatStringPrecision(p int)

func (v *JSONValue) String() string

type ParseError ¶

type ParseError string

ParseError should be thrown when there is an issue with parsing any of the specification or data

func (p ParseError) Error() string

type RequireError ¶

type RequireError string

RequireError should be thrown if a required key is missing in the data

func (r RequireError) Error() string

type SpecError ¶

type SpecError string

SpecError should be thrown if the spec for a transform is malformed

func (s SpecError) Error() string

type TransformFunc ¶

type TransformFunc func(spec *Config, data []byte) ([]byte, error)