FM / python3.12

/snap/core24/1643/usr/lib/python3.12

Name	Size	Mode	Actions
asyncio/	-	0755	rm
collections/	-	0755	rm
concurrent/	-	0755	rm
ctypes/	-	0755	rm
curses/	-	0755	rm
dbm/	-	0755	rm
email/	-	0755	rm
encodings/	-	0755	rm
html/	-	0755	rm
http/	-	0755	rm
importlib/	-	0755	rm
json/	-	0755	rm
lib-dynload/	-	0755	rm
logging/	-	0755	rm
multiprocessing/	-	0755	rm
pydoc_data/	-	0755	rm
re/	-	0755	rm
sqlite3/	-	0755	rm
test/	-	0755	rm
tomllib/	-	0755	rm
unittest/	-	0755	rm
urllib/	-	0755	rm
venv/	-	0755	rm
wsgiref/	-	0755	rm
xml/	-	0755	rm
xmlrpc/	-	0755	rm
zipfile/	-	0755	rm
zoneinfo/	-	0755	rm
__phello__/	-	0755	rm
__pycache__/	-	0755	rm
abc.py	6538	0644	edit dl rm
aifc.py	34211	0644	edit dl rm
antigravity.py	500	0644	edit dl rm
argparse.py	101750	0644	edit dl rm
ast.py	64260	0644	edit dl rm
base64.py	20602	0755	edit dl rm
bdb.py	32463	0644	edit dl rm
bisect.py	3423	0644	edit dl rm
bz2.py	11847	0644	edit dl rm
calendar.py	25418	0644	edit dl rm
cgi.py	34418	0755	edit dl rm
cgitb.py	12421	0644	edit dl rm
chunk.py	5500	0644	edit dl rm
cmd.py	14873	0644	edit dl rm
code.py	10695	0644	edit dl rm
codecs.py	36870	0644	edit dl rm
codeop.py	5908	0644	edit dl rm
colorsys.py	4062	0644	edit dl rm
compileall.py	20598	0644	edit dl rm
configparser.py	53789	0644	edit dl rm
contextlib.py	27637	0644	edit dl rm
contextvars.py	129	0644	edit dl rm
copy.py	8412	0644	edit dl rm
copyreg.py	7614	0644	edit dl rm
cProfile.py	6555	0755	edit dl rm
crypt.py	3913	0644	edit dl rm
csv.py	16386	0644	edit dl rm
dataclasses.py	61753	0644	edit dl rm
datetime.py	268	0644	edit dl rm
decimal.py	320	0644	edit dl rm
difflib.py	83308	0644	edit dl rm
dis.py	30209	0644	edit dl rm
doctest.py	106479	0644	edit dl rm
enum.py	81636	0644	edit dl rm
EXTERNALLY-MANAGED	645	0644	edit dl rm
filecmp.py	10187	0644	edit dl rm
fileinput.py	15714	0644	edit dl rm
fnmatch.py	5999	0644	edit dl rm
fractions.py	38067	0644	edit dl rm
ftplib.py	34735	0644	edit dl rm
functools.py	38126	0644	edit dl rm
genericpath.py	5572	0644	edit dl rm
getopt.py	7488	0644	edit dl rm
getpass.py	5990	0644	edit dl rm
gettext.py	21747	0644	edit dl rm
glob.py	8732	0644	edit dl rm
graphlib.py	9656	0644	edit dl rm
gzip.py	24859	0644	edit dl rm
hashlib.py	9349	0644	edit dl rm
heapq.py	23024	0644	edit dl rm
hmac.py	7716	0644	edit dl rm
imaplib.py	53688	0644	edit dl rm
imghdr.py	4398	0644	edit dl rm
inspect.py	125420	0644	edit dl rm
io.py	3582	0644	edit dl rm
ipaddress.py	78294	0644	edit dl rm
keyword.py	1073	0644	edit dl rm
LICENSE.txt	13936	0644	edit dl rm
linecache.py	5649	0644	edit dl rm
locale.py	78562	0644	edit dl rm
lzma.py	13277	0644	edit dl rm
mailbox.py	78911	0644	edit dl rm
mailcap.py	9333	0644	edit dl rm
mimetypes.py	22888	0644	edit dl rm
modulefinder.py	23699	0644	edit dl rm
netrc.py	6922	0644	edit dl rm
nntplib.py	41087	0644	edit dl rm
ntpath.py	30027	0644	edit dl rm
nturl2path.py	2887	0644	edit dl rm
numbers.py	11467	0644	edit dl rm
opcode.py	13174	0644	edit dl rm
operator.py	10965	0644	edit dl rm
optparse.py	60369	0644	edit dl rm
os.py	39786	0644	edit dl rm
pathlib.py	51153	0644	edit dl rm
pdb.py	69459	0755	edit dl rm
pickle.py	64901	0644	edit dl rm
pickletools.py	93861	0644	edit dl rm
pipes.py	8978	0644	edit dl rm
pkgutil.py	18281	0644	edit dl rm
platform.py	43331	0755	edit dl rm
plistlib.py	28582	0644	edit dl rm
poplib.py	14163	0644	edit dl rm
posixpath.py	17623	0644	edit dl rm
pprint.py	24158	0644	edit dl rm
profile.py	23092	0755	edit dl rm
pstats.py	29289	0644	edit dl rm
pty.py	6137	0644	edit dl rm
pyclbr.py	11396	0644	edit dl rm
pydoc.py	113090	0755	edit dl rm
py_compile.py	7878	0644	edit dl rm
queue.py	11496	0644	edit dl rm
quopri.py	7183	0755	edit dl rm
random.py	34683	0644	edit dl rm
reprlib.py	6569	0644	edit dl rm
rlcompleter.py	7827	0644	edit dl rm
runpy.py	12898	0644	edit dl rm
sched.py	6351	0644	edit dl rm
secrets.py	1984	0644	edit dl rm
selectors.py	19671	0644	edit dl rm
shelve.py	8560	0644	edit dl rm
shlex.py	13353	0644	edit dl rm
shutil.py	58120	0644	edit dl rm
signal.py	2495	0644	edit dl rm
site.py	23903	0644	edit dl rm
sitecustomize.py	-	0	edit dl rm
smtplib.py	43531	0755	edit dl rm
sndhdr.py	7448	0644	edit dl rm
socket.py	37411	0644	edit dl rm
socketserver.py	27851	0644	edit dl rm
sre_compile.py	231	0644	edit dl rm
sre_constants.py	232	0644	edit dl rm
sre_parse.py	229	0644	edit dl rm
ssl.py	50822	0644	edit dl rm
stat.py	5485	0644	edit dl rm
statistics.py	50227	0644	edit dl rm
string.py	11786	0644	edit dl rm
stringprep.py	12917	0644	edit dl rm
struct.py	257	0644	edit dl rm
subprocess.py	88725	0644	edit dl rm
sunau.py	18478	0644	edit dl rm
symtable.py	10753	0644	edit dl rm
sysconfig.py	32768	0644	edit dl rm
tabnanny.py	11530	0755	edit dl rm
tarfile.py	112555	0755	edit dl rm
telnetlib.py	23301	0644	edit dl rm
tempfile.py	37334	0644	edit dl rm
textwrap.py	19718	0644	edit dl rm
this.py	1003	0644	edit dl rm
threading.py	60123	0644	edit dl rm
timeit.py	13463	0755	edit dl rm
token.py	2479	0644	edit dl rm
tokenize.py	21214	0644	edit dl rm
trace.py	29182	0755	edit dl rm
traceback.py	46325	0644	edit dl rm
tracemalloc.py	18047	0644	edit dl rm
tty.py	2035	0644	edit dl rm
turtle.py	146361	0644	edit dl rm
types.py	10993	0644	edit dl rm
typing.py	117428	0644	edit dl rm
uu.py	7364	0755	edit dl rm
uuid.py	29656	0644	edit dl rm
warnings.py	21760	0644	edit dl rm
wave.py	22769	0644	edit dl rm
weakref.py	21513	0644	edit dl rm
webbrowser.py	23627	0755	edit dl rm
xdrlib.py	5942	0644	edit dl rm
zipapp.py	7543	0644	edit dl rm
zipimport.py	28132	0644	edit dl rm
_aix_support.py	4021	0644	edit dl rm
_collections_abc.py	32082	0644	edit dl rm
_compat_pickle.py	8761	0644	edit dl rm
_compression.py	5681	0644	edit dl rm
_distutils_system_mod.py	5716	0644	edit dl rm
_markupbase.py	14653	0644	edit dl rm
_osx_support.py	22023	0644	edit dl rm
_pydatetime.py	92097	0644	edit dl rm
_pydecimal.py	229220	0644	edit dl rm
_pyio.py	93593	0644	edit dl rm
_pylong.py	9047	0644	edit dl rm
_py_abc.py	6189	0644	edit dl rm
_sitebuiltins.py	3128	0644	edit dl rm
_strptime.py	24615	0644	edit dl rm
_sysconfigdata__linux_x86_64-linux-gnu.py	49505	0644	edit dl rm
_sysconfigdata__x86_64-linux-gnu.py	49505	0644	edit dl rm
_threading_local.py	7220	0644	edit dl rm
_weakrefset.py	5893	0644	edit dl rm
__future__.py	5218	0644	edit dl rm
__hello__.py	227	0644	edit dl rm

