Adds the initial scaffolding for zpy and zz.

Signed-off-by: Amy Ringo <me@remexre.com>

Author: remexre

Makefile

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 ukoOS Contributors
+# SPDX-FileCopyrightText: 2025-2026 ukoOS Contributors
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 
@@ -42,6 +42,7 @@ endef
 # Information about the build to perform.
 include $(srcdir)/doc/include.mak
 include $(srcdir)/src/kernel/include.mak
+include $(srcdir)/src/zz/include.mak
 
 # Load the target.
 ifeq ($(realpath $(srcdir)/src/targets/$(arch)/$(target).mak),)

REUSE.toml

@@ -7,9 +7,9 @@ SPDX-FileCopyrightText = "2025 ukoOS Contributors"
 SPDX-License-Identifier = "GPL-3.0-or-later"
 
 [[annotations]]
-path = ["README.md", "doc/**.md", "doc/**.png", "doc/**.jpg"]
+path = ["README.md", "doc/**.md", "doc/**.png", "doc/**.jpg", "src/**.md"]
 precedence = "aggregate"
-SPDX-FileCopyrightText = "2025 ukoOS Contributors"
+SPDX-FileCopyrightText = "2025-2026 ukoOS Contributors"
 SPDX-License-Identifier = "CC-BY-SA-4.0 OR GFDL-1.3-or-later"
 
 [[annotations]]

doc/SUMMARY.md

@@ -14,6 +14,8 @@
     - [Overview](./kernel/mm/overview.md)
     - [Memory map](./kernel/mm/memory-map.md)
     - [Booting](./kernel/mm/booting.md)
+- [Z]()
+  - [Introduction](./z/introduction.md)
 - [Targets](./targets.md)
 - [Tutorials](./tutorials/tutorials.md)
   - [First Day](./tutorials/first-day.md)

doc/z/introduction.md

@@ -0,0 +1,5 @@
+# Introduction
+
+The Z language is an efficient Lisp dialect.
+
+Z is relatively similar to Common Lisp; a programmer new to Z without existing Common Lisp experience should assume that it's similar to Python.

src/zpy/README.md

@@ -0,0 +1,6 @@
+# zpy
+
+A bootstrap interpreter for the Z language, written in Python.
+See the documentation for more about the language.
+
+This interpreter runs on the host at build-time, and is used to interpret the `zz` compiler and run it on itself, producing the binary we actually ship.

src/zpy/main.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+
+# SPDX-FileCopyrightText: 2026 ukoOS Contributors
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from pathlib import Path
+from sys import argv
+
+
+def main(src_path: Path, *args: str):
+    with src_path.open() as src_file:
+        src = src_file.read()
+
+    pass
+
+
+if __name__ == "__main__":
+    main(Path(argv[0]), *argv[1:])

src/zz/README.md

@@ -0,0 +1,4 @@
+# zz
+
+A compiler for the Z language, written in Z.
+See the documentation for more about the language.

src/zz/include.mak

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2026 ukoOS Contributors
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+all:: src/zz/zz.elf
+install:: src/zz/zz.elf
+	install -DT src/zz/zz.elf $(DESTDIR)$(prefix)/sys/zz.elf
+
+# Bootstrap zz.
+src/zz/zz.elf: $(srcdir)/src/zpy/main.py $(srcdir)/src/zz/main.z
+	@mkdir -p $(dir $@)
+	@echo "ZPY     $@"
+	$(Q)$(PYTHON3) $(srcdir)/src/zpy/main.py \
+		$(srcdir)/src/zz/main.z \
+		$(srcdir)/src/zz/main.z

src/zz/main.z

@@ -0,0 +1,10 @@
+;; SPDX-FileCopyrightText: 2026 ukoOS Contributors
+;;
+;; SPDX-License-Identifier: GPL-3.0-or-later
+
+(defun main ()
+  (+ 40 2))
+
+(1+ (* 2 (+ 19 (main))))
+
+;; vi: set ft=lisp :