Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
asyncio	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
collections	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
concurrent	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
config-3.12-x86_64-linux-gnu	[ DIR ]	drwxr-xr-x	2025-08-15 19:32
ctypes	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
curses	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
dbm	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
email	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
encodings	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
ensurepip	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
html	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
http	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
importlib	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
json	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
lib-dynload	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
lib2to3	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
logging	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
multiprocessing	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
pydoc_data	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
re	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
site-packages	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
sqlite3	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
tomllib	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
unittest	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
urllib	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
venv	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
wsgiref	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
xml	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
xmlrpc	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
zipfile	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
zoneinfo	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
LICENSE.txt	13.61 KB	-rw-r--r--	2025-06-03 15:41
__future__.py	5.1 KB	-rw-r--r--	2025-06-23 14:37
__hello__.py	227 B	-rw-r--r--	2025-06-23 14:37
_aix_support.py	3.93 KB	-rw-r--r--	2025-06-23 14:37
_collections_abc.py	31.34 KB	-rw-r--r--	2025-06-23 14:36
_compat_pickle.py	8.56 KB	-rw-r--r--	2025-06-23 14:37
_compression.py	5.55 KB	-rw-r--r--	2025-06-23 14:36
_markupbase.py	14.31 KB	-rw-r--r--	2025-06-23 14:36
_osx_support.py	21.51 KB	-rw-r--r--	2025-06-23 14:37
_py_abc.py	6.04 KB	-rw-r--r--	2025-06-23 14:37
_pydatetime.py	89.93 KB	-rw-r--r--	2025-06-23 14:37
_pydecimal.py	221.96 KB	-rw-r--r--	2025-06-23 14:36
_pyio.py	91.4 KB	-rw-r--r--	2025-06-23 14:36
_pylong.py	10.54 KB	-rw-r--r--	2025-06-23 14:36
_sitebuiltins.py	3.05 KB	-rw-r--r--	2025-06-23 14:36
_strptime.py	27.73 KB	-rw-r--r--	2025-06-23 14:37
_sysconfigdata__linux_x86_64-linux-gnu.py	75.67 KB	-rw-r--r--	2025-06-23 14:49
_sysconfigdata_d_linux_x86_64-linux-gnu.py	75.67 KB	-rw-r--r--	2025-06-23 14:39
_threading_local.py	7.05 KB	-rw-r--r--	2025-06-23 14:36
_weakrefset.py	5.75 KB	-rw-r--r--	2025-06-23 14:36
abc.py	6.38 KB	-rw-r--r--	2025-06-23 14:36
aifc.py	33.41 KB	-rw-r--r--	2025-06-23 14:37
antigravity.py	500 B	-rw-r--r--	2025-06-23 14:36
argparse.py	98.78 KB	-rw-r--r--	2025-06-23 14:37
ast.py	62.94 KB	-rw-r--r--	2025-06-23 14:37
base64.py	20.16 KB	-rwxr-xr-x	2025-06-23 14:36
bdb.py	32.79 KB	-rw-r--r--	2025-06-23 14:37
bisect.py	3.34 KB	-rw-r--r--	2025-06-23 14:36
bz2.py	11.57 KB	-rw-r--r--	2025-06-23 14:37
cProfile.py	6.42 KB	-rwxr-xr-x	2025-06-23 14:36
calendar.py	25.26 KB	-rw-r--r--	2025-06-23 14:37
cgi.py	33.63 KB	-rwxr-xr-x	2025-06-23 14:37
cgitb.py	12.13 KB	-rw-r--r--	2025-06-23 14:37
chunk.py	5.37 KB	-rw-r--r--	2025-06-23 14:36
cmd.py	14.52 KB	-rw-r--r--	2025-06-23 14:36
code.py	10.71 KB	-rw-r--r--	2025-06-23 14:36
codecs.py	36.01 KB	-rw-r--r--	2025-06-23 14:36
codeop.py	5.77 KB	-rw-r--r--	2025-06-23 14:36
colorsys.py	3.97 KB	-rw-r--r--	2025-06-23 14:36
compileall.py	20.03 KB	-rw-r--r--	2025-06-23 14:36
configparser.py	52.53 KB	-rw-r--r--	2025-06-23 14:36
contextlib.py	26.99 KB	-rw-r--r--	2025-06-23 14:36
contextvars.py	129 B	-rw-r--r--	2025-06-23 14:37
copy.py	8.21 KB	-rw-r--r--	2025-06-23 14:36
copyreg.py	7.44 KB	-rw-r--r--	2025-06-23 14:37
crypt.py	3.82 KB	-rw-r--r--	2025-06-23 14:36
csv.py	16 KB	-rw-r--r--	2025-06-23 14:36
dataclasses.py	60.63 KB	-rw-r--r--	2025-06-23 14:37
datetime.py	268 B	-rw-r--r--	2025-06-23 14:37
decimal.py	2.74 KB	-rw-r--r--	2025-06-23 14:37
difflib.py	81.41 KB	-rw-r--r--	2025-06-23 14:36
dis.py	29.52 KB	-rw-r--r--	2025-06-23 14:36
doctest.py	104.25 KB	-rw-r--r--	2025-06-23 14:36
enum.py	79.63 KB	-rw-r--r--	2025-06-23 14:36
filecmp.py	10.14 KB	-rw-r--r--	2025-06-23 14:36
fileinput.py	15.35 KB	-rw-r--r--	2025-06-23 14:36
fnmatch.py	5.86 KB	-rw-r--r--	2025-06-23 14:36
fractions.py	37.25 KB	-rw-r--r--	2025-06-23 14:36
ftplib.py	33.92 KB	-rw-r--r--	2025-06-23 14:36
functools.py	37.05 KB	-rw-r--r--	2025-06-23 14:37
genericpath.py	5.44 KB	-rw-r--r--	2025-06-23 14:37
getopt.py	7.31 KB	-rw-r--r--	2025-06-23 14:37
getpass.py	5.85 KB	-rw-r--r--	2025-06-23 14:36
gettext.py	20.82 KB	-rw-r--r--	2025-06-23 14:37
glob.py	8.53 KB	-rw-r--r--	2025-06-23 14:36
graphlib.py	9.42 KB	-rw-r--r--	2025-06-23 14:36
gzip.py	24.81 KB	-rw-r--r--	2025-06-23 14:37
hashlib.py	9.13 KB	-rw-r--r--	2025-06-23 14:37
heapq.py	22.48 KB	-rw-r--r--	2025-06-23 14:36
hmac.py	7.54 KB	-rw-r--r--	2025-06-23 14:36
imaplib.py	52.77 KB	-rw-r--r--	2025-06-23 14:37
imghdr.py	4.29 KB	-rw-r--r--	2025-06-23 14:37
inspect.py	124.15 KB	-rw-r--r--	2025-06-23 14:37
io.py	3.5 KB	-rw-r--r--	2025-06-23 14:36
ipaddress.py	79.51 KB	-rw-r--r--	2025-06-23 14:37
keyword.py	1.05 KB	-rw-r--r--	2025-06-23 14:37
linecache.py	5.66 KB	-rw-r--r--	2025-06-23 14:36
locale.py	76.76 KB	-rw-r--r--	2025-06-23 14:37
lzma.py	12.97 KB	-rw-r--r--	2025-06-23 14:37
mailbox.py	77.06 KB	-rw-r--r--	2025-06-23 14:37
mailcap.py	9.11 KB	-rw-r--r--	2025-06-23 14:36
mimetypes.py	22.5 KB	-rw-r--r--	2025-06-23 14:37
modulefinder.py	23.14 KB	-rw-r--r--	2025-06-23 14:36
netrc.py	6.76 KB	-rw-r--r--	2025-06-23 14:36
nntplib.py	40.12 KB	-rw-r--r--	2025-06-23 14:36
ntpath.py	31.57 KB	-rw-r--r--	2025-06-23 14:36
nturl2path.py	2.32 KB	-rw-r--r--	2025-06-23 14:37
numbers.py	11.2 KB	-rw-r--r--	2025-06-23 14:37
opcode.py	12.87 KB	-rw-r--r--	2025-06-23 14:37
operator.py	10.71 KB	-rw-r--r--	2025-06-23 14:37
optparse.py	58.95 KB	-rw-r--r--	2025-06-23 14:37
os.py	39.86 KB	-rw-r--r--	2025-06-23 14:36
pathlib.py	49.86 KB	-rw-r--r--	2025-06-23 14:37
pdb.py	68.66 KB	-rwxr-xr-x	2025-06-23 14:36
pickle.py	65.34 KB	-rw-r--r--	2025-06-23 14:36
pickletools.py	91.85 KB	-rw-r--r--	2025-06-23 14:36
pipes.py	8.77 KB	-rw-r--r--	2025-06-23 14:37
pkgutil.py	17.85 KB	-rw-r--r--	2025-06-23 14:36
platform.py	42.38 KB	-rwxr-xr-x	2025-06-23 14:36
plistlib.py	27.68 KB	-rw-r--r--	2025-06-23 14:36
poplib.py	14.28 KB	-rw-r--r--	2025-06-23 14:36
posixpath.py	17.07 KB	-rw-r--r--	2025-06-23 14:36
pprint.py	23.59 KB	-rw-r--r--	2025-06-23 14:36
profile.py	22.56 KB	-rwxr-xr-x	2025-06-23 14:36
pstats.py	28.6 KB	-rw-r--r--	2025-06-23 14:36
pty.py	5.99 KB	-rw-r--r--	2025-06-23 14:36
py_compile.py	7.65 KB	-rw-r--r--	2025-06-23 14:37
pyclbr.py	11.13 KB	-rw-r--r--	2025-06-23 14:36
pydoc.py	110.86 KB	-rwxr-xr-x	2025-06-23 14:36
queue.py	11.23 KB	-rw-r--r--	2025-06-23 14:37
quopri.py	7.03 KB	-rwxr-xr-x	2025-06-23 14:37
random.py	33.88 KB	-rw-r--r--	2025-06-23 14:36
reprlib.py	6.98 KB	-rw-r--r--	2025-06-23 14:36
rlcompleter.py	7.64 KB	-rw-r--r--	2025-06-23 14:37
runpy.py	12.58 KB	-rw-r--r--	2025-06-23 14:36
sched.py	6.2 KB	-rw-r--r--	2025-06-23 14:37
secrets.py	1.94 KB	-rw-r--r--	2025-06-23 14:36
selectors.py	19.21 KB	-rw-r--r--	2025-06-23 14:36
shelve.py	8.36 KB	-rw-r--r--	2025-06-23 14:37
shlex.py	13.04 KB	-rw-r--r--	2025-06-23 14:37
shutil.py	55.43 KB	-rw-r--r--	2025-06-23 14:37
signal.py	2.44 KB	-rw-r--r--	2025-06-23 14:37
site.py	22.65 KB	-rw-r--r--	2025-06-23 14:37
smtplib.py	42.52 KB	-rwxr-xr-x	2025-06-23 14:36
sndhdr.py	7.27 KB	-rw-r--r--	2025-06-23 14:37
socket.py	36.93 KB	-rw-r--r--	2025-06-23 14:37
socketserver.py	27.41 KB	-rw-r--r--	2025-06-23 14:37
sre_compile.py	231 B	-rw-r--r--	2025-06-23 14:36
sre_constants.py	232 B	-rw-r--r--	2025-06-23 14:36
sre_parse.py	229 B	-rw-r--r--	2025-06-23 14:36
ssl.py	49.71 KB	-rw-r--r--	2025-06-23 14:37
stat.py	5.36 KB	-rw-r--r--	2025-06-23 14:37
statistics.py	49.05 KB	-rw-r--r--	2025-06-23 14:36
string.py	11.51 KB	-rw-r--r--	2025-06-23 14:37
stringprep.py	12.61 KB	-rw-r--r--	2025-06-23 14:36
struct.py	257 B	-rw-r--r--	2025-06-23 14:36
subprocess.py	86.67 KB	-rw-r--r--	2025-06-23 14:36
sunau.py	18.04 KB	-rw-r--r--	2025-06-23 14:36
symtable.py	12.18 KB	-rw-r--r--	2025-06-23 14:37
sysconfig.py	31.1 KB	-rw-r--r--	2025-06-23 14:37
tabnanny.py	11.27 KB	-rwxr-xr-x	2025-06-23 14:37
tarfile.py	109.82 KB	-rwxr-xr-x	2025-06-23 14:36
telnetlib.py	22.79 KB	-rw-r--r--	2025-06-23 14:36
tempfile.py	31.63 KB	-rw-r--r--	2025-06-23 14:36
textwrap.py	19.26 KB	-rw-r--r--	2025-06-23 14:36
this.py	1003 B	-rw-r--r--	2025-06-23 14:36
threading.py	58.79 KB	-rw-r--r--	2025-06-23 14:37
timeit.py	13.16 KB	-rwxr-xr-x	2025-06-23 14:36
token.py	2.45 KB	-rw-r--r--	2025-06-23 14:36
tokenize.py	21.06 KB	-rw-r--r--	2025-06-23 14:37
trace.py	28.68 KB	-rwxr-xr-x	2025-06-23 14:36
traceback.py	45.31 KB	-rw-r--r--	2025-06-23 14:37
tracemalloc.py	17.62 KB	-rw-r--r--	2025-06-23 14:37
tty.py	1.99 KB	-rw-r--r--	2025-06-23 14:36
types.py	10.74 KB	-rw-r--r--	2025-06-23 14:36
typing.py	116.05 KB	-rw-r--r--	2025-06-23 14:37
uu.py	7.17 KB	-rw-r--r--	2025-06-23 14:50
uuid.py	28.96 KB	-rw-r--r--	2025-06-23 14:36
warnings.py	21.4 KB	-rw-r--r--	2025-06-23 14:36
wave.py	22.24 KB	-rw-r--r--	2025-06-23 14:36
weakref.py	21.01 KB	-rw-r--r--	2025-06-23 14:37
webbrowser.py	23.19 KB	-rwxr-xr-x	2025-06-23 14:37
xdrlib.py	5.8 KB	-rw-r--r--	2025-06-23 14:37
zipapp.py	7.37 KB	-rw-r--r--	2025-06-23 14:36
zipimport.py	27.19 KB	-rw-r--r--	2025-06-23 14:37