Edit: /snap/core24/1643/usr/lib/python3.12/pyclbr.py (11396B)

"""Parse a Python module and describe its classes and functions.

Parse enough of a Python file to recognize imports and class and
function definitions, and to find out the superclasses of a class.

The interface consists of a single function:
    readmodule_ex(module, path=None)
where module is the name of a Python module, and path is an optional
list of directories where the module is to be searched.  If present,
path is prepended to the system search path sys.path.  The return value
is a dictionary.  The keys of the dictionary are the names of the
classes and functions defined in the module (including classes that are
defined via the from XXX import YYY construct).  The values are
instances of classes Class and Function.  One special key/value pair is
present for packages: the key '__path__' has a list as its value which
contains the package search path.

Classes and Functions have a common superclass: _Object.  Every instance
has the following attributes:
    module  -- name of the module;
    name    -- name of the object;
    file    -- file in which the object is defined;
    lineno  -- line in the file where the object's definition starts;
    end_lineno -- line in the file where the object's definition ends;
    parent  -- parent of this object, if any;
    children -- nested objects contained in this object.
The 'children' attribute is a dictionary mapping names to objects.

Instances of Function describe functions with the attributes from _Object,
plus the following:
    is_async -- if a function is defined with an 'async' prefix

Instances of Class describe classes with the attributes from _Object,
plus the following:
    super   -- list of super classes (Class instances if possible);
    methods -- mapping of method names to beginning line numbers.
If the name of a super class is not recognized, the corresponding
entry in the list of super classes is not a class instance but a
string giving the name of the super class.  Since import statements
are recognized and imported modules are scanned as well, this
shouldn't happen often.
"""

import ast
import sys
import importlib.util

__all__ = ["readmodule", "readmodule_ex", "Class", "Function"]

_modules = {}  # Initialize cache of modules we've seen.

class _Object:
    "Information about Python class or function."
    def __init__(self, module, name, file, lineno, end_lineno, parent):
        self.module = module
        self.name = name
        self.file = file
        self.lineno = lineno
        self.end_lineno = end_lineno
        self.parent = parent
        self.children = {}
        if parent is not None:
            parent.children[name] = self

# Odd Function and Class signatures are for back-compatibility.
class Function(_Object):
    "Information about a Python function, including methods."
    def __init__(self, module, name, file, lineno,
                 parent=None, is_async=False, *, end_lineno=None):
        super().__init__(module, name, file, lineno, end_lineno, parent)
        self.is_async = is_async
        if isinstance(parent, Class):
            parent.methods[name] = lineno

class Class(_Object):
    "Information about a Python class."
    def __init__(self, module, name, super_, file, lineno,
                 parent=None, *, end_lineno=None):
        super().__init__(module, name, file, lineno, end_lineno, parent)
        self.super = super_ or []
        self.methods = {}

# These 2 functions are used in these tests
# Lib/test/test_pyclbr, Lib/idlelib/idle_test/test_browser.py
def _nest_function(ob, func_name, lineno, end_lineno, is_async=False):
    "Return a Function after nesting within ob."
    return Function(ob.module, func_name, ob.file, lineno,
                    parent=ob, is_async=is_async, end_lineno=end_lineno)

def _nest_class(ob, class_name, lineno, end_lineno, super=None):
    "Return a Class after nesting within ob."
    return Class(ob.module, class_name, super, ob.file, lineno,
                 parent=ob, end_lineno=end_lineno)

def readmodule(module, path=None):
    """Return Class objects for the top-level classes in module.

This is the original interface, before Functions were added.
    """

res = {}
    for key, value in _readmodule(module, path or []).items():
        if isinstance(value, Class):
            res[key] = value
    return res

def readmodule_ex(module, path=None):
    """Return a dictionary with all functions and classes in module.

Search for module in PATH + sys.path.
    If possible, include imported superclasses.
    Do this by reading source, without importing (and executing) it.
    """
    return _readmodule(module, path or [])

def _readmodule(module, path, inpackage=None):
    """Do the hard work for readmodule[_ex].

If inpackage is given, it must be the dotted name of the package in
    which we are searching for a submodule, and then PATH must be the
    package search path; otherwise, we are searching for a top-level
    module, and path is combined with sys.path.
    """
    # Compute the full module name (prepending inpackage if set).
    if inpackage is not None:
        fullmodule = "%s.%s" % (inpackage, module)
    else:
        fullmodule = module

# Check in the cache.
    if fullmodule in _modules:
        return _modules[fullmodule]

# Initialize the dict for this module's contents.
    tree = {}

# Check if it is a built-in module; we don't do much for these.
    if module in sys.builtin_module_names and inpackage is None:
        _modules[module] = tree
        return tree

# Check for a dotted module name.
    i = module.rfind('.')
    if i >= 0:
        package = module[:i]
        submodule = module[i+1:]
        parent = _readmodule(package, path, inpackage)
        if inpackage is not None:
            package = "%s.%s" % (inpackage, package)
        if not '__path__' in parent:
            raise ImportError('No package named {}'.format(package))
        return _readmodule(submodule, parent['__path__'], package)

