summaryrefslogtreecommitdiff
path: root/tex/context/base/luat-ini.lua
blob: 94c878eb11d2d0c012e47ab080a04bfa626d506d (plain)
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
if not modules then modules = { } end modules ['luat-ini'] = {
    version   = 1.001,
    comment   = "companion to luat-lib.mkiv",
    author    = "Hans Hagen, PRAGMA-ADE, Hasselt NL",
    copyright = "PRAGMA ADE / ConTeXt Development Team",
    license   = "see context related readme files"
}

-- rather experimental down here ... will change with lua 5.2 --

local debug = require("debug")

local string, table, lpeg, math, io, system = string, table, lpeg, math, io, system
local next, setfenv = next, setfenv or debug.setfenv

--[[ldx--
<p>We cannot load anything yet. However what we will do us reserve a fewtables.
These can be used for runtime user data or third party modules and will not be
cluttered by macro package code.</p>
--ldx]]--

userdata      = userdata      or { } -- for users (e.g. functions etc)
thirddata     = thirddata     or { } -- only for third party modules
moduledata    = moduledata    or { } -- only for development team
documentdata  = documentdata  or { } -- for users (e.g. raw data)
parametersets = parametersets or { } -- experimental for team

--[[ldx--
<p>Please create a namespace within these tables before using them!</p>

<typing>
userdata ['my.name'] = { }
thirddata['tricks' ] = { }
</typing>
--ldx]]--

--[[ldx--
<p>We could cook up a readonly model for global tables but it
makes more sense to invite users to use one of the predefined
namespaces. One can redefine the protector. After all, it's
just a lightweight suggestive system, not a watertight
one.</p>
--ldx]]--

-- this will change when we move on to lua 5.2+

local global = _G

global.global = global
--~ rawset(global,"global",global)

local dummy = function() end

-- another approach is to freeze tables by using a metatable, this will be
-- implemented stepwise

local protected = {
    -- global table
    global       = global,
    -- user tables
 -- moduledata   = moduledata,
    userdata     = userdata,
    thirddata    = thirddata,
    documentdata = documentdata,
    -- reserved
    protect      = dummy,
    unprotect    = dummy,
    -- luatex
    tex          = tex,
    -- lua
    string       = string,
    table        = table,
    lpeg         = lpeg,
    math         = math,
    io           = io,
    --
    -- maybe other l-*, xml etc
}

-- moduledata  : no need for protection (only for developers)
-- isolatedata : full protection
-- userdata    : protected
-- thirddata   : protected

userdata, thirddata = nil, nil

-- we could have a metatable that automaticaly creates a top level namespace

if not setfenv then
    texio.write_nl("warning: we need to fix setfenv by using 'load in' or '_ENV'")
end

local function protect_full(name)
    local t = { }
    for k, v in next, protected do
        t[k] = v
    end
    return t
end

local function protect_part(name)
--~     local t = global[name]
    local t = rawget(global,name)
    if not t then
        t = { }
        for k, v in next, protected do
            t[k] = v
        end
--~         global[name] = t
        rawset(global,name,t)
    end
    return t
end

function protect(name)
    if name == "isolateddata" then
        setfenv(2,protect_full(name))
    else
        setfenv(2,protect_part(name or "shareddata"))
    end
end

lua.numbers  = { }
lua.messages = { }

function lua.registername(name,message)
    local lnn = lua.numbers[name]
    if not lnn then
        lnn = #lua.messages + 1
        lua.messages[lnn] = message
        lua.numbers[name] = lnn
    end
    lua.name[lnn] = message
    context(lnn)
    -- initialize once
    if name ~= "isolateddata" then
        protect_full(name or "shareddata")
    end
end

--~ function lua.checknames()
--~     lua.name[0] = "ctx"
--~     for k, v in next, lua.messages do
--~         lua.name[k] = v
--~     end
--~ end

storage.register("lua/numbers", lua.numbers, "lua.numbers")
storage.register("lua/messages", lua.messages, "lua.messages")