Gecko [ goons4good.org ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
asyncio	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
collections	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
concurrent	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
config-3.10-x86_64-linux-gnu	[ DIR ]	drwxr-xr-x	2026-02-10 03:51
ctypes	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
curses	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
dbm	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
distutils	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
email	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
encodings	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
ensurepip	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
html	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
http	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
importlib	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
json	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
lib-dynload	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
lib2to3	[ DIR ]	drwxr-xr-x	2026-02-10 03:52
logging	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
multiprocessing	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
pydoc_data	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
site-packages	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
sqlite3	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
unittest	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
urllib	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
venv	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
wsgiref	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
xml	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
xmlrpc	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
zoneinfo	[ DIR ]	drwxr-xr-x	2026-02-10 03:50
LICENSE.txt	13.61 KB	-rw-r--r--	2025-10-09 11:25
__future__.py	5.03 KB	-rw-r--r--	2025-10-09 11:25
__phello__.foo.py	64 B	-rw-r--r--	2025-10-09 11:25
_aix_support.py	3.19 KB	-rw-r--r--	2025-10-09 11:25
_bootsubprocess.py	2.61 KB	-rw-r--r--	2025-10-09 11:25
_collections_abc.py	31.53 KB	-rw-r--r--	2025-10-09 11:25
_compat_pickle.py	8.54 KB	-rw-r--r--	2025-10-09 11:25
_compression.py	5.55 KB	-rw-r--r--	2025-10-09 11:25
_markupbase.py	14.31 KB	-rw-r--r--	2025-10-09 11:25
_osx_support.py	21.28 KB	-rw-r--r--	2025-10-09 11:25
_py_abc.py	6.04 KB	-rw-r--r--	2025-10-09 11:25
_pydecimal.py	223.32 KB	-rw-r--r--	2025-10-09 11:25
_pyio.py	92.25 KB	-rw-r--r--	2025-10-09 11:25
_sitebuiltins.py	3.05 KB	-rw-r--r--	2025-10-09 11:25
_strptime.py	24.68 KB	-rw-r--r--	2025-10-09 11:25
_sysconfigdata__linux_x86_64-linux-gnu.py	40.49 KB	-rw-r--r--	2026-01-09 08:15
_sysconfigdata_d_linux_x86_64-linux-gnu.py	39.91 KB	-rw-r--r--	2026-01-09 08:05
_threading_local.py	7.05 KB	-rw-r--r--	2025-10-09 11:25
_weakrefset.py	5.78 KB	-rw-r--r--	2025-10-09 11:25
abc.py	6.37 KB	-rw-r--r--	2025-10-09 11:25
aifc.py	31.84 KB	-rw-r--r--	2025-10-09 11:25
antigravity.py	500 B	-rw-r--r--	2025-10-09 11:25
argparse.py	96.23 KB	-rw-r--r--	2025-10-09 11:25
ast.py	58.5 KB	-rw-r--r--	2025-10-09 11:25
asynchat.py	11.25 KB	-rw-r--r--	2025-10-09 11:25
asyncore.py	19.79 KB	-rw-r--r--	2025-10-09 11:25
base64.py	20.37 KB	-rwxr-xr-x	2025-10-09 11:25
bdb.py	31.64 KB	-rw-r--r--	2025-10-09 11:25
binhex.py	14.44 KB	-rw-r--r--	2025-10-09 11:25
bisect.py	3.06 KB	-rw-r--r--	2025-10-09 11:25
bz2.py	11.57 KB	-rw-r--r--	2025-10-09 11:25
cProfile.py	6.21 KB	-rwxr-xr-x	2025-10-09 11:25
calendar.py	24 KB	-rw-r--r--	2025-10-09 11:25
cgi.py	33.31 KB	-rwxr-xr-x	2025-10-09 11:25
cgitb.py	11.81 KB	-rw-r--r--	2025-10-09 11:25
chunk.py	5.31 KB	-rw-r--r--	2025-10-09 11:25
cmd.py	14.51 KB	-rw-r--r--	2025-10-09 11:25
code.py	10.37 KB	-rw-r--r--	2025-10-09 11:25
codecs.py	35.85 KB	-rw-r--r--	2025-10-09 11:25
codeop.py	5.48 KB	-rw-r--r--	2025-10-09 11:25
colorsys.py	3.92 KB	-rw-r--r--	2025-10-09 11:25
compileall.py	19.78 KB	-rw-r--r--	2025-10-09 11:25
configparser.py	53.33 KB	-rw-r--r--	2025-10-09 11:25
contextlib.py	25.28 KB	-rw-r--r--	2025-10-09 11:25
contextvars.py	129 B	-rw-r--r--	2025-10-09 11:25
copy.py	8.48 KB	-rw-r--r--	2025-10-09 11:25
copyreg.py	7.25 KB	-rw-r--r--	2025-10-09 11:25
crypt.py	3.76 KB	-rw-r--r--	2025-10-09 11:25
csv.py	15.65 KB	-rw-r--r--	2025-10-09 11:25
dataclasses.py	55.07 KB	-rw-r--r--	2025-10-09 11:25
datetime.py	86.02 KB	-rw-r--r--	2025-10-09 11:25
decimal.py	320 B	-rw-r--r--	2025-10-09 11:25
difflib.py	81.36 KB	-rw-r--r--	2025-10-09 11:25
dis.py	19.55 KB	-rw-r--r--	2025-10-09 11:25
doctest.py	102.68 KB	-rw-r--r--	2025-10-09 11:25
enum.py	38.9 KB	-rw-r--r--	2025-10-09 11:25
filecmp.py	9.94 KB	-rw-r--r--	2025-10-09 11:25
fileinput.py	16.06 KB	-rw-r--r--	2025-10-09 11:25
fnmatch.py	6.56 KB	-rw-r--r--	2025-10-09 11:25
fractions.py	27.58 KB	-rw-r--r--	2025-10-09 11:25
ftplib.py	34.66 KB	-rw-r--r--	2025-10-09 11:25
functools.py	37.18 KB	-rw-r--r--	2025-10-09 11:25
genericpath.py	5.12 KB	-rw-r--r--	2025-10-09 11:25
getopt.py	7.31 KB	-rw-r--r--	2025-10-09 11:25
getpass.py	5.85 KB	-rw-r--r--	2025-10-09 11:25
gettext.py	26.63 KB	-rw-r--r--	2025-10-09 11:25
glob.py	7.7 KB	-rw-r--r--	2025-10-09 11:25
graphlib.py	9.35 KB	-rw-r--r--	2025-10-09 11:25
gzip.py	21.34 KB	-rw-r--r--	2025-10-09 11:25
hashlib.py	9.99 KB	-rw-r--r--	2025-10-09 11:25
heapq.py	22.34 KB	-rw-r--r--	2025-10-09 11:25
hmac.py	7.54 KB	-rw-r--r--	2025-10-09 11:25
imaplib.py	53.92 KB	-rw-r--r--	2025-10-09 11:25
imghdr.py	3.72 KB	-rw-r--r--	2025-10-09 11:25
imp.py	10.34 KB	-rw-r--r--	2025-10-09 11:25
inspect.py	121.46 KB	-rw-r--r--	2025-10-09 11:25
io.py	4.1 KB	-rw-r--r--	2025-10-09 11:25
ipaddress.py	78.94 KB	-rw-r--r--	2025-10-09 11:25
keyword.py	1.04 KB	-rw-r--r--	2025-10-09 11:25
linecache.py	5.56 KB	-rw-r--r--	2025-10-09 11:25
locale.py	76.29 KB	-rw-r--r--	2025-10-09 11:25
lzma.py	12.97 KB	-rw-r--r--	2025-10-09 11:25
mailbox.py	76.95 KB	-rw-r--r--	2025-10-09 11:25
mailcap.py	8.9 KB	-rw-r--r--	2025-10-09 11:25
mimetypes.py	22.01 KB	-rw-r--r--	2025-10-09 11:25
modulefinder.py	23.83 KB	-rw-r--r--	2025-10-09 11:25
netrc.py	5.61 KB	-rw-r--r--	2025-10-09 11:25
nntplib.py	40.06 KB	-rw-r--r--	2025-10-09 11:25
ntpath.py	29.24 KB	-rw-r--r--	2025-10-09 11:25
nturl2path.py	2.82 KB	-rw-r--r--	2025-10-09 11:25
numbers.py	10.11 KB	-rw-r--r--	2025-10-09 11:25
opcode.py	5.76 KB	-rw-r--r--	2025-10-09 11:25
operator.py	10.5 KB	-rw-r--r--	2025-10-09 11:25
optparse.py	58.95 KB	-rw-r--r--	2025-10-09 11:25
os.py	38.63 KB	-rw-r--r--	2025-10-09 11:25
pathlib.py	48.41 KB	-rw-r--r--	2025-10-09 11:25
pdb.py	61.76 KB	-rwxr-xr-x	2025-10-09 11:25
pickle.py	63.43 KB	-rw-r--r--	2025-10-09 11:25
pickletools.py	91.29 KB	-rw-r--r--	2025-10-09 11:25
pipes.py	8.71 KB	-rw-r--r--	2025-10-09 11:25
pkgutil.py	24 KB	-rw-r--r--	2025-10-09 11:25
platform.py	41.05 KB	-rwxr-xr-x	2025-10-09 11:25
plistlib.py	27.69 KB	-rw-r--r--	2025-10-09 11:25
poplib.py	14.84 KB	-rw-r--r--	2025-10-09 11:25
posixpath.py	16.05 KB	-rw-r--r--	2025-10-09 11:25
pprint.py	23.87 KB	-rw-r--r--	2025-10-09 11:25
profile.py	22.36 KB	-rwxr-xr-x	2025-10-09 11:25
pstats.py	28.64 KB	-rw-r--r--	2025-10-09 11:25
pty.py	5.09 KB	-rw-r--r--	2025-10-09 11:25
py_compile.py	7.71 KB	-rw-r--r--	2026-01-09 08:02
pyclbr.py	11.13 KB	-rw-r--r--	2025-10-09 11:25
pydoc.py	107.03 KB	-rwxr-xr-x	2025-10-09 11:25
queue.py	11.23 KB	-rw-r--r--	2025-10-09 11:25
quopri.py	7.11 KB	-rwxr-xr-x	2025-10-09 11:25
random.py	32.44 KB	-rw-r--r--	2025-10-09 11:25
re.py	15.49 KB	-rw-r--r--	2025-10-09 11:25
reprlib.py	5.14 KB	-rw-r--r--	2025-10-09 11:25
rlcompleter.py	7.63 KB	-rw-r--r--	2025-10-09 11:25
runpy.py	12.8 KB	-rw-r--r--	2025-10-09 11:25
sched.py	6.2 KB	-rw-r--r--	2025-10-09 11:25
secrets.py	1.99 KB	-rw-r--r--	2025-10-09 11:25
selectors.py	19.08 KB	-rw-r--r--	2025-10-09 11:25
shelve.py	8.36 KB	-rw-r--r--	2025-10-09 11:25
shlex.py	13.18 KB	-rw-r--r--	2025-10-09 11:25
shutil.py	53.29 KB	-rw-r--r--	2025-10-09 11:25
signal.py	2.38 KB	-rw-r--r--	2025-10-09 11:25
site.py	22.39 KB	-rw-r--r--	2025-10-09 11:25
smtpd.py	34.35 KB	-rwxr-xr-x	2025-10-09 11:25
smtplib.py	44.37 KB	-rwxr-xr-x	2025-10-09 11:25
sndhdr.py	6.93 KB	-rw-r--r--	2025-10-09 11:25
socket.py	36.14 KB	-rw-r--r--	2025-10-09 11:25
socketserver.py	26.66 KB	-rw-r--r--	2025-10-09 11:25
sre_compile.py	27.32 KB	-rw-r--r--	2025-10-09 11:25
sre_constants.py	7.01 KB	-rw-r--r--	2025-10-09 11:25
sre_parse.py	39.82 KB	-rw-r--r--	2025-10-09 11:25
ssl.py	52.63 KB	-rw-r--r--	2025-10-09 11:25
stat.py	5.36 KB	-rw-r--r--	2025-10-09 11:25
statistics.py	42.19 KB	-rw-r--r--	2025-10-09 11:25
string.py	10.32 KB	-rw-r--r--	2025-10-09 11:25
stringprep.py	12.61 KB	-rw-r--r--	2025-10-09 11:25
struct.py	257 B	-rw-r--r--	2025-10-09 11:25
subprocess.py	82.93 KB	-rw-r--r--	2025-10-09 11:25
sunau.py	17.73 KB	-rw-r--r--	2025-10-09 11:25
symtable.py	9.98 KB	-rw-r--r--	2025-10-09 11:25
sysconfig.py	26.96 KB	-rw-r--r--	2025-10-09 11:25
tabnanny.py	11.05 KB	-rwxr-xr-x	2025-10-09 11:25
tarfile.py	109.12 KB	-rwxr-xr-x	2025-10-09 11:25
telnetlib.py	22.71 KB	-rw-r--r--	2025-10-09 11:25
tempfile.py	28.78 KB	-rw-r--r--	2025-10-09 11:25
textwrap.py	19.31 KB	-rw-r--r--	2025-10-09 11:25
this.py	1003 B	-rw-r--r--	2025-10-09 11:25
threading.py	55.41 KB	-rw-r--r--	2026-01-09 08:02
timeit.py	13.19 KB	-rwxr-xr-x	2025-10-09 11:25
token.py	2.33 KB	-rw-r--r--	2025-10-09 11:25
tokenize.py	25.31 KB	-rw-r--r--	2025-10-09 11:25
trace.py	28.54 KB	-rwxr-xr-x	2025-10-09 11:25
traceback.py	25.61 KB	-rw-r--r--	2025-10-09 11:25
tracemalloc.py	17.62 KB	-rw-r--r--	2025-10-09 11:25
tty.py	879 B	-rw-r--r--	2025-10-09 11:25
types.py	9.88 KB	-rw-r--r--	2025-10-09 11:25
typing.py	90.39 KB	-rw-r--r--	2025-10-09 11:25
uu.py	7.11 KB	-rw-r--r--	2026-01-09 08:16
uuid.py	26.86 KB	-rw-r--r--	2025-10-09 11:25
warnings.py	19.23 KB	-rw-r--r--	2025-10-09 11:25
wave.py	17.58 KB	-rw-r--r--	2025-10-09 11:25
weakref.py	21.05 KB	-rw-r--r--	2025-10-09 11:25
webbrowser.py	23.69 KB	-rwxr-xr-x	2025-10-09 11:25
xdrlib.py	5.77 KB	-rw-r--r--	2025-10-09 11:25
zipapp.py	7.36 KB	-rw-r--r--	2025-10-09 11:25
zipfile.py	88.73 KB	-rw-r--r--	2025-10-09 11:25
zipimport.py	30.17 KB	-rw-r--r--	2025-10-09 11:25

Rename

"""Cache lines from Python source files.

This is intended to read lines from modules imported -- hence if a filename
is not found, it will look down the module search path for a file by
that name.
"""

import functools
import sys
import os
import tokenize

__all__ = ["getline", "clearcache", "checkcache", "lazycache"]

# The cache. Maps filenames to either a thunk which will provide source code,
# or a tuple (size, mtime, lines, fullname) once loaded.
cache = {}

def clearcache():
    """Clear the cache entirely."""
    cache.clear()

def getline(filename, lineno, module_globals=None):
    """Get a line for a Python source file from the cache.
    Update the cache if it doesn't contain an entry for this file already."""

lines = getlines(filename, module_globals)
    if 1 <= lineno <= len(lines):
        return lines[lineno - 1]
    return ''

def getlines(filename, module_globals=None):
    """Get the lines for a Python source file from the cache.
    Update the cache if it doesn't contain an entry for this file already."""

if filename in cache:
        entry = cache[filename]
        if len(entry) != 1:
            return cache[filename][2]

try:
        return updatecache(filename, module_globals)
    except MemoryError:
        clearcache()
        return []

def checkcache(filename=None):
    """Discard cache entries that are out of date.
    (This is not checked upon each call!)"""

if filename is None:
        filenames = list(cache.keys())
    elif filename in cache:
        filenames = [filename]
    else:
        return

for filename in filenames:
        entry = cache[filename]
        if len(entry) == 1:
            # lazy cache entry, leave it lazy.
            continue
        size, mtime, lines, fullname = entry
        if mtime is None:
            continue   # no-op for files loaded via a __loader__
        try:
            stat = os.stat(fullname)
        except OSError:
            cache.pop(filename, None)
            continue
        if size != stat.st_size or mtime != stat.st_mtime:
            cache.pop(filename, None)

def updatecache(filename, module_globals=None):
    """Update a cache entry and return its list of lines.
    If something's wrong, print a message, discard the cache entry,
    and return an empty list."""

if filename in cache:
        if len(cache[filename]) != 1:
            cache.pop(filename, None)
    if not filename or (filename.startswith('<') and filename.endswith('>')):
        return []

fullname = filename
    try:
        stat = os.stat(fullname)
    except OSError:
        basename = filename

# Realise a lazy loader based lookup if there is one
        # otherwise try to lookup right now.
        if lazycache(filename, module_globals):
            try:
                data = cache[filename][0]()
            except (ImportError, OSError):
                pass
            else:
                if data is None:
                    # No luck, the PEP302 loader cannot find the source
                    # for this module.
                    return []
                cache[filename] = (
                    len(data),
                    None,
                    [line + '\n' for line in data.splitlines()],
                    fullname
                )
                return cache[filename][2]

# Try looking through the module search path, which is only useful
        # when handling a relative filename.
        if os.path.isabs(filename):
            return []

for dirname in sys.path:
            try:
                fullname = os.path.join(dirname, basename)
            except (TypeError, AttributeError):
                # Not sufficiently string-like to do anything useful with.
                continue
            try:
                stat = os.stat(fullname)
                break
            except OSError:
                pass
        else:
            return []
    try:
        with tokenize.open(fullname) as fp:
            lines = fp.readlines()
    except (OSError, UnicodeDecodeError, SyntaxError):
        return []
    if lines and not lines[-1].endswith('\n'):
        lines[-1] += '\n'
    size, mtime = stat.st_size, stat.st_mtime
    cache[filename] = size, mtime, lines, fullname
    return lines

def lazycache(filename, module_globals):
    """Seed the cache for filename with module_globals.

The module loader will be asked for the source only when getlines is
    called, not immediately.

If there is an entry in the cache already, it is not altered.

:return: True if a lazy load is registered in the cache,
        otherwise False. To register such a load a module loader with a
        get_source method must be found, the filename must be a cacheable
        filename, and the filename must not be already cached.
    """
    if filename in cache:
        if len(cache[filename]) == 1:
            return True
        else:
            return False
    if not filename or (filename.startswith('<') and filename.endswith('>')):
        return False
    # Try for a __loader__, if available
    if module_globals and '__name__' in module_globals:
        name = module_globals['__name__']
        if (loader := module_globals.get('__loader__')) is None:
            if spec := module_globals.get('__spec__'):
                try:
                    loader = spec.loader
                except AttributeError:
                    pass
        get_source = getattr(loader, 'get_source', None)

if name and get_source:
            get_lines = functools.partial(get_source, name)
            cache[filename] = (get_lines,)
            return True
    return False