fast_excel 0.4.1 → 0.5.0

data/libxlsxwriter/Makefile

@@ -2,7 +2,7 @@
 #
 # Makefile for libxlsxwriter library.
 #
-# Copyright 2014-2019, John McNamara, jmcnamara@cpan.org
+# Copyright 2014-2022, John McNamara, jmcnamara@cpan.org
 #
 
 # Keep the output quiet by default.
@@ -11,45 +11,86 @@ ifdef V
 Q=
 endif
 
-INSTALL_DIR ?= /usr/local
+DESTDIR ?=
+PREFIX  ?= /usr/local
 
 PYTEST ?= py.test
+PYTESTFILES ?= test
 
-.PHONY: docs tags examples
+VERSION   = $(shell sed -n -e 's/.*LXW_VERSION \"\(.*\)\"/\1/p'   include/xlsxwriter.h)
+SOVERSION = $(shell sed -n -e 's/.*LXW_SOVERSION \"\(.*\)\"/\1/p' include/xlsxwriter.h)
 
-# Build the libs.
-all :
+.PHONY: docs tags examples third_party
+
+# Build libxlsxwriter.
+all : third_party
+	$(Q)$(MAKE) -C src
+
+# Build the third party libs.
+third_party :
 ifndef USE_SYSTEM_MINIZIP
 	$(Q)$(MAKE) -C third_party/minizip
 endif
 ifndef USE_STANDARD_TMPFILE
 	$(Q)$(MAKE) -C third_party/tmpfileplus
 endif
-	$(Q)$(MAKE) -C src
+ifndef USE_NO_MD5
+ifndef USE_OPENSSL_MD5
+	$(Q)$(MAKE) -C third_party/md5
+endif
+endif
+ifdef USE_DTOA_LIBRARY
+	$(Q)$(MAKE) -C third_party/dtoa
+endif
+
+# Build a macOS universal binary.
+universal_binary :
+	$(Q)$(MAKE) clean
+	$(Q)TARGET_ARCH="-target x86_64-apple-macos10.12" $(MAKE) all
+	$(Q)mv lib/libxlsxwriter.a     libxlsxwriter_x86_64.a
+	$(Q)mv lib/libxlsxwriter.$(SOVERSION).dylib libxlsxwriter_x86_64.dylib
+
+	$(Q)$(MAKE) clean
+	$(Q)TARGET_ARCH="-target arm64-apple-macos11" $(MAKE) all
+	$(Q)mv lib/libxlsxwriter.a     lib/libxlsxwriter_arm64.a
+	$(Q)mv lib/libxlsxwriter.$(SOVERSION).dylib lib/libxlsxwriter_arm64.dylib
+	$(Q)mv libxlsxwriter_x86_64.a libxlsxwriter_x86_64.dylib lib
+
+	$(Q)lipo -create -output lib/libxlsxwriter.a                  lib/libxlsxwriter_x86_64.a     lib/libxlsxwriter_arm64.a
+	$(Q)lipo -create -output lib/libxlsxwriter.$(SOVERSION).dylib lib/libxlsxwriter_x86_64.dylib lib/libxlsxwriter_arm64.dylib
+	$(Q)rm -f lib/libxlsxwriter_x86_64.* lib/libxlsxwriter_arm64.*
 
 # Build the example programs.
-examples :
+examples : all
 	$(Q)$(MAKE) -C examples
 
+# Build the example programs with CPP for compatibility checking.
+examples_cpp : all
+	$(Q)$(MAKE) -C examples CC=$(CXX)
+
 # Clean src and test directories.
 clean :
 	$(Q)$(MAKE) clean -C src
