refactor (bindings/zig): Improvements

[kassane]

Which issue does this PR close?

N/D

Rationale for this change

It tends to be usable and testable.

What changes are included in this PR?

• Operator wrapper added
• more unittests
• wip: add stackful-async (zigcoro library) support
• replace @cImport/@cInclude to translate-c only (see: zig#20875)
• add custom test-runner output (more info)

Note

zig build [run|test] --summary [all|new|failures|none] show build-runner tree-output, not test output.

Are there any user-facing changes?

testable and easy to use.

[kassane]

Why??

================================================================================
    "operator advanced operations" - Unsupported
================================================================================
    /home/kassane/opendal/bindings/zig/src/opendal.zig:269:5: 0x103d9a0 in codeToError (test)
        return switch (code) {
        ^
    /home/kassane/opendal/bindings/zig/src/opendal.zig:113:13: 0x103f725 in copy (test)
                try codeToError(err.*.code);
                ^
    /home/kassane/opendal/bindings/zig/src/opendal.zig:385:5: 0x1040031 in test.operator advanced operations (test)
        try op.copy("/testdir/renamed.txt", "/testdir/copied.txt");
        ^

opendal/bindings/zig/src/opendal.zig

Lines 394 to 402 in b2c839c

	// Test rename operation
	// try op.rename("/testdir/file.txt", "/testdir/renamed.txt");
	// try testing.expect(!try op.exists("/testdir/file.txt"));
	// try testing.expect(try op.exists("/testdir/renamed.txt"));
	// Test copy operation
	// try op.copy("/testdir/renamed.txt", "/testdir/copied.txt");
	// try testing.expect(try op.exists("/testdir/renamed.txt"));
	// try testing.expect(try op.exists("/testdir/copied.txt"));

[kassane]

@Xuanwo,

async unittest get error:

GDB output

Warning: 'set target-async', an alias for the command 'set mi-async', is deprecated.
Use 'set mi-async'.
No line 468 in file "/home/kassane/opendal/bindings/zig/src/opendal.zig".
Running executable

This GDB supports auto-downloading debuginfo from the following URLs:
  <https://debuginfod.archlinux.org>
Enable debuginfod for this session? (y or [n]) [answered N; input not from terminal]
Debuginfod has been disabled.
To make this setting permanent, add 'set debuginfod enabled off' to .gdbinit.
[Thread debugging using libthread_db enabled]
Using host libthread_db library "/usr/lib/libthread_db.so.1".
undefined
Error Tests (0.07ms)
Semantic Analyzer (0.01ms)
operator basic operations (6.53ms)
operator advanced operations (1.36ms)


Breakpoint 2, opendal.writeData () at opendal.zig:448
448	fn writeData(op: *Operator, path: []const u8, data: []const u8) anyerror!void {

Program
 received signal SIGSEGV, Segmentation fault.
0x00007ffff7500837 in core::str::validations::next_code_point<core::slice::iter::Iter<u8>> (bytes=0xaaaaaaaaaaaaaaaa) at /rustc/f6e511eec7342f59a25f7c0534f1dbea00d01b14/library/core/src/str/validations.rs:35
warning: 35	/rustc/f6e511eec7342f59a25f7c0534f1dbea00d01b14/library/core/src/str/validations.rs: File or directory does not exist

Tested

• zig-version: 0.13.0
• rustc-version: 1.82.0 (f6e511eec 2024-10-15)

---

Edit

May be blocked by:

• research: How to support async API for C binding? #1741
• Tracking issue of missing functionalities in OpenDAL C binding #2959

[Xuanwo]

Thank you @kassane for you effort, I will review this PR later this week.

[kassane]

Thank you @kassane for you effort, I will review this PR later this week.

Nice!
Now, latest commit clean build.zig - opendal_module provide all dependencies.

[Xuanwo]

Thank you @kassane for this great work!