Filesystem tools

opentine.tools.fs provides read, write, edit, and ls. With no explicit policy, paths are rooted at the current working directory and writes are allowed within that root.

1from opentine.tools.fs import edit, ls, read, write
2
3content = read("src/main.py")
4listing = ls("src")
5write("output/report.md", "# Report\n")
6edit("output/report.md", "Report", "Verified report")

Operations

• read returns UTF-8 text and enforces the file-size cap.
• write creates parent directories and replaces content.
• edit replaces the first match.
• ls returns sorted entries prefixed with d or f .

Explicit policy

v0.9.1 refuses writes inside a .git directory or file and through hard-linked files, even within an otherwise writable root.

Use FilesystemPolicy to separate readable roots from writable roots, deny symlinks, and cap file size.

1from opentine.policies import FilesystemPolicy
2from opentine.tools.fs import read, write
3
4policy = FilesystemPolicy(
5    roots=("/workspace/project",),
6    write_roots=("/workspace/project/output",),
7    deny_symlinks=True,
8    max_file_bytes=250_000,
9)
10
11source = read("src/main.py", policy=policy)
12write("report.md", source, policy=policy)

Passing sandbox=None does not disable rooting; it uses the current working directory. There is no unscoped filesystem mode in these helpers, and special files are rejected rather than read as ordinary content.