diff options
Diffstat (limited to 'vendor/gopkg.in/ini.v1/ini.go')
-rw-r--r-- | vendor/gopkg.in/ini.v1/ini.go | 176 |
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. | ||
16 | package ini | ||
17 | |||
18 | import ( | ||
19 | "os" | ||
20 | "regexp" | ||
21 | "runtime" | ||
22 | "strings" | ||
23 | ) | ||
24 | |||
25 | const ( | ||
26 | // Maximum allowed depth when recursively substituing variable names. | ||
27 | depthValues = 99 | ||
28 | ) | ||
29 | |||
30 | var ( | ||
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 | |||
58 | var inTest = len(os.Args) > 0 && strings.HasSuffix(strings.TrimSuffix(os.Args[0], ".exe"), ".test") | ||
59 | |||
60 | func 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). | ||
67 | type 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. | ||
131 | type DebugFunc func(message string) | ||
132 | |||
133 | // LoadSources allows caller to apply customized options for loading from data source(s). | ||
134 | func 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. | ||
156 | func 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. | ||
162 | func 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. | ||
168 | func 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. | ||
174 | func ShadowLoad(source interface{}, others ...interface{}) (*File, error) { | ||
175 | return LoadSources(LoadOptions{AllowShadows: true}, source, others...) | ||
176 | } | ||