use os

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

Constants

Functions

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 getpid

Get the current process ID.

Signature: ( -- pid:i64)

Example:

os::getpid print nl

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 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 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 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 system

Execute a shell command.

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

Example:

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

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!