Rename

"""Pseudo terminal utilities."""

# Bugs: No signal handling.  Doesn't set slave termios and window size.
#       Only tested on Linux, FreeBSD, and macOS.
# See:  W. Richard Stevens. 1992.  Advanced Programming in the
#       UNIX Environment.  Chapter 19.
# Author: Steen Lumholt -- with additions by Guido.

from select import select
import os
import sys
import tty

# names imported directly for test mocking purposes
from os import close, waitpid
from tty import setraw, tcgetattr, tcsetattr

__all__ = ["openpty", "fork", "spawn"]

STDIN_FILENO = 0
STDOUT_FILENO = 1
STDERR_FILENO = 2

CHILD = 0

def openpty():
    """openpty() -> (master_fd, slave_fd)
    Open a pty master/slave pair, using os.openpty() if possible."""

try:
        return os.openpty()
    except (AttributeError, OSError):
        pass
    master_fd, slave_name = _open_terminal()
    slave_fd = slave_open(slave_name)
    return master_fd, slave_fd

def master_open():
    """master_open() -> (master_fd, slave_name)
    Open a pty master and return the fd, and the filename of the slave end.
    Deprecated, use openpty() instead."""

import warnings
    warnings.warn("Use pty.openpty() instead.", DeprecationWarning, stacklevel=2)  # Remove API in 3.14

