dotfiles/home/private_dot_config/nim/config.nims
2023-02-28 12:37:48 -06:00

475 lines
19 KiB
Nim

from macros import error
from strutils import `%`, endsWith, strip, replace
from sequtils import filterIt, concat
const
nimVersion = (major: NimMajor, minor: NimMinor, patch: NimPatch)
when nimVersion <= (0, 19, 9):
from ospaths import `/`, splitPath, splitFile
when not defined(projectDir):
let projectDir = getCurrentDir
echo "\nprojectDir() is not defined, fallback to getCurrentDir(), you must run it from the project directory (needs Nim devel).\n"
else:
when nimVersion < (1, 2, 0):
from os import `/`, splitPath, splitFile
import oswalkdir # This was deprecated in Nim 1.2.0; just use "import os" instead
else:
when nimVersion < (1, 3, 0):
from os import `/`, splitPath, splitFile, walkDirRec, pcFile, pcDir
else:
# nim devel
import std/[os]
when nimVersion >= (1, 7, 3):
import std/[assertions] # for doAssert
# Switches
hint("Processing", false) # Do not print the "Hint: .. [Processing]" messages when compiling
# Use Dragonbox by default - https://github.com/nim-lang/Nim/commit/25efb5386293540b0542833625d3fb6e22f3cfbc
switch("define", "nimFpRoundtrips")
when nimVersion >= (0, 20, 0):
when defined(strictMode):
switch("styleCheck", "error")
else:
switch("styleCheck", "hint")
## Constants
const
doOptimize = true
stripSwitches = @["--strip-all", "--remove-section=.comment", "--remove-section=.note.gnu.gold-version", "--remove-section=.note", "--remove-section=.note.gnu.build-id", "--remove-section=.note.ABI-tag"]
# upxSwitches = @["--best"] # fast
upxSwitches = @["--ultra-brute"] # slower
checksumsSwitches = @["--tag"]
gpgSignSwitches = @["--clear-sign", "--armor", "--detach-sign", "--digest-algo sha512"]
gpgEncryptSwitches = @["--armor", "--symmetric", "--s2k-digest-algo sha512", "--cipher-algo AES256", "-z 9"] # 9=Max, 0=Disabled
proc getGitRootMaybe(): string =
## Try to get the path to the current git root directory.
## Return ``projectDir()`` if a ``.git`` directory is not found.
const
maxAttempts = 10 # arbitrarily picked
var
path = projectDir() # projectDir() needs nim 0.20.0 (or nim devel as of Tue Oct 16 08:41:09 EDT 2018)
attempt = 0
while (attempt < maxAttempts) and (not dirExists(path / ".git")):
path = path / "../"
attempt += 1
if dirExists(path / ".git"):
result = path
else:
result = projectDir()
## Lets
let
root = getGitRootMaybe()
(_, pkgName) = root.splitPath()
srcFile = root / "src" / (pkgName & ".nim")
# pcre
pcreVersion = getEnv("PCREVER", "8.42")
pcreSourceDir = "pcre-" & pcreVersion
pcreArchiveFile = pcreSourceDir & ".tar.bz2"
pcreDownloadLink = "https://downloads.sourceforge.net/pcre/" & pcreArchiveFile
pcreInstallDir = (root / "pcre/") & pcreVersion
# http://www.linuxfromscratch.org/blfs/view/8.1/general/pcre.html
pcreConfigureCmd = ["./configure", "--prefix=" & pcreInstallDir, "--enable-pcre16", "--enable-pcre32", "--disable-shared"]
pcreLibDir = pcreInstallDir / "lib"
pcreLibFile = pcreLibDir / "libpcre.a"
# libressl
libreSslVersion = getEnv("LIBRESSLVER", "2.8.1")
libreSslSourceDir = "libressl-" & libreSslVersion
libreSslArchiveFile = libreSslSourceDir & ".tar.gz"
libreSslDownloadLink = "https://ftp.openbsd.org/pub/OpenBSD/LibreSSL/" & libreSslArchiveFile
libreSslInstallDir = (root / "libressl/") & libreSslVersion
libreSslConfigureCmd = ["./configure", "--disable-shared", "--prefix=" & libreSslInstallDir]
libreSslLibDir = libreSslInstallDir / "lib"
libreSslLibFile = libreSslLibDir / "libssl.a"
libreCryptoLibFile = libreSslLibDir / "libcrypto.a"
libreSslIncludeDir = libreSslInstallDir / "include/openssl"
# openssl
openSslSeedConfigOsCompiler = "linux-x86_64"
openSslVersion = getEnv("OPENSSLVER", "1.1.1")
openSslSourceDir = "openssl-" & openSslVersion
openSslArchiveFile = openSslSourceDir & ".tar.gz"
openSslDownloadLink = "https://www.openssl.org/source/" & openSslArchiveFile
openSslInstallDir = (root / "openssl/") & openSslVersion
# "no-async" is needed for openssl to compile using musl
# - https://gitter.im/nim-lang/Nim?at=5bbf75c3ae7be940163cc198
# - https://www.openwall.com/lists/musl/2016/02/04/5
# -DOPENSSL_NO_SECURE_MEMORY is needed to make openssl compile using musl.
# - https://github.com/openssl/openssl/issues/7207#issuecomment-420814524
openSslConfigureCmd = ["./Configure", openSslSeedConfigOsCompiler, "no-shared", "no-zlib", "no-async", "-fPIC", "-DOPENSSL_NO_SECURE_MEMORY", "--prefix=" & openSslInstallDir]
openSslLibDir = openSslInstallDir / "lib"
openSslLibFile = openSslLibDir / "libssl.a"
openCryptoLibFile = openSslLibDir / "libcrypto.a"
openSslIncludeDir = openSslInstallDir / "include/openssl"
# Custom Header file to force to link to GLibC 2.5, for old Linux (x86_64).
glibc25DownloadLink = "https://raw.githubusercontent.com/wheybags/glibc_version_header/master/version_headers/x64/force_link_glibc_2.5.h"
## Helper Procs
# https://github.com/kaushalmodi/elnim
proc dollar[T](s: T): string =
result = $s
proc mapconcat[T](s: openArray[T]; sep = " "; op: proc(x: T): string = dollar): string =
## Concatenate elements of ``s`` after applying ``op`` to each element.
## Separate each element using ``sep``.
for i, x in s:
result.add(op(x))
if i < s.len-1:
result.add(sep)
proc parseArgs(): tuple[switches: seq[string], nonSwitches: seq[string]] =
## Parse the args and return its components as
## ``(switches, nonSwitches)``.
let
numParams = paramCount() # count starts at 0
# So "nim musl foo.nim" will have a count of 2.
# param 0 will always be "nim"
doAssert numParams >= 1
# param 1 will always be the task name like "musl".
let
subCmd = paramStr(1)
if numParams < 2:
error("The '$1' sub-command needs at least one non-switch argument" % [subCmd])
for i in 2 .. numParams:
if paramStr(i)[0] == '-': # -d:foo or --define:foo
result.switches.add(paramStr(i))
else:
result.nonSwitches.add(paramStr(i))
proc runUtil(f, util: string; args: seq[string]) =
## Run ``util`` executable with ``args`` on ``f`` file.
doAssert findExe(util) != "",
"'$1' executable was not found" % [util]
let
cmd = concat(@[util], args, @[f]).mapconcat()
echo "Running '$1' .." % [cmd]
exec cmd
template preBuild(targetPlusSwitches: string) =
assert targetPlusSwitches.len > 0, "Build arguments must not be empty"
when defined(libressl) and defined(openssl):
error("Define only 'libressl' or 'openssl', not both.")
let (switches, nimFiles) = parseArgs()
assert nimFiles.len > 0, """
This nim sub-command accepts at least one Nim file name
Examples: nim <SUB COMMAND> FILE.nim
nim <SUB COMMAND> FILE1.nim FILE2.nim
nim <SUB COMMAND> -d:pcre FILE.nim
"""
var allBuildCmds {.inject.} = newSeqOfCap[tuple[nimArgs, binFile: string]](nimFiles.len)
for f in nimFiles:
let
extraSwitches = switches.mapconcat()
(dirName, baseName, tmpVar) = splitFile(f)
binFile = dirName / baseName # Save the binary in the same dir as the nim file
nimArgsArray = when doOptimize:
[targetPlusSwitches, "-d:musl", "-d:release", "--opt:size", "--passL:-s", "--listFullPaths:off", "--excessiveStackTrace:off", extraSwitches, " --out:" & binFile, f]
else:
[targetPlusSwitches, "-d:musl", extraSwitches, " --out:" & binFile, f]
nimArgs = nimArgsArray.mapconcat()
discard tmpVar # Avoid the "declared but not used" warning. Workaround for https://github.com/nim-lang/Nim/issues/12094
allBuildCmds.add((nimArgs: nimArgs, binFile: binFile))
## Tasks
task installPcre, "Install PCRE using musl-gcc":
if not fileExists(pcreLibFile):
if not dirExists(pcreSourceDir):
if not fileExists(pcreArchiveFile):
exec("curl -LO " & pcreDownloadLink)
exec("tar xf " & pcreArchiveFile)
else:
echo "PCRE lib source dir " & pcreSourceDir & " already exists"
withDir pcreSourceDir:
putEnv("CC", "musl-gcc -static")
exec(pcreConfigureCmd.mapconcat())
exec("make -j8")
exec("make install")
else:
echo pcreLibFile & " already exists"
setCommand("nop")
task installLibreSsl, "Install LIBRESSL using musl-gcc":
if (not fileExists(libreSslLibFile)) or (not fileExists(libreCryptoLibFile)):
if not dirExists(libreSslSourceDir):
if not fileExists(libreSslArchiveFile):
exec("curl -LO " & libreSslDownloadLink)
exec("tar xf " & libreSslArchiveFile)
else:
echo "LibreSSL lib source dir " & libreSslSourceDir & " already exists"
withDir libreSslSourceDir:
# -idirafter /usr/include/ # Needed for linux/sysctl.h
# -idirafter /usr/include/x86_64-linux-gnu/ # Needed for Travis/Ubuntu build to pass, for asm/types.h
putEnv("CC", "musl-gcc -static -idirafter /usr/include/ -idirafter /usr/include/x86_64-linux-gnu/")
putEnv("C_INCLUDE_PATH", libreSslIncludeDir)
exec(libreSslConfigureCmd.mapconcat())
exec("make -j8 -C crypto") # build just the "crypto" component
exec("make -j8 -C ssl") # build just the "ssl" component
exec("make -C crypto install")
exec("make -C ssl install")
else:
echo libreSslLibFile & " already exists"
setCommand("nop")
task installOpenSsl, "Install OPENSSL using musl-gcc":
if (not fileExists(openSslLibFile)) or (not fileExists(openCryptoLibFile)):
if not dirExists(openSslSourceDir):
if not fileExists(openSslArchiveFile):
exec("curl -LO " & openSslDownloadLink)
exec("tar xf " & openSslArchiveFile)
else:
echo "OpenSSL lib source dir " & openSslSourceDir & " already exists"
withDir openSslSourceDir:
# https://gcc.gnu.org/onlinedocs/gcc/Directory-Options.html
# -idirafter /usr/include/ # Needed for Travis/Ubuntu build to pass, for linux/version.h, etc.
# -idirafter /usr/include/x86_64-linux-gnu/ # Needed for Travis/Ubuntu build to pass, for asm/types.h
putEnv("CC", "musl-gcc -static -idirafter /usr/include/ -idirafter /usr/include/x86_64-linux-gnu/")
putEnv("C_INCLUDE_PATH", openSslIncludeDir)
exec(openSslConfigureCmd.mapconcat())
echo "The insecure switch -DOPENSSL_NO_SECURE_MEMORY is needed so that OpenSSL can be compiled using MUSL."
exec("make -j8 depend")
exec("make -j8")
exec("make install_sw")
else:
echo openSslLibFile & " already exists"
setCommand("nop")
task strip, "Optimize the binary size using 'strip' utility":
## Usage: nim strip <FILE1> <FILE2> ..
let
(_, binFiles) = parseArgs()
for f in binFiles:
f.runUtil("strip", stripSwitches)
setCommand("nop")
task upx, "Optimize the binary size using 'upx' utility":
## Usage: nim upx <FILE1> <FILE2> ..
let
(_, binFiles) = parseArgs()
for f in binFiles:
f.runUtil("upx", upxSwitches)
setCommand("nop")
task checksums, "Generate checksums of the binary using 'sha1sum' and 'md5sum'":
## Usage: nim checksums <FILE1> <FILE2> ..
let (_, binFiles) = parseArgs()
for f in binFiles:
f.runUtil("md5sum", checksumsSwitches)
f.runUtil("sha1sum", checksumsSwitches)
setCommand("nop")
task sign, "Sign the binary using 'gpg' (armored, ascii)":
## Usage: nim sign <FILE1> <FILE2> ..
let (_, binFiles) = parseArgs()
for f in binFiles:
f.runUtil("gpg", gpgSignSwitches)
setCommand("nop")
task encrypt, "Encrypt the binary using 'gpg' (compressed, symmetric, ascii)":
## Usage: nim encrypt <FILE1> <FILE2> ..
# Decrypt is just double click or 'gpg --decrypt' (Asks Password).
let (_, binFiles) = parseArgs()
for f in binFiles:
f.runUtil("gpg", gpgEncryptSwitches)
setCommand("nop")
task musl, "Build an optimized static binary using musl":
## Usage: nim musl [-d:pcre] [-d:libressl|-d:openssl] <FILE1> <FILE2> ..
preBuild("c")
for cmd in allBuildCmds:
# Build binary
echo "\nRunning 'nim " & cmd.nimArgs & "' .."
selfExec cmd.nimArgs
when doOptimize:
cmd.binFile.runUtil("strip", stripSwitches)
cmd.binFile.runUtil("upx", upxSwitches)
echo "Built: " & cmd.binFile
task glibc25, "Build C, dynamically linked to GLibC 2.5 (x86_64)":
## Usage: nim glibc25 file.nim
# See https://github.com/wheybags/glibc_version_header/pull/21.
let
header = getCurrentDir() / "force_link_glibc_2.5.h"
optns = ["-ffast-math", "-flto", "-include" & header] # Don't use -march here
if not fileExists(header):
exec("curl -LO " & glibc25DownloadLink)
var passCSwitches: string
for o in optns:
passCSwitches.add(" --passC:" & o)
preBuild("c -d:ssl" & passCSwitches)
for cmd in allBuildCmds:
echo "\nRunning 'nim " & cmd.nimArgs
# preBuild auto-adds "-d:musl", so remove that.
# FIXME: Make preBuild not always add that switch. -- Thu Jun 13 12:13:17 EDT 2019 - kmodi
selfExec cmd.nimArgs.replace("-d:musl", "")
when doOptimize:
cmd.binFile.runUtil("strip", stripSwitches)
# Version check -- Changes from GLIBC_2.15 to GLIBC_2.5
cmd.binFile.runUtil("ldd", @["-v"])
task js2asm, "Build JS, print Assembly from that JS (performance debug)":
## Usage: nim js2asm <FILE1> <FILE2> ..
# This debugs performance of JavaScript, the less ASM the better JS.
# This ASM is NOT usable as proper ASM, just for Debug performance.
preBuild("js")
for cmd in allBuildCmds:
echo "\nRunning 'nim " & cmd.nimArgs
selfExec cmd.nimArgs
cmd.binFile.runUtil("node", @["--print_code"])
task c2asm, "Build C, print Assembly from that C (performance debug)":
## Usage: nim c2asm <FILE1> <FILE2> ..
# This debugs performance of Nim, the less ASM the better your Nim.
const
optns = [ # This cleans up the produced ASM as much as possible.
"-ffast-math", "-march=native", "-fno-math-errno", "-fno-exceptions",
"-fno-asynchronous-unwind-tables", "-fno-inline-functions", "-std=c11",
"-fno-inline-functions-called-once", "-fno-inline-small-functions",
"-xc", "-s", "-S", "-O3", "-masm=intel", "-o-"]
var passCSwitches: string
for o in optns:
passCSwitches.add(" --passC:" & o)
preBuild("compileToC --compileOnly:on -d:danger -d:noSignalHandler" & passCSwitches)
for cmd in allBuildCmds:
echo "\nRunning 'nim " & cmd.nimArgs
selfExec cmd.nimArgs
let cSource = nimcacheDir() / cmd.binFile & ".nim.c"
cSource.runUtil("gcc", @optns)
task fmt, "Run nimpretty on all git-managed .nim files in the current repo":
## Usage: nim fmt
for file in walkDirRec(root, {pcFile, pcDir}):
if file.splitFile().ext == ".nim":
let
# https://github.com/nim-lang/Nim/issues/6262#issuecomment-454983572
# https://stackoverflow.com/a/2406813/1219634
fileIsGitManaged = gorgeEx("cd $1 && git ls-files --error-unmatch $2" % [getCurrentDir(), file]).exitCode == 0
# ^^^^^-- That "cd" is required.
if fileIsGitManaged:
let
cmd = "nimpretty $1" % [file]
echo "Running $1 .." % [cmd]
exec(cmd)
setCommand("nop")
task rmfiles, "Recursively remove all files with the specific extension(s) from the current directory":
## Usage: nim rmfiles pyc c o
for extToDelete in parseArgs().nonSwitches: # Invalid Patterns: "", " ", "\t"
assert extToDelete.strip.len > 0, "Specified extension must not be whitespace or empty string"
assert extToDelete[0] != '.', "Do not prefix the extensions with dot"
for file in walkDirRec(getCurrentDir(), {pcFile, pcDir}):
if file.splitFile().ext == "." & extToDelete:
# echo "file to delete: ", file
rmFile(file)
setCommand("nop")
task test, "Run tests via 'nim doc' (runnableExamples) and tests in tests/ dir":
let
testDir = root / "tests"
selfExec("doc " & srcFile)
if dirExists(testDir):
let
testFiles = listFiles(testDir).filterIt(it.len >= 5 and it.endsWith(".nim"))
for t in testFiles:
selfExec "c -r " & t
when nimVersion >= (1, 3, 5):
task docs, "Deploy doc html + search index to public/ directory":
let
deployDir = root / "public"
selfExec("doc --project --outdir:$1 $2" % [deployDir, srcFile]) # generates search index and theindex.html too.
withDir deployDir:
# Move PKGNAME.html to index.html so that we can access the
# documentation on a clean URL like https://foo.bar/ instead of
# https://foo.bar/PKGNAME.html.
mvFile(pkgName & ".html", "index.html")
# As we renamed the file, we need to rename that in hyperlinks
# and the search index too.
for file in walkDirRec(".", {pcFile}):
exec(r"sed -i -r 's|$1\.html|index.html|g' $2" % [pkgName, file])
else:
task docs, "Deploy doc html + search index to public/ directory":
let
deployDir = root / "public"
docOutBaseName = "index"
deployHtmlFile = deployDir / (docOutBaseName & ".html")
genDocCmd = "nim doc --out:$1 --index:on $2" % [deployHtmlFile, srcFile]
genTheIndexCmd = "nim buildIndex -o:$1/theindex.html $1" % [deployDir]
deployJsFile = deployDir / "dochack.js"
docHackJsSource = "https://nim-lang.github.io/Nim/dochack.js" # devel docs dochack.js
mkDir(deployDir)
exec(genDocCmd)
exec(genTheIndexCmd)
if not fileExists(deployJsFile):
withDir deployDir:
exec("curl -LO " & docHackJsSource)
# https://www.reddit.com/r/nim/comments/byzq7d/go_run_for_nim/
task runc, "Run equivalent of 'nim c -r ..'":
switch("run")
switch("verbosity", "0")
hint("Processing", false)
setCommand("c")
task runcpp, "Run equivalent of 'nim cpp -r ..'":
switch("run")
switch("verbosity", "0")
hint("Processing", false)
setCommand("cpp")
## Define Switch Parsing
# -d:musl
when defined(musl):
var
muslGccPath: string
echo " [-d:musl] Building a static binary using musl .."
muslGccPath = findExe("musl-gcc")
if muslGccPath == "":
error("'musl-gcc' binary was not found in PATH.")
switch("passL", "-static")
switch("gcc.exe", muslGccPath)
switch("gcc.linkerexe", muslGccPath)
# -d:pcre
when defined(pcre):
let
pcreIncludeDir = pcreInstallDir / "include"
if not fileExists(pcreLibFile):
selfExec "installPcre" # Install PCRE in current dir if pcreLibFile is not found
switch("passC", "-I" & pcreIncludeDir) # So that pcre.h is found when running the musl task
switch("define", "usePcreHeader")
switch("passL", pcreLibFile)
# -d:libressl or -d:openssl
when defined(libressl) or defined(openssl):
switch("define", "ssl") # Pass -d:ssl to nim
when defined(libressl):
let
sslLibFile = libreSslLibFile
cryptoLibFile = libreCryptoLibFile
sslIncludeDir = libreSslIncludeDir
sslLibDir = libreSslLibDir
when defined(openssl):
let
sslLibFile = openSslLibFile
cryptoLibFile = openCryptoLibFile
sslIncludeDir = openSslIncludeDir
sslLibDir = openSslLibDir
if (not fileExists(sslLibFile)) or (not fileExists(cryptoLibFile)):
# Install SSL in current dir if sslLibFile or cryptoLibFile is not found
when defined(libressl):
selfExec "installLibreSsl"
when defined(openssl):
selfExec "installOpenSsl"
switch("passC", "-I" & sslIncludeDir) # So that ssl.h is found when running the musl task
switch("passL", "-L" & sslLibDir)
switch("passL", "-lssl")
switch("passL", "-lcrypto") # This *has* to come *after* -lssl
switch("dynlibOverride", "libssl")
switch("dynlibOverride", "libcrypto")