# Search the path for the module.
    f = None
    if inpackage is not None:
        search_path = path
    else:
        search_path = path + sys.path
    spec = importlib.util._find_spec_from_path(fullmodule, search_path)
    if spec is None:
        raise ModuleNotFoundError(f"no module named {fullmodule!r}", name=fullmodule)
    _modules[fullmodule] = tree
    # Is module a package?
    if spec.submodule_search_locations is not None:
        tree['__path__'] = spec.submodule_search_locations
    try:
        source = spec.loader.get_source(fullmodule)
    except (AttributeError, ImportError):
        # If module is not Python source, we cannot do anything.
        return tree
    else:
        if source is None:
            return tree

fname = spec.loader.get_filename(fullmodule)
    return _create_tree(fullmodule, path, fname, source, tree, inpackage)

class _ModuleBrowser(ast.NodeVisitor):
    def __init__(self, module, path, file, tree, inpackage):
        self.path = path
        self.tree = tree
        self.file = file
        self.module = module
        self.inpackage = inpackage
        self.stack = []

def visit_ClassDef(self, node):
        bases = []
        for base in node.bases:
            name = ast.unparse(base)
            if name in self.tree:
                # We know this super class.
                bases.append(self.tree[name])
            elif len(names := name.split(".")) > 1:
                # Super class form is module.class:
                # look in module for class.
                *_, module, class_ = names
                if module in _modules:
                    bases.append(_modules[module].get(class_, name))
            else:
                bases.append(name)

parent = self.stack[-1] if self.stack else None
        class_ = Class(self.module, node.name, bases, self.file, node.lineno,
                       parent=parent, end_lineno=node.end_lineno)
        if parent is None:
            self.tree[node.name] = class_
        self.stack.append(class_)
        self.generic_visit(node)
        self.stack.pop()

def visit_FunctionDef(self, node, *, is_async=False):
        parent = self.stack[-1] if self.stack else None
        function = Function(self.module, node.name, self.file, node.lineno,
                            parent, is_async, end_lineno=node.end_lineno)
        if parent is None:
            self.tree[node.name] = function
        self.stack.append(function)
        self.generic_visit(node)
        self.stack.pop()

def visit_AsyncFunctionDef(self, node):
        self.visit_FunctionDef(node, is_async=True)

def visit_Import(self, node):
        if node.col_offset != 0:
            return

for module in node.names:
            try:
                try:
                    _readmodule(module.name, self.path, self.inpackage)
                except ImportError:
                    _readmodule(module.name, [])
            except (ImportError, SyntaxError):
                # If we can't find or parse the imported module,
                # too bad -- don't die here.
                continue

def visit_ImportFrom(self, node):
        if node.col_offset != 0:
            return
        try:
            module = "." * node.level
            if node.module:
                module += node.module
            module = _readmodule(module, self.path, self.inpackage)
        except (ImportError, SyntaxError):
            return

for name in node.names:
            if name.name in module:
                self.tree[name.asname or name.name] = module[name.name]
            elif name.name == "*":
                for import_name, import_value in module.items():
                    if import_name.startswith("_"):
                        continue
                    self.tree[import_name] = import_value

def _create_tree(fullmodule, path, fname, source, tree, inpackage):
    mbrowser = _ModuleBrowser(fullmodule, path, fname, tree, inpackage)
    mbrowser.visit(ast.parse(source))
    return mbrowser.tree

def _main():
    "Print module output (default this file) for quick visual check."
    import os
    try:
        mod = sys.argv[1]
    except:
        mod = __file__
    if os.path.exists(mod):
        path = [os.path.dirname(mod)]
        mod = os.path.basename(mod)
        if mod.lower().endswith(".py"):
            mod = mod[:-3]
    else:
        path = []
    tree = readmodule_ex(mod, path)
    lineno_key = lambda a: getattr(a, 'lineno', 0)
    objs = sorted(tree.values(), key=lineno_key, reverse=True)
    indent_level = 2
    while objs:
        obj = objs.pop()
        if isinstance(obj, list):
            # Value is a __path__ key.
            continue
        if not hasattr(obj, 'indent'):
            obj.indent = 0

if isinstance(obj, _Object):
            new_objs = sorted(obj.children.values(),
                              key=lineno_key, reverse=True)
            for ob in new_objs:
                ob.indent = obj.indent + indent_level
            objs.extend(new_objs)
        if isinstance(obj, Class):
            print("{}class {} {} {}"
                  .format(' ' * obj.indent, obj.name, obj.super, obj.lineno))
        elif isinstance(obj, Function):
            print("{}def {} {}".format(' ' * obj.indent, obj.name, obj.lineno))

if __name__ == "__main__":
    _main()

cmd: