vx-toolkit 1.16.2__py3-none-any.whl

vx_toolkit/_bin/std/collections/vec.vx

@@ -0,0 +1,40 @@
+# ============================================================
+# std::collections::vec —— 动态数组 Vec
+# Zig 风格：显式分配器传参
+# ============================================================
+
+import std.mem.allocator
+
+# Vec 内存布局（每个槽位 8 字节，64 位平台）:
+#   buf[0] = capacity (int)
+#   buf[1] = size (int)
+#   buf[2..] = 元素数组
+
+func Vec_new(alloc: var) -> int:
+    var buf = malloc(2048)
+    buf[0] = 254
+    buf[1] = 0
+    return buf
+
+func Vec_push(alloc: var, v: int, val: int) -> int:
+    var size = v[1]
+    var cap = v[0]
+    if size >= cap:
+        return v
+    v[size + 2] = val
+    v[1] = size + 1
+    return v
+
+func Vec_get(v: int, index: int) -> int:
+    if index < 0 or index >= v[1]:
+        return 0
+    return v[index + 2]
+
+func Vec_size(v: int) -> int:
+    return v[1]
+
+func Vec_is_empty(v: int) -> bool:
+    return v[1] == 0
+
+func Vec_dealloc(alloc: var, v: int):
+    c_free(v)

vx_toolkit/_bin/std/conv.vx

@@ -0,0 +1,57 @@
+# ============================================================
+# std::conv —— 类型转换工具
+# 依赖 VM 内建 int/float/str/parse_int/parse_float
+# ============================================================
+
+import std.error
+
+class Conv:
+    # 字符串 -> 整数，失败返回 nil
+    func parse_int(s: var) -> var:
+        return parse_int(s)
+
+    # 字符串 -> 浮点数，失败返回 nil
+    func parse_float(s: var) -> var:
+        return parse_float(s)
+
+    # 任意 -> 整数（与 int 内建等价）
+    func to_int(v: var) -> int:
+        return int(v)
+
+    # 任意 -> 浮点数（与 float 内建等价）
+    func to_float(v: var) -> float:
+        return float(v)
+
+    # 任意 -> 字符串（与 str 内建等价）
+    func to_str(v: var) -> var:
+        return str(v)
+
+    # 安全解析整数，返回 Result
+    func parse_int_result(s: var) -> var:
+        var r = parse_int(s)
+        if r == nil:
+            return Result.err(error.value_error("Conv.parse_int: invalid integer '" + s + "'"))
+        return Result.ok(r)
+
+    # 安全解析浮点数，返回 Result
+    func parse_float_result(s: var) -> var:
+        var r = parse_float(s)
+        if r == nil:
+            return Result.err(error.value_error("Conv.parse_float: invalid float '" + s + "'"))
+        return Result.ok(r)
+
+# 顶层便捷函数
+func parse_int(s: var) -> var:
+    return Conv.parse_int(s)
+
+func parse_float(s: var) -> var:
+    return Conv.parse_float(s)
+
+func to_int(v: var) -> int:
+    return Conv.to_int(v)
+
+func to_float(v: var) -> float:
+    return Conv.to_float(v)
+
+func to_str(v: var) -> var:
+    return Conv.to_str(v)

vx_toolkit/_bin/std/error.vx

