Update build for Zig 0.14.1

This commit updates the build system for Zig 0.14.1 compatibility, including
proper module configuration, build API changes, and adds a package manifest
(build.zig.zon).

Author: femiagbabiaka

.gitignore

@@ -1 +1,2 @@
-/zig-cache/
+.zig-cache/
+zig-out/*

build.zig

@@ -1,21 +1,36 @@
 const std = @import("std");
 
-pub fn build(b: *std.build.Builder) void {
+pub fn build(b: *std.Build) void {
     const target = b.standardTargetOptions(.{});
     const optimize = b.standardOptimizeOption(.{});
 
-    _ = b.addModule("getopt", .{
-        .source_file = .{
-            .path = "getopt.zig",
-        },
+    const getopt_lib_mod = b.createModule(.{
+        .root_source_file = b.path("getopt.zig"),
+        .target = target,
+        .optimize = optimize,
     });
 
-    const tests = b.addTest(.{
-        .root_source_file = .{ .path = "getopt.zig" },
+    const getopt_example_exe_mod = b.createModule(.{
+        .root_source_file = b.path("example.zig"),
         .target = target,
         .optimize = optimize,
     });
-    const run_tests = b.addRunArtifact(tests);
+
+    const lib = b.addLibrary(.{
+        .linkage = .static,
+        .name = "getopt",
+        .root_module = getopt_lib_mod,
+    });
+    b.installArtifact(lib);
+
+    const exe = b.addExecutable(.{
+        .name = "example",
+        .root_module = getopt_example_exe_mod,
+    });
+    b.installArtifact(exe);
+
+    const getopt_lib_unit_tests = b.addTest(.{ .root_module = getopt_lib_mod });
+    const run_tests = b.addRunArtifact(getopt_lib_unit_tests);
 
     const test_step = b.step("test", "Run tests");
     test_step.dependOn(&run_tests.step);

build.zig.zon

@@ -0,0 +1,50 @@
+.{
+    // This is the default name used by packages depending on this one. For
+    // example, when a user runs `zig fetch --save <url>`, this field is used
+    // as the key in the `dependencies` table. Although the user can choose a
+    // different name, most users will stick with this provided value.
+    //
+    // It is redundant to include "zig" in this name because it is already
+    // within the Zig package namespace.
+    .name = .getopt,
+
+    // This is a [Semantic Version](https://semver.org/).
+    // In a future version of Zig it will be used for package deduplication.
+    .version = "0.0.0",
+
+    // Together with name, this represents a globally unique package
+    // identifier. This field is generated by the Zig toolchain when the
+    // package is first created, and then *never changes*. This allows
+    // unambiguous detection of one package being an updated version of
+    // another.
+    //
+    // When forking a Zig project, this id should be regenerated (delete the
+    // field and run `zig build`) if the upstream project is still maintained.
+    // Otherwise, the fork is *hostile*, attempting to take control over the
+    // original project's identity. Thus it is recommended to leave the comment
+    // on the following line intact, so that it shows up in code reviews that
+    // modify the field.
+    .fingerprint = 0x2a601179af5673be,
+
+    // Tracks the earliest Zig version that the package considers to be a
+    // supported use case.
+    .minimum_zig_version = "0.14.1",
+
+    // This field is optional.
+    // Each dependency must either provide a `url` and `hash`, or a `path`.
+    // `zig build --fetch` can be used to fetch all dependencies of a package, recursively.
+    // Once all dependencies are fetched, `zig build` no longer requires
+    // internet connectivity.
+    .dependencies = .{},
+    .paths = .{
+        "build.zig",
+        "build.zig.zon",
+        "example.zig",
+        "LICENSE",
+        "README.md",
+        "getopt.zig",
+        // For example...
+        //"LICENSE",
+        //"README.md",
+    },
+}

getopt.zig

@@ -16,7 +16,7 @@ pub const Option = struct {
 pub const Error = error{ InvalidOption, MissingArgument };
 
 pub const OptionsIterator = struct {
-    argv: [][*:0]const u8,
+    argv: [][*:0]u8,
     opts: []const u8,
 
     /// Index of the current element of the argv vector.
@@ -75,15 +75,15 @@ pub const OptionsIterator = struct {
     }
 
     /// Return remaining arguments, if any.
-    pub fn args(self: *OptionsIterator) ?[][*:0]const u8 {
+    pub fn args(self: *OptionsIterator) ?[][*:0]u8 {
         if (self.optind < self.argv.len)
             return self.argv[self.optind..]
         else
             return null;
     }
 };
 
-fn getoptArgv(argv: [][*:0]const u8, optstring: []const u8) OptionsIterator {
+fn getoptArgv(argv: [][*:0]u8, optstring: []const u8) OptionsIterator {
     return OptionsIterator{
         .argv = argv,
         .opts = optstring,
@@ -92,9 +92,7 @@ fn getoptArgv(argv: [][*:0]const u8, optstring: []const u8) OptionsIterator {
 
 /// Parse os.argv according to the optstring.
 pub fn getopt(optstring: []const u8) OptionsIterator {
-    // https://github.com/ziglang/zig/issues/8808
-    const argv: [][*:0]const u8 = os.argv;
-    return getoptArgv(argv, optstring);
+    return getoptArgv(os.argv, optstring);
 }
 
 test "no args separate" {