API's --x--

TENUM® provides several APIs that you can import anymore with the most important one being the filesystem API. The filesystem API is how you do persistence in TENUM®. Here is a non-exhaustive list of functions you can use via the filesystem API:

filesystem.createDirectory{
    rootPath = rootPath,
    path = "/test"
}
filesystem.createFile{
    rootPath = rootPath,
    path = "/test2/test.txt",
    content = "Hello World"
}
local textFiles = filesystem.list{
    rootPath = rootPath,
    path = "/test",
    recursive = true,
    endsWith = ".txt"
}
filesystem.delete{
    rootPath = rootPath,
    path = "/test/child",
    recursive = true
}
filesystem.createOrUpdateFile{
    rootPath = rootPath,
    path = "/test/text.txt",
    content = "Hello World"
}
local content = filesystem.read{
    rootPath = rootPath,
    path = "/test/text.txt"
}
filesystem.createFile{
    rootPath = rootPath,
    path = "/test/text2.txt",
    content = content
}
filesystem.patch{
    rootPath = rootPath,
    path = "/test/text2.txt",
    original = content,
    modified = content .. " 2000"
}
filesystem.append{
    rootPath = rootPath,
    path = "/test/text2.txt",
    content = " 2000"
}

Another helpful library is the extstring library. Here you have some string utilities you can use.

extstring.endsWith(stringToCheck, suffix)
extstring.startsWith(stringToCheck, preffix)
extstring.removePrefix(stringToProcess, preffix)
extstring.split(stringToSplit, token)
extstring.print(luaTable)
extstring.replace(stringToProcess, tokenToFind, tokenToReplaceWith)
extstring.contains(stringToCheck, tokenToCheck)
extstring.lines(stringToSplitByLineEnding)

TENUM® also provides a time library

time.now()
time.minus(timestampNow, pastTimestamp)
time.plus(timestampNow, pastTimestamp)
time.convertToLocal()
time.parse()
time.parseToLocal()
time.nowLocal()
time.convert()

Last modified: 25 March 2025