@@ -0,0 +1,165 @@
+# ============================================================
+# std::error —— 错误处理模块（零依赖基础模块）
+# ============================================================
+
+# ---- ErrorKind 枚举：错误类别标签 ----
+enum ErrorKind:
+    None      = 0
+    IO        = 1
+    Parse     = 2
+    TypeError = 3
+    Runtime   = 4
+    ValueError = 5
+    Index     = 6
+    Key       = 7
+    Math      = 8
+    System    = 9
+    Other     = 99
+
+# ---- Error 类：标准错误类型 ----
+class Error:
+    kind: int           # ErrorKind 值
+    msg: var            # 人类可读的错误描述
+    code: int           # 错误码（0 表示无错误）
+    source: var         # 源文件路径（字符串或空串）
+    line: int           # 出错行号（0 表示未知）
+    col: int            # 出错列号（0 表示未知）
+
+    # 构造器：创建基本错误
+    func new(kind: int, msg: var) -> var:
+        var e = new Error()
+        e.kind = kind
+        e.msg = msg
+        e.code = 0
+        e.source = ""
+        e.line = 0
+        e.col = 0
+        return e
+
+    # 设置错误码，返回自身（链式调用）
+    func with_code(code: int) -> var:
+        self.code = code
+        return self
+
+    # 设置源码位置，返回自身
+    func with_location(file: var, line: int, col: int) -> var:
+        self.source = file
+        self.line = line
+        self.col = col
+        return self
+
+    # 是否为严重错误（code != 0）
+    func is_critical() -> bool:
+        if self.code != 0:
+            return true
+        return false
+
+    # 格式化输出
+    func to_string() -> var:
+        var result = ""
+        if self.source != "":
+            result = result + self.source
+            if self.line > 0:
+                result = result + ":" + self.line
+                if self.col > 0:
+                    result = result + ":" + self.col
+            result = result + " "
+        result = result + "[" + self.kind + "] "
+        result = result + self.msg
+        if self.code != 0:
+            result = result + " (code=" + self.code + ")"
+        return result
+
+# ---- Result 类：替代泛型枚举 Result[T, E] ----
+# 使用方式：
+#   成功：var r = Result.ok(value)
+#   失败：var r = Result.err(error)
+#   检查：if r.is_ok: ... else: ...
+class Result:
+    is_ok: bool
+    value: var          # 成功时的值
+    error: var          # 失败时的 Error 对象
+
+    # 创建成功结果
+    func ok(val: var) -> var:
+        var r = new Result()
+        r.is_ok = true
+        r.value = val
+        r.error = nil
+        return r
+
+    # 创建失败结果
+    func err(err: var) -> var:
+        var r = new Result()
+        r.is_ok = false
+        r.value = nil
+        r.error = err
+        return r
+
+    # 如果成功则解包值，否则返回默认值
+    func unwrap_or(default_val: var) -> var:
+        if self.is_ok:
+            return self.value
+        return default_val
+
+    # 解包值，失败时触发错误
+    func unwrap() -> var:
+        if self.is_ok:
+            return self.value
+        return self.error
+
+# ---- Backtrace 类：堆栈追踪 ----
+# 第一版简化实现：存储函数名和位置的字符串列表
+class Backtrace:
+    frames: var          # 字符串列表，每帧 "func @ file:line"
+    depth: int
+
+    func new() -> var:
+        var bt = new Backtrace()
+        bt.frames = []
+        bt.depth = 0
+        return bt
+
+    # 捕获当前堆栈（VM 内建支持，当前用占位实现）
+    func capture() -> var:
+        var bt = new Backtrace()
+        bt.frames = []
+        bt.depth = 0
+        # TODO: VM 层支持 CallFrame 内省时替换为实际捕获
+        return bt
+
+    # 添加一帧
+    func push_frame(frame_info: var):
+        # frame_info 格式："func_name @ file:line"
+        self.frames = self.frames + [frame_info]
+        self.depth = self.depth + 1
+
+    # 格式化输出堆栈
+    func render() -> var:
+        var output = "Stack trace (depth=" + self.depth + "):\n"
+        var i = 0
+        while i < self.depth:
+            output = output + "  #" + i + " " + self.frames[i] + "\n"
+            i = i + 1
+        return output
+
+# ---- 快捷构造函数 ----
+# 创建 IO 错误
+func io_error(msg: var) -> var:
+    return new Error(ErrorKind.IO, msg)
+
+# 创建解析错误
+func parse_error(msg: var) -> var:
+    return new Error(ErrorKind.Parse, msg)
+
+# 创建类型错误
+func type_error(msg: var) -> var:
+    return new Error(ErrorKind.TypeError, msg)
+
+# 创建运行时错误
+func runtime_error(msg: var) -> var:
+    return new Error(ErrorKind.Runtime, msg)
+
+# 创建值错误
+func value_error(msg: var) -> var:
+    return new Error(ErrorKind.ValueError, msg)

vx_toolkit/_bin/std/io/dir.vx

