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

0•

開発者ツール

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

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.

主な機能

01Detailed error handling patterns using the Maybe(T) tagged union for syscall metadata.

02Optimized directory iteration and path management patterns.

03Implementation of the bun.sys.File wrapper for robust cross-platform file operations.

040 GitHub stars

05Automatic EINTR retry handling for reliable low-level system communication.

06Normalized cross-platform file flags using the bun.O namespace.

ユースケース

01Implementing low-level system logic that requires detailed errno and syscall context.

02Refactoring standard Zig code to use Bun's cross-platform system call wrappers.

03Developing high-performance file system utilities within the Bun ecosystem.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zhcndoc/bun zig-system-calls

For use in Claude.ai and ChatGPT

Download Skill