Orkuncakilkaya
b205dd8dfd
All checks were successful
docs / build-and-deploy (push) Successful in 2s
An Os.* namespace, Go-flavored and game-scoped, for the environment *around* the game: the command line, environment variables, standard streams, process exit, the host platform, and the per-user known folders a game writes into. Rounds the bare System.* builtins (arg/getenv/exit) into one coherent surface. - args / arg_count / arg the argument vector (args() -> []string) - env / env_or / has_env read env vars (null-safe via env_or) - set_env / unset_env mutate this process's environment - exit(code) terminate with a status code - platform() / arch() host facts (uname sysname/machine) - stdout_write / stderr_write raw writes to the standard streams - save_dir / config_dir / cache_dir / temp_dir per-user known folders Pure libc over NUL-terminated strings; C-free, no new runtime. arg_count/arg/ exit stay light (no prelude) as thin aliases of the existing intrinsics; the rest share one Os runtime prelude emitted on demand (g_uses_osrt). platform() is portable (uname system name is field 0 on every Unix); arch() and the known-folder layout follow the macOS/BSD conventions — the fully supported native target today. Linux/Windows/wasm folder resolution and a target-aware arch() are documented follow-ups. - examples/library/os.ludic: asserts the invariants that hold regardless of host — env round-trip, env_or fallback, unset, args()==arg_count(), non-empty platform/arch and known dirs. Wired into `x test` (now 54 passed). - docs: a new Os section + 17 per-symbol pages; inventory updated; every fence passes check-docs (--fmt) and the site builds via docgen. - seed regenerated; `x bootstrap-cfree` fixpoint holds. Closes #21 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
37 lines
1.6 KiB
Text
37 lines
1.6 KiB
Text
# os.ludic — Os.* environment interface. args/env/platform are non-deterministic
|
|
# host input, so instead of fixed answers we assert the invariants that must hold
|
|
# regardless of where it runs: an env var round-trips, env_or falls back when a
|
|
# var is unset, unset removes it, args() agrees with arg_count(), and the host
|
|
# facts and known folders are all non-empty. Running it prints: 1 2 3 4 5 6 7 8 9 10 11 12 13
|
|
program Os {
|
|
entry {
|
|
# environment variables round-trip through set/get
|
|
if Os.set_env("LUDIC_OS_TEST", "42") { print(1) }
|
|
if Os.env("LUDIC_OS_TEST") == "42" { print(2) }
|
|
if Os.has_env("LUDIC_OS_TEST") { print(3) }
|
|
|
|
# env_or returns the fallback for a variable that is not set
|
|
if Os.env_or("LUDIC_OS_DEFINITELY_UNSET", "fallback") == "fallback" { print(4) }
|
|
|
|
# unset removes the variable
|
|
if Os.unset_env("LUDIC_OS_TEST") { print(5) }
|
|
if not Os.has_env("LUDIC_OS_TEST") { print(6) }
|
|
|
|
# the argument vector always carries at least the program path, and args()
|
|
# is a []string of exactly arg_count() elements
|
|
if Os.arg_count() >= 1 { print(7) }
|
|
if len(Os.args()) == Os.arg_count() { print(8) }
|
|
|
|
# platform and arch are non-empty host facts
|
|
if len(Os.platform()) > 0 { print(9) }
|
|
if len(Os.arch()) > 0 { print(10) }
|
|
|
|
# per-user known folders resolve to non-empty paths
|
|
if len(Os.save_dir("MyGame")) > 0 { print(11) }
|
|
if len(Os.temp_dir()) > 0 { print(12) }
|
|
|
|
# diagnostics go to stderr, so they never disturb this program's stdout
|
|
Os.stderr_write("os.ludic: hello from stderr\n")
|
|
print(13)
|
|
}
|
|
}
|