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
|
--[[
File l3build-aux.lua Copyright (C) 2018-2020 The LaTeX Project
It may be distributed and/or modified under the conditions of the
LaTeX Project Public License (LPPL), either version 1.3c of this
license or (at your option) any later version. The latest version
of this license is in the file
http://www.latex-project.org/lppl.txt
This file is part of the "l3build bundle" (The Work in LPPL)
and all files in that bundle must be distributed together.
-----------------------------------------------------------------------
The development version of the bundle can be found at
https://github.com/latex3/l3build
for those people who are interested.
--]]
-- local safety guards and shortcuts
local match = string.match
local pairs = pairs
local print = print
local lookup = kpse.lookup
local os_time = os.time
--
-- Auxiliary functions which are used by more than one main function
--
---Convert the given `epoch` to a number.
---@param epoch string
---@return number
---@see l3build.lua
---@usage private?
function normalise_epoch(epoch)
assert(epoch, 'normalize_epoch argument must not be nil')
-- If given as an ISO date, turn into an epoch number
local y, m, d = match(epoch, "^(%d%d%d%d)-(%d%d)-(%d%d)$")
if y then
return os_time({
year = y, month = m, day = d,
hour = 0, sec = 0, isdst = nil
}) - os_time({
year = 1970, month = 1, day = 1,
hour = 0, sec = 0, isdst = nil
})
elseif match(epoch, "^%d+$") then
return tonumber(epoch)
else
return 0
end
end
---Returns the CLI command (ending with `os_concat`) to set the epoch
---when forcecheckepoch is true, a void string otherwise.
---Will be run while checking or typesetting
---@param epoch string
---@param force boolean
---@return string
---@see check, typesetting
---@usage private?
function set_epoch_cmd(epoch, force)
return force and (
os_setenv .. " SOURCE_DATE_EPOCH=" .. epoch
.. os_concat ..
os_setenv .. " SOURCE_DATE_EPOCH_TEX_PRIMITIVES=1"
.. os_concat ..
os_setenv .. " FORCE_SOURCE_DATE=1"
.. os_concat
) or ""
end
---Returns the script name depending on the calling sequence.
---`l3build ...` -> full path of `l3build.lua` in the TDS
---When called via `texlua l3build.lua ...`, `l3build.lua` is resolved to either
---`./l3build.lua` or the full path of `l3build.lua` in the TDS.
---`texlua l3build.lua` -> `/Library/TeX/texbin/l3build.lua` or `./l3build.lua`
---@return string
local function get_script_name()
if match(arg[0], "l3build$") or match(arg[0], "l3build%.lua$") then
return lookup("l3build.lua")
else
return arg[0] -- Why no lookup here?
end
end
-- Performs the task named target given modules in a bundle.
---A module is the path of a directory relative to the main one.
---Uses `run` to launch a command.
---@param modules table List of modules.
---@param target string
---@param opts table
---@return number 0 on proper termination, a non 0 error code otherwise.
---@see many places, including latex2e/build.lua
---@usage Public
function call(modules, target, opts)
-- Turn the option table into a CLI option string
opts = opts or options
local cli_opts = ""
for k,v in pairs(opts) do
if k ~= "names" and k ~= "target" then -- Special cases, TODO enhance the design to remove the need for this comment
local t = option_list[k] or {}
local value = ""
if t["type"] == "string" then
value = value .. "=" .. v
elseif t["type"] == "table" then
for _,a in pairs(v) do
if value == "" then
value = "=" .. a -- Add the initial "=" here
else
value = value .. "," .. a
end
end
end
cli_opts = cli_opts .. " --" .. k .. value
end
end
if opts.names then
for _, name in pairs(opts.names) do
cli_opts = cli_opts .. " " .. name
end
end
local script_name = get_script_name()
for _, module in ipairs(modules) do
local text
if module == "." and opts["config"] and #opts["config"]>0 then
text = " with configuration " .. opts["config"][1]
else
text = " for module " .. module
end
print("Running l3build with target \"" .. target .. "\"" .. text )
local error_level = run(
module,
"texlua " .. script_name .. " " .. target .. cli_opts
)
if error_level ~= 0 then
return error_level
end
end
return 0
end
---Unpack the given dependencies.
---A dependency is the path of a directory relative to the main one.
---@param deps table regular array of dependencies.
---@return number 0 on proper termination, a non 0 error code otherwise.
---@see stdmain, check, unpack, typesetting
---@usage Private?
function dep_install(deps)
local error_level
for _, dep in ipairs(deps) do
print("Installing dependency: " .. dep)
error_level = run(dep, "texlua " .. get_script_name() .. " unpack -q")
if error_level ~= 0 then
return error_level
end
end
return 0
end
|