-	# $(Q)$(MAKE) clean -C test/unit
-	# $(Q)$(MAKE) clean -C test/functional/src
-	# $(Q)$(MAKE) clean -C examples
+	$(Q)$(MAKE) clean -C test/unit
+	$(Q)$(MAKE) clean -C test/functional/src
+	$(Q)$(MAKE) clean -C test/cpp
+	$(Q)$(MAKE) clean -C examples
 	$(Q)rm -rf docs/html
 	$(Q)rm -rf test/functional/__pycache__
 	$(Q)rm -f  test/functional/*.pyc
 	$(Q)rm -f  lib/*
-ifndef USE_STANDARD_TMPFILE
 	$(Q)$(MAKE) clean -C third_party/minizip
-endif
-ifndef USE_STANDARD_TMPFILE
 	$(Q)$(MAKE) clean -C third_party/tmpfileplus
-endif
+	$(Q)$(MAKE) clean -C third_party/md5
+	$(Q)$(MAKE) clean -C third_party/dtoa
+
+# Clean src and lib dir only, as a precursor for static analysis.
+clean_src :
+	$(Q)$(MAKE) clean -C src
+	$(Q)rm -f  lib/*
 
 # Run the unit tests.
-test : all test_functional test_unit
+test : all test_cpp test_unit test_functional
 
 # Test for C++ const correctness on APIs.
 test_const : all
@@ -60,20 +101,30 @@ test_const : all
 # Run the functional tests.
 test_functional : all
 	$(Q)$(MAKE) -C test/functional/src
-	$(Q)$(PYTEST) test/functional -v
+	$(Q)$(PYTEST) test/functional -v -k $(PYTESTFILES)
 
 # Run all tests.
-test_unit :
-	@echo "Compiling unit tests ..."
-ifndef USE_SYSTEM_MINIZIP
-	$(Q)$(MAKE) -C third_party/minizip
-endif
-ifndef USE_STANDARD_TMPFILE
-	$(Q)$(MAKE) -C third_party/tmpfileplus
-endif
+test_unit : all
 	$(Q)$(MAKE) -C src test_lib
 	$(Q)$(MAKE) -C test/unit test
 
+# Test C++ compilation.
+test_cpp : all
+	$(Q)$(MAKE) -C test/cpp
+
+# Test Cmake. This test should really be done with Cmake in the cmake dir but
+# this is a workaround for now.
+test_cmake :
+ifneq ($(findstring m32,$(CFLAGS)),m32)
+	$(Q)$(MAKE) -C src clean
+	$(Q)cd cmake; cmake .. -DBUILD_TESTS=ON -DBUILD_EXAMPLES=ON; make clean; make; cp libxlsxwriter.a ../src/
+	$(Q)cmake/xlsxwriter_unit
+	$(Q)$(MAKE) -C test/functional/src
+	$(Q)$(PYTEST) test/functional -v -k $(PYTESTFILES)
+else
+	@echo "Skipping Cmake tests on 32 bit target."
+endif
+
 # Test the functional test exes with valgrind (in 64bit mode only).
 test_valgrind : all
 ifndef NO_VALGRIND
@@ -97,50 +148,95 @@ tags:
 doc: docs
 docs:
 	$(Q)$(MAKE) -C docs
+	@echo "Docs built."
+
+docs_doxygen_only:
+	$(Q)$(MAKE) -C docs docs_doxygen_only
 
-# Simple minded install.
+docs_external:
+	$(Q)make -C ../libxlsxwriter.github.io release
+
+# Simple install.
 install: all
-	$(Q)mkdir -p        $(INSTALL_DIR)/include
-	$(Q)cp -R include/* $(INSTALL_DIR)/include
-	$(Q)mkdir -p        $(INSTALL_DIR)/lib
-	$(Q)cp lib/*        $(INSTALL_DIR)/lib
+	$(Q)mkdir -p        $(DESTDIR)$(PREFIX)/include
+	$(Q)cp -R include/* $(DESTDIR)$(PREFIX)/include
+	$(Q)mkdir -p        $(DESTDIR)$(PREFIX)/lib
+	$(Q)cp -R lib/*     $(DESTDIR)$(PREFIX)/lib
+	$(Q)mkdir -p        $(DESTDIR)$(PREFIX)/lib/pkgconfig
+	$(Q)sed -e          's|@PREFIX@|$(PREFIX)|g'  -e 's|@VERSION@|$(VERSION)|g' dev/release/pkg-config.txt > $(DESTDIR)$(PREFIX)/lib/pkgconfig/xlsxwriter.pc
 
-# Simpler minded uninstall.
+# Simpler uninstall.
 uninstall:
-	$(Q)rm -rf $(INSTALL_DIR)/include/xlsxwriter*
-	$(Q)rm     $(INSTALL_DIR)/lib/libxlsxwriter.*
+	$(Q)rm -rf $(DESTDIR)$(PREFIX)/include/xlsxwriter*
+	$(Q)rm     $(DESTDIR)$(PREFIX)/lib/libxlsxwriter.*
+	$(Q)rm     $(DESTDIR)$(PREFIX)/lib/pkgconfig/xlsxwriter.pc
 
 # Strip the lib files.
 strip:
 	$(Q)strip lib/*
 
 # Run a coverity static analysis.
-coverity:
-ifndef USE_SYSTEM_MINIZIP
-	$(Q)$(MAKE) -C third_party/minizip
-endif
-ifndef USE_STANDARD_TMPFILE
-	$(Q)$(MAKE) -C third_party/tmpfileplus
-endif
-	$(Q)$(MAKE) -C src clean
-	$(Q)rm -f  lib/*
+coverity: clean_src third_party
 	$(Q)rm -rf  cov-int
 	$(Q)rm -f libxlsxwriter-coverity.tgz
-	$(Q)../../cov-analysis-linux64-8.7.0/bin/cov-build --dir cov-int make -C src libxlsxwriter.a
+	$(Q)../../cov-analysis-linux64-2019.03/bin/cov-build --dir cov-int make -C src libxlsxwriter.a
 	$(Q)tar -czf libxlsxwriter-coverity.tgz cov-int
 	$(Q)$(MAKE) -C src clean
 	$(Q)rm -f  lib/*
 
-# Run a scan-build static analysis.
-scan_build:
-ifndef USE_SYSTEM_MINIZIP
-	$(Q)$(MAKE) -C third_party/minizip
+# Run gcov coverage analysis.
+gcov: third_party
+	$(Q)$(MAKE) -C src clean
+	$(Q)$(MAKE) -C src                 GCOV="--coverage" OPT_LEVEL="-O0"
+	$(Q)$(MAKE) -C src test_lib        GCOV="--coverage"
+	$(Q)$(MAKE) -C test/unit test      GCOV="--coverage"
+	$(Q)$(MAKE) -C test/functional/src GCOV="--coverage"
+	$(Q)$(PYTEST) test/functional -v -k $(PYTESTFILES)
+	$(Q)mkdir -p build
+	$(Q)gcovr -r src --html-details -o build/libxlsxwriter_gcov.html
+	$(Q)gcovr -r . -f src --sonarqube build/coverage.xml
+
+# Run sonarcloud analysis.
+sonarcloud: gcov
+ifndef SONAR_TOKEN
+	@echo "Please define SONAR_TOKEN to run this analysis."
+	@exit 1
 endif
-ifndef USE_STANDARD_TMPFILE
-	$(Q)$(MAKE) -C third_party/tmpfileplus
+	$(Q)$(MAKE) clean
+	$(Q)../sonar-scanner-4.6.1.2450-macosx/bin/build-wrapper-macosx-x86 --out-dir build make all
+	$(Q)../sonar-scanner-4.6.1.2450-macosx/bin/sonar-scanner \
+        -Dsonar.organization=jmcnamara-github \
+        -Dsonar.projectKey=jmcnamara_libxlsxwriter \
+        -Dsonar.projectName=libxlsxwriter \
+        -Dsonar.projectVersion=$(VERSION) \
+        -Dsonar.sources=src \
+        -Dsonar.sourceEncoding=UTF-8 \
+        -Dsonar.cfamily.build-wrapper-output=build \
+        -Dsonar.working.directory=build/scannerwork \
+        -Dsonar.host.url=https://sonarcloud.io \
+        -Dsonar.coverageReportPaths=build/coverage.xml
+
+sonarcloud_no_gcov:
+ifndef SONAR_TOKEN
+	@echo "Please define SONAR_TOKEN to run this analysis."
+	@exit 1
 endif
-	$(Q)$(MAKE) -C src clean
-	$(Q)rm -f  lib/*
+	$(Q)$(MAKE) clean
+	$(Q)../sonar-scanner-4.6.1.2450-macosx/bin/build-wrapper-macosx-x86 --out-dir build make all
+	$(Q)../sonar-scanner-4.6.1.2450-macosx/bin/sonar-scanner \
+        -Dsonar.organization=jmcnamara-github \
+        -Dsonar.projectKey=jmcnamara_libxlsxwriter \
+        -Dsonar.projectName=libxlsxwriter \
+        -Dsonar.projectVersion=$(VERSION) \
+        -Dsonar.sources=src \
+        -Dsonar.sourceEncoding=UTF-8 \
+        -Dsonar.cfamily.build-wrapper-output=build \
+        -Dsonar.working.directory=build/scannerwork \
+        -Dsonar.host.url=https://sonarcloud.io
+
+
+# Run a scan-build static analysis.
+scan_build: clean_src third_party
 	$(Q)scan-build make -C src libxlsxwriter.a
 	$(Q)$(MAKE) -C src clean
 	$(Q)rm -f  lib/*
@@ -152,14 +248,15 @@ spellcheck:
 	$(Q)for f in examples/*.c;           do aspell --lang=en_US --check $$f; done
 	$(Q)aspell --lang=en_US --check Changes.txt
 	$(Q)aspell --lang=en_US --check Readme.md
+	$(Q)aspell --lang=en_US --check docs/src/examples.txt
 
 releasecheck:
 	$(Q)dev/release/release_check.sh
 
 release: releasecheck
 	@echo
-	@echo "Pushing to git master ..."
-	$(Q)git push origin master
+	@echo "Pushing to git main ..."
+	$(Q)git push origin main
 	$(Q)git push --tags
 
 	@echo
@@ -172,7 +269,7 @@ release: releasecheck
 
 	@echo
 	@echo "Finished. Opening files."
-	$(Q)open http://libxlsxwriter.github.io/changes.html
-	$(Q)open http://cocoadocs.org/docsets/libxlsxwriter
+	$(Q)open https://libxlsxwriter.github.io/changes.html
+	$(Q)open https://cocoadocs.org/docsets/libxlsxwriter
 	$(Q)open https://github.com/jmcnamara/libxlsxwriter
 	$(Q)open https://github.com/jmcnamara/libxlsxwriter/releases

data/libxlsxwriter/Package.swift

@@ -0,0 +1,42 @@
+// swift-tools-version: 5.7
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "libxlsxwriter",
+    products: [
+        .library(
+            name: "libxlsxwriter",
+            targets: ["libxlsxwriter"]),
+    ],
+    targets: [
+        .target(
+            name: "libxlsxwriter",
+            path: ".",
+            exclude: [
+                "src/Makefile",
+            ],
+            sources: [
+                "include",
+                "src",
+                "third_party/minizip/zip.c",
+                "third_party/minizip/ioapi.c",
+                "third_party/tmpfileplus/tmpfileplus.c",
+                "third_party/md5/md5.c"
+            ],
+            publicHeadersPath: "include",
+            linkerSettings: [
+                .linkedLibrary("z")
+            ]),
+        .testTarget(
+            name: "libxlsxwritertests",
+            dependencies: ["libxlsxwriter"],
+            path: ".",
+            sources: ["test/swift"],
+            linkerSettings: [
+                .linkedLibrary("z")
+            ]
+        )
+    ]
+)

data/libxlsxwriter/Readme.md

@@ -21,7 +21,10 @@ It supports features such as:
 - Autofilters.
 - Charts.
 - Data validation and drop down lists.
-- Worksheet PNG/JPEG images.
+- Conditional formatting.
+- Worksheet PNG/JPEG/GIF images.
+- Cell comments.
+- Support for adding Macros.
 - Memory optimization mode for writing large files.
 - Source code available on [GitHub](https://github.com/jmcnamara/libxlsxwriter).
 - FreeBSD license.
@@ -74,7 +77,6 @@ int main() {
 ```
 
 
-
 See the [full documentation](http://libxlsxwriter.github.io) for the getting
 started guide, a tutorial, the main API documentation and examples.
 

data/libxlsxwriter/build.zig

@@ -0,0 +1,324 @@
+const std = @import("std");
+const Path = std.Build.LazyPath;
+
+// Although this function looks imperative, note that its job is to
+// declaratively construct a build graph that will be libcuted by an external
+// runner.
+pub fn build(b: *std.Build) void {
+    // Standard target options allows the person running `zig build` to choose
+    // what target to build for. Here we do not override the defaults, which
+    // means any target is allowed, and the default is native. Other options
+    // for restricting supported target set are available.
+    const target = b.standardTargetOptions(.{});
+
+    // Standard optimization options allow the person running `zig build` to select
+    // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. Here we do not
+    // set a preferred release mode, allowing the user to decide how to optimize.
+    const optimize = b.standardOptimizeOption(.{});
+
+    const shared = b.option(bool, "SHARED_LIBRARY", "Build the Shared Library [default: false]") orelse false;
+    const examples = b.option(bool, "BUILD_EXAMPLES", "Build libxlsxwriter examples [default: false]") orelse false;
+    const tests = b.option(bool, "BUILD_TESTS", "Build libxlsxwriter tests [default: false]") orelse false;
+    const dtoa = b.option(bool, "USE_DTOA_LIBRARY", "Use the locale independent third party Milo Yip DTOA library [default: off]") orelse false;
+    const minizip = b.option(bool, "USE_SYSTEM_MINIZIP", "Use system minizip installation [default: off]") orelse false;
+    const md5 = b.option(bool, "USE_OPENSSL_MD5", "Build libxlsxwriter with the OpenSSL MD5 lib [default: off]") orelse false;
+    const stdtmpfile = b.option(bool, "USE_STANDARD_TMPFILE", "Use the C standard library's tmpfile() [default: off]") orelse false;
+
+    const lib = if (shared) b.addSharedLibrary(.{
+        .name = "xlsxwriter",
+        .target = target,
+        .optimize = optimize,
+        .version = .{
+            .major = 1,
+            .minor = 1,
+            .patch = 6,
+        },
+    }) else b.addStaticLibrary(.{
+        .name = "xlsxwriter",
+        .target = target,
+        .optimize = optimize,
+    });
+    lib.pie = true;
+    switch (optimize) {
+        .Debug, .ReleaseSafe => lib.bundle_compiler_rt = true,
+        else => lib.strip = true,
+    }
+    if (tests)
+        lib.defineCMacro("TESTING", null);
+    lib.addCSourceFiles(&.{
+        "src/vml.c",
+        "src/chartsheet.c",
+        "src/theme.c",
+        "src/content_types.c",
+        "src/xmlwriter.c",
+        "src/app.c",
+        "src/styles.c",
+        "src/core.c",
+        "src/comment.c",
+        "src/utility.c",
+        "src/metadata.c",
+        "src/custom.c",
+        "src/hash_table.c",
+        "src/relationships.c",
+        "src/drawing.c",
+        "src/chart.c",
+        "src/shared_strings.c",
+        "src/worksheet.c",
+        "src/format.c",
+        "src/table.c",
+        "src/workbook.c",
+        "src/packager.c",
+    }, cflags);
+
+    // minizip
+    if (minizip) {
+        lib.addCSourceFiles(switch (target.getOsTag()) {
+            .windows => minizip_src ++ [_][]const u8{
+                "third_party/minizip/iowin32.c",
+            },
+            else => minizip_src,
+        }, cflags);
+    }
+
+    // zig-pkg: download & build zlib (to all targets)
+    const zlib_dep = b.dependency("zlib", .{
+        .optimize = optimize,
+        .target = target,
+    });
+    const zlib = zlib_dep.artifact("z");
+    lib.linkLibrary(zlib);
+    lib.installLibraryHeaders(zlib);
+
+    // md5
+    if (!md5)
+        lib.addCSourceFile(.{ .file = .{ .path = "third_party/md5/md5.c" }, .flags = cflags })
+    else
+        lib.linkSystemLibrary("crypto");
+
+    // dtoa
+    if (dtoa)
+        lib.addCSourceFile(.{ .file = Path.relative("third_party/dtoa/emyg_dtoa.c"), .flags = cflags });
+
+    // tmpfileplus
+    if (stdtmpfile)
+        lib.addCSourceFile(.{ .file = .{ .path = "third_party/tmpfileplus/tmpfileplus.c" }, .flags = cflags })
+    else
+        lib.defineCMacro("USE_STANDARD_TMPFILE", null);
+
+    lib.addIncludePath(Path.relative("include"));
+    lib.addIncludePath(Path.relative("third_party"));
+    lib.linkLibC();
+
+    // get headers on include to zig-out/include
+    lib.installHeadersDirectory("include", "");
+
+    // get binaries on zig-cache to zig-out
+    b.installArtifact(lib);
+
+    // build examples
+    if (examples) {
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/anatomy.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/array_formula.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/autofilter.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/background.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/chart_area.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/chart_column.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/data_validate.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/hello.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/watermark.c",
+        });
+        buildExe(b, .{
+            .lib = lib,
+            .path = "examples/worksheet_protection.c",
+        });
+    }
+    // build tests
+    if (tests) {
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/app/test_app.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/chart/test_chart.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/chartsheet/test_chartsheet.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/content_types/test_content_types.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/content_types/test_content_types_write_default.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/content_types/test_content_types_write_override.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/relationships/test_relationships.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/app/test_app_xml_declaration.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/relationships/test_relationships_xml_declaration.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/custom/test_custom_xml_declaration.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/metadata/test_metadata_xml_declaration.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/core/test_core_xml_declaration.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/sst/test_shared_strings.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/workbook/test_workbook.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/xmlwriter/test_xmlwriter.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/table/test_table01.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/table/test_table02.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/table/test_table03.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/table/test_table04.c",
+        });
+        buildTest(b, .{
+            .lib = lib,
+            .path = "test/unit/styles/test_styles_write_border.c",
+        });
+    }
+}
+
+fn buildExe(b: *std.Build, info: BuildInfo) void {
+    const exe = b.addExecutable(.{
+        .name = info.filename(),
+        .optimize = info.lib.optimize,
+        .target = info.lib.target,
+    });
+    exe.addCSourceFile(.{ .file = Path.relative(info.path), .flags = cflags });
+    exe.linkLibrary(info.lib);
+    for (info.lib.include_dirs.items) |include| {
+        exe.include_dirs.append(include) catch {};
+    }
+    exe.linkLibC();
+    b.installArtifact(exe);
+
+    const run_cmd = b.addRunArtifact(exe);
+    run_cmd.step.dependOn(b.getInstallStep());
+    if (b.args) |args| {
+        run_cmd.addArgs(args);
+    }
+
+    const run_step = b.step(
+        b.fmt("{s}", .{info.filename()}),
+        b.fmt("Run the {s} test", .{info.filename()}),
+    );
+    run_step.dependOn(&run_cmd.step);
+}
+
+fn buildTest(b: *std.Build, info: BuildInfo) void {
+    const exe = b.addExecutable(.{
+        .name = info.filename(),
+        .optimize = info.lib.optimize,
+        .target = info.lib.target,
+    });
+    exe.defineCMacro("TESTING", null);
+    exe.addCSourceFile(.{ .file = Path.relative(info.path), .flags = cflags });
+    exe.addCSourceFile(.{ .file = Path.relative("test/unit/test_all.c"), .flags = cflags });
+    exe.addIncludePath(Path.relative("test/unit"));
+    for (info.lib.include_dirs.items) |include| {
+        exe.include_dirs.append(include) catch {};
+    }
+    exe.linkLibrary(info.lib);
+    exe.linkLibC();
+    b.installArtifact(exe);
+
+    const run_cmd = b.addRunArtifact(exe);
+    run_cmd.step.dependOn(b.getInstallStep());
+    if (b.args) |args| {
+        run_cmd.addArgs(args);
+    }
+
+    const run_step = b.step(
+        b.fmt("{s}", .{info.filename()}),
+        b.fmt("Run the {s} test", .{info.filename()}),
+    );
+    run_step.dependOn(&run_cmd.step);
+}
+
+const cflags = &.{
+    "-std=c89",
+    "-Wall",
+    "-Wextra",
+    "-Wno-unused-parameter",
+};
+const minizip_src: []const []const u8 = &.{
+    "third_party/minizip/ioapi.c",
+    "third_party/minizip/mztools.c",
+    "third_party/minizip/unzip.c",
+    "third_party/minizip/zip.c",
+};
+
+const BuildInfo = struct {
+    lib: *std.Build.Step.Compile,
+    path: []const u8,
+
+    fn filename(self: BuildInfo) []const u8 {
+        var split = std.mem.splitSequence(u8, std.fs.path.basename(self.path), ".");
+        return split.first();
+    }
+};

data/libxlsxwriter/build.zig.zon

@@ -0,0 +1,11 @@
+.{
+    .name = "libxlsxwriter",
+    .version = "1.1.6",
+    .dependencies = .{
+        .zlib = .{
+            .url = "https://github.com/kassane/zlib/archive/4a99cc2bfa344c969f086fcb8c5873d80448f3e6.tar.gz",
+            .hash = "12209e851f7e2c6ba2f01de3e11b1771f03e49666065320abd8414aac152bfa75fae",
+        },
+    },
+}
+//syntax tip: zig - anon struct (json-like)