a10 0.4.2

This library is meant as a low-level library safely exposing different OS's abilities to perform non-blocking I/O.
Documentation
use std::io;
use std::task::{self, Poll};

use crate::SubmissionQueue;
use crate::kqueue::fd::OpKind;
use crate::kqueue::op::{Evented, State};
use crate::poll::PollableState;

pub(crate) struct PollableOp;

impl crate::op::Iter for PollableOp {
    type Output = io::Result<()>;
    type Resources = PollableState;
    type Args = ();
    type State = State<Evented, Self::Resources, Self::Args>;

    fn poll_next(
        state: &mut Self::State,
        ctx: &mut task::Context<'_>,
        sq: &SubmissionQueue,
    ) -> Poll<Option<Self::Output>> {
        const OP: OpKind = OpKind::Read;

        match &mut state.status {
            Evented::NotStarted | Evented::ToSubmit => {
                // SAFETY: status is not Complete so it's safe to access the resources.
                let resources = unsafe { state.resources.assume_init_ref() };
                // Add ourselves to the waiters for the operation.
                let fd_state = &resources.state;
                let needs_register = {
                    let mut fd_state = fd_state.lock();
                    let needs_register = !fd_state.has_waiting_op(OP);
                    fd_state.add(OP, ctx.waker().clone());
                    needs_register
                }; // Unlock fd state.

                // If we're to first we need to register an event with the
                // kernel.
                if needs_register {
                    sq.submissions().add(|event| {
                        event.0.filter = libc::EVFILT_READ;
                        event.0.ident = resources.sq.submissions().fd().cast_unsigned() as _;
                        event.0.udata = fd_state.as_udata();
                    });
                }

                // Set ourselves to waiting for an event from the kernel.
                state.status = Evented::Waiting;
                // We've added our waker above to the list, we'll be woken up
                // once we can make progress.
                Poll::Pending
            }
            Evented::Waiting => {
                // SAFETY: status is not Complete so it's safe to access the resources.
                let resources = unsafe { state.resources.assume_init_ref() };
                if resources.state.lock().has_waiting_op(OP) {
                    // Polled before we got an event.
                    Poll::Pending
                } else {
                    // Return Ok and reset the state to wait for another event.
                    state.status = Evented::ToSubmit;
                    Poll::Ready(Some(Ok(())))
                }
            }
            Evented::Complete => Poll::Ready(None),
        }
    }
}