• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

sile-typesetter / sile / 11929316253

20 Nov 2024 08:14AM UTC coverage: 36.551% (-19.8%) from 56.367%
11929316253

push

github

alerque
ci(tooling): Don't require developer workflow tooling in CI

6633 of 18147 relevant lines covered (36.55%)

3388.89 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

83.64
/types/length.lua
1
--- SILE length type.
2
-- Lengths are composed of 3 `measurement`s: a length, a stretch, and a shrink. Each part internally is just
3
-- a measurement, but combined describe a flexible length that is allowed to grow up to the amount defined by stretch or
4
-- compress up to the amount defined by shrink.
5
-- @types length
6

7
local function _error_if_not_number (a)
8
   if type(a) ~= "number" then
8✔
9
      SU.error("We tried to do impossible arithmetic on a " .. SU.type(a) .. ". (That's a bug)", true)
×
10
   end
11
end
12

13
--- @type length
14
local length = pl.class()
19✔
15
length.type = "length"
19✔
16

17
length.length = nil
19✔
18
length.stretch = nil
19✔
19
length.shrink = nil
19✔
20

21
--- Constructor.
22
-- @tparam measurement spec A measurement or value that can be cast to a measurement.
23
-- @tparam[opt=0] measurement stretch A measurement describing how much the length is allowed to grow.
24
-- @tparam[opt=0] measurement shrink A measurement describing how much the length is allowed to grow.
25
-- @treturn length
26
-- @usage
27
-- SILE.types.length("6em", "4pt", "2pt")
28
-- SILE.types.length("6em plus 4pt minus 2pt")
29
-- SILE.types.length(30, 4, 2)
30
function length:_init (spec, stretch, shrink)
19✔
31
   if stretch or shrink then
30,234✔
32
      self.length = SILE.types.measurement(spec or 0)
10,764✔
33
      self.stretch = SILE.types.measurement(stretch or 0)
10,764✔
34
      self.shrink = SILE.types.measurement(shrink or 0)
10,764✔
35
   elseif type(spec) == "number" then
24,852✔
36
      self.length = SILE.types.measurement(spec)
18,212✔
37
   elseif SU.type(spec) == "measurement" then
31,492✔
38
      self.length = spec
370✔
39
   elseif SU.type(spec) == "glue" then
30,752✔
40
      self.length = SILE.types.measurement(spec.width.length or 0)
×
41
      self.stretch = SILE.types.measurement(spec.width.stretch or 0)
×
42
      self.shrink = SILE.types.measurement(spec.width.shrink or 0)
×
43
   elseif type(spec) == "table" then
15,376✔
44
      self.length = SILE.types.measurement(spec.length or 0)
8,092✔
45
      self.stretch = SILE.types.measurement(spec.stretch or 0)
8,092✔
46
      self.shrink = SILE.types.measurement(spec.shrink or 0)
8,092✔
47
   elseif type(spec) == "string" then
11,330✔
48
      local amount = tonumber(spec)
225✔
49
      if type(amount) == "number" then
225✔
50
         self:_init(amount)
4✔
51
      else
52
         local parsed = SILE.parserBits.length:match(spec)
223✔
53
         if not parsed then
223✔
54
            SU.error("Could not parse length '" .. spec .. "'")
×
55
         end
56
         self:_init(parsed)
223✔
57
      end
58
   end
59
   if not self.length then
30,234✔
60
      self.length = SILE.types.measurement()
22,210✔
61
   end
62
   if not self.stretch then
30,234✔
63
      self.stretch = SILE.types.measurement()
41,162✔
64
   end
65
   if not self.shrink then
30,234✔
66
      self.shrink = SILE.types.measurement()
41,162✔
67
   end
68
end
69

70
function length:absolute ()
19✔
71
   return SILE.types.length(self.length:tonumber(), self.stretch:tonumber(), self.shrink:tonumber())
11,784✔
72
end
73

74
function length:negate ()
19✔
75
   return self:__unm()
×
76
end
77

78
function length:tostring ()
19✔
79
   return self:__tostring()
×
80
end
81

82
function length:tonumber ()
19✔
83
   return self.length:tonumber()
26,002✔
84
end
85

86
function length:__tostring ()
19✔
87
   local str = tostring(self.length)
2✔
88
   if self.stretch.amount ~= 0 then
2✔
89
      str = str .. " plus " .. tostring(self.stretch)
2✔
90
   end
91
   if self.shrink.amount ~= 0 then
2✔
92
      str = str .. " minus " .. tostring(self.shrink)
×
93
   end
94
   return str
2✔
95
end
96

97
function length:__add (other)
19✔
98
   if type(self) == "number" then
1,790✔
99
      self, other = other, self
1,405✔
100
   end
101
   other = SU.cast("length", other)
3,580✔
102
   return SILE.types.length(self.length + other.length, self.stretch + other.stretch, self.shrink + other.shrink)
7,160✔
103
end
104

105
-- See usage comments on SILE.types.measurement:___add()
106
function length:___add (other)
19✔
107
   if SU.type(other) ~= "length" then
19,758✔
108
      self.length:___add(other)
1,102✔
109
   else
110
      self.length:___add(other.length)
9,328✔
111
      self.stretch:___add(other.stretch)
9,328✔
112
      self.shrink:___add(other.shrink)
9,328✔
113
   end
114
   return nil
9,879✔
115
end
116

117
function length:__sub (other)
19✔
118
   local result = SILE.types.length(self)
1,950✔
119
   other = SU.cast("length", other)
3,900✔
120
   result.length = result.length - other.length
3,900✔
121
   result.stretch = result.stretch - other.stretch
3,900✔
122
   result.shrink = result.shrink - other.shrink
3,900✔
123
   return result
1,950✔
124
end
125

126
-- See usage comments on SILE.types.measurement:___add()
127
function length:___sub (other)
19✔
128
   self.length:___sub(other.length)
712✔
129
   self.stretch:___sub(other.stretch)
712✔
130
   self.shrink:___sub(other.shrink)
712✔
131
   return nil
712✔
132
end
133

134
function length:__mul (other)
19✔
135
   if type(self) == "number" then
8✔
136
      self, other = other, self
×
137
   end
138
   _error_if_not_number(other)
8✔
139
   local result = SILE.types.length(self)
8✔
140
   result.length = result.length * other
16✔
141
   result.stretch = result.stretch * other
16✔
142
   result.shrink = result.shrink * other
16✔
143
   return result
8✔
144
end
145

146
function length:__div (other)
19✔
147
   local result = SILE.types.length(self)
×
148
   _error_if_not_number(other)
×
149
   result.length = result.length / other
×
150
   result.stretch = result.stretch / other
×
151
   result.shrink = result.shrink / other
×
152
   return result
×
153
end
154

155
function length:__unm ()
19✔
156
   local result = SILE.types.length(self)
3✔
157
   result.length = result.length:__unm()
6✔
158
   return result
3✔
159
end
160

161
function length:__lt (other)
19✔
162
   local a = SU.cast("number", self)
7,764✔
163
   local b = SU.cast("number", other)
7,764✔
164
   return a - b < 0
7,764✔
165
end
166

167
function length:__le (other)
19✔
168
   local a = SU.cast("number", self)
3✔
169
   local b = SU.cast("number", other)
3✔
170
   return a - b <= 0
3✔
171
end
172

173
function length:__eq (other)
19✔
174
   local a = SU.cast("length", self)
×
175
   local b = SU.cast("length", other)
×
176
   return a.length == b.length and a.stretch == b.stretch and a.shrink == b.shrink
×
177
end
178

179
return length
19✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc