Debian Codegraph @

Lib/_pyrepl/_minimal_curses.py

raw
1 """Minimal '_curses' module, the low-level interface for curses module
2 which is not meant to be used directly.
3
4 Based on ctypes. It's too incomplete to be really called '_curses', so
5 to use it, you have to import it and stick it in sys.modules['_curses']
6 manually.
7
8 Note that there is also a built-in module _minimal_curses which will
9 hide this one if compiled in.
10 """
11
12 import ctypes
13 import ctypes.util
14
15
16 class error(Exception):
17 pass
18
19
20 def _find_clib() -> str:
21 trylibs = ["ncursesw", "ncurses", "curses"]
22
23 for lib in trylibs:
24 path = ctypes.util.find_library(lib)
25 if path:
26 return path
27 raise ModuleNotFoundError("curses library not found", name="_pyrepl._minimal_curses")
28
29
30 _clibpath = _find_clib()
31 clib = ctypes.cdll.LoadLibrary(_clibpath)
32
33 clib.setupterm.argtypes = [ctypes.c_char_p, ctypes.c_int, ctypes.POINTER(ctypes.c_int)]
34 clib.setupterm.restype = ctypes.c_int
35
36 clib.tigetstr.argtypes = [ctypes.c_char_p]
37 clib.tigetstr.restype = ctypes.c_ssize_t
38
39 clib.tparm.argtypes = [ctypes.c_char_p] + 9 * [ctypes.c_int] # type: ignore[operator]
40 clib.tparm.restype = ctypes.c_char_p
41
42 OK = 0
43 ERR = -1
44
45 # ____________________________________________________________
46
47
48 def setupterm(termstr, fd):
49 err = ctypes.c_int(0)
50 result = clib.setupterm(termstr, fd, ctypes.byref(err))
51 if result == ERR:
52 raise error("setupterm() failed (err=%d)" % err.value)
53
54
55 def tigetstr(cap):
56 if not isinstance(cap, bytes):
57 cap = cap.encode("ascii")
58 result = clib.tigetstr(cap)
59 if result == ERR:
60 return None
61 return ctypes.cast(result, ctypes.c_char_p).value
62
63
64 def tparm(str, i1=0, i2=0, i3=0, i4=0, i5=0, i6=0, i7=0, i8=0, i9=0):
65 result = clib.tparm(str, i1, i2, i3, i4, i5, i6, i7, i8, i9)
66 if result is None:
67 raise error("tparm() returned NULL")
68 return result