use os

Operating system interface. Error codes: Ok=1 (success), specific errors start at 2

Constants

Functions

fn chdir

Change the current working directory.

Signature: (path:str -- )!

Example:

"/tmp" os::chdir!

fn chmod

Change file permissions. Mode is specified as Unix permission bits (e.g., 0o644, 0o755).

Signature: (path:str mode:i64 -- )!

Example:

"/tmp/script.sh" 0o755 os::chmod!

fn chown

Change file owner and group. Use -1 for uid or gid to leave unchanged.

Signature: (path:str uid:i64 gid:i64 -- )!

Example:

"/tmp/myfile" 1000 1000 os::chown!

fn copy

Copy a file.

Signature: (srcpath:str dstpath:str -- )!

Example:

"src.txt" "dst.txt" os::copy!

fn cwd

Get current working directory.

Signature: ( -- path:str)!

Example:

os::cwd!  // dir

fn delete

Delete a file or empty directory.

Signature: (path:str -- )!

Example:

"/tmp/test.txt" os::delete!

fn exec

Execute a command and capture all output. Simpler alternative to os::popen when you just need the full output.

Signature: (cmd:str -- stdout:str exitcode:i64)!

Example:

"echo hello" os::exec! -> exitcode  // stdout

fn exists

Check if path exists.

Signature: (path:str -- exists:i64)

Example:

"/tmp" os::exists print  // 1

fn exit

Exit the program with status code.

Signature: (code:i64 -- )

Example:

os::ExitSuccess os::exit

fn getenv

Get environment variable value.

Signature: (name:str -- value:str)

Example:

"HOME" os::getenv  // home

fn getgid

Get the current group ID.

Signature: ( -- gid:i64)

Example:

os::getgid print

fn getpid

Get the current process ID.

Signature: ( -- pid:i64)

Example:

os::getpid print nl

fn getuid

Get the current user ID.

Signature: ( -- uid:i64)

Example:

os::getuid print

fn glob

Match files using glob pattern. Supports *, ?, and ** for recursive matching.

Signature: (pattern:str -- entries:ptr count:i64)!

Example:

"*.qd" os::glob! -> count  // entries

fn hostname

Get the system hostname.

Signature: ( -- hostname:str)!

Example:

os::hostname! print

fn is_dir

Check if path is a directory.

Signature: (path:str -- is_dir:i64)

Example:

"/tmp" os::is_dir print  // 1

fn is_file

Check if path is a regular file.

Signature: (path:str -- is_file:i64)

Example:

"/etc/passwd" os::is_file print  // 1

fn is_symlink

Check if path is a symbolic link. Does not follow the link to check if the target exists.

Signature: (path:str -- is_symlink:i64)

Example:

"/tmp/mylink" os::is_symlink print

fn list

List directory contents.

Signature: (path:str -- entries:ptr count:i64)!

Example:

"/tmp" os::list! -> entries  // count

fn mkdir

Create a directory and all parent directories.

Signature: (path:str -- )!

Example:

"/tmp/a/b/c" os::mkdir!

fn mktemp

Create a unique temporary directory. Creates a directory in /tmp with a unique name. Caller is responsible for removing it when done (use os::rmdir).

Signature: ( -- path:str)!

Example:

os::mktemp!  // tmpdir

fn popen

Execute a command and stream output line-by-line to a callback. The callback is called synchronously for each line of output (without trailing newline). The call blocks until the command completes. Closures with captured variables are supported.

Signature: (cmd:str callback:ptr -- exitcode:i64)!

Example:

"ls -la" fn (line:str -- ) { print nl } os::popen!  // code

fn readlink

Read the target of a symbolic link.

Signature: (path:str -- target:str)!

Example:

"/tmp/mylink" os::readlink!  // target

fn rename

Rename or move a file.

Signature: (oldpath:str newpath:str -- )!

Example:

"old.txt" "new.txt" os::rename!

fn rmdir

Remove directory and all contents recursively.

Signature: (path:str -- )!

Example:

"/tmp/mydir" os::rmdir!

fn setenv

Set environment variable.

Signature: (name:str value:str -- )

Example:

"MY_VAR" "hello" os::setenv

fn symlink

Create a symbolic link.

Signature: (target:str linkpath:str -- )!

Example:

"/usr/bin/python3" "/tmp/python" os::symlink!

fn system

Execute a shell command.

Signature: (cmd:str -- exitcode:i64)

Example:

"ls -la" os::system  // code

fn unsetenv

Unset environment variable.

Signature: (name:str -- )

Example:

"MY_VAR" os::unsetenv

fn walk

Walk a directory tree recursively. Calls callback for each file and directory.

Signature: (path:str callback:ptr -- )!

Example:

"/tmp" fn (p:str is_dir:i64 depth:i64 -- ) { p print nl } os::walk!