Crate dispatchr

dispatchr

Drew’s Rust bindings for libdispatch, a.k.a. GCD. This is an alternative to the dispatch crate.

This crate is part of the objr expanded universe universe which provide low-level, zero-cost Rust abstractions for Apple platform features that mimic code from first-party compilers. Distinctive features of this library include:

• Leverages blocksr technology for fast, low-overhead, static compile-time optimizations of dispatch calls.
• Exposes a rich set of datatypes for dispatch_data, including managed, unmanaged, contiguous, and zero-copy-bridged flavors of data
• Binds dispatch_read/write, the defacto API for nonblocking IO on macOS.
  • Notably, the rest of the Rust ecosystem uses some cross-platform API to cover macOS, like poll or kevent. These lack various features and optimizations of the preferred API.
  • In general, Apple implements the cross-platform APIs with about as much care as the developers using them to port cross-platform apps: not enough.
• Binds QoS, which is the solution for task priority and responsive GUI apps on macOS

Status

dispatchr covers large but incomplete portions of the libdispatch API.

• global queues, dispatch_sync
• qos
• popular portions of io: dispatch_read, dispatch_write, dispatch_io_create_with_path
• data
• semaphore
• source (timers only)

Re-exports

pub use qos::QoS;

Modules

block_impl

https://clang.llvm.org/docs/Block-ABI-Apple.html#high-level

data

Maps dispatch_data_t to Rust types.

external_data

Collection of types that allow bridging external memory into dispatch data.

io

<dispatch/io.h>

qos

queue

<dispatch/queue.h>

semaphore

source

time