FM / idlelib

/opt/alt/python36/lib64/python3.6/idlelib/

/opt/alt/python36/lib64/python3.6/idlelib

Name	Size	Mode	Actions
Icons/	-	0755	rm
idle_test/	-	0755	rm
__pycache__/	-	0755	rm
autocomplete.py	9324	0644	edit dl rm
autocomplete_w.py	19829	0644	edit dl rm
autoexpand.py	3216	0644	edit dl rm
browser.py	8281	0644	edit dl rm
calltip.py	6067	0644	edit dl rm
calltip_w.py	7111	0644	edit dl rm
ChangeLog	56360	0644	edit dl rm
codecontext.py	10490	0644	edit dl rm
colorizer.py	11275	0644	edit dl rm
config-extensions.def	2266	0644	edit dl rm
config-highlight.def	2687	0644	edit dl rm
config-keys.def	10775	0644	edit dl rm
config-main.def	3128	0644	edit dl rm
config.py	38878	0644	edit dl rm
configdialog.py	101057	0644	edit dl rm
config_key.py	13408	0644	edit dl rm
CREDITS.txt	1866	0644	edit dl rm
debugger.py	19097	0644	edit dl rm
debugger_r.py	12140	0644	edit dl rm
debugobj.py	4055	0644	edit dl rm
debugobj_r.py	1082	0644	edit dl rm
delegator.py	1043	0644	edit dl rm
dynoption.py	2017	0644	edit dl rm
editor.py	67275	0644	edit dl rm
extend.txt	3642	0644	edit dl rm
filelist.py	3896	0644	edit dl rm
grep.py	6742	0644	edit dl rm
help.html	55114	0644	edit dl rm
help.py	11325	0644	edit dl rm
help_about.py	8981	0644	edit dl rm
history.py	4043	0644	edit dl rm
HISTORY.txt	10312	0644	edit dl rm
hyperparser.py	12882	0644	edit dl rm
idle.py	454	0644	edit dl rm
idle.pyw	570	0644	edit dl rm
iomenu.py	20734	0644	edit dl rm
macosx.py	9660	0644	edit dl rm
mainmenu.py	3703	0644	edit dl rm
multicall.py	18648	0644	edit dl rm
NEWS.txt	39839	0644	edit dl rm
NEWS2x.txt	27172	0644	edit dl rm
outwin.py	5808	0644	edit dl rm
paragraph.py	7167	0644	edit dl rm
parenmatch.py	7204	0644	edit dl rm
pathbrowser.py	3193	0644	edit dl rm
percolator.py	3130	0644	edit dl rm
pyparse.py	20118	0644	edit dl rm
pyshell.py	57728	0755	edit dl rm
query.py	12434	0644	edit dl rm
README.txt	9592	0644	edit dl rm
redirector.py	6875	0644	edit dl rm
replace.py	7502	0644	edit dl rm
rpc.py	21137	0644	edit dl rm
rstrip.py	868	0644	edit dl rm
run.py	17272	0644	edit dl rm
runscript.py	7841	0644	edit dl rm
scrolledlist.py	4458	0644	edit dl rm
search.py	3164	0644	edit dl rm
searchbase.py	7451	0644	edit dl rm
searchengine.py	7472	0644	edit dl rm
squeezer.py	13308	0644	edit dl rm
stackviewer.py	4454	0644	edit dl rm
statusbar.py	1441	0644	edit dl rm
textview.py	6121	0644	edit dl rm
TODO.txt	8478	0644	edit dl rm
tooltip.py	6486	0644	edit dl rm
tree.py	15089	0644	edit dl rm
undo.py	11047	0644	edit dl rm
window.py	2588	0644	edit dl rm
zoomheight.py	1340	0644	edit dl rm
zzdummy.py	961	0644	edit dl rm
_pyclbr.py	15199	0644	edit dl rm
__init__.py	396	0644	edit dl rm
__main__.py	159	0644	edit dl rm

Edit: /opt/alt/python36/lib64/python3.6/idlelib/calltip.py (6067B)

"""Pop up a reminder of how to call a function.

Call Tips are floating windows which display function, class, and method
parameter and docstring information when you type an opening parenthesis, and
which disappear when you type a closing parenthesis.
"""
import inspect
import re
import sys
import textwrap
import types

from idlelib import calltip_w
from idlelib.hyperparser import HyperParser
import __main__

class Calltip:

def __init__(self, editwin=None):
        if editwin is None:  # subprocess and test
            self.editwin = None
        else:
            self.editwin = editwin
            self.text = editwin.text
            self.active_calltip = None
            self._calltip_window = self._make_tk_calltip_window

def close(self):
        self._calltip_window = None

