Files
marqdo-cli/stdlib/fs/file.mq.md
T
cflmy e029853e32 feat(lang): implement RFC-LANG-0002 unified semantics (breaking)
One Markdown-to-program mapping, no version selector or legacy mapper.

Frontend/runtime:
- resolve @exec/@knowledge heading declarations with nearest-ancestor
  inheritance; only an Exec H2 is callable; add UnitKind::Knowledge and
  sem.* diagnostics (mode marker, unit name, exec-without-function,
  payload nesting/empty, syntax, control stack, params position,
  version directive, inferred-signature lint)
- extract Strong/Emph/inline Code as one-statement carriers, refuse
  nested carriers, and honour heading segment boundaries so an if/while
  cannot be closed across a heading
- lower if/else/while/end to the existing Branch/Loop/Return IR with a
  compile-time control stack; keep payload-relative source spans through
  expression parsing and rewrite them onto the file
- accept params(...) only as the first direct Exec H2 payload; keep the
  existing free-variable inference and named-only rule for inferred
  signatures; fix duplicate-mode/else/end and Knowledge-body inertness
- reject marqdo_semantics/syntax front matter directives

Data and tests:
- migrate stdlib/**/*.mq.md, regenerate stdlib.json digest
- migrate examples and the full semantics/negative/runtime corpus to
  the only current syntax; expected values/runtime codes preserved
- migrate Rust-embedded .mq.md fixtures, init template, CLI help and
  security-lane fixtures

Verified: cargo fmt --check, cargo clippy -D warnings and
cargo test --workspace --locked (green).
2026-11-21 12:26:46 +08:00

3.8 KiB

import
import
utf8
../text/utf8.mq.md

@exec file

读文本

params(路径)

以 UTF-8 读取一个有界的项目文件。文件在打开时整文件载入,上限 8 MiB; 结果使用可恢复 Result 形状。

流 = resource.open("file", 路径, ["read"])

内存 = memory.new(128, 128)

读取 = resource.read(流, 内存, 0, 8388608)

关闭 = resource.close(流)

if not 读取.ok

return 读取

else if not 关闭.ok

return 关闭

else if true

文本 = utf8.解码(内存, 0, 读取.value.count)

if not 文本.ok

return 文本

else if true

return {ok: true, value: 文本.value}

end end end end end

写文本

params(路径, 文本)

把文本按 UTF-8 写入项目文件。路径必须已经通过 fs_write 授权; 文件只在 resource.close 成功时创建或覆盖,写入缓冲上限 8 MiB。

内存 = memory.new(128, 128)

长度 = utf8.编码(文本, 内存, 0)

流 = resource.open("file", 路径, ["write"])

写入 = resource.write(流, 内存, 0, 长度)

关闭 = resource.close(流)

if not 写入.ok

return 写入

else if not 关闭.ok

return 关闭

else if true

return {ok: true, value: {count: 写入.value.count}}

end end end

复制文件

params(源, 目标)

按字节复制一个有界的项目文件。源读取和目标写入分别需要 fs_read/fs_write 授权,结果值与 写文本 相同。

输入 = resource.open("file", 源, ["read"])

内存 = memory.new(128, 128)

读取 = resource.read(输入, 内存, 0, 8388608)

关闭输入 = resource.close(输入)

if not 读取.ok

return 读取

else if not 关闭输入.ok

return 关闭输入

else if true

输出 = resource.open("file", 目标, ["write"])

写入 = resource.write(输出, 内存, 0, 读取.value.count)

关闭输出 = resource.close(输出)

if not 写入.ok

return 写入

else if not 关闭输出.ok

return 关闭输出

else if true

return {ok: true, value: {count: 写入.value.count}}

end end end end end end

存在

params(路径)

return resource.request("fs.exists", [路径])

元数据

params(路径)

return resource.request("fs.metadata", [路径])

是文件

params(路径)

元数据 = resource.request("fs.metadata", [路径])

if not 元数据.ok

return 元数据

else if true

return {ok: true, value: 元数据.value.kind == "file"}

end end

是目录

params(路径)

元数据 = resource.request("fs.metadata", [路径])

if not 元数据.ok

return 元数据

else if true

return {ok: true, value: 元数据.value.kind == "directory"}

end end

列出目录

params(路径)

return resource.request("fs.list", [路径])

创建目录

params(路径)

return resource.request("fs.mkdir", [路径])

删除

params(路径)

删除一个文件或空目录。非空目录返回 fs.not_empty,不递归删除。

return resource.request("fs.remove", [路径])

重命名

params(源, 目标)

目标已存在时返回 fs.exists,不覆盖。

return resource.request("fs.rename", [源, 目标])

追加文本

params(路径, 文本)

把文本追加到项目文件;文件不存在时创建。仍受 8 MiB 单次读取上限和 fs_write 授权约束。

return resource.request("fs.append", [路径, 文本])

读取片段

params(路径, 偏移, 长度)

从偏移处读取最多 长度 字节,按 UTF-8 解码后返回文本。偏移/长度必须 是非负整数,长度上限 8 MiB。

return resource.request("fs.read_at", [路径, 偏移, 长度])

遍历

params(路径)

递归列出目录下的普通文件,返回相对项目根的路径列表。跳过符号链接, 深度上限 64,条目上限 4096。

return resource.request("fs.walk", [路径])