1. 1
2. 2
3. 3
4. 4
5. 5
6. 6
7. 7
8. 8
9. 9
10. 10
11. 11
12. 12
13. 13
14. 14
15. 15
16. 16
17. 17
18. 18
19. 19
20. 20
21. 21
22. 22
23. 23
24. 24
25. 25
26. 26
27. 27
28. 28
29. 29
30. 30
31. 31
32. 32
33. 33
34. 34
35. 35
36. 36
37. 37
38. 38
39. 39
40. 40
41. 41
42. 42
43. 43
44. 44
45. 45
46. 46
47. 47
48. 48
49. 49
50. 50
51. 51
52. 52
53. 53
54. 54
55. 55
56. 56
57. 57
58. 58
59. 59
60. 60
61. 61
62. 62
63. 63
64. 64
65. 65
66. 66
67. 67
68. 68
69. 69
70. 70
71. 71
72. 72
73. 73
74. 74
75. 75
76. 76
77. 77
78. 78
79. 79
80. 80
81. 81
82. 82
83. 83
84. 84
85. 85
86. 86
87. 87
88. 88
89. 89
90. 90
91. 91

// Copyright 2025 Shota FUJI
//
// Licensed under the Zero-Clause BSD License or the Apache License, Version 2.0, at your option.
// You may not use, copy, modify, or distribute this file except according to those terms. You can
// find a copy of the Zero-Clause BSD License at LICENSES/0BSD.txt, and a copy of the Apache License,
// Version 2.0 at LICENSES/Apache-2.0.txt. You may also obtain a copy of the Zero-Clause BSD License
// at <https://opensource.org/license/0bsd> and a copy of the Apache License, Version 2.0 at
// <https://www.apache.org/licenses/LICENSE-2.0>
//
// SPDX-License-Identifier: 0BSD OR Apache-2.0
//
// ===
//
// This file defines how the steps and options for `zig build` command. See official documentation
// <https://ziglang.org/learn/build-system/> for more info.

const std = @import("std");

pub fn build(b: *std.Build) void {
    const target = b.standardTargetOptions(.{});
    const optimize = b.standardOptimizeOption(.{});

    // Exports Zig API. A project depending on this package imports this module.
    const module = b.addModule("moo", .{ .root_source_file = b.path("src/lib.zig") });

    // Tests
    const test_step = b.step("test", "Run unit tests");
    const unit_tests = b.addTest(.{
        .name = "moo_test",
        .root_source_file = b.path("src/lib.zig"),
        .target = target,
        .optimize = optimize,
    });
    test_step.dependOn(&b.addRunArtifact(unit_tests).step);

    // API Docs
    {
        const subdir = b.option(
            []const u8,
            "docs-dir",
            "Subdirectory to install docs into. Default is \"docs/api\"",
        ) orelse "docs/api";

        const lib = b.addStaticLibrary(.{
            .name = "moo",
            .root_source_file = b.path("src/lib.zig"),
            .target = target,
            .optimize = .Debug,
        });

        const install_docs = b.addInstallDirectory(.{
            .source_dir = lib.getEmittedDocs(),
            .install_dir = .prefix,
            .install_subdir = subdir,
        });

        const step = b.step("docs", "Install API docs into $prefix/$docs-dir");
        step.dependOn(&install_docs.step);
    }

    // Zig example
    // This is not a command due to steps can't trigger lazy dependencies' fetching.
    // <https://github.com/ziglang/zig/issues/21525>
    const example = b.option(bool, "example-zig", "Build Zig example program") orelse false;
    if (example) {
        const example_zig = b.addExecutable(.{
            .name = "example-zig",
            .root_source_file = b.path("examples/basic.zig"),
            .target = target,
            .optimize = optimize,
        });

        example_zig.root_module.addImport("moo", module);

        if (b.lazyDependency("websocket", .{
            .target = target,
            .optimize = optimize,
        })) |websocket| {
            example_zig.root_module.addImport("websocket", websocket.module("websocket"));
        }

        if (b.lazyDependency("clap", .{
            .target = target,
            .optimize = optimize,
        })) |clap| {
            example_zig.root_module.addImport("clap", clap.module("clap"));
        }

        b.installArtifact(example_zig);
    }
}