gitoria

4.4 KB

1. // lib/tickets-helpers.hl — what lib/tickets.hl looks up: where tickets lives, the shapes of its answers, and the
2. // `#12` ticket references in commit subjects and pull request titles (links both ways). Statics only, no fetch here.
3. // Config (environment, or `.env` beside project.hl — never printed): GITORIA_TICKETS_URL, default https://tickets.worldapi.org
4. import { envOr } from './util.hl'
6. static ticketsRaw = envOr('GITORIA_TICKETS_URL', 'https://tickets.worldapi.org')
7. static ticketsUrl = ticketsRaw.endsWith('/') ? ticketsRaw.slice(0, ticketsRaw.length - 1) : ticketsRaw
8. static maxRows = 200
9. static agent = 'gitoria.worldapi.org (tickets)'
11. // a code tickets sent back: letters, digits, `-` and `_`
12. static isCode = (s) => {
13. if (s == null || hlTypeName(s) != 'String' || s.length == 0 || s.length > 200) { return false }
14. let i = 0
15. while (i < s.length) {
16. let c = s.charCodeAt(i)
17. if (!((c >= 48 && c <= 57) || (c >= 97 && c <= 122) || (c >= 65 && c <= 90) || c == 45 || c == 95)) { return false }
18. i = i + 1
19. }
20. return true
21. }
23. static ticketHref = (project, n) => { return ticketsUrl + '/projects/' + project + '/' + n }
25. // one row for the page (a state's words are shown as tickets writes them)
26. static viewOf = (t) => {
27. return { number = t.number subject = t.subject state = t.state stateSlug = t.stateSlug created = t.created updated = t.updated url = ticketsUrl + t.href }
28. }
30. // ---- a write as a person: its headers, the reason of a refusal ----------------------------------------
31. static writeHeaders = (c, identity) => {
32. return { 'user-agent' = agent 'authorization' = 'Bearer ' + c.key 'x-tickets-identity' = identity }
33. }
35. static whyOf = (r) => {
36. j = r.json()
37. return j != null && j.error != null ? ': ' + j.error : ''
38. }
40. // ---- "#12" in a text ---------------------------------------------------------------------------------
41. static isDigitCode = (c) => { return c >= 48 && c <= 57 }
42. static isWordCode = (c) => { return (c >= 48 && c <= 57) || (c >= 65 && c <= 90) || (c >= 97 && c <= 122) || c == 95 }
44. // every `#N` of a text (N = 1–9 digits, not glued to a word before it): [{ at, len, n }]
45. static refsOf = (text) => {
46. out = []
47. if (text == null || hlTypeName(text) != 'String') { return out }
48. let i = 0
49. while (i < text.length) {
50. if (text[i] == '#' && (i == 0 || !isWordCode(text.charCodeAt(i - 1)))) {
51. let j = i + 1
52. while (j < text.length && j - i - 1 < 9 && isDigitCode(text.charCodeAt(j))) { j = j + 1 }
53. let stop = j >= text.length || !isWordCode(text.charCodeAt(j))
54. if (j > i + 1 && stop && text.slice(i + 1, i + 2) != '0') { out.push({ at = i len = j - i n = toNumber(text.slice(i + 1, j)) }) }
55. i = j
56. } else {
57. i = i + 1
58. }
59. }
60. return out
61. }
63. // a text as pieces for a View: [{ text, href, isLink, isText }] — `#N` becomes a link when the repo is connected
64. static refParts = (text, project) => {
65. out = []
66. t = text == null ? '' : '' + text
67. refs = project == null || project == '' ? [] : refsOf(t)
68. let pos = 0
69. for (x of refs) {
70. if (x.at > pos) { out.push({ text = t.slice(pos, x.at) href = '' isLink = false isText = true }) }
71. out.push({ text = t.slice(x.at, x.at + x.len) href = ticketHref(project, x.n) isLink = true isText = false })
72. pos = x.at + x.len
73. }
74. if (pos < t.length || out.length == 0) { out.push({ text = t.slice(pos) href = '' isLink = false isText = true }) }
75. return out
76. }
78. // the numbers a text says it fixes: "fixes #3", "closes #4, #5"? — only the word directly before `#N` counts
79. static fixedBy = (text) => {
80. out = []
81. t = text == null ? '' : ('' + text).toLowerCase()
82. for (x of refsOf(t)) {
83. let before = t.slice(0, x.at).trimEnd()
84. let ok = false
85. for (w of ['fix', 'fixes', 'fixed', 'close', 'closes', 'closed', 'resolve', 'resolves', 'resolved']) {
86. if (before.endsWith(w) && (before.length == w.length || !isWordCode(before.charCodeAt(before.length - w.length - 1)))) { ok = true }
87. }
88. if (ok && !out.includes(x.n)) { out.push(x.n) }
89. }
90. return out
91. }
93. // the commit list of a code page with pieces for the subjects (the View draws links from `parts`)
94. static withRefParts = (data, project) => {
95. if (data == null || data.isMessage) { return data }
96. d = data
97. d.subjectParts = refParts(d.subject, project)
98. cs = []
99. for (c of d.commits) {
100. let q = c
101. q.parts = refParts(c.subject, project)
102. cs.push(q)
103. }
104. d.commits = cs
105. return d
106. }
108. static withPullParts = (list, project) => {
109. out = []
110. for (p of list) {
111. let q = p
112. q.parts = refParts(p.title, project)
113. out.push(q)
114. }
115. return out
116. }