try:
        master_fd, slave_fd = os.openpty()
    except (AttributeError, OSError):
        pass
    else:
        slave_name = os.ttyname(slave_fd)
        os.close(slave_fd)
        return master_fd, slave_name

return _open_terminal()

def _open_terminal():
    """Open pty master and return (master_fd, tty_name)."""
    for x in 'pqrstuvwxyzPQRST':
        for y in '0123456789abcdef':
            pty_name = '/dev/pty' + x + y
            try:
                fd = os.open(pty_name, os.O_RDWR)
            except OSError:
                continue
            return (fd, '/dev/tty' + x + y)
    raise OSError('out of pty devices')

def slave_open(tty_name):
    """slave_open(tty_name) -> slave_fd
    Open the pty slave and acquire the controlling terminal, returning
    opened filedescriptor.
    Deprecated, use openpty() instead."""

import warnings
    warnings.warn("Use pty.openpty() instead.", DeprecationWarning, stacklevel=2)  # Remove API in 3.14

result = os.open(tty_name, os.O_RDWR)
    try:
        from fcntl import ioctl, I_PUSH
    except ImportError:
        return result
    try:
        ioctl(result, I_PUSH, "ptem")
        ioctl(result, I_PUSH, "ldterm")
    except OSError:
        pass
    return result

