Repository navigation
Expand file tree
/
Copy paththreecode.nimble
More file actions
136 lines (128 loc) · 5.73 KB
/
Copy paththreecode.nimble
File metadata and controls
136 lines (128 loc) · 5.73 KB
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
version = "0.8.4"
author = "Carlo Capocasa"
description = "The economical coding agent. It's so lean you can use it for free!"
license = "MIT"
srcDir = "src"
namedBin["threecode"] = "3code"
requires "nim >= 2.0.0"
requires "streamhttp >= 0.5.0"
requires "ttty >= 0.5.0"
requires "unicodedb >= 0.13.0"
requires "tinotify >= 0.1.3"
requires "sandwall >= 0.5.12"
requires "libsha >= 1.0"
requires "zippy >= 0.10"
requires "ws >= 0.6.0"
import std/strutils
# nim md2html emits no table of contents. addPageToc wraps the page body in
# the nimdoc row/sidebar skeleton and fills a pinned left menu with every
# h2-h6 heading (styled via #page-toc in docs/3code.css).
proc stripTags(s: string): string =
result = ""
var i = 0
while i < s.len:
if s[i] == '<':
let j = s.find('>', i)
if j < 0: break
i = j + 1
else:
result.add s[i]
inc i
proc addPageToc(path: string) =
let html = readFile(path)
var entries: seq[tuple[level: int, id, text: string]] = @[]
var i = 0
while true:
let h = html.find("<h", i)
if h < 0: break
i = h + 2
if html.len - h < 10 or html[h + 2] notin {'2'..'6'} or
html[h + 3] != ' ' or html[h + 4 .. h + 6] != "id=":
continue
let idEnd = html.find('"', h + 8)
let openEnd = html.find('>', h)
let close = html.find("</h", h)
if idEnd < 0 or openEnd < 0 or close < 0: continue
entries.add((ord(html[h + 2]) - ord('0'), html[h + 8 ..< idEnd],
stripTags(html[openEnd + 1 ..< close]).strip))
if entries.len == 0: return
var menu = "<ul class=\"page-toc-list\">\n<li><a href=\"#" & entries[0].id &
"\">" & entries[0].text & "</a>"
var cur = entries[0].level
for e in entries[1 .. ^1]:
if e.level > cur:
for _ in 1 .. e.level - cur: menu.add "<ul>\n<li>"
elif e.level == cur:
menu.add "</li>\n<li>"
else:
menu.add "</li>\n"
for _ in 1 .. cur - e.level: menu.add "</ul>\n</li>\n"
menu.add "<li>"
cur = e.level
menu.add "<a href=\"#" & e.id & "\">" & e.text & "</a>"
menu.add "</li>\n"
if cur > entries[0].level:
for _ in 1 .. cur - entries[0].level: menu.add "</ul>\n</li>\n"
menu.add "</ul>\n"
let nav = "<div class=\"row\">\n<div class=\"three columns\" id=\"page-toc\">\n" &
"<div class=\"page-toc-title\">Contents</div>\n" & menu &
"</div>\n<div class=\"nine columns\" id=\"content\">\n"
let titleEnd = html.find("</h1>")
let footer = html.find("<div class=\"twelve-columns footer\">")
if titleEnd < 0 or footer < 0 or footer < titleEnd: return
writeFile(path, html[0 .. titleEnd + 4] & "\n" & nav &
html[titleEnd + 5 ..< footer] & "</div>\n</div>\n" &
html[footer .. ^1])
task gui, "Build bin/3code-gui: native GUI-subsystem build, headless only":
# --app:gui makes a WinMain (GUI subsystem) binary on Windows: no
# console is ever attached, double-clicking opens no terminal. On
# macOS it links the GUI frameworks (no Terminal spawn either when
# launched from a bundle); on Linux it equals the console build.
# -d:tcNativeGui makes the runtime refuse anything but --headless/
# --gui: without a console, a terminal-UI run would be blind.
exec "sh tests/tools/build_binary.sh bin/3code-gui src/threecode.nim " &
"--app:gui -d:tcNativeGui"
task test, "Run the test suite via testament (all, or named files)":
var files: seq[string] = @[]
for p in commandLineParams:
if p.len > 0 and p[0] notin {'-'}:
files.add p
if files.len == 0:
# Full suite through the CI wrapper: testament output goes to a log
# file, never a reader pipe whose 64KiB buffer backpressures a wedged
# test into silent infinity (the `nimble test` hang), and a watchdog
# names and bounds any stall. PER_TEST_SECS=0 by default: local runs
# share the box with editors and other suites, where the CI 300s
# per-test cap flakily kills slow-but-healthy tty tests; an ambient
# PER_TEST_SECS still wins.
exec "PER_TEST_SECS=${PER_TEST_SECS:-0} sh tests/tools/ci_tests.sh 2400"
else:
# Plain Nim tracks all imported/configured inputs, not just source mtimes.
exec "sh tests/tools/build_binary.sh 3code src/threecode.nim"
var cmd = "sh tests/tools/test_dispatch.sh files"
for file in files:
cmd.add " '" & file.replace("'", "'\"'\"'") & "'"
exec cmd
task docs, "Build HTML manual, reference, and developer docs":
# nim md2html regenerates nimdoc.out.css from nimdoc's built-in default
# (light theme + visible theme switcher). Our curated dark theme lives
# in 3code.css and wins by overwriting the generated file.
# Run from the base project directory: the nested `nim md2html` walks up to
# find config.nims, which reads threecode.nimble relative to cwd. withDir
# would break that path resolution.
exec "nim md2html --docCmd:skip --outdir:docs docs/manual.md"
mvFile("docs/manual.html", "docs/index.html")
exec "nim md2html --docCmd:skip --outdir:docs docs/reference.md"
exec "nim md2html --docCmd:skip --outdir:docs docs/plugins.md"
exec "nim md2html --docCmd:skip --outdir:docs docs/dev.md"
cpFile("docs/3code.css", "docs/nimdoc.out.css")
for page in ["index.html", "reference.html", "plugins.html", "dev.html"]:
addPageToc("docs/" & page)
task devdocs, "Build developer HTML docs from source":
# NOTE: currently fails on this box. `nim doc` implies `-d:nimdoc`, which
# flips std/nativesockets to its winlean flavor on Linux; deps that mix
# std/net with std/posix (streamhttp setsockopt, sandwall sockshim/proxy
# SocketHandle/SockLen) then fail to typecheck in doc mode only.
exec "nim doc --project --outdir:docs/dev src/threecode.nim"
cpFile("docs/dev/3code.css", "docs/dev/nimdoc.out.css")
exec "cat docs/dev/3code-header.js >> docs/dev/dochack.js"