@@ -0,0 +1,50 @@
+# ============================================================
+# std::io::dir —— 目录遍历
+# ============================================================
+
+import std.error
+import std.collections.vec
+
+# ---- Dir 类：目录操作 ----
+class Dir:
+    path: var           # 目录路径
+
+    # 打开目录
+    func open(path: var) -> var:
+        var d = new Dir()
+        d.path = path
+        return d
+
+    # 创建目录（占位：需要 VM 支持）
+    func create(path: var) -> var:
+        # TODO: 需要 VM 内建 mkdir 指令
+        return Result.err(error.io_error("Dir.create: not implemented"))
+
+    # 递归创建目录
+    func create_all(path: var) -> var:
+        return Result.err(error.io_error("Dir.create_all: not implemented"))
+
+    # 获取目录下的条目列表（占位）
+    func entries() -> var:
+        # TODO: 需要 VM 内建 read_dir 指令
+        return Result.err(error.io_error("Dir.entries: not implemented"))
+
+    # 获取目录下的文件列表
+    func files() -> var:
+        return Result.err(error.io_error("Dir.files: not implemented"))
+
+    # 获取目录下的子目录列表
+    func dirs() -> var:
+        return Result.err(error.io_error("Dir.dirs: not implemented"))
+
+    # 递归遍历（占位）
+    func walk() -> var:
+        return Result.err(error.io_error("Dir.walk: not implemented"))
+
+    # 删除目录
+    func remove(path: var) -> var:
+        return Result.err(error.io_error("Dir.remove: not implemented"))
+
+    # 递归删除
+    func remove_all(path: var) -> var:
+        return Result.err(error.io_error("Dir.remove_all: not implemented"))

vx_toolkit/_bin/std/io/file.vx

@@ -0,0 +1,154 @@
+# ============================================================
+# std::io::file —— 文件操作
+# 封装 VM 内建的 file_read/file_write/file_exists 指令
+# ============================================================
+
+import std.error
+import std.collections.vec
+import std.string.util
+
+# ---- File 类：文件操作 ----
+class File:
+    path: var           # 文件路径
+    mode: var           # 打开模式："r" | "w" | "a"
+    open: bool          # 是否已打开
+
+    # ========== 构造器/析构 ==========
+
+    func new() -> var:
+        var f = new File()
+        f.path = ""
+        f.mode = ""
+        f.open = false
+        return f
+
+    # 打开文件
+    func open(path: var, mode: var) -> var:
+        var f = new File()
+        f.path = path
+        f.mode = mode
+        f.open = true
+        return f
+
+    # 关闭文件
+    func close():
+        self.open = false
+
+    # 是否打开
+    func is_open() -> bool:
+        return self.open
+
+    # ========== 读取操作 ==========
+
+    # 读取全部文本内容
+    func read_all() -> var:
+        if self.open == false:
+            return Result.err(error.io_error("File.read_all: file not open"))
+        var content = file_read(self.path)
+        if content == nil:
+            return Result.err(error.io_error("File.read_all: failed to read '" + self.path + "'"))
+        return Result.ok(content)
+
+    # 读取全部字节（返回整数数组）
+    func read_bytes() -> var:
+        if self.open == false:
+            return Result.err(error.io_error("File.read_bytes: file not open"))
+        var content = file_read(self.path)
+        if content == nil:
+            return Result.err(error.io_error("File.read_bytes: failed to read '" + self.path + "'"))
+        # 转换为字节数组
+        var bytes = []
+        var i = 0
+        var n = len(content)
+        while i < n:
+            bytes = bytes + [content[i]]
+            i = i + 1
+        return Result.ok(bytes)
+
+    # 读取一行
+    func read_line() -> var:
+        var r = self.read_all()
+        if r.is_ok == false:
+            return r
+        var content = r.value
+        var lines = StringUtil.lines(content)
+        if lines.size() > 0:
+            return Result.ok(lines.get(0).unwrap())
+        return Result.ok("")
+
+    # 读取所有行
+    func read_lines() -> var:
+        var r = self.read_all()
+        if r.is_ok == false:
+            return r
+        return Result.ok(StringUtil.lines(r.value))
+
+    # ========== 写入操作 ==========
+
+    # 写入文本
+    func write(content: var) -> var:
+        if self.open == false:
+            return Result.err(error.io_error("File.write: file not open"))
+        file_write(self.path, content)
+        return Result.ok(nil)
+
+    # 写入字节
+    func write_bytes(data: var) -> var:
+        if self.open == false:
+            return Result.err(error.io_error("File.write_bytes: file not open"))
+        # 将字节数组转为字符串写入
+        var s = ""
+        var i = 0
+        while i < len(data):
+            s = s + data[i]
+            i = i + 1
+        file_write(self.path, s)
+        return Result.ok(nil)
+
+    # 写入行（自动添加换行）
+    func write_line(line: var) -> var:
+        if self.open == false:
+            return Result.err(error.io_error("File.write_line: file not open"))
+        file_write(self.path, line + "\n")
+        return Result.ok(nil)
+
+    # ========== 静态方法：元数据与文件操作 ==========
+
+    # 检查文件是否存在
+    func exists(path: var) -> bool:
+        return file_exists(path)
+
+    # 检查是否为目录（简化判断：无扩展名且不存在文件）
+    func is_dir(path: var) -> bool:
+        if file_exists(path):
+            return false
+        return true
+
+    # 检查是否为文件
+    func is_file(path: var) -> bool:
+        return file_exists(path)
+
+    # 删除文件
+    func delete(path: var) -> var:
+        if file_exists(path) == false:
+            return Result.err(error.io_error("File.delete: file not found: '" + path + "'"))
+        # 通过写入空内容来"删除"
+        file_write(path, "")
+        return Result.ok(nil)
+
+    # 重命名（通过读+写+删实现）
+    func rename(from: var, to: var) -> var:
+        if file_exists(from) == false:
+            return Result.err(error.io_error("File.rename: source not found: '" + from + "'"))
+        var content = file_read(from)
+        file_write(to, content)
+        file_write(from, "")
+        return Result.ok(nil)
+
+    # 复制文件
+    func copy(src: var, dst: var) -> var:
+        if file_exists(src) == false:
+            return Result.err(error.io_error("File.copy: source not found: '" + src + "'"))
+        var content = file_read(src)
+        file_write(dst, content)
+        return Result.ok(nil)

