Standard Library
std.fs
Filesystem operations for reading, writing, and managing files and directories.
Exported functions
Read a text file.
Examples
var content = fs.read_file("file.txt")Read a file as raw bytes.
Examples
use fs from "std.fs"
const file = fs.create_temp_file("tea-bytes-")
fs.write_bytes(file, [0, 127, 255])
@println(fs.read_bytes(file)) # [0, 127, 255]
fs.remove(file)Write text to a file.
Examples
fs.write_file("file.txt", "Hello, world!")Write text to a file atomically.
Examples
use fs from "std.fs"
const file = fs.create_temp_file("tea-config-")
fs.write_file_atomic(file, "theme=dark\n")
@println(fs.read_file(file))
fs.remove(file)Write raw bytes to a file.
Write raw bytes to a file atomically.
Examples
use fs from "std.fs"
const file = fs.create_temp_file("tea-bytes-")
fs.write_bytes_atomic(file, [0, 127, 255])
@println(fs.read_bytes(file)) # [0, 127, 255]
fs.remove(file)Create a directory.
Examples
fs.create_dir("my_dir")Create a directory and any missing parent directories.
Create any missing parent directories for a file path.
Examples
use fs from "std.fs"
use path from "std.path"
const directory = fs.create_temp_dir("tea-output-")
const file = path.join([directory, "reports", "summary.txt"])
fs.ensure_parent(file)
fs.write_file(file, "All checks passed")
@println(fs.exists(file)) # true
fs.remove(directory)Alias for ensure_dir().
Remove a file or directory.
Examples
fs.remove("file.txt")Return true when a path exists.
Return true when the path is a symbolic link.
Return the target path stored in a symbolic link.
Create a symbolic link that points at a file target.
Create a symbolic link that points at a directory target.
List all entries in a directory.
Examples
var entries = fs.read_dir(".")Recursively walk a directory and return full entry paths.
Return filesystem entries that match a glob pattern.
Copy a file to a new location.
Rename or move a file or directory.
Get metadata information for a file or directory.
Alias for metadata().
Read a text file and split it into lines.
Examples
use fs from "std.fs"
const file = fs.create_temp_file("tea-lines-")
fs.write_lines(file, ["tea", "coffee"])
for line in fs.read_lines(file)
@println(line)
end
fs.remove(file)Write a list of lines to a file, joining them with "\n".
Append raw bytes to a file, creating it when it does not exist.
Append text to a file, creating it when it does not exist.
Create a unique temporary directory and return its path.
Examples
use fs from "std.fs"
const directory = fs.create_temp_dir("tea-example-")
@println(fs.exists(directory)) # true
fs.remove(directory)Create a unique temporary file and return its path.
Examples
use fs from "std.fs"
const file = fs.create_temp_file("tea-example-")
fs.write_file(file, "Hello, Tea!")
@println(fs.read_file(file)) # Hello, Tea!
fs.remove(file)