def fork():
    """fork() -> (pid, master_fd)
    Fork and make the child a session leader with a controlling terminal."""

try:
        pid, fd = os.forkpty()
    except (AttributeError, OSError):
        pass
    else:
        if pid == CHILD:
            try:
                os.setsid()
            except OSError:
                # os.forkpty() already set us session leader
                pass
        return pid, fd

master_fd, slave_fd = openpty()
    pid = os.fork()
    if pid == CHILD:
        os.close(master_fd)
        os.login_tty(slave_fd)
    else:
        os.close(slave_fd)

# Parent and child process.
    return pid, master_fd

def _read(fd):
    """Default read function."""
    return os.read(fd, 1024)

def _copy(master_fd, master_read=_read, stdin_read=_read):
    """Parent copy loop.
    Copies
            pty master -> standard output   (master_read)
            standard input -> pty master    (stdin_read)"""
    if os.get_blocking(master_fd):
        # If we write more than tty/ndisc is willing to buffer, we may block
        # indefinitely. So we set master_fd to non-blocking temporarily during
        # the copy operation.
        os.set_blocking(master_fd, False)
        try:
            _copy(master_fd, master_read=master_read, stdin_read=stdin_read)
        finally:
            # restore blocking mode for backwards compatibility
            os.set_blocking(master_fd, True)
        return
    high_waterlevel = 4096
    stdin_avail = master_fd != STDIN_FILENO
    stdout_avail = master_fd != STDOUT_FILENO
    i_buf = b''
    o_buf = b''
    while 1:
        rfds = []
        wfds = []
        if stdin_avail and len(i_buf) < high_waterlevel:
            rfds.append(STDIN_FILENO)
        if stdout_avail and len(o_buf) < high_waterlevel:
            rfds.append(master_fd)
        if stdout_avail and len(o_buf) > 0:
            wfds.append(STDOUT_FILENO)
        if len(i_buf) > 0:
            wfds.append(master_fd)

