Vendor things

third-party/vendor/calloop/CHANGELOG.md

@@ -0,0 +1,260 @@
+# Change Log
+
+## Unreleased
+
+## 0.10.4 -- 2022-12-05
+
+#### Bugfixes
+
+- Fixed a crash due to double borrow when handling pre/post run hooks
+
+## 0.10.2 -- 2022-11-08
+
+#### Bugfixes
+
+- The return value of `LoopHandle::insert_idle` no longer borrows the `LoopHandle`.
+
+## 0.10.1 -- 2022-06-20
+
+#### Additions
+
+- The `Channel` now has proxy methods for `Receiver::recv` and `Receiver::try_recv`
+- Enable support for `target_os = "android"`
+
+## 0.10.0 -- 2022-05-06
+
+- **Breaking:** Calloop's internal storage is now backed by a `slotmap`. As a result the
+  `RegistrationToken` is now `Copy+Clone`, and the low-level registration API of `Poll` is
+  altered in a breaking way. MSRV is bumped to 1.49.
+- **Breaking:** `generic::Fd` adapter is removed, as since that rust version `RawFd` implements
+  `AsRawFd`, allowing it to be used directly in `Generic`.
+- **Breaking:** The `EventSource` trait has a new associated type `Error`. This determines the type
+  of the error variant returned by `EventSource::process_events()`. It must be convertible into
+  `Box<dyn std::error::Error + Sync + Send>`.
+- **Breaking:** All library-provided event sources now have their own error types for the
+  associated `Error` type on the `EventSource` trait.
+- **Breaking:** Many API functions now use Calloop's own error type (`calloop::Error`) instead of
+  `std::io::Error` as the error variants of their returned results.
+- **Breaking:** The `Timer` event source has been completely reworked and is now directly driven by
+  calloop polling mechanism instead of a background thread. Timer multiplexing is now handled by
+  creating multiple `Timer`s, and self-repeating timers is handled by the return value of the
+  associated event callback.
+- **Breaking:** The minimum supported Rust version is now 1.53.0
+- Introduce `EventLoop::try_new_high_precision()` for sub-millisecond accuracy in the event loop
+- The `PingSource` event source now uses an `eventfd` instead of a pipe on Linux.
+
+## 0.9.2 -- 2021-12-27
+
+#### Additions
+
+- Introduce the methods `pre_run()` and `post_run()` to `EventSource`, allowing event sources
+  to do preparations before entering a run/dispatch session, and cleanup afterwards. They have default
+  implementations doing nothing.
+
+## 0.9.1 -- 2021-08-10
+
+- Update `nix` dependency to 0.22
+
+## 0.9.0 -- 2021-06-29
+
+#### Breaking changes
+
+- MSRV is now 1.41
+- The `futures` module now has a proper error type for `Scheduler::schedule()`
+- The return type of `EventSource::process_events()` is now `io::Result<PostAction>` allowing
+  the sources to directly request the event loop to reregister/disable/destroy them.
+- The `Token` creation mechanism is now driven by a `TokenFactory`, that
+  dynamically generates new unique token for sub-sources. Following for this
+  if you create a new event source that is not built by composing the ones
+  provided by calloop, you need to check if the `Token` provided to
+  `process_events` is the same as the one you created when (re)registering
+  your source. If you delegate `process_events` to a sub-source, you no longer
+  need to check the `sub_id` before, instead the source you are delegating to
+  is responsible to to this check.
+
+#### Bugfixes
+
+- Cancelling a timeout no longer prevents later timeouts from firing.
+
+## 0.8.0 -- 2021-05-30
+
+#### Breaking changes
+
+- The `Dispatcher` type no longer has the closure type within its type parameters,
+  but instead now has an explicit lifetime parameter, as well as the source type `S`
+  and the event loop `Data` type. This allows the type to be explicitly named and
+  stored into an other struct.
+
+#### Additions
+
+- `Token` now has a method `with_sub_id()` that returns a copy of the token
+  but with the given `sub_id`.
+
+## 0.7.2 -- 2021-02-09
+
+#### Changes
+
+- `EventLoop::run()` now accepts `Into<Option<Duration>>`, like `EventLoop::dispatch()`
+
+#### Bugfixes
+
+- The `Ping` event source now automatically disables itself when its sending end is
+  dropped, preventing to always be considered readable (which caused a busy-loop).
+  This also fixes a similar behavior of `Executor` and `Channel`, which use `Ping`
+  internally.
+
+## 0.7.0 -- 2020-10-13
+
+#### Breaking Changes
+
+- The return type for `LoopHandle::insert_source` was renamed as
+  `RegistrationToken` and can be used in `{enable,disable,update,remove,kill}`
+  just like before.
+- Allow non-`'static` event sources and callbacks, so they can hold references
+  to other values.
+  - `LoopHandle::with_source` was removed. To achieve the same behaviour, use a
+    `Dispatcher` and register it via the `LoopHandle::register_dispatcher`. The
+    `EventSource` will be available using `Dispatcher::as_source_{ref,mut}`.
+  - `LoopHandle::remove` doesn't return the event source any more. To achieve
+    the same behaviour, use a `Dispatcher` and register it via the
+    `LoopHandle::register_dispatcher`. After removing the `EventSource` with
+    `LoopHandle::remove`, you will be able to call
+    `Dispatcher::into_source_inner` to get ownership of the `EventSource`.
+  - `LoopHandle::register_dispatcher` can be used in place of
+    `LoopHandle::insert_source` when the source needs to be accessed after
+    its insertion in the loop.
+- `Interest` is changed into a struct to allow empty interest queries
+
+#### Additions
+
+- Introduce a futures executor as a new event source, behind the `executor` cargo
+  feature.
+- Introduce the `LoopHandle::adapt_io` method for creating `Async<F>` adapters to
+  adapt IO objects for async use, powered by the event loop.
+
+## 0.6.5 -- 2020-10-07
+
+#### Fixes
+
+- Channel now signals readinnes after the event has actually been sent, fixing a race
+  condition where the event loop would try to read the message before it has been
+  written.
+
+## 0.6.4 -- 2020-08-30
+
+#### Fixes
+
+- Fix double borrow during dispatch when some event source is getting removed
+
+## 0.6.3 -- 2020-08-27
+
+#### Aditions
+
+- Add support for `openbsd`, `netbsd`, and `dragonfly`.
+- `InsertError<E>` now implements `std::error::Error`.
+
+#### Changes
+
+- Allow non-`'static` dispatch `Data`. `Data` is passed as an argument to the
+  `callback`s while dispatching. This change allows defining `Data` types which
+  can hold references to other values.
+- `dispatch` now will retry on `EINTR`.
+
+## 0.6.2 -- 2020-04-23
+
+- Update the README and keywords for crates.io
+
+## 0.6.1 -- 2020-04-22
+
+- Introduce `LoopHandle::kill` to allow dropping a source from within its callback
+
+## 0.6.0 -- 2020-04-22
+
+- Drop the `mio` dependency
+- **Breaking Change**: Significantly rework the `calloop` API, notably:
+  - Event sources are now owned by the `EventLoop`
+  - Users can now again set the polling mode (Level/Edge/OneShot)
+- Introduce the `Ping` event source
+
+## 0.5.2 -- 2020-04-14
+
+- `channel::Channel` is now `Send`, allowing you to create a channel in one thread and sending
+  its receiving end to an other thread for event loop insertion.
+
+## 0.5.1 -- 2020-03-14
+
+- Update `mio` to `0.7`
+
+## 0.5.0 -- 2020-02-07
+
+- Update to 2018 edition
+- Update `nix` dependency to `0.17`
+- **Breaking** Update `mio` dependency to `0.7.0-alpha.1`. The API of `calloop` for custom
+  event sources significantly changed, and the channel and timer event sources are now
+  implemented in `calloop` rather than pulled from `mio-extras`.
+
+## 0.4.4 -- 2019-06-13
+
+- Update `nix` dependency to `0.14`
+
+## 0.4.3 -- 2019-02-17
+
+- Update `mio` dependency
+- Update `nix` dependency
+
+## 0.4.2 -- 2018-11-15
+
+- Implement `Debug` for `InsertError`.
+
+## 0.4.1 -- 2018-11-14
+
+- Disable the `sources::signal` module on FreeBSD so that the library can be built on this
+  platform.
+
+## 0.4.0 -- 2018-11-04
+
+- **Breaking** Use `mio-extras` instead of `mio-more` which is not maintained.
+- **Breaking** Reexport `mio` rather than selectively re-exporting some of its types.
+- Add methods to `Generic` to retrive the inner `Rc` and construct it from an `Rc`
+- **Breaking** `LoopHandle::insert_source` now allows to retrieve the source on error.
+
+## 0.3.2 -- 2018-09-25
+
+- Fix the contents of `EventedRawFd` which was erroneously not public.
+
+## 0.3.1 -- 2018-09-25
+
+- introduce `EventedRawFd` as a special case for the `Generic` event source, for when
+  you really have to manipulate raw fds
+- Don't panic when the removal of an event source trigger the removal of an other one
+
+## 0.3.0 -- 2018-09-10
+
+- Fixed a bug where inserting an event source from within a callback caused a panic.
+- **[breaking]** Erase the `Data` type parameter from `Source` and `Idle`, for
+  improved ergonomics.
+
+## 0.2.2 -- 2018-09-10
+
+- Introduce an `EventLoop::run` method, as well as the `LoopSignal` handle allowing to
+  wakeup or stop the event loop from anywhere.
+
+## 0.2.1 -- 2018-09-01
+
+- Use `FnOnce` for insertion in idle callbacks.
+
+## 0.2.0 -- 2018-08-30
+
+- **[breaking]** Add a `&mut shared_data` argument to `EventLoop::dispatch(..)` to share data
+  between callbacks.
+
+## 0.1.1 -- 2018-08-29
+
+- `Generic` event source for wrapping arbitrary `Evented` types
+- timer event sources
+- UNIX signal event sources
+- channel event sources
+
+## 0.1.0 -- 2018-08-24
+
+Initial release