aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/gopkg.in/ini.v1/ini.go
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/gopkg.in/ini.v1/ini.go')
-rw-r--r--vendor/gopkg.in/ini.v1/ini.go176
1 files changed, 176 insertions, 0 deletions
diff --git a/vendor/gopkg.in/ini.v1/ini.go b/vendor/gopkg.in/ini.v1/ini.go
new file mode 100644
index 0000000..99e7f86
--- /dev/null
+++ b/vendor/gopkg.in/ini.v1/ini.go
@@ -0,0 +1,176 @@
1// Copyright 2014 Unknwon
2//
3// Licensed under the Apache License, Version 2.0 (the "License"): you may
4// not use this file except in compliance with the License. You may obtain
5// a copy of the License at
6//
7// http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
11// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12// License for the specific language governing permissions and limitations
13// under the License.
14
15// Package ini provides INI file read and write functionality in Go.
16package ini
17
18import (
19 "os"
20 "regexp"
21 "runtime"
22 "strings"
23)
24
25const (
26 // Maximum allowed depth when recursively substituing variable names.
27 depthValues = 99
28)
29
30var (
31 // DefaultSection is the name of default section. You can use this var or the string literal.
32 // In most of cases, an empty string is all you need to access the section.
33 DefaultSection = "DEFAULT"
34
35 // LineBreak is the delimiter to determine or compose a new line.
36 // This variable will be changed to "\r\n" automatically on Windows at package init time.
37 LineBreak = "\n"
38
39 // Variable regexp pattern: %(variable)s
40 varPattern = regexp.MustCompile(`%\(([^)]+)\)s`)
41
42 // DefaultHeader explicitly writes default section header.
43 DefaultHeader = false
44
45 // PrettySection indicates whether to put a line between sections.
46 PrettySection = true
47 // PrettyFormat indicates whether to align "=" sign with spaces to produce pretty output
48 // or reduce all possible spaces for compact format.
49 PrettyFormat = true
50 // PrettyEqual places spaces around "=" sign even when PrettyFormat is false.
51 PrettyEqual = false
52 // DefaultFormatLeft places custom spaces on the left when PrettyFormat and PrettyEqual are both disabled.
53 DefaultFormatLeft = ""
54 // DefaultFormatRight places custom spaces on the right when PrettyFormat and PrettyEqual are both disabled.
55 DefaultFormatRight = ""
56)
57
58var inTest = len(os.Args) > 0 && strings.HasSuffix(strings.TrimSuffix(os.Args[0], ".exe"), ".test")
59
60func init() {
61 if runtime.GOOS == "windows" && !inTest {
62 LineBreak = "\r\n"
63 }
64}
65
66// LoadOptions contains all customized options used for load data source(s).
67type LoadOptions struct {
68 // Loose indicates whether the parser should ignore nonexistent files or return error.
69 Loose bool
70 // Insensitive indicates whether the parser forces all section and key names to lowercase.
71 Insensitive bool
72 // InsensitiveSections indicates whether the parser forces all section to lowercase.
73 InsensitiveSections bool
74 // InsensitiveKeys indicates whether the parser forces all key names to lowercase.
75 InsensitiveKeys bool
76 // IgnoreContinuation indicates whether to ignore continuation lines while parsing.
77 IgnoreContinuation bool
78 // IgnoreInlineComment indicates whether to ignore comments at the end of value and treat it as part of value.
79 IgnoreInlineComment bool
80 // SkipUnrecognizableLines indicates whether to skip unrecognizable lines that do not conform to key/value pairs.
81 SkipUnrecognizableLines bool
82 // ShortCircuit indicates whether to ignore other configuration sources after loaded the first available configuration source.
83 ShortCircuit bool
84 // AllowBooleanKeys indicates whether to allow boolean type keys or treat as value is missing.
85 // This type of keys are mostly used in my.cnf.
86 AllowBooleanKeys bool
87 // AllowShadows indicates whether to keep track of keys with same name under same section.
88 AllowShadows bool
89 // AllowNestedValues indicates whether to allow AWS-like nested values.
90 // Docs: http://docs.aws.amazon.com/cli/latest/topic/config-vars.html#nested-values
91 AllowNestedValues bool
92 // AllowPythonMultilineValues indicates whether to allow Python-like multi-line values.
93 // Docs: https://docs.python.org/3/library/configparser.html#supported-ini-file-structure
94 // Relevant quote: Values can also span multiple lines, as long as they are indented deeper
95 // than the first line of the value.
96 AllowPythonMultilineValues bool
97 // SpaceBeforeInlineComment indicates whether to allow comment symbols (\# and \;) inside value.
98 // Docs: https://docs.python.org/2/library/configparser.html
99 // Quote: Comments may appear on their own in an otherwise empty line, or may be entered in lines holding values or section names.
100 // In the latter case, they need to be preceded by a whitespace character to be recognized as a comment.
101 SpaceBeforeInlineComment bool
102 // UnescapeValueDoubleQuotes indicates whether to unescape double quotes inside value to regular format
103 // when value is surrounded by double quotes, e.g. key="a \"value\"" => key=a "value"
104 UnescapeValueDoubleQuotes bool
105 // UnescapeValueCommentSymbols indicates to unescape comment symbols (\# and \;) inside value to regular format
106 // when value is NOT surrounded by any quotes.
107 // Note: UNSTABLE, behavior might change to only unescape inside double quotes but may noy necessary at all.
108 UnescapeValueCommentSymbols bool
109 // UnparseableSections stores a list of blocks that are allowed with raw content which do not otherwise
110 // conform to key/value pairs. Specify the names of those blocks here.
111 UnparseableSections []string
112 // KeyValueDelimiters is the sequence of delimiters that are used to separate key and value. By default, it is "=:".
113 KeyValueDelimiters string
114 // KeyValueDelimiterOnWrite is the delimiter that are used to separate key and value output. By default, it is "=".
115 KeyValueDelimiterOnWrite string
116 // ChildSectionDelimiter is the delimiter that is used to separate child sections. By default, it is ".".
117 ChildSectionDelimiter string
118 // PreserveSurroundedQuote indicates whether to preserve surrounded quote (single and double quotes).
119 PreserveSurroundedQuote bool
120 // DebugFunc is called to collect debug information (currently only useful to debug parsing Python-style multiline values).
121 DebugFunc DebugFunc
122 // ReaderBufferSize is the buffer size of the reader in bytes.
123 ReaderBufferSize int
124 // AllowNonUniqueSections indicates whether to allow sections with the same name multiple times.
125 AllowNonUniqueSections bool
126 // AllowDuplicateShadowValues indicates whether values for shadowed keys should be deduplicated.
127 AllowDuplicateShadowValues bool
128}
129
130// DebugFunc is the type of function called to log parse events.
131type DebugFunc func(message string)
132
133// LoadSources allows caller to apply customized options for loading from data source(s).
134func LoadSources(opts LoadOptions, source interface{}, others ...interface{}) (_ *File, err error) {
135 sources := make([]dataSource, len(others)+1)
136 sources[0], err = parseDataSource(source)
137 if err != nil {
138 return nil, err
139 }
140 for i := range others {
141 sources[i+1], err = parseDataSource(others[i])
142 if err != nil {
143 return nil, err
144 }
145 }
146 f := newFile(sources, opts)
147 if err = f.Reload(); err != nil {
148 return nil, err
149 }
150 return f, nil
151}
152
153// Load loads and parses from INI data sources.
154// Arguments can be mixed of file name with string type, or raw data in []byte.
155// It will return error if list contains nonexistent files.
156func Load(source interface{}, others ...interface{}) (*File, error) {
157 return LoadSources(LoadOptions{}, source, others...)
158}
159
160// LooseLoad has exactly same functionality as Load function
161// except it ignores nonexistent files instead of returning error.
162func LooseLoad(source interface{}, others ...interface{}) (*File, error) {
163 return LoadSources(LoadOptions{Loose: true}, source, others...)
164}
165
166// InsensitiveLoad has exactly same functionality as Load function
167// except it forces all section and key names to be lowercased.
168func InsensitiveLoad(source interface{}, others ...interface{}) (*File, error) {
169 return LoadSources(LoadOptions{Insensitive: true}, source, others...)
170}
171
172// ShadowLoad has exactly same functionality as Load function
173// except it allows have shadow keys.
174func ShadowLoad(source interface{}, others ...interface{}) (*File, error) {
175 return LoadSources(LoadOptions{AllowShadows: true}, source, others...)
176}