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.6m	[ 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
distutils	[ 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
idlelib	[ 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
site-packages	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
sqlite3	[ DIR ]	drwxr-xr-x	2025-08-15 19:31
test	[ 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
__future__.py	4.73 KB	-rw-r--r--	2024-04-17 17:32
__phello__.foo.py	64 B	-rw-r--r--	2024-04-17 17:32
_bootlocale.py	1.27 KB	-rw-r--r--	2024-04-17 17:32
_collections_abc.py	25.77 KB	-rw-r--r--	2024-04-17 17:32
_compat_pickle.py	8.54 KB	-rw-r--r--	2024-04-17 17:32
_compression.py	5.21 KB	-rw-r--r--	2024-04-17 17:32
_dummy_thread.py	5 KB	-rw-r--r--	2024-04-17 17:32
_markupbase.py	14.26 KB	-rw-r--r--	2024-04-17 17:32
_osx_support.py	18.69 KB	-rw-r--r--	2024-04-17 17:32
_pydecimal.py	224.83 KB	-rw-r--r--	2024-04-17 17:32
_pyio.py	86.03 KB	-rw-r--r--	2024-04-17 17:32
_sitebuiltins.py	3.04 KB	-rw-r--r--	2024-04-17 17:32
_strptime.py	24.17 KB	-rw-r--r--	2024-04-17 17:32
_sysconfigdata_dm_linux_x86_64-linux-gnu.py	28.89 KB	-rw-r--r--	2024-04-17 17:32
_sysconfigdata_m_linux_x86_64-linux-gnu.py	27.86 KB	-rw-r--r--	2024-04-17 17:32
_threading_local.py	7.04 KB	-rw-r--r--	2024-04-17 17:32
_weakrefset.py	5.57 KB	-rw-r--r--	2024-04-17 17:32
abc.py	8.52 KB	-rw-r--r--	2024-04-17 17:32
aifc.py	31.69 KB	-rw-r--r--	2024-04-17 17:32
antigravity.py	477 B	-rw-r--r--	2024-04-17 17:32
argparse.py	88.25 KB	-rw-r--r--	2024-04-17 17:32
ast.py	11.88 KB	-rw-r--r--	2024-04-17 17:32
asynchat.py	11.06 KB	-rw-r--r--	2024-04-17 17:32
asyncore.py	19.69 KB	-rw-r--r--	2024-04-17 17:32
base64.py	19.91 KB	-rwxr-xr-x	2024-04-17 17:32
bdb.py	23 KB	-rw-r--r--	2024-04-17 17:32
binhex.py	13.63 KB	-rw-r--r--	2024-04-17 17:32
bisect.py	2.53 KB	-rw-r--r--	2024-04-17 17:32
bz2.py	12.19 KB	-rw-r--r--	2024-04-17 17:32
cProfile.py	5.26 KB	-rwxr-xr-x	2024-04-17 17:32
calendar.py	22.67 KB	-rw-r--r--	2024-04-17 17:32
cgi.py	36.21 KB	-rwxr-xr-x	2024-04-17 17:32
cgitb.py	11.74 KB	-rw-r--r--	2024-04-17 17:32
chunk.py	5.3 KB	-rw-r--r--	2024-04-17 17:32
cmd.py	14.51 KB	-rw-r--r--	2024-04-17 17:32
code.py	10.37 KB	-rw-r--r--	2024-04-17 17:32
codecs.py	35.43 KB	-rw-r--r--	2024-04-17 17:32
codeop.py	5.85 KB	-rw-r--r--	2024-04-17 17:32
colorsys.py	3.97 KB	-rw-r--r--	2024-04-17 17:32
compileall.py	11.84 KB	-rw-r--r--	2024-04-17 17:32
configparser.py	52.34 KB	-rw-r--r--	2024-04-17 17:32
contextlib.py	12.85 KB	-rw-r--r--	2024-04-17 17:32
copy.py	8.61 KB	-rw-r--r--	2024-04-17 17:32
copyreg.py	6.84 KB	-rw-r--r--	2024-04-17 17:32
crypt.py	1.82 KB	-rw-r--r--	2024-04-17 17:32
csv.py	15.8 KB	-rw-r--r--	2024-04-17 17:32
datetime.py	80.11 KB	-rw-r--r--	2024-04-17 17:32
decimal.py	320 B	-rw-r--r--	2024-04-17 17:32
difflib.py	82.4 KB	-rw-r--r--	2024-04-17 17:32
dis.py	17.71 KB	-rw-r--r--	2024-04-17 17:32
doctest.py	101.94 KB	-rw-r--r--	2024-04-17 17:32
dummy_threading.py	2.75 KB	-rw-r--r--	2024-04-17 17:32
enum.py	32.82 KB	-rw-r--r--	2024-04-17 17:32
filecmp.py	9.6 KB	-rw-r--r--	2024-04-17 17:32
fileinput.py	14.13 KB	-rw-r--r--	2024-04-17 17:32
fnmatch.py	3.09 KB	-rw-r--r--	2024-04-17 17:32
formatter.py	14.79 KB	-rw-r--r--	2024-04-17 17:32
fractions.py	23.08 KB	-rw-r--r--	2024-04-17 17:32
ftplib.py	34.78 KB	-rw-r--r--	2024-04-17 17:32
functools.py	30.61 KB	-rw-r--r--	2024-04-17 17:32
genericpath.py	4.64 KB	-rw-r--r--	2024-04-17 17:32
getopt.py	7.31 KB	-rw-r--r--	2024-04-17 17:32
getpass.py	5.85 KB	-rw-r--r--	2024-04-17 17:32
gettext.py	21.03 KB	-rw-r--r--	2024-04-17 17:32
glob.py	5.51 KB	-rw-r--r--	2024-04-17 17:32
gzip.py	19.86 KB	-rw-r--r--	2024-04-17 17:32
hashlib.py	9.31 KB	-rw-r--r--	2024-04-17 17:32
heapq.py	22.39 KB	-rw-r--r--	2024-04-17 17:32
hmac.py	4.94 KB	-rw-r--r--	2024-04-17 17:32
imaplib.py	52.05 KB	-rw-r--r--	2024-04-17 17:32
imghdr.py	3.71 KB	-rw-r--r--	2024-04-17 17:32
imp.py	10.42 KB	-rw-r--r--	2024-04-17 17:32
inspect.py	114.22 KB	-rw-r--r--	2024-04-17 17:32
io.py	3.43 KB	-rw-r--r--	2024-04-17 17:32
ipaddress.py	72.82 KB	-rw-r--r--	2024-04-17 17:32
keyword.py	2.17 KB	-rwxr-xr-x	2024-04-17 17:32
linecache.py	5.19 KB	-rw-r--r--	2024-04-17 17:32
locale.py	75.49 KB	-rw-r--r--	2024-04-17 17:32
lzma.py	12.68 KB	-rw-r--r--	2024-04-17 17:32
macpath.py	5.83 KB	-rw-r--r--	2024-04-17 17:32
macurl2path.py	2.67 KB	-rw-r--r--	2024-04-17 17:32
mailbox.py	76.78 KB	-rw-r--r--	2024-04-17 17:32
mailcap.py	7.91 KB	-rw-r--r--	2024-04-17 17:32
mimetypes.py	20.55 KB	-rw-r--r--	2024-04-17 17:32
modulefinder.py	22.49 KB	-rw-r--r--	2024-04-17 17:32
netrc.py	5.55 KB	-rw-r--r--	2024-04-17 17:32
nntplib.py	42.07 KB	-rw-r--r--	2024-04-17 17:32
ntpath.py	22.55 KB	-rw-r--r--	2024-04-17 17:32
nturl2path.py	2.39 KB	-rw-r--r--	2024-04-17 17:32
numbers.py	10 KB	-rw-r--r--	2024-04-17 17:32
opcode.py	5.69 KB	-rw-r--r--	2024-04-17 17:32
operator.py	10.61 KB	-rw-r--r--	2024-04-17 17:32
optparse.py	58.96 KB	-rw-r--r--	2024-04-17 17:32
os.py	36.65 KB	-rw-r--r--	2024-04-17 17:32
pathlib.py	47.83 KB	-rw-r--r--	2024-04-17 17:32
pdb.py	59.89 KB	-rwxr-xr-x	2024-04-17 17:32
pickle.py	54.39 KB	-rw-r--r--	2024-04-17 17:32
pickletools.py	89.62 KB	-rw-r--r--	2024-04-17 17:32
pipes.py	8.71 KB	-rw-r--r--	2024-04-17 17:32
pkgutil.py	20.82 KB	-rw-r--r--	2024-04-17 17:32
platform.py	46.1 KB	-rwxr-xr-x	2024-04-17 17:32
plistlib.py	32.02 KB	-rw-r--r--	2024-04-17 17:32
poplib.py	14.61 KB	-rw-r--r--	2024-04-17 17:32
posixpath.py	15.4 KB	-rw-r--r--	2024-04-17 17:32
pprint.py	20.37 KB	-rw-r--r--	2024-04-17 17:32
profile.py	21.52 KB	-rwxr-xr-x	2024-04-17 17:32
pstats.py	25.94 KB	-rw-r--r--	2024-04-17 17:32
pty.py	4.65 KB	-rw-r--r--	2024-04-17 17:32
py_compile.py	7.01 KB	-rw-r--r--	2024-04-17 17:32
pyclbr.py	13.24 KB	-rw-r--r--	2024-04-17 17:32
pydoc.py	101.08 KB	-rw-r--r--	2024-04-17 17:32
queue.py	8.57 KB	-rw-r--r--	2024-04-17 17:32
quopri.py	7.09 KB	-rwxr-xr-x	2024-04-17 17:32
random.py	26.8 KB	-rw-r--r--	2024-04-17 17:32
re.py	15.19 KB	-rw-r--r--	2024-04-17 17:32
reprlib.py	5.21 KB	-rw-r--r--	2024-04-17 17:32
rlcompleter.py	6.93 KB	-rw-r--r--	2024-04-17 17:32
runpy.py	11.68 KB	-rw-r--r--	2024-04-17 17:32
sched.py	6.36 KB	-rw-r--r--	2024-04-17 17:32
secrets.py	1.99 KB	-rw-r--r--	2024-04-17 17:32
selectors.py	18.98 KB	-rw-r--r--	2024-04-17 17:32
shelve.py	8.32 KB	-rw-r--r--	2024-04-17 17:32
shlex.py	12.65 KB	-rw-r--r--	2024-04-17 17:32
shutil.py	39.59 KB	-rw-r--r--	2024-04-17 17:32
signal.py	2.07 KB	-rw-r--r--	2024-04-17 17:32
site.py	20.53 KB	-rw-r--r--	2024-04-17 17:32
smtpd.py	33.91 KB	-rwxr-xr-x	2024-04-17 17:32
smtplib.py	43.38 KB	-rwxr-xr-x	2024-04-17 17:32
sndhdr.py	6.92 KB	-rw-r--r--	2024-04-17 17:32
socket.py	26.8 KB	-rw-r--r--	2024-04-17 17:32
socketserver.py	26.38 KB	-rw-r--r--	2024-04-17 17:32
sre_compile.py	18.88 KB	-rw-r--r--	2024-04-17 17:32
sre_constants.py	6.66 KB	-rw-r--r--	2024-04-17 17:32
sre_parse.py	35.68 KB	-rw-r--r--	2024-04-17 17:32
ssl.py	43.74 KB	-rw-r--r--	2024-04-17 17:32
stat.py	4.92 KB	-rw-r--r--	2024-04-17 17:32
statistics.py	20.19 KB	-rw-r--r--	2024-04-17 17:32
string.py	11.52 KB	-rw-r--r--	2024-04-17 17:32
stringprep.py	12.61 KB	-rw-r--r--	2024-04-17 17:32
struct.py	257 B	-rw-r--r--	2024-04-17 17:32
subprocess.py	60.88 KB	-rw-r--r--	2024-04-17 17:32
sunau.py	17.67 KB	-rw-r--r--	2024-04-17 17:32
symbol.py	2.07 KB	-rwxr-xr-x	2024-04-17 17:32
symtable.py	7.11 KB	-rw-r--r--	2024-04-17 17:32
sysconfig.py	24.4 KB	-rw-r--r--	2024-04-17 17:32
tabnanny.py	11.15 KB	-rwxr-xr-x	2024-04-17 17:32
tarfile.py	91.13 KB	-rwxr-xr-x	2024-04-17 17:32
telnetlib.py	22.59 KB	-rw-r--r--	2024-04-17 17:32
tempfile.py	26.15 KB	-rw-r--r--	2024-04-17 17:32
textwrap.py	19.1 KB	-rw-r--r--	2024-04-17 17:32
this.py	1003 B	-rw-r--r--	2024-04-17 17:32
threading.py	47.88 KB	-rw-r--r--	2024-04-17 17:32
timeit.py	13.03 KB	-rwxr-xr-x	2024-04-17 17:32
token.py	3 KB	-rw-r--r--	2024-04-17 17:32
tokenize.py	28.8 KB	-rw-r--r--	2024-04-17 17:32
trace.py	28.06 KB	-rwxr-xr-x	2024-04-17 17:32
traceback.py	22.91 KB	-rw-r--r--	2024-04-17 17:32
tracemalloc.py	16.27 KB	-rw-r--r--	2024-04-17 17:32
tty.py	879 B	-rw-r--r--	2024-04-17 17:32
types.py	8.66 KB	-rw-r--r--	2024-04-17 17:32
typing.py	78.39 KB	-rw-r--r--	2024-04-17 17:32
uu.py	6.75 KB	-rwxr-xr-x	2024-04-17 17:32
uuid.py	23.41 KB	-rw-r--r--	2024-04-17 17:32
warnings.py	18.05 KB	-rw-r--r--	2024-04-17 17:32
wave.py	17.29 KB	-rw-r--r--	2024-04-17 17:32
weakref.py	19.99 KB	-rw-r--r--	2024-04-17 17:32
webbrowser.py	21.26 KB	-rwxr-xr-x	2024-04-17 17:32
xdrlib.py	5.77 KB	-rw-r--r--	2024-04-17 17:32
zipapp.py	6.99 KB	-rw-r--r--	2024-04-17 17:32
zipfile.py	74.49 KB	-rw-r--r--	2024-04-17 17:32

Rename

"""Pseudo terminal utilities."""

# Bugs: No signal handling.  Doesn't set slave termios and window size.
#       Only tested on Linux.
# 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 tty

__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."""

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."""

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:
        # Establish a new session.
        os.setsid()
        os.close(master_fd)

# Slave becomes stdin/stdout/stderr of child.
        os.dup2(slave_fd, STDIN_FILENO)
        os.dup2(slave_fd, STDOUT_FILENO)
        os.dup2(slave_fd, STDERR_FILENO)
        if (slave_fd > STDERR_FILENO):
            os.close (slave_fd)

# Explicitly open the tty to make it become a controlling tty.
        tmp_fd = os.open(os.ttyname(STDOUT_FILENO), os.O_RDWR)
        os.close(tmp_fd)
    else:
        os.close(slave_fd)

# Parent and child process.
    return pid, master_fd

def _writen(fd, data):
    """Write all the data to a descriptor."""
    while data:
        n = os.write(fd, data)
        data = data[n:]

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)"""
    fds = [master_fd, STDIN_FILENO]
    while True:
        rfds, wfds, xfds = select(fds, [], [])
        if master_fd in rfds:
            data = master_read(master_fd)
            if not data:  # Reached EOF.
                fds.remove(master_fd)
            else:
                os.write(STDOUT_FILENO, data)
        if STDIN_FILENO in rfds:
            data = stdin_read(STDIN_FILENO)
            if not data:
                fds.remove(STDIN_FILENO)
            else:
                _writen(master_fd, data)

def spawn(argv, master_read=_read, stdin_read=_read):
    """Create a spawned process."""
    if type(argv) == type(''):
        argv = (argv,)
    pid, master_fd = fork()
    if pid == CHILD:
        os.execlp(argv[0], *argv)
    try:
        mode = tty.tcgetattr(STDIN_FILENO)
        tty.setraw(STDIN_FILENO)
        restore = 1
    except tty.error:    # This is the same as termios.error
        restore = 0
    try:
        _copy(master_fd, master_read, stdin_read)
    except OSError:
        if restore:
            tty.tcsetattr(STDIN_FILENO, tty.TCSAFLUSH, mode)

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