vx_toolkit/_bin/std/io/mod.vx

@@ -0,0 +1,5 @@
+# VX Standard I/O Library
+# Provides input/output functions via C ABI system calls
+
+extern func write(fd: int, buf: int, count: int) -> int
+extern func exit(code: int)

vx_toolkit/_bin/std/io/path.vx

@@ -0,0 +1,105 @@
+# ============================================================
+# std::io::path —— 路径操作
+# 纯字符串操作，无 I/O
+# ============================================================
+
+import std.error
+import std.string.util
+
+# ---- Path 类：路径处理工具（静态方法）----
+class Path:
+
+    # 连接路径片段
+    func join(base: var, child: var) -> var:
+        if base == "":
+            return child
+        if child == "":
+            return base
+        var sep = Path.separator()
+        var base_len = len(base)
+        if base[base_len - 1] == sep[0]:
+            return base + child
+        return base + sep + child
+
+    # 获取父目录
+    func parent(path: var) -> var:
+        var sep = Path.separator()
+        var idx = StringUtil.rfind(path, sep)
+        if idx < 0:
+            return Result.err(error.value_error("Path.parent: no parent for '" + path + "'"))
+        if idx == 0:
+            return Result.ok(sep)
+        return Result.ok(StringUtil.slice_to(path, idx))
+
+    # 获取文件名（含扩展名）
+    func file_name(path: var) -> var:
+        var sep = Path.separator()
+        var idx = StringUtil.rfind(path, sep)
+        if idx < 0:
+            return Result.ok(path)
+        return Result.ok(StringUtil.slice_from(path, idx + 1))
+
+    # 获取扩展名（含点号）
+    func extension(path: var) -> var:
+        var name_r = Path.file_name(path)
+        if name_r.is_ok == false:
+            return name_r
+        var name = name_r.value
+        var idx = StringUtil.rfind(name, ".")
+        if idx < 0:
+            return Result.err(error.value_error("Path.extension: no extension for '" + path + "'"))
+        return Result.ok(StringUtil.slice_from(name, idx))
+
+    # 获取不含扩展名的文件名
+    func stem(path: var) -> var:
+        var name_r = Path.file_name(path)
+        if name_r.is_ok == false:
+            return name_r
+        var name = name_r.value
+        var idx = StringUtil.rfind(name, ".")
+        if idx < 0:
+            return Result.ok(name)
+        return Result.ok(StringUtil.slice_to(name, idx))
+
+    # 是否为绝对路径
+    func is_absolute(path: var) -> bool:
+        if len(path) == 0:
+            return false
+        var sep = Path.separator()
+        if path[0] == sep[0]:
+            return true
+        # Windows 盘符路径
+        if len(path) >= 2:
+            if path[1] == ":":
+                return true
+        return false
+
+    # 规范化路径（折叠 ../ 和 ./）
+    func normalize(path: var) -> var:
+        var sep = Path.separator()
+        var parts = StringUtil.split(path, sep)
+        var result = []
+
+        var i = 0
+        while i < len(parts):
+            var part = parts[i]
+            if part == ".":
+                pass
+            elif part == "..":
+                var result_len = len(result)
+                if result_len > 0:
+                    var new_result = []
+                    var j = 0
+                    while j < result_len - 1:
+                        new_result = new_result + [result[j]]
+                        j = j + 1
+                    result = new_result
+            else:
+                result = result + [part]
+            i = i + 1
+
+        return StringUtil.join(result, sep)
+
+    # 路径分隔符
+    func separator() -> var:
+        return "/"