def _make_tk_calltip_window(self):
        # See __init__ for usage
        return calltip_w.CalltipWindow(self.text)

def _remove_calltip_window(self, event=None):
        if self.active_calltip:
            self.active_calltip.hidetip()
            self.active_calltip = None

def force_open_calltip_event(self, event):
        "The user selected the menu entry or hotkey, open the tip."
        self.open_calltip(True)
        return "break"

def try_open_calltip_event(self, event):
        """Happens when it would be nice to open a calltip, but not really
        necessary, for example after an opening bracket, so function calls
        won't be made.
        """
        self.open_calltip(False)

def refresh_calltip_event(self, event):
        if self.active_calltip and self.active_calltip.tipwindow:
            self.open_calltip(False)

def open_calltip(self, evalfuncs):
        self._remove_calltip_window()

hp = HyperParser(self.editwin, "insert")
        sur_paren = hp.get_surrounding_brackets('(')
        if not sur_paren:
            return
        hp.set_index(sur_paren[0])
        expression  = hp.get_expression()
        if not expression:
            return
        if not evalfuncs and (expression.find('(') != -1):
            return
        argspec = self.fetch_tip(expression)
        if not argspec:
            return
        self.active_calltip = self._calltip_window()
        self.active_calltip.showtip(argspec, sur_paren[0], sur_paren[1])

def fetch_tip(self, expression):
        """Return the argument list and docstring of a function or class.

If there is a Python subprocess, get the calltip there.  Otherwise,
        either this fetch_tip() is running in the subprocess or it was
        called in an IDLE running without the subprocess.

The subprocess environment is that of the most recently run script.  If
        two unrelated modules are being edited some calltips in the current
        module may be inoperative if the module was not the last to run.

To find methods, fetch_tip must be fed a fully qualified name.

"""
        try:
            rpcclt = self.editwin.flist.pyshell.interp.rpcclt
        except AttributeError:
            rpcclt = None
        if rpcclt:
            return rpcclt.remotecall("exec", "get_the_calltip",
                                     (expression,), {})
        else:
            return get_argspec(get_entity(expression))

def get_entity(expression):
    """Return the object corresponding to expression evaluated
    in a namespace spanning sys.modules and __main.dict__.
    """
    if expression:
        namespace = sys.modules.copy()
        namespace.update(__main__.__dict__)
        try:
            return eval(expression, namespace)
        except BaseException:
            # An uncaught exception closes idle, and eval can raise any
            # exception, especially if user classes are involved.
            return None

# The following are used in get_argspec and some in tests
_MAX_COLS = 85
_MAX_LINES = 5  # enough for bytes
_INDENT = ' '*4  # for wrapped signatures
_first_param = re.compile(r'(?<=\()\w*\,?\s*')
_default_callable_argspec = "See source or doc"
_invalid_method = "invalid method signature"
_argument_positional = "\n['/' marks preceding arguments as positional-only]\n"

def get_argspec(ob):
    '''Return a string describing the signature of a callable object, or ''.

For Python-coded functions and methods, the first line is introspected.
    Delete 'self' parameter for classes (.__init__) and bound methods.
    The next lines are the first lines of the doc string up to the first
    empty line or _MAX_LINES.    For builtins, this typically includes
    the arguments in addition to the return value.
    '''
    argspec = default = ""
    try:
        ob_call = ob.__call__
    except BaseException:
        return default

fob = ob_call if isinstance(ob_call, types.MethodType) else ob

try:
        argspec = str(inspect.signature(fob))
    except ValueError as err:
        msg = str(err)
        if msg.startswith(_invalid_method):
            return _invalid_method

if '/' in argspec:
        """Using AC's positional argument should add the explain"""
        argspec += _argument_positional
    if isinstance(fob, type) and argspec == '()':
        """fob with no argument, use default callable argspec"""
        argspec = _default_callable_argspec

lines = (textwrap.wrap(argspec, _MAX_COLS, subsequent_indent=_INDENT)
             if len(argspec) > _MAX_COLS else [argspec] if argspec else [])

if isinstance(ob_call, types.MethodType):
        doc = ob_call.__doc__
    else:
        doc = getattr(ob, "__doc__", "")
    if doc:
        for line in doc.split('\n', _MAX_LINES)[:_MAX_LINES]:
            line = line.strip()
            if not line:
                break
            if len(line) > _MAX_COLS:
                line = line[: _MAX_COLS - 3] + '...'
            lines.append(line)
        argspec = '\n'.join(lines)
    if not argspec:
        argspec = _default_callable_argspec
    return argspec

if __name__ == '__main__':
    from unittest import main
    main('idlelib.idle_test.test_calltip', verbosity=2)

cmd: