Documentation ¶
Overview ¶
Package ini is an LL(1) parser for configuration files.
Example: sections, err := ini.OpenFile("/path/to/file") if err != nil { panic(err) } profile := "foo" section, ok := sections.GetSection(profile) if !ok { fmt.Printf("section %q could not be found", profile) }
Below is the BNF that describes this parser
Grammar: stmt -> value stmt' stmt' -> epsilon | op stmt value -> number | string | boolean | quoted_string section -> [ section' section' -> value section_close section_close -> ] SkipState will skip (NL WS)+ comment -> # comment' | ; comment' comment' -> epsilon | value
Index ¶
- Constants
- Variables
- func EqualExprKey(ast AST) string
- func Walk(tree []AST, v Visitor) error
- type AST
- type ASTKind
- type DefaultVisitor
- type ParseError
- type ParseStack
- type Section
- func (t Section) Bool(k string) bool
- func (t Section) Float64(k string) float64
- func (t Section) Has(k string) bool
- func (t Section) Int(k string) int64
- func (t Section) String(k string) string
- func (t Section) UpdateSourceFile(property string, filepath string)
- func (t Section) UpdateValue(k string, v Value) error
- func (t Section) ValueType(k string) (ValueType, bool)
- type Sections
- type Token
- type TokenType
- type UnableToReadFile
- type Value
- type ValueType
- type Visitor
Constants ¶
const ( ASTKindNone = ASTKind(iota) ASTKindStart ASTKindExpr ASTKindEqualExpr ASTKindStatement ASTKindSkipStatement ASTKindExprStatement ASTKindSectionStatement ASTKindNestedSectionStatement ASTKindCompletedNestedSectionStatement ASTKindCommentStatement ASTKindCompletedSectionStatement )
ASTKind* is used in the parse table to transition between the different states
const ( TokenNone = TokenType(iota) TokenLit TokenSep TokenComma TokenOp TokenWS TokenNL TokenComment )
TokenType enums
const ( InvalidState = iota // stmt -> value stmt' StatementState // stmt' -> MarkComplete | op stmt StatementPrimeState // value -> number | string | boolean | quoted_string ValueState // section -> [ section' OpenScopeState // section' -> value section_close SectionState // section_close -> ] CloseScopeState // SkipState will skip (NL WS)+ SkipState // SkipTokenState will skip any token and push the previous // state onto the stack. SkipTokenState // comment -> # comment' | ; comment' // comment' -> MarkComplete | value CommentState // MarkComplete state will complete statements and move that // to the completed AST list MarkCompleteState // TerminalState signifies that the tokens have been fully parsed TerminalState )
State enums for the parse table
const ( NoneType = ValueType(iota) DecimalType IntegerType StringType QuotedStringType BoolType )
ValueType enums
Variables ¶
var Start = newAST(ASTKindStart, AST{})
Start is used to indicate the starting state of the parse table.
Functions ¶
func EqualExprKey ¶
EqualExprKey will return a LHS value in the equal expr
Types ¶
type AST ¶
AST interface allows us to determine what kind of node we are on and casting may not need to be necessary.
The root is always the first node in Children
func ParseASTBytes ¶
ParseASTBytes will parse input from a byte slice using an LL(1) parser.
func (*AST) AppendChild ¶
AppendChild will append to the list of children an AST has.
func (*AST) GetChildren ¶
GetChildren will return the current AST's list of children
func (*AST) GetRoot ¶
GetRoot will return the root AST which can be the first entry in the children list or a token.
func (*AST) SetChildren ¶
SetChildren will set and override all children of the AST.
type ASTKind ¶
type ASTKind int
ASTKind represents different states in the parse table and the type of AST that is being constructed
type DefaultVisitor ¶
type DefaultVisitor struct { // Sections defines list of the profile section Sections Sections // contains filtered or unexported fields }
DefaultVisitor is used to visit statements and expressions and ensure that they are both of the correct format. In addition, upon visiting this will build sections and populate the Sections field which can be used to retrieve profile configuration.
func NewDefaultVisitor ¶
func NewDefaultVisitor(filepath string) *DefaultVisitor
NewDefaultVisitor returns a DefaultVisitor. It takes in a filepath which points to the file it is visiting.
func (*DefaultVisitor) VisitExpr ¶
func (v *DefaultVisitor) VisitExpr(expr AST) error
VisitExpr visits expressions...
func (*DefaultVisitor) VisitStatement ¶
func (v *DefaultVisitor) VisitStatement(stmt AST) error
VisitStatement visits statements...
type ParseError ¶
type ParseError struct {
// contains filtered or unexported fields
}
ParseError is an error which is returned during any part of the parsing process.
func NewParseError ¶
func NewParseError(message string) *ParseError
NewParseError will return a new ParseError where message is the description of the error.
func (*ParseError) Error ¶
func (err *ParseError) Error() string
type ParseStack ¶
type ParseStack struct {
// contains filtered or unexported fields
}
ParseStack is a stack that contains a container, the stack portion, and the list which is the list of ASTs that have been successfully parsed.
func (*ParseStack) MarkComplete ¶
func (s *ParseStack) MarkComplete(ast AST)
MarkComplete will append the AST to the list of completed statements
func (*ParseStack) Pop ¶
func (s *ParseStack) Pop() AST
Pop will return and truncate the last container element.
func (*ParseStack) Push ¶
func (s *ParseStack) Push(ast AST)
Push will add the new AST to the container
func (ParseStack) String ¶
func (s ParseStack) String() string
type Section ¶
type Section struct { // Name is the Section profile name Name string // Errors is the list of errors Errors []error // Logs is the list of logs Logs []string // SourceFile is the INI Source file from where this section // was retrieved. They key is the property, value is the // source file the property was retrieved from. SourceFile map[string]string // contains filtered or unexported fields }
Section contains a name and values. This represent a sectioned entry in a configuration file.
func NewSection ¶ added in v0.31.0
NewSection returns an initialize section for the name
func (Section) Has ¶ added in v0.6.0
Has will return whether or not an entry exists in a given section
func (Section) UpdateSourceFile ¶ added in v0.31.0
UpdateSourceFile updates source file for a property to provided filepath.
func (Section) UpdateValue ¶ added in v0.31.0
UpdateValue updates value for a provided key with provided value
type Sections ¶
type Sections struct {
// contains filtered or unexported fields
}
Sections is a map of Section structures that represent a configuration.
func NewSections ¶ added in v0.31.0
func NewSections() Sections
NewSections returns empty ini Sections
func ParseBytes ¶
ParseBytes will parse the given bytes and return the parsed sections.
func (Sections) DeleteSection ¶ added in v0.31.0
DeleteSection deletes a section entry/value for provided section name./
func (Sections) GetSection ¶
GetSection will return section p. If section p does not exist, false will be returned in the second parameter.
func (Sections) HasSection ¶ added in v0.31.0
HasSection denotes if Sections consist of a section with provided name.
type Token ¶
type Token struct { ValueType ValueType // contains filtered or unexported fields }
Token indicates a metadata about a given value.
type UnableToReadFile ¶ added in v0.25.0
type UnableToReadFile struct {
Err error
}
UnableToReadFile is an error indicating that a ini file could not be read
func (*UnableToReadFile) Error ¶ added in v0.25.0
func (e *UnableToReadFile) Error() string
Error returns an error message and the underlying error message if present
func (*UnableToReadFile) Unwrap ¶ added in v0.25.0
func (e *UnableToReadFile) Unwrap() error
Unwrap returns the underlying error
type Value ¶
type Value struct { Type ValueType // contains filtered or unexported fields }
Value is a union container
func NewIntValue ¶ added in v0.31.0
NewIntValue returns a Value type generated using an int64 input.
func NewStringValue ¶ added in v0.31.0
NewStringValue returns a Value type generated using a string input.