process

The process module provides access to the current process and environment.

Import

import process
import { args, env, exit } from process

Command Line Arguments

args

Get all arguments:

@args = @process#args()
@// ["program.draft", "arg1", "arg2"]

arg

Get argument by index:

@first = @process#arg(0)

argc

Get argument count:

@count = @process#argc()

has_arg

Check if argument exists:

@verbose = @process#has_arg("--verbose")

get_arg

Get argument value:

@name = @process#get_arg("--name")

Environment Variables

env

Get environment variable:

@home = @process#env("HOME")
@path = @process#env("PATH")

env_or

Get environment variable with default:

@port = @process#env_or("PORT", "8080")

env_all

Get all environment variables:

@vars = @process#env_all()
for @key, @value in @vars
    write(@key + "=" + @value)
fin for.

set_env

Set environment variable:

@process#set_env("DEBUG", "true")

remove_env

Remove environment variable:

@process#remove_env("TEMP_VAR")

Process Information

pid

Get process ID:

@pid = @process#pid()

parent_pid

Get parent process ID:

@ppid = @process#parent_pid()

cwd

Get current working directory:

@dir = @process#cwd()

set_cwd

Set current working directory:

@process#set_cwd("/tmp")

temp_dir

Get temporary directory:

@tmp = @process#temp_dir()

home_dir

Get user home directory:

@home = @process#home_dir()

hostname

Get system hostname:

@host = @process#hostname()

os

Get operating system:

@os = @process#os()  @// "linux", "macos", "windows"

arch

Get architecture:

@arch = @process#arch()  @// "x86_64", "aarch64"

version

Get Draft version:

@version = @process#version()

uptime

Get process uptime:

@uptime = @process#uptime()

Exit

exit

Exit with status code:

@process#exit(0)   @// Success
@process#exit(1)   @// Error

abort

Abort immediately:

@process#abort()

panic

Panic with message:

@process#panic("Something went wrong")

Spawning Processes

spawn

Spawn a new process:

@child = @process#spawn("ls", ["-la"])
@result = @child#wait()

exec

Execute a process (replaces current):

@process#exec("ls", ["-la"])

Command Builder

@import process#Command

@cmd = @process#Command::new("git")
    #arg("commit")
    #arg("-m")
    #arg("Initial commit")
    #env("GIT_AUTHOR_NAME", "Alice")
    #cwd("/repo")

@result = @cmd#run()
@output = @result#stdout
@status = @result#status

Piped Commands

@import process#Command

@result = @process#Command::new("ls")
    #pipe(@process#Command::new("grep"), ".draft")
    #run()

Background Process

@import process#Command

@process = @process#Command::new("long-running-task")
    #spawn()

@// Do other work...

@process#wait()

Standard Streams

stdin

Access stdin:

@stdin = @process#stdin()
@line = @stdin#read_line()

stdout

Access stdout:

@stdout = @process#stdout()
@stdout#write("Hello")
@stdout#flush()

stderr

Access stderr:

@stderr = @process#stderr()
@stderr#write("Error!")

Redirect Output

@import process#Command

@result = @process#Command::new("ls")
    #stdout_to_file("output.txt")
    #run()

Signals

on_signal

Handle signals:

@process#on_signal("SIGTERM", fn() =>
    @io#write_line("Received SIGTERM")
    @server#shutdown()
    @process#exit(0)
fin action.)

@process#on_signal("SIGINT", fn() =>
    @io#write_line("Interrupted")
    @process#exit(0)
fin action.)

send_signal

Send signal to process:

@process#send_signal(@pid, "SIGTERM")

Working with Files (Quick Access)

read_file

Read file as string:

@content = @process#read_file("file.txt")

write_file

Write string to file:

@process#process#write_file("file.txt", "content")

Pipes

pipe

Create a pipe:

@pipe = @process#pipe()
@pipe#write("data")
@data = @pipe#read()

Resource Usage

memory_usage

Get memory usage:

@bytes = @process#memory_usage()

cpu_time

Get CPU time:

@time = @process#cpu_time()

Platform-Specific

open_url

Open URL in browser:

@process#open_url("https://draft-lang.dev")

open_file

Open file with default program:

@process#open_file("document.pdf")

beep

System beep:

@process#beep()

clear_screen

Clear terminal:

@process#clear_screen()