Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudwu/datalist
A simple list data sheet
https://github.com/cloudwu/datalist
Last synced: 3 days ago
JSON representation
A simple list data sheet
- Host: GitHub
- URL: https://github.com/cloudwu/datalist
- Owner: cloudwu
- Created: 2019-01-13T09:42:38.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-01T02:56:08.000Z (5 months ago)
- Last Synced: 2025-01-15T11:43:28.020Z (10 days ago)
- Language: C
- Size: 57.6 KB
- Stars: 81
- Watchers: 5
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- my-awesome - cloudwu/datalist - 09 star:0.1k fork:0.0k A simple list data sheet (C)
README
## datalist
A data format used by our game engine. It's just like a simpler version of yaml, or an enhanced version of json.
### A simple dictionary
key should be a string without space, use : to separate value.
```lua
a = datalist.parse [[
x : 1 # comments ...
y : 2
100 : number
]]
-- a = { x = 1, y = 2, ["100"] = "number" }
```
Or you can use datalist.parse_list to parse dictionary into a list with key value pairs.
```lua
a = datalist.parse_list [[
x : 1
y : 2
]]
-- a = { x , 1, y , 2 }
```
### A simple list
Use white space ( space, tab, cr, newline , etc) to separate atoms.
```lua
a = datalist.parse[[
hello "world"
0x1p+0 # hex float 1.0
2
0x3 # hex integer
nil
true
false
on # true
off # false
yes # true
no # false
]]
-- a = { "hello", "world", 1.0, 2, 3, nil, true, false, true, false, true, false }
```
### section list
--- can be used to separate sections of a list.
```lua
a = datalist.parse [[
---
x : hello
y : world
---
1 2 3
]]
-- a = { { x = "hello", y = "world" }, { 1,2,3 } }
```
### Use indent or {} to describe a multilayer structure
```lua
a = datalist.parse [[
x :
1 2 3
y :
dict : "hello world"
z : { foobar }
]]
-- a = { x = { 1,2,3 }, y = { dict = "hello world" }, z = { "foobar" } }
b = datalist.parse [[
---
hello world
---
x : 1
y : 2
]]
-- a = { "hello", "world", { x = 1, y = 2 } }
```
### Use tag to reference a structure
tag is a 64bit hex integer id.
```lua
a = datalist.parse [[
--- &1 # This structure tagged by 1
"hello\nworld"
---
x : *1 # The value is the structure with tag 1
]]
-- a = { { "hello\nworld" } , { x = { "hello\nworld" } } }
```
### Converter
The structure in [] would be convert by a user function.
```lua
a = datalist.parse( "[ 1, 2, 3 ]" , function (t)
local s = 0
for _, v in ipairs(t) do -- t = { 1,2,3 }
s = s + v
end
return s)
-- a = { 6 }
a = datalist.parse([[
[ sum 1 2 3 ]
[ vec 4 5 6 ]
]], function (t)
if t[1] == "sum" then
local s = 0
for i = 2, #t do
s = s + t[i]
end
elseif t[2] == "vec" then
table.remove(t, 1)
end
return t)
-- a = { 6 , { 4,5,6 } }
```