ast

Documentation

Index

• func ParamFuncArgToInt(a ParamFuncArg) (int, error)
• func ValidKind(k reflect.Kind) bool
• type ParamFunc
• type ParamFuncArg
• type ParamStatement
• type ParamType
  • func LookupParamType(ident string) ParamType
  • func LookupParamTypeFromStd(goType string) ParamType
  • func (pt ParamType) Assignable(k reflect.Kind) bool
  • func (pt ParamType) Kind() reflect.Kind
  • func (pt ParamType) String() string

Functions

func ParamFuncArgToInt

func ParamFuncArgToInt(a ParamFuncArg) (int, error)

ParamFuncArgToInt converts and returns any type of "a", to an integer.

func ValidKind

func ValidKind(k reflect.Kind) bool

ValidKind will return true if at least one param type is supported for this std kind.

Types

type ParamFunc

type ParamFunc struct {
	Name string         // range
	Args []ParamFuncArg // [1,5]
}

ParamFunc holds the name of a parameter's function and its arguments (values) A param func is declared with: {param:int range(1,5)}, the range is the param function name the 1 and 5 are the two param function arguments range(1,5)

type ParamFuncArg

type ParamFuncArg interface{}

ParamFuncArg represents a single parameter function's argument

type ParamStatement

type ParamStatement struct {
	Src       string      // the original unparsed source, i.e: {id:int range(1,5) else 404}
	Name      string      // id
	Type      ParamType   // int
	Funcs     []ParamFunc // range
	ErrorCode int         // 404
}

ParamStatement is a struct which holds all the necessary information about a macro parameter. It holds its type (string, int, alphabetical, file, path), its source ({param:type}), its name ("param"), its attached functions by the user (min, max...) and the http error code if that parameter failed to be evaluated.

type ParamType

type ParamType uint8

ParamType is a specific uint8 type which holds the parameter types' type.

const (
	// ParamTypeUnExpected is an unexpected parameter type.
	ParamTypeUnExpected ParamType = iota
	// ParamTypeString 	is the string type.
	// If parameter type is missing then it defaults to String type.
	// Allows anything
	// Declaration: /mypath/{myparam:string} or /mypath{myparam}
	ParamTypeString
	// ParamTypeInt is the integer, a number type.
	// Allows only positive numbers (0-9)
	// Declaration: /mypath/{myparam:int}
	ParamTypeInt
	// ParamTypeLong is the integer, a number type.
	// Allows only positive numbers (0-9)
	// Declaration: /mypath/{myparam:long}
	ParamTypeLong
	// ParamTypeBoolean is the bool type.
	// Allows only "1" or "t" or "T" or "TRUE" or "true" or "True"
	// or "0" or "f" or "F" or "FALSE" or "false" or "False".
	// Declaration: /mypath/{myparam:boolean}
	ParamTypeBoolean
	// ParamTypeAlphabetical is the  alphabetical/letter type type.
	// Allows letters only (upper or lowercase)
	// Declaration:  /mypath/{myparam:alphabetical}
	ParamTypeAlphabetical
	// ParamTypeFile  is the file single path type.
	// Allows:
	// letters (upper or lowercase)
	// numbers (0-9)
	// underscore (_)
	// dash (-)
	// point (.)
	// no spaces! or other character
	// Declaration: /mypath/{myparam:file}
	ParamTypeFile
	// ParamTypePath is the multi path (or wildcard) type.
	// Allows anything, should be the last part
	// Declaration: /mypath/{myparam:path}
	ParamTypePath
)

func LookupParamType

func LookupParamType(ident string) ParamType

LookupParamType accepts the string representation of a parameter type. Available: "string" "int" "long" "alphabetical" "file" "path"

func LookupParamTypeFromStd

func LookupParamTypeFromStd(goType string) ParamType

LookupParamTypeFromStd accepts the string representation of a standard go type. It returns a ParamType, but it may differs for example the alphabetical, file, path and string are all string go types, so make sure that caller resolves these types before this call.

string matches to string int matches to int int64 matches to long bool matches to boolean

func (ParamType) Assignable

func (pt ParamType) Assignable(k reflect.Kind) bool

Assignable returns true if the "k" standard type is assignabled to this ParamType.

func (ParamType) Kind

func (pt ParamType) Kind() reflect.Kind

Kind returns the std kind of this param type.

func (ParamType) String

func (pt ParamType) String() string