winpoll 0.20294.0

Implementation of `select.poll` on Microsoft Windows.

Implementation of select.poll on Microsoft Windows.

• Pure Python; no C extensions (uses ctypes.windll.Ws2_32)
• Drop-in-compatible API
• Clean "ponyfill"; no monkeypatching
• No dependencies (besides Windows Vista or newer)
• Python 3.6+ compatible

Usage

try:
    from select import (
        POLLIN, POLLOUT, POLLERR, POLLHUP, POLLNVAL,
        poll
    )

except ImportError:
    # https://github.com/python/cpython/issues/60711
    from winpoll import (
        POLLIN, POLLOUT, POLLERR, POLLHUP, POLLNVAL,
        wsapoll as poll
    )

p = poll()

p.register(sock1, POLLIN)
p.register(sock2, POLLIN | POLLOUT)
p.unregister(sock1)

for sock, events in p.poll(timeout=3):
    print(f"Socket {sock} is ready with {events}")

Like select.poll, winpoll.wsapoll objects acquire no special resources, thus have no cleanup requirement (besides plain garbage collection).

Limitations / Bugs

• Does not work before Windows Vista.

  • Last affected OS EOL: April 8, 2014

• Outbound TCP connections don't correctly report failure-to-connect ((POLLHUP | POLLERR | POLLWRNORM)) before Windows 10 Version 2004 (OS build 19041).

  • Last affected OS EOL: May 10, 2022

Installation

Command-line

pip install "winpoll ; sys_platform == 'win32'"

requirements.txt

winpoll ; sys_platform == 'win32'

pyproject.toml

[project]
dependencies = [
  ...,
  "winpoll ; sys_platform == 'win32'",
]