Neovim Adds Native Structured Concurrency Library 'vim.async'

Native Structured Concurrency Introduced

Neovim has integrated 'vim.async' into its Lua standard library, providing a native structured concurrency framework. This library aims to standardize how asynchronous operations are handled within Neovim, ensuring that the editor's primary event loop remains unblocked during these processes. The model draws inspiration from established structured concurrency principles.

Addressing Historical Asynchronous Challenges

Previously, Neovim plugins relied on various methods for asynchronous tasks, including Libuv bindings via vim.uv or external libraries. These approaches often led to complex callback structures or inconsistent coroutine implementations. The introduction of 'vim.async' directly addresses these long-standing issues by providing core concurrency primitives, improving task lifecycle management, cancellation propagation, and error handling.

Cooperative Scheduling and Task Management

Asynchronous routines in 'vim.async' run as Tasks, scheduled cooperatively using stackful coroutines. When a task awaits an event or I/O, its execution is suspended, returning control to the event loop. This mechanism ensures that synchronous editor operations and user input remain uninterrupted. The framework also enforces parent-child relationships, where child tasks are scoped to their parent, and unhandled exceptions in children propagate to the parent, triggering cancellation.

Synchronization and Flow Control Primitives

The 'vim.async' library includes several primitives for synchronization and flow control, mirroring modern concurrency runtimes. These include 'vim.async.semaphore()' for limiting concurrent executions, 'vim.async.timeout()' for setting cancellation deadlines, and 'vim.async.iter()' for processing task results in completion order. For error handling without invalidating the caller, 'vim.async.pawait()' provides an asynchronous alternative.