2017-09-10 18:19:47 -03:00
|
|
|
"""Pop up a reminder of how to call a function.
|
2000-08-14 22:13:23 -03:00
|
|
|
|
2002-12-12 15:15:39 -04:00
|
|
|
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.
|
2002-10-10 05:25:24 -03:00
|
|
|
"""
|
2019-03-24 18:32:40 -03:00
|
|
|
import __main__
|
2014-01-26 20:55:34 -04:00
|
|
|
import inspect
|
Merged revisions 53623-53858 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r53624 | peter.astrand | 2007-02-02 20:06:36 +0100 (Fri, 02 Feb 2007) | 1 line
We had several if statements checking the value of a fd. This is unsafe, since valid fds might be zero. We should check for not None instead.
........
r53635 | kurt.kaiser | 2007-02-05 07:03:18 +0100 (Mon, 05 Feb 2007) | 2 lines
Add 'raw' support to configHandler. Patch 1650174 Tal Einat.
........
r53641 | kurt.kaiser | 2007-02-06 00:02:16 +0100 (Tue, 06 Feb 2007) | 5 lines
1. Calltips now 'handle' tuples in the argument list (display '<tuple>' :)
Suggested solution by Christos Georgiou, Bug 791968.
2. Clean up tests, were not failing when they should have been.
4. Remove some camelcase and an unneeded try/except block.
........
r53644 | kurt.kaiser | 2007-02-06 04:21:40 +0100 (Tue, 06 Feb 2007) | 2 lines
Clean up ModifiedInterpreter.runcode() structure
........
r53646 | peter.astrand | 2007-02-06 16:37:50 +0100 (Tue, 06 Feb 2007) | 1 line
Applied patch 1124861.3.patch to solve bug #1124861: Automatically create pipes on Windows, if GetStdHandle fails. Will backport.
........
r53648 | lars.gustaebel | 2007-02-06 19:38:13 +0100 (Tue, 06 Feb 2007) | 4 lines
Patch #1652681: create nonexistent files in append mode and
allow appending to empty files.
........
r53649 | kurt.kaiser | 2007-02-06 20:09:43 +0100 (Tue, 06 Feb 2007) | 4 lines
Updated patch (CodeContext.061217.patch) to
[ 1362975 ] CodeContext - Improved text indentation
Tal Einat 16Dec06
........
r53650 | kurt.kaiser | 2007-02-06 20:21:19 +0100 (Tue, 06 Feb 2007) | 2 lines
narrow exception per [ 1540849 ] except too broad
........
r53653 | kurt.kaiser | 2007-02-07 04:39:41 +0100 (Wed, 07 Feb 2007) | 4 lines
[ 1621265 ] Auto-completion list placement
Move AC window below input line unless not enough space, then put it above.
Patch: Tal Einat
........
r53654 | kurt.kaiser | 2007-02-07 09:07:13 +0100 (Wed, 07 Feb 2007) | 2 lines
Handle AttributeError during calltip lookup
........
r53656 | raymond.hettinger | 2007-02-07 21:08:22 +0100 (Wed, 07 Feb 2007) | 3 lines
SF #1615701: make d.update(m) honor __getitem__() and keys() in dict subclasses
........
r53658 | raymond.hettinger | 2007-02-07 22:04:20 +0100 (Wed, 07 Feb 2007) | 1 line
SF: 1397711 Set docs conflated immutable and hashable
........
r53660 | raymond.hettinger | 2007-02-07 22:42:17 +0100 (Wed, 07 Feb 2007) | 1 line
Check for a common user error with defaultdict().
........
r53662 | raymond.hettinger | 2007-02-07 23:24:07 +0100 (Wed, 07 Feb 2007) | 1 line
Bug #1575169: operator.isSequenceType() now returns False for subclasses of dict.
........
r53664 | raymond.hettinger | 2007-02-08 00:49:03 +0100 (Thu, 08 Feb 2007) | 1 line
Silence compiler warning
........
r53666 | raymond.hettinger | 2007-02-08 01:07:32 +0100 (Thu, 08 Feb 2007) | 1 line
Do not let overflows in enumerate() and count() pass silently.
........
r53668 | raymond.hettinger | 2007-02-08 01:50:39 +0100 (Thu, 08 Feb 2007) | 1 line
Bypass set specific optimizations for set and frozenset subclasses.
........
r53670 | raymond.hettinger | 2007-02-08 02:42:35 +0100 (Thu, 08 Feb 2007) | 1 line
Fix docstring bug
........
r53671 | martin.v.loewis | 2007-02-08 10:13:36 +0100 (Thu, 08 Feb 2007) | 3 lines
Bug #1653736: Complain about keyword arguments to time.isoformat.
Will backport to 2.5.
........
r53679 | kurt.kaiser | 2007-02-08 23:58:18 +0100 (Thu, 08 Feb 2007) | 6 lines
Corrected some bugs in AutoComplete. Also, Page Up/Down in ACW implemented;
mouse and cursor selection in ACWindow implemented; double Tab inserts current
selection and closes ACW (similar to double-click and Return); scroll wheel now
works in ACW. Added AutoComplete instructions to IDLE Help.
........
r53689 | martin.v.loewis | 2007-02-09 13:19:32 +0100 (Fri, 09 Feb 2007) | 3 lines
Bug #1653736: Properly discard third argument to slot_nb_inplace_power.
Will backport.
........
r53691 | martin.v.loewis | 2007-02-09 13:36:48 +0100 (Fri, 09 Feb 2007) | 4 lines
Bug #1600860: Search for shared python library in LIBDIR, not
lib/python/config, on "linux" and "gnu" systems.
Will backport.
........
r53693 | martin.v.loewis | 2007-02-09 13:58:49 +0100 (Fri, 09 Feb 2007) | 2 lines
Update broken link. Will backport to 2.5.
........
r53697 | georg.brandl | 2007-02-09 19:48:41 +0100 (Fri, 09 Feb 2007) | 2 lines
Bug #1656078: typo in in profile docs.
........
r53731 | brett.cannon | 2007-02-11 06:36:00 +0100 (Sun, 11 Feb 2007) | 3 lines
Change a very minor inconsistency (that is purely cosmetic) in the AST
definition.
........
r53735 | skip.montanaro | 2007-02-11 19:24:37 +0100 (Sun, 11 Feb 2007) | 1 line
fix trace.py --ignore-dir
........
r53741 | brett.cannon | 2007-02-11 20:44:41 +0100 (Sun, 11 Feb 2007) | 3 lines
Check in changed Python-ast.c from a cosmetic change to Python.asdl (in
r53731).
........
r53751 | brett.cannon | 2007-02-12 04:51:02 +0100 (Mon, 12 Feb 2007) | 5 lines
Modify Parser/asdl_c.py so that the __version__ number for Python/Python-ast.c
is specified at the top of the file. Also add a note that Python/Python-ast.c
needs to be committed separately after a change to the AST grammar to capture
the revision number of the change (which is what __version__ is set to).
........
r53752 | lars.gustaebel | 2007-02-12 10:25:53 +0100 (Mon, 12 Feb 2007) | 3 lines
Bug #1656581: Point out that external file objects are supposed to be
at position 0.
........
r53754 | martin.v.loewis | 2007-02-12 13:21:10 +0100 (Mon, 12 Feb 2007) | 3 lines
Patch 1463026: Support default namespace in XMLGenerator.
Fixes #847665. Will backport.
........
r53757 | armin.rigo | 2007-02-12 17:23:24 +0100 (Mon, 12 Feb 2007) | 4 lines
Fix the line to what is my guess at the original author's meaning.
(The line has no effect anyway, but is present because it's
customary call the base class __init__).
........
r53763 | martin.v.loewis | 2007-02-13 09:34:45 +0100 (Tue, 13 Feb 2007) | 3 lines
Patch #685268: Consider a package's __path__ in imputil.
Will backport.
........
r53765 | martin.v.loewis | 2007-02-13 10:49:38 +0100 (Tue, 13 Feb 2007) | 2 lines
Patch #698833: Support file decryption in zipfile.
........
r53766 | martin.v.loewis | 2007-02-13 11:10:39 +0100 (Tue, 13 Feb 2007) | 3 lines
Patch #1517891: Make 'a' create the file if it doesn't exist.
Fixes #1514451.
........
r53767 | martin.v.loewis | 2007-02-13 13:08:24 +0100 (Tue, 13 Feb 2007) | 3 lines
Bug #1658794: Remove extraneous 'this'.
Will backport to 2.5.
........
r53769 | martin.v.loewis | 2007-02-13 13:14:19 +0100 (Tue, 13 Feb 2007) | 3 lines
Patch #1657276: Make NETLINK_DNRTMSG conditional.
Will backport.
........
r53771 | lars.gustaebel | 2007-02-13 17:09:24 +0100 (Tue, 13 Feb 2007) | 4 lines
Patch #1647484: Renamed GzipFile's filename attribute to name. The
filename attribute is still accessible as a property that emits a
DeprecationWarning.
........
r53772 | lars.gustaebel | 2007-02-13 17:24:00 +0100 (Tue, 13 Feb 2007) | 3 lines
Strip the '.gz' extension from the filename that is written to the
gzip header.
........
r53774 | martin.v.loewis | 2007-02-14 11:07:37 +0100 (Wed, 14 Feb 2007) | 2 lines
Patch #1432399: Add HCI sockets.
........
r53775 | martin.v.loewis | 2007-02-14 12:30:07 +0100 (Wed, 14 Feb 2007) | 2 lines
Update 1432399 to removal of _BT_SOCKADDR_MEMB.
........
r53776 | martin.v.loewis | 2007-02-14 12:30:56 +0100 (Wed, 14 Feb 2007) | 3 lines
Ignore directory time stamps when considering
whether to rerun libffi configure.
........
r53778 | lars.gustaebel | 2007-02-14 15:45:12 +0100 (Wed, 14 Feb 2007) | 4 lines
A missing binary mode in AppendTest caused failures in Windows
Buildbot.
........
r53782 | martin.v.loewis | 2007-02-15 10:51:35 +0100 (Thu, 15 Feb 2007) | 2 lines
Patch #1397848: add the reasoning behind no-resize-on-shrinkage.
........
r53783 | georg.brandl | 2007-02-15 11:37:59 +0100 (Thu, 15 Feb 2007) | 2 lines
Make functools.wraps() docs a bit clearer.
........
r53785 | georg.brandl | 2007-02-15 12:29:04 +0100 (Thu, 15 Feb 2007) | 2 lines
Patch #1494140: Add documentation for the new struct.Struct object.
........
r53787 | georg.brandl | 2007-02-15 12:29:55 +0100 (Thu, 15 Feb 2007) | 2 lines
Add missing \versionadded.
........
r53800 | brett.cannon | 2007-02-15 23:54:39 +0100 (Thu, 15 Feb 2007) | 11 lines
Update the encoding package's search function to use absolute imports when
calling __import__. This helps make the expected search locations for encoding
modules be more explicit.
One could use an explicit value for __path__ when making the call to __import__
to force the exact location searched for encodings. This would give the most
strict search path possible if one is worried about malicious code being
imported. The unfortunate side-effect of that is that if __path__ was modified
on 'encodings' on purpose in a safe way it would not be picked up in future
__import__ calls.
........
r53801 | brett.cannon | 2007-02-16 20:33:01 +0100 (Fri, 16 Feb 2007) | 2 lines
Make the __import__ call in encodings.__init__ absolute with a level 0 call.
........
r53809 | vinay.sajip | 2007-02-16 23:36:24 +0100 (Fri, 16 Feb 2007) | 1 line
Minor fix for currentframe (SF #1652788).
........
r53818 | raymond.hettinger | 2007-02-19 03:03:19 +0100 (Mon, 19 Feb 2007) | 3 lines
Extend work on revision 52962: Eliminate redundant calls to PyObject_Hash().
........
r53820 | raymond.hettinger | 2007-02-19 05:08:43 +0100 (Mon, 19 Feb 2007) | 1 line
Add merge() function to heapq.
........
r53821 | raymond.hettinger | 2007-02-19 06:28:28 +0100 (Mon, 19 Feb 2007) | 1 line
Add tie-breaker count to preserve sort stability.
........
r53822 | raymond.hettinger | 2007-02-19 07:59:32 +0100 (Mon, 19 Feb 2007) | 1 line
Use C heapreplace() instead of slower _siftup() in pure python.
........
r53823 | raymond.hettinger | 2007-02-19 08:30:21 +0100 (Mon, 19 Feb 2007) | 1 line
Add test for merge stability
........
r53824 | raymond.hettinger | 2007-02-19 10:14:10 +0100 (Mon, 19 Feb 2007) | 1 line
Provide an example of defaultdict with non-zero constant factory function.
........
r53825 | lars.gustaebel | 2007-02-19 10:54:47 +0100 (Mon, 19 Feb 2007) | 2 lines
Moved misplaced news item.
........
r53826 | martin.v.loewis | 2007-02-19 11:55:19 +0100 (Mon, 19 Feb 2007) | 3 lines
Patch #1490190: posixmodule now includes os.chflags() and os.lchflags()
functions on platforms where the underlying system calls are available.
........
r53827 | raymond.hettinger | 2007-02-19 19:15:04 +0100 (Mon, 19 Feb 2007) | 1 line
Fixup docstrings for merge().
........
r53829 | raymond.hettinger | 2007-02-19 21:44:04 +0100 (Mon, 19 Feb 2007) | 1 line
Fixup set/dict interoperability.
........
r53837 | raymond.hettinger | 2007-02-21 06:20:38 +0100 (Wed, 21 Feb 2007) | 1 line
Add itertools.izip_longest().
........
r53838 | raymond.hettinger | 2007-02-21 18:22:05 +0100 (Wed, 21 Feb 2007) | 1 line
Remove filler struct item and fix leak.
........
2007-02-23 11:07:44 -04:00
|
|
|
import re
|
2002-10-10 05:25:24 -03:00
|
|
|
import sys
|
2014-01-26 20:55:34 -04:00
|
|
|
import textwrap
|
2000-08-14 22:13:23 -03:00
|
|
|
import types
|
|
|
|
|
2016-05-28 14:22:31 -03:00
|
|
|
from idlelib import calltip_w
|
|
|
|
from idlelib.hyperparser import HyperParser
|
2002-10-10 05:25:24 -03:00
|
|
|
|
2000-08-14 22:13:23 -03:00
|
|
|
|
2018-06-20 00:27:37 -03:00
|
|
|
class Calltip:
|
2000-08-14 22:13:23 -03:00
|
|
|
|
2002-10-10 05:25:24 -03:00
|
|
|
def __init__(self, editwin=None):
|
2004-05-04 05:34:56 -03:00
|
|
|
if editwin is None: # subprocess and test
|
2002-10-10 05:25:24 -03:00
|
|
|
self.editwin = None
|
2007-08-30 03:35:15 -03:00
|
|
|
else:
|
|
|
|
self.editwin = editwin
|
|
|
|
self.text = editwin.text
|
|
|
|
self.active_calltip = None
|
|
|
|
self._calltip_window = self._make_tk_calltip_window
|
2000-08-14 22:13:23 -03:00
|
|
|
|
|
|
|
def close(self):
|
2007-08-30 03:35:15 -03:00
|
|
|
self._calltip_window = None
|
2000-08-14 22:13:23 -03:00
|
|
|
|
|
|
|
def _make_tk_calltip_window(self):
|
2002-10-10 05:25:24 -03:00
|
|
|
# See __init__ for usage
|
2018-06-20 03:40:14 -03:00
|
|
|
return calltip_w.CalltipWindow(self.text)
|
2000-08-14 22:13:23 -03:00
|
|
|
|
2005-11-18 18:05:48 -04:00
|
|
|
def _remove_calltip_window(self, event=None):
|
2007-08-30 03:35:15 -03:00
|
|
|
if self.active_calltip:
|
|
|
|
self.active_calltip.hidetip()
|
|
|
|
self.active_calltip = None
|
2001-07-12 20:10:35 -03:00
|
|
|
|
2005-11-18 18:05:48 -04:00
|
|
|
def force_open_calltip_event(self, event):
|
2007-08-30 03:35:15 -03:00
|
|
|
"The user selected the menu entry or hotkey, open the tip."
|
2005-11-18 18:05:48 -04:00
|
|
|
self.open_calltip(True)
|
2017-06-27 01:02:32 -03:00
|
|
|
return "break"
|
2000-08-14 22:13:23 -03:00
|
|
|
|
2005-11-18 18:05:48 -04:00
|
|
|
def try_open_calltip_event(self, event):
|
2018-06-20 03:40:14 -03:00
|
|
|
"""Happens when it would be nice to open a calltip, but not really
|
2007-08-30 03:35:15 -03:00
|
|
|
necessary, for example after an opening bracket, so function calls
|
2005-11-18 18:05:48 -04:00
|
|
|
won't be made.
|
|
|
|
"""
|
|
|
|
self.open_calltip(False)
|
|
|
|
|
|
|
|
def refresh_calltip_event(self, event):
|
2018-08-05 03:47:28 -03:00
|
|
|
if self.active_calltip and self.active_calltip.tipwindow:
|
2005-11-18 18:05:48 -04:00
|
|
|
self.open_calltip(False)
|
2000-08-14 22:13:23 -03:00
|
|
|
|
2005-11-18 18:05:48 -04:00
|
|
|
def open_calltip(self, evalfuncs):
|
|
|
|
self._remove_calltip_window()
|
2002-10-10 05:25:24 -03:00
|
|
|
|
2005-11-18 18:05:48 -04:00
|
|
|
hp = HyperParser(self.editwin, "insert")
|
|
|
|
sur_paren = hp.get_surrounding_brackets('(')
|
|
|
|
if not sur_paren:
|
|
|
|
return
|
|
|
|
hp.set_index(sur_paren[0])
|
2012-06-03 01:27:54 -03:00
|
|
|
expression = hp.get_expression()
|
|
|
|
if not expression:
|
2007-08-30 03:35:15 -03:00
|
|
|
return
|
2012-06-03 01:27:54 -03:00
|
|
|
if not evalfuncs and (expression.find('(') != -1):
|
2005-11-18 18:05:48 -04:00
|
|
|
return
|
2012-06-03 01:27:54 -03:00
|
|
|
argspec = self.fetch_tip(expression)
|
2007-08-30 03:35:15 -03:00
|
|
|
if not argspec:
|
2005-11-18 18:05:48 -04:00
|
|
|
return
|
2007-08-30 03:35:15 -03:00
|
|
|
self.active_calltip = self._calltip_window()
|
|
|
|
self.active_calltip.showtip(argspec, sur_paren[0], sur_paren[1])
|
2002-12-31 12:03:23 -04:00
|
|
|
|
2012-06-03 01:27:54 -03:00
|
|
|
def fetch_tip(self, expression):
|
2007-08-30 03:35:15 -03:00
|
|
|
"""Return the argument list and docstring of a function or class.
|
2002-12-31 12:03:23 -04:00
|
|
|
|
2002-12-12 15:15:39 -04:00
|
|
|
If there is a Python subprocess, get the calltip there. Otherwise,
|
2007-08-30 03:35:15 -03:00
|
|
|
either this fetch_tip() is running in the subprocess or it was
|
|
|
|
called in an IDLE running without the subprocess.
|
2002-12-12 15:15:39 -04:00
|
|
|
|
|
|
|
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.
|
|
|
|
|
Merged revisions 53623-53858 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r53624 | peter.astrand | 2007-02-02 20:06:36 +0100 (Fri, 02 Feb 2007) | 1 line
We had several if statements checking the value of a fd. This is unsafe, since valid fds might be zero. We should check for not None instead.
........
r53635 | kurt.kaiser | 2007-02-05 07:03:18 +0100 (Mon, 05 Feb 2007) | 2 lines
Add 'raw' support to configHandler. Patch 1650174 Tal Einat.
........
r53641 | kurt.kaiser | 2007-02-06 00:02:16 +0100 (Tue, 06 Feb 2007) | 5 lines
1. Calltips now 'handle' tuples in the argument list (display '<tuple>' :)
Suggested solution by Christos Georgiou, Bug 791968.
2. Clean up tests, were not failing when they should have been.
4. Remove some camelcase and an unneeded try/except block.
........
r53644 | kurt.kaiser | 2007-02-06 04:21:40 +0100 (Tue, 06 Feb 2007) | 2 lines
Clean up ModifiedInterpreter.runcode() structure
........
r53646 | peter.astrand | 2007-02-06 16:37:50 +0100 (Tue, 06 Feb 2007) | 1 line
Applied patch 1124861.3.patch to solve bug #1124861: Automatically create pipes on Windows, if GetStdHandle fails. Will backport.
........
r53648 | lars.gustaebel | 2007-02-06 19:38:13 +0100 (Tue, 06 Feb 2007) | 4 lines
Patch #1652681: create nonexistent files in append mode and
allow appending to empty files.
........
r53649 | kurt.kaiser | 2007-02-06 20:09:43 +0100 (Tue, 06 Feb 2007) | 4 lines
Updated patch (CodeContext.061217.patch) to
[ 1362975 ] CodeContext - Improved text indentation
Tal Einat 16Dec06
........
r53650 | kurt.kaiser | 2007-02-06 20:21:19 +0100 (Tue, 06 Feb 2007) | 2 lines
narrow exception per [ 1540849 ] except too broad
........
r53653 | kurt.kaiser | 2007-02-07 04:39:41 +0100 (Wed, 07 Feb 2007) | 4 lines
[ 1621265 ] Auto-completion list placement
Move AC window below input line unless not enough space, then put it above.
Patch: Tal Einat
........
r53654 | kurt.kaiser | 2007-02-07 09:07:13 +0100 (Wed, 07 Feb 2007) | 2 lines
Handle AttributeError during calltip lookup
........
r53656 | raymond.hettinger | 2007-02-07 21:08:22 +0100 (Wed, 07 Feb 2007) | 3 lines
SF #1615701: make d.update(m) honor __getitem__() and keys() in dict subclasses
........
r53658 | raymond.hettinger | 2007-02-07 22:04:20 +0100 (Wed, 07 Feb 2007) | 1 line
SF: 1397711 Set docs conflated immutable and hashable
........
r53660 | raymond.hettinger | 2007-02-07 22:42:17 +0100 (Wed, 07 Feb 2007) | 1 line
Check for a common user error with defaultdict().
........
r53662 | raymond.hettinger | 2007-02-07 23:24:07 +0100 (Wed, 07 Feb 2007) | 1 line
Bug #1575169: operator.isSequenceType() now returns False for subclasses of dict.
........
r53664 | raymond.hettinger | 2007-02-08 00:49:03 +0100 (Thu, 08 Feb 2007) | 1 line
Silence compiler warning
........
r53666 | raymond.hettinger | 2007-02-08 01:07:32 +0100 (Thu, 08 Feb 2007) | 1 line
Do not let overflows in enumerate() and count() pass silently.
........
r53668 | raymond.hettinger | 2007-02-08 01:50:39 +0100 (Thu, 08 Feb 2007) | 1 line
Bypass set specific optimizations for set and frozenset subclasses.
........
r53670 | raymond.hettinger | 2007-02-08 02:42:35 +0100 (Thu, 08 Feb 2007) | 1 line
Fix docstring bug
........
r53671 | martin.v.loewis | 2007-02-08 10:13:36 +0100 (Thu, 08 Feb 2007) | 3 lines
Bug #1653736: Complain about keyword arguments to time.isoformat.
Will backport to 2.5.
........
r53679 | kurt.kaiser | 2007-02-08 23:58:18 +0100 (Thu, 08 Feb 2007) | 6 lines
Corrected some bugs in AutoComplete. Also, Page Up/Down in ACW implemented;
mouse and cursor selection in ACWindow implemented; double Tab inserts current
selection and closes ACW (similar to double-click and Return); scroll wheel now
works in ACW. Added AutoComplete instructions to IDLE Help.
........
r53689 | martin.v.loewis | 2007-02-09 13:19:32 +0100 (Fri, 09 Feb 2007) | 3 lines
Bug #1653736: Properly discard third argument to slot_nb_inplace_power.
Will backport.
........
r53691 | martin.v.loewis | 2007-02-09 13:36:48 +0100 (Fri, 09 Feb 2007) | 4 lines
Bug #1600860: Search for shared python library in LIBDIR, not
lib/python/config, on "linux" and "gnu" systems.
Will backport.
........
r53693 | martin.v.loewis | 2007-02-09 13:58:49 +0100 (Fri, 09 Feb 2007) | 2 lines
Update broken link. Will backport to 2.5.
........
r53697 | georg.brandl | 2007-02-09 19:48:41 +0100 (Fri, 09 Feb 2007) | 2 lines
Bug #1656078: typo in in profile docs.
........
r53731 | brett.cannon | 2007-02-11 06:36:00 +0100 (Sun, 11 Feb 2007) | 3 lines
Change a very minor inconsistency (that is purely cosmetic) in the AST
definition.
........
r53735 | skip.montanaro | 2007-02-11 19:24:37 +0100 (Sun, 11 Feb 2007) | 1 line
fix trace.py --ignore-dir
........
r53741 | brett.cannon | 2007-02-11 20:44:41 +0100 (Sun, 11 Feb 2007) | 3 lines
Check in changed Python-ast.c from a cosmetic change to Python.asdl (in
r53731).
........
r53751 | brett.cannon | 2007-02-12 04:51:02 +0100 (Mon, 12 Feb 2007) | 5 lines
Modify Parser/asdl_c.py so that the __version__ number for Python/Python-ast.c
is specified at the top of the file. Also add a note that Python/Python-ast.c
needs to be committed separately after a change to the AST grammar to capture
the revision number of the change (which is what __version__ is set to).
........
r53752 | lars.gustaebel | 2007-02-12 10:25:53 +0100 (Mon, 12 Feb 2007) | 3 lines
Bug #1656581: Point out that external file objects are supposed to be
at position 0.
........
r53754 | martin.v.loewis | 2007-02-12 13:21:10 +0100 (Mon, 12 Feb 2007) | 3 lines
Patch 1463026: Support default namespace in XMLGenerator.
Fixes #847665. Will backport.
........
r53757 | armin.rigo | 2007-02-12 17:23:24 +0100 (Mon, 12 Feb 2007) | 4 lines
Fix the line to what is my guess at the original author's meaning.
(The line has no effect anyway, but is present because it's
customary call the base class __init__).
........
r53763 | martin.v.loewis | 2007-02-13 09:34:45 +0100 (Tue, 13 Feb 2007) | 3 lines
Patch #685268: Consider a package's __path__ in imputil.
Will backport.
........
r53765 | martin.v.loewis | 2007-02-13 10:49:38 +0100 (Tue, 13 Feb 2007) | 2 lines
Patch #698833: Support file decryption in zipfile.
........
r53766 | martin.v.loewis | 2007-02-13 11:10:39 +0100 (Tue, 13 Feb 2007) | 3 lines
Patch #1517891: Make 'a' create the file if it doesn't exist.
Fixes #1514451.
........
r53767 | martin.v.loewis | 2007-02-13 13:08:24 +0100 (Tue, 13 Feb 2007) | 3 lines
Bug #1658794: Remove extraneous 'this'.
Will backport to 2.5.
........
r53769 | martin.v.loewis | 2007-02-13 13:14:19 +0100 (Tue, 13 Feb 2007) | 3 lines
Patch #1657276: Make NETLINK_DNRTMSG conditional.
Will backport.
........
r53771 | lars.gustaebel | 2007-02-13 17:09:24 +0100 (Tue, 13 Feb 2007) | 4 lines
Patch #1647484: Renamed GzipFile's filename attribute to name. The
filename attribute is still accessible as a property that emits a
DeprecationWarning.
........
r53772 | lars.gustaebel | 2007-02-13 17:24:00 +0100 (Tue, 13 Feb 2007) | 3 lines
Strip the '.gz' extension from the filename that is written to the
gzip header.
........
r53774 | martin.v.loewis | 2007-02-14 11:07:37 +0100 (Wed, 14 Feb 2007) | 2 lines
Patch #1432399: Add HCI sockets.
........
r53775 | martin.v.loewis | 2007-02-14 12:30:07 +0100 (Wed, 14 Feb 2007) | 2 lines
Update 1432399 to removal of _BT_SOCKADDR_MEMB.
........
r53776 | martin.v.loewis | 2007-02-14 12:30:56 +0100 (Wed, 14 Feb 2007) | 3 lines
Ignore directory time stamps when considering
whether to rerun libffi configure.
........
r53778 | lars.gustaebel | 2007-02-14 15:45:12 +0100 (Wed, 14 Feb 2007) | 4 lines
A missing binary mode in AppendTest caused failures in Windows
Buildbot.
........
r53782 | martin.v.loewis | 2007-02-15 10:51:35 +0100 (Thu, 15 Feb 2007) | 2 lines
Patch #1397848: add the reasoning behind no-resize-on-shrinkage.
........
r53783 | georg.brandl | 2007-02-15 11:37:59 +0100 (Thu, 15 Feb 2007) | 2 lines
Make functools.wraps() docs a bit clearer.
........
r53785 | georg.brandl | 2007-02-15 12:29:04 +0100 (Thu, 15 Feb 2007) | 2 lines
Patch #1494140: Add documentation for the new struct.Struct object.
........
r53787 | georg.brandl | 2007-02-15 12:29:55 +0100 (Thu, 15 Feb 2007) | 2 lines
Add missing \versionadded.
........
r53800 | brett.cannon | 2007-02-15 23:54:39 +0100 (Thu, 15 Feb 2007) | 11 lines
Update the encoding package's search function to use absolute imports when
calling __import__. This helps make the expected search locations for encoding
modules be more explicit.
One could use an explicit value for __path__ when making the call to __import__
to force the exact location searched for encodings. This would give the most
strict search path possible if one is worried about malicious code being
imported. The unfortunate side-effect of that is that if __path__ was modified
on 'encodings' on purpose in a safe way it would not be picked up in future
__import__ calls.
........
r53801 | brett.cannon | 2007-02-16 20:33:01 +0100 (Fri, 16 Feb 2007) | 2 lines
Make the __import__ call in encodings.__init__ absolute with a level 0 call.
........
r53809 | vinay.sajip | 2007-02-16 23:36:24 +0100 (Fri, 16 Feb 2007) | 1 line
Minor fix for currentframe (SF #1652788).
........
r53818 | raymond.hettinger | 2007-02-19 03:03:19 +0100 (Mon, 19 Feb 2007) | 3 lines
Extend work on revision 52962: Eliminate redundant calls to PyObject_Hash().
........
r53820 | raymond.hettinger | 2007-02-19 05:08:43 +0100 (Mon, 19 Feb 2007) | 1 line
Add merge() function to heapq.
........
r53821 | raymond.hettinger | 2007-02-19 06:28:28 +0100 (Mon, 19 Feb 2007) | 1 line
Add tie-breaker count to preserve sort stability.
........
r53822 | raymond.hettinger | 2007-02-19 07:59:32 +0100 (Mon, 19 Feb 2007) | 1 line
Use C heapreplace() instead of slower _siftup() in pure python.
........
r53823 | raymond.hettinger | 2007-02-19 08:30:21 +0100 (Mon, 19 Feb 2007) | 1 line
Add test for merge stability
........
r53824 | raymond.hettinger | 2007-02-19 10:14:10 +0100 (Mon, 19 Feb 2007) | 1 line
Provide an example of defaultdict with non-zero constant factory function.
........
r53825 | lars.gustaebel | 2007-02-19 10:54:47 +0100 (Mon, 19 Feb 2007) | 2 lines
Moved misplaced news item.
........
r53826 | martin.v.loewis | 2007-02-19 11:55:19 +0100 (Mon, 19 Feb 2007) | 3 lines
Patch #1490190: posixmodule now includes os.chflags() and os.lchflags()
functions on platforms where the underlying system calls are available.
........
r53827 | raymond.hettinger | 2007-02-19 19:15:04 +0100 (Mon, 19 Feb 2007) | 1 line
Fixup docstrings for merge().
........
r53829 | raymond.hettinger | 2007-02-19 21:44:04 +0100 (Mon, 19 Feb 2007) | 1 line
Fixup set/dict interoperability.
........
r53837 | raymond.hettinger | 2007-02-21 06:20:38 +0100 (Wed, 21 Feb 2007) | 1 line
Add itertools.izip_longest().
........
r53838 | raymond.hettinger | 2007-02-21 18:22:05 +0100 (Wed, 21 Feb 2007) | 1 line
Remove filler struct item and fix leak.
........
2007-02-23 11:07:44 -04:00
|
|
|
To find methods, fetch_tip must be fed a fully qualified name.
|
|
|
|
|
2002-12-31 12:03:23 -04:00
|
|
|
"""
|
2002-12-12 15:15:39 -04:00
|
|
|
try:
|
|
|
|
rpcclt = self.editwin.flist.pyshell.interp.rpcclt
|
2012-06-03 01:27:54 -03:00
|
|
|
except AttributeError:
|
2002-12-12 15:15:39 -04:00
|
|
|
rpcclt = None
|
2002-10-10 05:25:24 -03:00
|
|
|
if rpcclt:
|
|
|
|
return rpcclt.remotecall("exec", "get_the_calltip",
|
2012-06-03 01:27:54 -03:00
|
|
|
(expression,), {})
|
2002-10-10 05:25:24 -03:00
|
|
|
else:
|
2012-06-07 20:41:04 -03:00
|
|
|
return get_argspec(get_entity(expression))
|
2002-10-10 05:25:24 -03:00
|
|
|
|
2017-09-10 18:19:47 -03:00
|
|
|
|
2012-06-07 20:41:04 -03:00
|
|
|
def get_entity(expression):
|
|
|
|
"""Return the object corresponding to expression evaluated
|
2019-03-24 18:32:40 -03:00
|
|
|
in a namespace spanning sys.modules and __main.dict__.
|
2012-06-07 20:41:04 -03:00
|
|
|
"""
|
|
|
|
if expression:
|
2019-03-24 18:32:40 -03:00
|
|
|
namespace = {**sys.modules, **__main__.__dict__}
|
2012-06-07 20:41:04 -03:00
|
|
|
try:
|
2019-03-23 05:08:37 -03:00
|
|
|
return eval(expression, namespace) # Only protect user code.
|
2012-06-07 20:41:04 -03:00
|
|
|
except BaseException:
|
|
|
|
# An uncaught exception closes idle, and eval can raise any
|
|
|
|
# exception, especially if user classes are involved.
|
|
|
|
return None
|
|
|
|
|
2014-01-21 21:45:17 -04:00
|
|
|
# The following are used in get_argspec and some in tests
|
2014-01-26 20:55:34 -04:00
|
|
|
_MAX_COLS = 85
|
2014-01-21 21:45:17 -04:00
|
|
|
_MAX_LINES = 5 # enough for bytes
|
2014-01-26 20:55:34 -04:00
|
|
|
_INDENT = ' '*4 # for wrapped signatures
|
2016-09-08 14:59:53 -03:00
|
|
|
_first_param = re.compile(r'(?<=\()\w*\,?\s*')
|
2014-01-21 16:36:51 -04:00
|
|
|
_default_callable_argspec = "See source or doc"
|
2017-08-09 21:58:13 -03:00
|
|
|
_invalid_method = "invalid method signature"
|
2019-06-04 23:15:48 -03:00
|
|
|
_argument_positional = " # '/' marks preceding args as positional-only."
|
2007-08-30 03:35:15 -03:00
|
|
|
|
|
|
|
def get_argspec(ob):
|
2014-01-21 16:36:51 -04:00
|
|
|
'''Return a string describing the signature of a callable object, or ''.
|
2012-06-07 20:41:04 -03:00
|
|
|
|
|
|
|
For Python-coded functions and methods, the first line is introspected.
|
|
|
|
Delete 'self' parameter for classes (.__init__) and bound methods.
|
2014-01-21 21:45:17 -04:00
|
|
|
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.
|
2012-06-07 20:41:04 -03:00
|
|
|
'''
|
2017-08-09 21:58:13 -03:00
|
|
|
argspec = default = ""
|
2014-01-21 16:36:51 -04:00
|
|
|
try:
|
|
|
|
ob_call = ob.__call__
|
|
|
|
except BaseException:
|
2017-08-09 21:58:13 -03:00
|
|
|
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
|
|
|
|
|
2019-06-04 23:15:48 -03:00
|
|
|
if '/' in argspec and len(argspec) < _MAX_COLS - len(_argument_positional):
|
|
|
|
# Add explanation TODO remove after 3.7, before 3.9.
|
2017-08-09 21:58:13 -03:00
|
|
|
argspec += _argument_positional
|
|
|
|
if isinstance(fob, type) and argspec == '()':
|
2019-06-04 23:15:48 -03:00
|
|
|
# If fob has no argument, use default callable argspec.
|
2017-08-09 21:58:13 -03:00
|
|
|
argspec = _default_callable_argspec
|
2014-01-21 16:36:51 -04:00
|
|
|
|
2014-01-26 20:55:34 -04:00
|
|
|
lines = (textwrap.wrap(argspec, _MAX_COLS, subsequent_indent=_INDENT)
|
2017-08-09 21:58:13 -03:00
|
|
|
if len(argspec) > _MAX_COLS else [argspec] if argspec else [])
|
2014-01-26 20:55:34 -04:00
|
|
|
|
2014-01-21 16:36:51 -04:00
|
|
|
if isinstance(ob_call, types.MethodType):
|
|
|
|
doc = ob_call.__doc__
|
|
|
|
else:
|
|
|
|
doc = getattr(ob, "__doc__", "")
|
|
|
|
if doc:
|
2014-01-26 20:55:34 -04:00
|
|
|
for line in doc.split('\n', _MAX_LINES)[:_MAX_LINES]:
|
2014-01-21 21:45:17 -04:00
|
|
|
line = line.strip()
|
|
|
|
if not line:
|
|
|
|
break
|
|
|
|
if len(line) > _MAX_COLS:
|
|
|
|
line = line[: _MAX_COLS - 3] + '...'
|
|
|
|
lines.append(line)
|
2019-01-03 05:44:47 -04:00
|
|
|
argspec = '\n'.join(lines)
|
2014-01-21 16:36:51 -04:00
|
|
|
if not argspec:
|
|
|
|
argspec = _default_callable_argspec
|
2007-08-30 03:35:15 -03:00
|
|
|
return argspec
|
2000-08-14 22:13:23 -03:00
|
|
|
|
2017-08-09 21:58:13 -03:00
|
|
|
|
2007-08-30 03:35:15 -03:00
|
|
|
if __name__ == '__main__':
|
2013-05-27 22:32:03 -03:00
|
|
|
from unittest import main
|
2018-06-20 00:27:37 -03:00
|
|
|
main('idlelib.idle_test.test_calltip', verbosity=2)
|