Issue #20311: selectors: Add a resolution attribute to BaseSelector.

2 files changed, 27 insertions, 1 deletions

diff --git a/Lib/selectors.py b/Lib/selectors.py
index cd8b29e..b1b530a 100644
--- a/Lib/selectors.py
+++ b/Lib/selectors.py
@@ -5,7 +5,7 @@ This module allows high-level and efficient I/O multiplexing, built upon the
 """
 
 
-from abc import ABCMeta, abstractmethod
+from abc import ABCMeta, abstractmethod, abstractproperty
 from collections import namedtuple, Mapping
 import functools
 import select
@@ -82,6 +82,11 @@ class BaseSelector(metaclass=ABCMeta):
     performant implementation on the current platform.
     """
 
+    @abstractproperty
+    def resolution(self):
+        """Resolution of the selector in seconds"""
+        return None
+
     @abstractmethod
     def register(self, fileobj, events, data=None):
         """Register a file object.
@@ -283,6 +288,10 @@ class SelectSelector(_BaseSelectorImpl):
         self._readers = set()
         self._writers = set()
 
+    @property
+    def resolution(self):
+        return 1e-6
+
     def register(self, fileobj, events, data=None):
         key = super().register(fileobj, events, data)
         if events & EVENT_READ:
@@ -335,6 +344,10 @@ if hasattr(select, 'poll'):
             super().__init__()
             self._poll = select.poll()
 
+        @property
+        def resolution(self):
+            return 1e-3
+
         def register(self, fileobj, events, data=None):
             key = super().register(fileobj, events, data)
             poll_events = 0
@@ -385,6 +398,10 @@ if hasattr(select, 'epoll'):
             super().__init__()
             self._epoll = select.epoll()
 
+        @property
+        def resolution(self):
+            return 1e-3
+
         def fileno(self):
             return self._epoll.fileno()
 
@@ -445,6 +462,10 @@ if hasattr(select, 'kqueue'):
             super().__init__()
             self._kqueue = select.kqueue()
 
+        @property
+        def resolution(self):
+            return 1e-9
+
         def fileno(self):
             return self._kqueue.fileno()
 
diff --git a/Lib/test/test_selectors.py b/Lib/test/test_selectors.py
index 5292904..f7e84b7 100644
--- a/Lib/test/test_selectors.py
+++ b/Lib/test/test_selectors.py
@@ -363,6 +363,11 @@ class BaseSelectorTestCase(unittest.TestCase):
         self.assertFalse(s.select(2))
         self.assertLess(time() - t, 2.5)
 
+    def test_resolution(self):
+        s = self.SELECTOR()
+        self.assertIsInstance(s.resolution, (int, float))
+        self.assertGreater(s.resolution, 0.0)
+
 
 class ScalableSelectorMixIn: