1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
# Changelog
Notable changes to this crate will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## Unreleased - YYYY-MM-DD
## 0.3.0 - 2025-04-19
### Added
- Allow `Queue::exec_sync` on workloops.
This is discouraged for performance reasons, but doesn't need to be
outright disallowed.
- Added `DispatchRetained<T>`, which is a smart pointer which allows
retain/release operations on dispatch objects, similar in spirit to
`objc2::rc::Retained`. This mostly replaces `DispatchObject<T>`.
- Implement `Send` and `Sync` for dispatch objects.
- Added `DispatchData` helper functions.
### Changed
- Changed how memory management works to match other `objc2` crates. Instead
of types like `DispatchGroup` holding the retain count internally, it is now
done externally by `DispatchRetained<DispatchGroup>`.
- Converted `DispatchObject` to a trait.
- **BREAKING**: Renamed dispatch types to be prefixed with `Dispatch`
(e.g. `DispatchGroup`, `DispatchQueue` and `DispatchOnce`).
Some of the old names are kept (but deprecated) for easier migration.
- Handle memory management in `ffi` module automatically.
- Merged some high-level binding types with their `ffi` "_t"/"_s" counterparts.
E.g. `dispatch_group_t`, `dispatch_group_s` and `DispatchGroup` are now one
type.
- Move some functions to methods on the relevant Dispatch type.
### Removed
- **BREAKING**: Removed `TargetQueueError` and the error case in
`DispatchObject::set_target_queue` (it now instead aborts on error,
as that's what the underlying function does).
- Removed `ffi` methods that are actually macros:
- `dispatch_wait`
- `dispatch_notify`
- `dispatch_cancel`
- `dispatch_testcancel`
Using these would have resulted in a linker error before.
* **BREAKING**: Removed direct access to most modules. Instead, types are
publicly exported in the root.
## 0.2.0 - 2025-01-22
### Added
- Added support for `objc2` encodings.
- Added initial support for `block2`.
- Autogenerated `ffi` bindings, which adds:
- `dispatch_data_applier_t`.
- `dispatch_fd_t`.
- `dispatch_io_close_flags_t`.
- `dispatch_io_handler_t`.
- `dispatch_io_interval_flags_t`.
- `dispatch_io_s` / `dispatch_io_t`.
- `dispatch_io_type_t`.
- `DISPATCH_WALLTIME_NOW`.
- `_dispatch_source_type_mach_recv`.
- `_dispatch_source_type_proc`.
- `_dispatch_source_type_signal`.
- `_dispatch_source_type_vnode`.
- `dispatch_allow_send_signals`.
- `dispatch_apply`.
- `dispatch_cancel`.
- `dispatch_data_apply`.
- `dispatch_get_current_queueDeprecated`.
- `dispatch_get_main_queue`.
- `dispatch_io_barrier`.
- `dispatch_io_close`.
- `dispatch_io_create`.
- `dispatch_io_create_with_io`.
- `dispatch_io_create_with_path`.
- `dispatch_io_get_descriptor`.
- `dispatch_io_read`.
- `dispatch_io_set_high_water`.
- `dispatch_io_set_interval`.
- `dispatch_io_set_low_water`.
- `dispatch_io_write`.
- `dispatch_notify`.
- `dispatch_read`.
- `dispatch_testcancel`.
- `dispatch_wait`.
- `dispatch_write`.
- Added `#[must_use]` in bindings where the source uses it.
- Added `Queue::main` for fetching the main queue.
- Moved `run_on_main` and `MainThreadBound` from `objc2-foundation` to this
crate.
- Added `Once`, a wrapper over `dispatch_once_f` which works similarly to
`std::sync::Once`.
- Added `#![no_std]` support
### Changed
- Moved to the `objc2` project.
- **BREAKING**: Made `Queue::set_specific` take a key pointer instead of a `usize`.
### Fixed
- **BREAKING**: Use `extern "C-unwind"` instead of `extern "C"` in certain functions that required that.
- **BREAKING**: Use `isize` instead of `usize` in certain functions where that is more correct.
- **BREAKING**: An `F: 'static` bound was added to the following methods to make
sure any referenced values passed to them are borrowed for long
enough since they perform their `work` asynchronously (#689):
- `Group::exec_async`
- `Queue::exec_async`
- `Queue::barrier_async`
- `Queue::barrier_async_and_wait`
## 0.1.0 - 2022-10-02
Initial version.
|
