Gecko [ theprintave.ca ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
asyncio	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
collections	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
concurrent	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
config-3.10-x86_64-linux-gnu	[ DIR ]	drwxr-xr-x	2025-02-22 06:15
ctypes	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
curses	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
dbm	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
distutils	[ DIR ]	drwxr-xr-x	2025-02-22 06:15
email	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
encodings	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
html	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
http	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
importlib	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
json	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
lib-dynload	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
lib2to3	[ DIR ]	drwxr-xr-x	2024-02-16 18:45
logging	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
multiprocessing	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
pydoc_data	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
sqlite3	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
test	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
unittest	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
urllib	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
venv	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
wsgiref	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
xml	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
xmlrpc	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
zoneinfo	[ DIR ]	drwxr-xr-x	2025-02-22 06:16
LICENSE.txt	13.61 KB	-rw-r--r--	2025-02-04 14:57
__future__.py	5.03 KB	-rw-r--r--	2025-02-04 14:57
__phello__.foo.py	64 B	-rw-r--r--	2025-02-04 14:57
_aix_support.py	3.19 KB	-rw-r--r--	2025-02-04 14:57
_bootsubprocess.py	2.61 KB	-rw-r--r--	2025-02-04 14:57
_collections_abc.py	31.53 KB	-rw-r--r--	2025-02-04 14:57
_compat_pickle.py	8.54 KB	-rw-r--r--	2025-02-04 14:57
_compression.py	5.55 KB	-rw-r--r--	2025-02-04 14:57
_distutils_system_mod.py	6.16 KB	-rw-r--r--	2025-02-04 14:57
_markupbase.py	14.31 KB	-rw-r--r--	2025-02-04 14:57
_osx_support.py	21.28 KB	-rw-r--r--	2025-02-04 14:57
_py_abc.py	6.04 KB	-rw-r--r--	2025-02-04 14:57
_pydecimal.py	223.32 KB	-rw-r--r--	2025-02-04 14:57
_pyio.py	92.25 KB	-rw-r--r--	2025-02-04 14:57
_sitebuiltins.py	3.05 KB	-rw-r--r--	2025-02-04 14:57
_strptime.py	24.68 KB	-rw-r--r--	2025-02-04 14:57
_sysconfigdata__linux_x86_64-linux-gnu.py	26.84 KB	-rw-r--r--	2025-02-04 14:57
_sysconfigdata__x86_64-linux-gnu.py	26.84 KB	-rw-r--r--	2025-02-04 14:57
_threading_local.py	7.05 KB	-rw-r--r--	2025-02-04 14:57
_weakrefset.py	5.78 KB	-rw-r--r--	2025-02-04 14:57
abc.py	6.37 KB	-rw-r--r--	2025-02-04 14:57
aifc.py	31.84 KB	-rw-r--r--	2025-02-04 14:57
antigravity.py	500 B	-rw-r--r--	2025-02-04 14:57
argparse.py	96.52 KB	-rw-r--r--	2025-02-04 14:57
ast.py	58.5 KB	-rw-r--r--	2025-02-04 14:57
asynchat.py	11.25 KB	-rw-r--r--	2025-02-04 14:57
asyncore.py	19.79 KB	-rw-r--r--	2025-02-04 14:57
base64.py	20.36 KB	-rwxr-xr-x	2025-02-04 14:57
bdb.py	31.64 KB	-rw-r--r--	2025-02-04 14:57
binhex.py	14.44 KB	-rw-r--r--	2025-02-04 14:57
bisect.py	3.06 KB	-rw-r--r--	2025-02-04 14:57
bz2.py	11.57 KB	-rw-r--r--	2025-02-04 14:57
cProfile.py	6.2 KB	-rwxr-xr-x	2025-02-04 14:57
calendar.py	24 KB	-rw-r--r--	2025-02-04 14:57
cgi.py	33.3 KB	-rwxr-xr-x	2025-02-04 14:57
cgitb.py	11.81 KB	-rw-r--r--	2025-02-04 14:57
chunk.py	5.31 KB	-rw-r--r--	2025-02-04 14:57
cmd.py	14.51 KB	-rw-r--r--	2025-02-04 14:57
code.py	10.37 KB	-rw-r--r--	2025-02-04 14:57
codecs.py	35.85 KB	-rw-r--r--	2025-02-04 14:57
codeop.py	5.48 KB	-rw-r--r--	2025-02-04 14:57
colorsys.py	3.92 KB	-rw-r--r--	2025-02-04 14:57
compileall.py	19.78 KB	-rw-r--r--	2025-02-04 14:57
configparser.py	53.33 KB	-rw-r--r--	2025-02-04 14:57
contextlib.py	25.28 KB	-rw-r--r--	2025-02-04 14:57
contextvars.py	129 B	-rw-r--r--	2025-02-04 14:57
copy.py	8.48 KB	-rw-r--r--	2025-02-04 14:57
copyreg.py	7.25 KB	-rw-r--r--	2025-02-04 14:57
crypt.py	3.76 KB	-rw-r--r--	2025-02-04 14:57
csv.py	15.65 KB	-rw-r--r--	2025-02-04 14:57
dataclasses.py	55.07 KB	-rw-r--r--	2025-02-04 14:57
datetime.py	86.02 KB	-rw-r--r--	2025-02-04 14:57
decimal.py	320 B	-rw-r--r--	2025-02-04 14:57
difflib.py	81.36 KB	-rw-r--r--	2025-02-04 14:57
dis.py	19.55 KB	-rw-r--r--	2025-02-04 14:57
doctest.py	102.68 KB	-rw-r--r--	2025-02-04 14:57
enum.py	38.9 KB	-rw-r--r--	2025-02-04 14:57
filecmp.py	9.94 KB	-rw-r--r--	2025-02-04 14:57
fileinput.py	16.06 KB	-rw-r--r--	2025-02-04 14:57
fnmatch.py	6.56 KB	-rw-r--r--	2025-02-04 14:57
fractions.py	27.58 KB	-rw-r--r--	2025-02-04 14:57
ftplib.py	34.66 KB	-rw-r--r--	2025-02-04 14:57
functools.py	37.18 KB	-rw-r--r--	2025-02-04 14:57
genericpath.py	4.86 KB	-rw-r--r--	2025-02-04 14:57
getopt.py	7.31 KB	-rw-r--r--	2025-02-04 14:57
getpass.py	5.85 KB	-rw-r--r--	2025-02-04 14:57
gettext.py	27.04 KB	-rw-r--r--	2025-02-04 14:57
glob.py	7.7 KB	-rw-r--r--	2025-02-04 14:57
graphlib.py	9.35 KB	-rw-r--r--	2025-02-04 14:57
gzip.py	21.34 KB	-rw-r--r--	2025-02-04 14:57
hashlib.py	9.99 KB	-rw-r--r--	2025-02-04 14:57
heapq.py	22.34 KB	-rw-r--r--	2025-02-04 14:57
hmac.py	7.54 KB	-rw-r--r--	2025-02-04 14:57
imaplib.py	53.58 KB	-rw-r--r--	2025-02-04 14:57
imghdr.py	3.72 KB	-rw-r--r--	2025-02-04 14:57
imp.py	10.34 KB	-rw-r--r--	2025-02-04 14:57
inspect.py	121.46 KB	-rw-r--r--	2025-02-04 14:57
io.py	4.1 KB	-rw-r--r--	2025-02-04 14:57
ipaddress.py	75.96 KB	-rw-r--r--	2025-02-04 14:57
keyword.py	1.04 KB	-rw-r--r--	2025-02-04 14:57
linecache.py	5.56 KB	-rw-r--r--	2025-02-04 14:57
locale.py	76.3 KB	-rw-r--r--	2025-02-04 14:57
lzma.py	12.97 KB	-rw-r--r--	2025-02-04 14:57
mailbox.py	76.95 KB	-rw-r--r--	2025-02-04 14:57
mailcap.py	8.9 KB	-rw-r--r--	2025-02-04 14:57
mimetypes.py	22.01 KB	-rw-r--r--	2025-02-04 14:57
modulefinder.py	23.83 KB	-rw-r--r--	2025-02-04 14:57
netrc.py	5.61 KB	-rw-r--r--	2025-02-04 14:57
nntplib.py	40.06 KB	-rw-r--r--	2025-02-04 14:57
ntpath.py	28.79 KB	-rw-r--r--	2025-02-04 14:57
nturl2path.py	2.82 KB	-rw-r--r--	2025-02-04 14:57
numbers.py	10.11 KB	-rw-r--r--	2025-02-04 14:57
opcode.py	5.76 KB	-rw-r--r--	2025-02-04 14:57
operator.py	10.5 KB	-rw-r--r--	2025-02-04 14:57
optparse.py	58.95 KB	-rw-r--r--	2025-02-04 14:57
os.py	38.63 KB	-rw-r--r--	2025-02-04 14:57
pathlib.py	48.41 KB	-rw-r--r--	2025-02-04 14:57
pdb.py	61.74 KB	-rwxr-xr-x	2025-02-04 14:57
pickle.py	63.43 KB	-rw-r--r--	2025-02-04 14:57
pickletools.py	91.29 KB	-rw-r--r--	2025-02-04 14:57
pipes.py	8.71 KB	-rw-r--r--	2025-02-04 14:57
pkgutil.py	24 KB	-rw-r--r--	2025-02-04 14:57
platform.py	41.04 KB	-rwxr-xr-x	2025-02-04 14:57
plistlib.py	27.69 KB	-rw-r--r--	2025-02-04 14:57
poplib.py	14.84 KB	-rw-r--r--	2025-02-04 14:57
posixpath.py	15.87 KB	-rw-r--r--	2025-02-04 14:57
pprint.py	23.87 KB	-rw-r--r--	2025-02-04 14:57
profile.py	22.35 KB	-rwxr-xr-x	2025-02-04 14:57
pstats.py	28.64 KB	-rw-r--r--	2025-02-04 14:57
pty.py	5.09 KB	-rw-r--r--	2025-02-04 14:57
py_compile.py	7.69 KB	-rw-r--r--	2025-02-04 14:57
pyclbr.py	11.13 KB	-rw-r--r--	2025-02-04 14:57
pydoc.py	107.31 KB	-rwxr-xr-x	2025-02-04 14:57
queue.py	11.23 KB	-rw-r--r--	2025-02-04 14:57
quopri.py	7.1 KB	-rwxr-xr-x	2025-02-04 14:57
random.py	32.44 KB	-rw-r--r--	2025-02-04 14:57
re.py	15.49 KB	-rw-r--r--	2025-02-04 14:57
reprlib.py	5.14 KB	-rw-r--r--	2025-02-04 14:57
rlcompleter.py	7.63 KB	-rw-r--r--	2025-02-04 14:57
runpy.py	12.8 KB	-rw-r--r--	2025-02-04 14:57
sched.py	6.2 KB	-rw-r--r--	2025-02-04 14:57
secrets.py	1.99 KB	-rw-r--r--	2025-02-04 14:57
selectors.py	19.08 KB	-rw-r--r--	2025-02-04 14:57
shelve.py	8.36 KB	-rw-r--r--	2025-02-04 14:57
shlex.py	13.18 KB	-rw-r--r--	2025-02-04 14:57
shutil.py	53.29 KB	-rw-r--r--	2025-02-04 14:57
signal.py	2.38 KB	-rw-r--r--	2025-02-04 14:57
site.py	23.11 KB	-rw-r--r--	2025-02-04 14:57
sitecustomize.py	155 B	-rw-r--r--	2023-11-20 15:14
smtpd.py	34.34 KB	-rwxr-xr-x	2025-02-04 14:57
smtplib.py	44.35 KB	-rwxr-xr-x	2025-02-04 14:57
sndhdr.py	6.93 KB	-rw-r--r--	2025-02-04 14:57
socket.py	35.92 KB	-rw-r--r--	2025-02-04 14:57
socketserver.py	26.66 KB	-rw-r--r--	2025-02-04 14:57
sre_compile.py	27.32 KB	-rw-r--r--	2025-02-04 14:57
sre_constants.py	7.01 KB	-rw-r--r--	2025-02-04 14:57
sre_parse.py	39.82 KB	-rw-r--r--	2025-02-04 14:57
ssl.py	52.47 KB	-rw-r--r--	2025-02-04 14:57
stat.py	5.36 KB	-rw-r--r--	2025-02-04 14:57
statistics.py	42.19 KB	-rw-r--r--	2025-02-04 14:57
string.py	10.32 KB	-rw-r--r--	2025-02-04 14:57
stringprep.py	12.61 KB	-rw-r--r--	2025-02-04 14:57
struct.py	257 B	-rw-r--r--	2025-02-04 14:57
subprocess.py	82.93 KB	-rw-r--r--	2025-02-04 14:57
sunau.py	17.73 KB	-rw-r--r--	2025-02-04 14:57
symtable.py	9.98 KB	-rw-r--r--	2025-02-04 14:57
sysconfig.py	28.71 KB	-rw-r--r--	2025-02-04 14:57
tabnanny.py	11.03 KB	-rwxr-xr-x	2025-02-04 14:57
tarfile.py	104.81 KB	-rwxr-xr-x	2025-02-04 14:57
telnetlib.py	22.71 KB	-rw-r--r--	2025-02-04 14:57
tempfile.py	33.76 KB	-rw-r--r--	2025-02-04 14:57
textwrap.py	19.31 KB	-rw-r--r--	2025-02-04 14:57
this.py	1003 B	-rw-r--r--	2025-02-04 14:57
threading.py	55.86 KB	-rw-r--r--	2025-02-04 14:57
timeit.py	13.18 KB	-rwxr-xr-x	2025-02-04 14:57
token.py	2.33 KB	-rw-r--r--	2025-02-04 14:57
tokenize.py	25.31 KB	-rw-r--r--	2025-02-04 14:57
trace.py	28.53 KB	-rwxr-xr-x	2025-02-04 14:57
traceback.py	25.61 KB	-rw-r--r--	2025-02-04 14:57
tracemalloc.py	17.62 KB	-rw-r--r--	2025-02-04 14:57
tty.py	879 B	-rw-r--r--	2025-02-04 14:57
turtle.py	140.39 KB	-rw-r--r--	2025-02-04 14:57
types.py	9.88 KB	-rw-r--r--	2025-02-04 14:57
typing.py	90.39 KB	-rw-r--r--	2025-02-04 14:57
uu.py	7.13 KB	-rwxr-xr-x	2025-02-04 14:57
uuid.py	26.86 KB	-rw-r--r--	2025-02-04 14:57
warnings.py	19.23 KB	-rw-r--r--	2025-02-04 14:57
wave.py	17.58 KB	-rw-r--r--	2025-02-04 14:57
weakref.py	21.05 KB	-rw-r--r--	2025-02-04 14:57
webbrowser.py	23.68 KB	-rwxr-xr-x	2025-02-04 14:57
xdrlib.py	5.77 KB	-rw-r--r--	2025-02-04 14:57
zipapp.py	7.36 KB	-rw-r--r--	2025-02-04 14:57
zipfile.py	88.08 KB	-rw-r--r--	2025-02-04 14:57
zipimport.py	30.17 KB	-rw-r--r--	2025-02-04 14:57

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

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 fds:
        rfds, _wfds, _xfds = select(fds, [], [])

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.
            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,)
    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]