1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
|
-- lib/clod.lua
--
-- Configuration Language Organised (by) Dots
--
-- Copyright 2012 Daniel Silverstone <dsilvers@digital-scurf.org>
--
local type = type
local getinfo = debug.getinfo
local pcall = pcall
local loadstring = loadstring
local tconcat = table.concat
local setmetatable = setmetatable
local setfenv = setfenv
local pairs = pairs
-- metatable for clod config operations
local clod_mt = {}
-- metadata for clod config instances
local metadata = setmetatable({}, {__mode = "k"})
-- metatable for settings objects
local settings_mt = {}
-- Helper routines
local function gen_settings(tab, prefix)
local meta = metadata[tab]
local clodconf = meta.conf or tab
local newmeta = {
conf = clodconf,
prefix = prefix
}
local ret = setmetatable({}, settings_mt)
metadata[ret] = newmeta
return ret
end
function settings_mt:__index(subkey)
local meta = metadata[self]
local confmeta = metadata[meta.conf]
local key = subkey
if meta.prefix then
key = meta.prefix .. "." .. subkey
end
if confmeta.settings[key] then
return confmeta.settings[key].value
end
for k in pairs(confmeta.settings) do
if k:sub(1,#key) == key then
return gen_settings(self, key)
end
end
end
local function insert_after(entry, new_entry)
-- Interject new_entry after entry
if entry.next then
entry.next.prev = new_entry
end
new_entry.next = entry.next
new_entry.prev = entry
entry.next = new_entry
-- Now sort the line numbers out
local lineno = entry.lineno
while entry do
entry.lineno = lineno
lineno = lineno + 1
entry = entry.next
end
end
local function delete_entry(entry)
if entry.prev then
entry.prev.next = entry.next
end
if entry.next then
entry.next.prev = entry.prev
end
-- Shuffle all lines from here on down away
entry = entry.next
while entry do
entry.lineno = entry.lineno - 1
entry = entry.next
end
end
local function has_key(confmeta, key)
return confmeta.settings[key] ~= nil
end
local function calculate_wild_key(confmeta, prefix)
local keyno = 1
local keystr = ("%si_%s"):format(prefix, keyno)
while has_key(confmeta, keystr) do
keyno = keyno + 1
keystr = ("%si_%s"):format(prefix, keyno)
end
return keystr
end
function settings_mt:__newindex(subkey, value)
local meta = metadata[self]
local confmeta = metadata[meta.conf]
local key = subkey
if type(value) == "table" or type(value) == "function" then
error("Clod does not support " .. type(value) .. "s as values")
end
if meta.prefix then
key = meta.prefix .. "." .. subkey
end
local wild_prefix, last_key_element = key:match("^(.-)([^.]+)$")
if last_key_element == "*" then
-- Wild insert, so calculate a unique key to use
key = calculate_wild_key(confmeta, wild_prefix)
end
if value == nil then
-- removing an entry...
if confmeta.settings[key] then
-- Need to remove *this* entry
local entry = confmeta.settings[key]
local prev = entry.prev
local next = entry.next
delete_entry(entry)
if prev and next then
-- Also delete 'next' if prev is also blank
if not prev.key and not next.key then
delete_entry(next)
end
elseif prev and not next then
-- Also delete prev, if it's not the zeroth sentinel
-- and it's blank, since we've removed the last line
if not prev.key and prev.lineno > 0 then
delete_entry(prev)
end
end
end
elseif confmeta.settings[key] then
-- Replacing extant entry
confmeta.settings[key].value = value
else
-- Inventing a new entry, let's try and find a good
-- spot for it.
--
-- Search the list, looking for the longest common prefix.
-- Place the new element at the end of any section of that
-- longest common prefix, or else at the end.
-- If placing at the end, insert a blank line if necessary
-- to separate it from something without a common prefix.
local longest_prefix = 0
local longest_prefix_found_at = nil
local entry = confmeta.entries
while entry do
if entry.key then
local maxpos = 0
for i = (#key < #entry.key and #key or #entry.key), 1, -1 do
if key:sub(1,i) == entry.key:sub(1,i) then
if key:sub(1,i):find("%.") then
maxpos = i
break
end
end
end
if maxpos > longest_prefix then
longest_prefix = maxpos
longest_prefix_found_at = entry
end
end
entry = entry.next
end
local insert_blank = false
if longest_prefix == 0 then
local last = confmeta.entries
while last.next do
last = last.next
end
longest_prefix_found_at = last
if last.key then
insert_blank = true
end
end
local before = longest_prefix_found_at
if insert_blank then
insert_after(before, {})
before = before.next
end
insert_after(before, { key = key, value = value })
confmeta.settings[key] = before.next
end
end
-- Methods for clod instances
local methods = {}
function methods:serialise()
local entries = metadata[self].entries
local retstr = {}
local function serialise_entry(entry)
local key, value, line = entry.key, entry.value, ""
if key then
local wild_prefix = key:match("^(.-)%.i_[0-9]+$")
if wild_prefix then
key = wild_prefix .. '["*"]'
end
local vtype = type(value)
assert((vtype == "string" or vtype == "number" or vtype == "boolean"),
"Unexpected " .. vtype .. " in key: " .. key)
if vtype == "string" then
line = ("%s %q"):format(key, value)
elseif vtype == "number" then
line = ("%s = %d"):format(key, value)
elseif vtype == "boolean" then
line = ("%s = %s"):format(key, value and "true" or "false")
end
end
retstr[#retstr+1] = line
end
while entries do
if entries.lineno ~= 0 then
serialise_entry(entries)
end
entries = entries.next
end
serialise_entry({})
return tconcat(retstr, "\n")
end
function methods:each(prefix)
if prefix then
prefix = "^" .. prefix:gsub("%.", "%%.")
end
local function iterator(confmeta, prev_key)
local next_key, next_value = next(confmeta.settings, prev_key)
if prefix then
while next_key and not next_key:match(prefix) do
next_key, next_value = next(confmeta.settings, next_key)
end
end
if next_key and next_value then
return next_key, next_value.value
end
end
return iterator, metadata[self], nil
end
-- Metamethods for clod instances
function clod_mt:__index(key)
if key == "settings" then
return gen_settings(self)
elseif methods[key] then
return methods[key]
end
end
local function parse_config(conf, confname)
local ret = {}
local settings = {}
local last_entry = {lineno = 0}
local front_entry = last_entry
local keys = {}
local parse_mt = {}
local function gen_hook(key)
local ret = setmetatable({}, parse_mt)
keys[ret] = key
return ret
end
function parse_mt:__index(key)
local prefix = keys[self]
if not prefix then
-- This is a global indexing, so return a fresh entry
return gen_hook(key)
end
-- A 'local' indexing, so combine with the key
return gen_hook(("%s.%s"):format(prefix, key))
end
function parse_mt:__newindex(key, value)
-- This is the equivalent of 'foo = "bar"' instead of 'foo "bar"'
if type(value) == "table" or type(value) == "function" then
error("Clod does not support " .. type(value) .. "s as values")
end
return self[key](value, 1)
end
function parse_mt:__call(value, offset)
if type(value) == "table" or type(value) == "function" then
error("Clod does not support " .. type(value) .. "s as values")
end
local key = assert(keys[self])
local wild_prefix, last_key_element = key:match("^(.-)([^.]+)$")
if last_key_element == "*" then
-- Wild insert, so calculate a unique key to use
key = calculate_wild_key({settings=settings}, wild_prefix)
end
local curline = getinfo(2 + (offset or 0), "Snlf").currentline
local entry = { key = key, value = value, lineno = curline }
while last_entry.lineno < (curline - 1) do
local empty = {
lineno = last_entry.lineno + 1,
prev = last_entry
}
last_entry.next = empty
last_entry = empty
end
last_entry.next = entry
entry.prev = last_entry
last_entry = entry
settings[key] = entry
end
local func, msg = loadstring(conf, ("@%s"):format(confname or "clod-config"))
if not func then
return nil, msg
end
local globs = setmetatable({}, parse_mt)
setfenv(func, globs)
local ok, err = pcall(func)
if not ok then
return nil, err
end
-- Successfully loaded the settings, they're in settings and front_entry
-- points to line zero which we keep, for cleanliness
-- Construct a return object ready for magic
local ret = setmetatable({}, clod_mt)
metadata[ret] = {
settings = settings,
entries = front_entry,
}
return ret
end
return {
parse = parse_config,
}
|