rfds, wfds, _xfds = select(rfds, wfds, [])

if STDOUT_FILENO in wfds:
            try:
                n = os.write(STDOUT_FILENO, o_buf)
                o_buf = o_buf[n:]
            except OSError:
                stdout_avail = False

if master_fd in rfds:
            # Some OSes signal EOF by returning an empty byte string,
            # some throw OSErrors.
            try:
                data = master_read(master_fd)
            except OSError:
                data = b""
            if not data:  # Reached EOF.
                return    # Assume the child process has exited and is
                          # unreachable, so we clean up.
            o_buf += data

if master_fd in wfds:
            n = os.write(master_fd, i_buf)
            i_buf = i_buf[n:]

if stdin_avail and STDIN_FILENO in rfds:
            data = stdin_read(STDIN_FILENO)
            if not data:
                stdin_avail = False
            else:
                i_buf += data

def spawn(argv, master_read=_read, stdin_read=_read):
    """Create a spawned process."""
    if isinstance(argv, str):
        argv = (argv,)
    sys.audit('pty.spawn', argv)

pid, master_fd = fork()
    if pid == CHILD:
        os.execlp(argv[0], *argv)

try:
        mode = tcgetattr(STDIN_FILENO)
        setraw(STDIN_FILENO)
        restore = True
    except tty.error:    # This is the same as termios.error
        restore = False

try:
        _copy(master_fd, master_read, stdin_read)
    finally:
        if restore:
            tcsetattr(STDIN_FILENO, tty.TCSAFLUSH, mode)

close(master_fd)
    return waitpid(pid, 0)[1]