vx_toolkit/_bin/std/io/stream.vx

@@ -0,0 +1,82 @@
+# ============================================================
+# std::io::stream —— 标准输入输出流
+# ============================================================
+
+import std.error
+
+# ---- Stdin 类：标准输入 ----
+# 第一版通过内建函数实现基本输入
+class Stdin:
+    # 读取一行（从标准输入）
+    func read_line() -> var:
+        # VX 当前无内建 stdin 指令，返回占位
+        return Result.err(error.io_error("Stdin.read_line: not implemented"))
+
+    # 读取全部
+    func read_all() -> var:
+        return Result.err(error.io_error("Stdin.read_all: not implemented"))
+
+# ---- Stdout 类：标准输出 ----
+class Stdout:
+    # 输出文本（无换行）
+    func write(text: var):
+        out(text)
+
+    # 输出文本并换行
+    func write_line(text: var):
+        out(text + "\n")
+
+    # 格式化输出
+    func write_fmt(fmt: var, args: var):
+        var result = ""
+        var i = 0
+        var fmt_len = len(fmt)
+        var arg_idx = 0
+        var arg_len = len(args)
+
+        while i < fmt_len:
+            var ch = fmt[i]
+            if ch == "{":
+                if i + 1 < fmt_len:
+                    if fmt[i + 1] == "}":
+                        if arg_idx < arg_len:
+                            result = result + args[arg_idx]
+                            arg_idx = arg_idx + 1
+                        i = i + 1
+                    else:
+                        result = result + ch
+                else:
+                    result = result + ch
+            else:
+                result = result + ch
+            i = i + 1
+        out(result)
+
+    # 刷新缓冲区（stdout 即时刷新，此方法为空操作）
+    func flush():
+        pass
+
+# ---- Stderr 类：标准错误输出 ----
+class Stderr:
+    # 输出到 stderr
+    func write(text: var):
+        # VM 当前没有 stderr 专用指令，用 stdout + 标记
+        out("[ERR] " + text)
+
+    # 输出并换行
+    func write_line(text: var):
+        out("[ERR] " + text + "\n")
+
+# ========== 便捷函数 ==========
+
+# 打印无换行
+func print(text: var):
+    out(text)
+
+# 打印并换行
+func println(text: var):
+    out(text + "\n")
+
+# 打印到 stderr
+func eprint(text: var):
+    out("[ERR] " + text)

vx_toolkit/_bin/std/io.vx

@@ -0,0 +1,6 @@
+# VX Standard Library - I/O Module
+#
+# Provides basic input/output functions.
+# Implementations are provided by the AOT linker built-in stubs.
+
+extern func out(value: int)