summaryrefslogtreecommitdiff
path: root/typings/serial/tools/list_ports.pyi
diff options
context:
space:
mode:
Diffstat (limited to 'typings/serial/tools/list_ports.pyi')
-rw-r--r--typings/serial/tools/list_ports.pyi16
1 files changed, 16 insertions, 0 deletions
diff --git a/typings/serial/tools/list_ports.pyi b/typings/serial/tools/list_ports.pyi
new file mode 100644
index 0000000..67df6f6
--- /dev/null
+++ b/typings/serial/tools/list_ports.pyi
@@ -0,0 +1,16 @@
+"""\
+This module will provide a function called comports that returns an
+iterable (generator or list) that will enumerate available com ports. Note that
+on some systems non-existent ports may be listed.
+
+Additionally a grep function is supplied that can be used to search for ports
+based on their descriptions or hardware ID.
+"""
+from typing import Any, List, Optional
+
+from list_ports_common import ListPortInfo
+
+
+def comports(include_links: Optional[Any] = ...) -> List[ListPortInfo]:
+ """Return a list of info objects about serial ports"""
+ ...