Does bun.sys handle file closing automatically?

No, you should use the defer pattern with fd.close() for standard cleanup, or use closeAllowingBadFileDescriptor if you need to handle specific errors during the closing process.

What is the benefit of the Maybe(T) return type?

Maybe(T) is a tagged union that allows you to access detailed error metadata like the raw errno, the specific syscall that failed, and the associated file descriptor or path, which is more comprehensive than a standard Zig error union.

Why should I use bun.sys instead of Zig's std.fs?

bun.sys provides better cross-platform support with libuv fallbacks on Windows, automatic handling of EINTR (interrupted) calls, and significantly more detailed error information including the syscall tag and file path.

Can I use bun.sys for network programming?

While bun.sys has limited socket support, it is recommended to use uws.Socket (libuwebsockets) for non-blocking network I/O and only use bun.sys for pipes or blocking operations.

Zig Bun System Calls

Name: Zig Bun System Calls
Author: zhcndoc

byzhcndoc

Developer Tools

Guides the implementation of high-performance, cross-platform system calls and file I/O using Bun's specialized Zig API.

About

This skill provides specialized guidance for developers using the bun.sys layer in Zig to perform system operations. It helps transition from standard Zig library calls (std.fs or std.posix) to Bun's internal abstractions, which offer superior cross-platform compatibility via libuv, automatic EINTR retry logic, and enriched error metadata. It covers the bun.sys.File wrapper, directory iteration, and path operations, ensuring that file operations are resilient and provide detailed context for debugging and error handling.

Key Features

Detailed error handling patterns using the Maybe(T) tagged union for syscall metadata.
Optimized directory iteration and path management patterns.
Implementation of the bun.sys.File wrapper for robust cross-platform file operations.
0 GitHub stars
Automatic EINTR retry handling for reliable low-level system communication.
Normalized cross-platform file flags using the bun.O namespace.

Use Cases

Implementing low-level system logic that requires detailed errno and syscall context.
Refactoring standard Zig code to use Bun's cross-platform system call wrappers.
Developing high-performance file system utilities within the Bun ecosystem.

About

Key Features

Detailed error handling patterns using the Maybe(T) tagged union for syscall metadata.
Optimized directory iteration and path management patterns.
Implementation of the bun.sys.File wrapper for robust cross-platform file operations.
0 GitHub stars
Automatic EINTR retry handling for reliable low-level system communication.
Normalized cross-platform file flags using the bun.O namespace.

Use Cases

Implementing low-level system logic that requires detailed errno and syscall context.
Refactoring standard Zig code to use Bun's cross-platform system call wrappers.
Developing high-performance file system utilities within the Bun ecosystem.