gitoria

4.5 KB

1. // lib/git-helpers.hl — what the git readers look up: path and name checks, ids, tab-separated fields, sizes, and the
2. // commit-subject markers of pull requests (`|||PR`) and releases (`|||RL`). Statics only, git itself is not called here.
4. // a path we let through: printable, no leading dash, no backslash / quote / control characters
5. static safePath = (path) => {
6. if (path == null || path == '' || path.length > 300 || path.startsWith('-')) { return false }
7. let i = 0
8. while (i < path.length) {
9. let c = path.charCodeAt(i)
10. if (c < 32 || c == 127 || c == 34 || c == 92 || c == 58) { return false }
11. i = i + 1
12. }
13. return true
14. }
16. static safeName = (n) => { return safePath(n) && n.length <= 100 && !n.endsWith('/') && !n.includes('//') }
18. // a URL path piece: percent-encoded, the slashes kept (encodeURIComponent is a global since hybriel #14)
19. static enc = (s) => { return encodeURIComponent(s).replaceAll('%2F', '/') }
21. static isHexId = (s) => {
22. if (s == null || s.length < 4 || s.length > 40) { return false }
23. let i = 0
24. while (i < s.length) {
25. let c = s.charCodeAt(i)
26. if (!((c >= 48 && c <= 57) || (c >= 97 && c <= 102))) { return false }
27. i = i + 1
28. }
29. return true
30. }
32. // tab-separated fields of a line git wrote. (split() / indexOf() do not find a tab in a line that
33. // came from hl:proc, so scan by character code.)
34. static tabAt = (line) => {
35. let i = 0
36. while (i < line.length) {
37. if (line.charCodeAt(i) == 9) { return i }
38. i = i + 1
39. }
40. return -1
41. }
42. static tabs = (line) => {
43. out = []
44. let start = 0
45. let i = 0
46. while (i < line.length) {
47. if (line.charCodeAt(i) == 9) {
48. out.push(line.slice(start, i))
49. start = i + 1
50. }
51. i = i + 1
52. }
53. out.push(line.slice(start))
54. return out
55. }
57. static sizeText = (n) => {
58. if (n < 1024) { return n + ' B' }
59. unit = n < 1048576 ? 1024 : 1048576
60. t = (n * 10 - (n * 10) % unit) / unit
61. return ((t - t % 10) / 10) + '.' + (t % 10) + (n < 1048576 ? ' KB' : ' MB')
62. }
64. // ---- the markers (pulls.hl, releases.hl) ----------------------------------------------------------
65. // a commit subject → null (not a request) or { target: '' (= default) | name, title }
66. static parsePull = (subject) => {
67. if (subject == null) { return null }
68. if (subject == '|||PR') { return { target = '' title = '' } }
69. if (subject.startsWith('|||PR ')) { return { target = '' title = subject.slice(6).trim() } }
70. if (subject.startsWith('|||PR|')) {
71. close = subject.indexOf(']')
72. if (close < 7) { return null }
73. let target = subject.slice(6, close)
74. rest = subject.slice(close + 1)
75. if (rest != '' && !rest.startsWith(' ')) { return null }
76. if (!safeName(target)) { return null }
77. return { target = target title = rest.trim() }
78. }
79. return null
80. }
82. static isDigits = (s) => {
83. if (s == '' || s.length > 9) { return false }
84. let i = 0
85. while (i < s.length) {
86. let c = s.charCodeAt(i)
87. if (c < 48 || c > 57) { return false }
88. i = i + 1
89. }
90. return true
91. }
93. // the part of a version after its patch digits: only letters, digits, `.` and `-`
94. static suffixOk = (s) => {
95. let i = 0
96. while (i < s.length) {
97. let c = s.charCodeAt(i)
98. if (!((c >= 48 && c <= 57) || (c >= 65 && c <= 90) || (c >= 97 && c <= 122) || c == 45 || c == 46)) { return false }
99. i = i + 1
100. }
101. return true
102. }
104. // `1.2.3` or `1.2.3a` → { major, minor, patch, text } or null
105. static parseVersion = (t) => {
106. if (t == null || t.length > 32) { return null }
107. parts = t.split('.')
108. if (parts.length < 3) { return null }
109. if (!isDigits(parts[0]) || !isDigits(parts[1])) { return null }
110. rest = parts.slice(2).join('.')
111. let n = 0
112. while (n < rest.length && rest.charCodeAt(n) >= 48 && rest.charCodeAt(n) <= 57) { n = n + 1 }
113. if (n == 0 || n > 9 || !suffixOk(rest.slice(n))) { return null }
114. return { major = toNumber(parts[0]) minor = toNumber(parts[1]) patch = toNumber(rest.slice(0, n)) text = t }
115. }
117. // a commit subject → null (not a release) or { kind: 'patch' | 'med' | 'mj' | 'set', version, title }
118. static parseRelease = (subject) => {
119. if (subject == null) { return null }
120. if (subject == '|||RL') { return { kind = 'patch' version = null title = '' } }
121. if (subject.startsWith('|||RL ')) { return { kind = 'patch' version = null title = subject.slice(6).trim() } }
122. if (subject.startsWith('|||RL|')) {
123. body = subject.slice(6)
124. sp = body.indexOf(' ')
125. token = sp < 0 ? body : body.slice(0, sp)
126. let title = sp < 0 ? '' : body.slice(sp + 1).trim()
127. if (token == 'med') { return { kind = 'med' version = null title = title } }
128. if (token == 'mj') { return { kind = 'mj' version = null title = title } }
129. v = parseVersion(token)
130. if (v == null) { return null }
131. return { kind = 'set' version = v title = title }
132. }
133. return null
134. }