Zig Init & 包元数据

.{
    // 包名称：用作依赖表中的键
    // 约定：小写，无"zig"前缀（在Zig命名空间中冗余）
    .name = .mylib,

    // 用于包去重的语义版本
    .version = "1.2.3",

    // 全局唯一包标识符
    // 由工具链生成一次，然后永不改变
    // 允许明确检测包更新
    .fingerprint = 0xa1b2c3d4e5f60718,

    // 最低支持的 Zig 版本
    .minimum_zig_version = "0.15.2",

    // 外部依赖
    .dependencies = .{
        // 具有 URL 和哈希的远程依赖
        .example_remote = .{
            .url = "https://github.com/user/repo/archive/tag.tar.gz",
            // 多哈希格式：包身份的真实来源
            .hash = "1220abcdef1234567890abcdef1234567890abcdef1234567890abcdef12345678",
        },

        // 本地路径依赖（不需要哈希）
        .example_local = .{
            .path = "../sibling-package",
        },

        // 延迟依赖：仅在实际使用时才获取
        .example_lazy = .{
            .url = "https://example.com/optional.tar.gz",
            .hash = "1220fedcba0987654321fedcba0987654321fedcba0987654321fedcba098765",
            .lazy = true,
        },
    },

    // 包含在包哈希中的文件
    // 仅分发这些文件/目录
    .paths = .{
        "build.zig",
        "build.zig.zon",
        "src",
        "LICENSE",
        "README.md",
    },
}

const std = @Import("std");

pub fn main() !void {
    std.debug.print("--- 依赖类型比较 ---\n\n", .{});

    // 演示不同的依赖规范模式
    const deps = [_]Dependency{
        .{
            .name = "remote_package",
            .kind = .{ .remote = .{
                .url = "https://example.com/pkg.tar.gz",
                .hash = "122012345678...",
            } },
            .lazy = false,
        },
        .{
            .name = "local_package",
            .kind = .{ .local = .{
                .path = "../local-lib",
            } },
            .lazy = false,
        },
        .{
            .name = "lazy_optional",
            .kind = .{ .remote = .{
                .url = "https://example.com/opt.tar.gz",
                .hash = "1220abcdef...",
            } },
            .lazy = true,
        },
    };

    for (deps, 0..) |dep, i| {
        std.debug.print("Dependency {d}: {s}\n", .{ i + 1, dep.name });
        std.debug.print("  Type: {s}\n", .{@tagName(dep.kind)});
        std.debug.print("  Lazy: {}\n", .{dep.lazy});

        switch (dep.kind) {
            .remote => |r| {
                std.debug.print("  URL: {s}\n", .{r.url});
                std.debug.print("  Hash: {s}\n", .{r.hash});
                std.debug.print("  (Fetched from network, cached locally)\n", .{});
            },
            .local => |l| {
                std.debug.print("  Path: {s}\n", .{l.path});
                std.debug.print("  (No hash needed, relative to build root)\n", .{});
            },
        }
        std.debug.print("\n", .{});
    }

    std.debug.print("关键差异：\n", .{});
    std.debug.print("  - 远程：使用哈希作为真实来源\n", .{});
    std.debug.print("  - 本地：直接文件系统路径\n", .{});
    std.debug.print("  - 延迟：仅在实际导入时获取\n", .{});
}

const Dependency = struct {
    name: []const u8,
    kind: union(enum) {
        remote: struct {
            url: []const u8,
            hash: []const u8,
        },
        local: struct {
            path: []const u8,
        },
    },
    lazy: bool,
};