upstream/ipython Files · IPython/utils/pyfile.py

Backport PR : qtconsole: wrap argument list in tooltip to match width of text body...

Backport PR : qtconsole: wrap argument list in tooltip to match width of text body previously, a function with a long argument list would produce a very wide tooltip, hurting readability. Since the width of the docstring body is chosen by the developer whereas the formatting of the argument list is currently not, it's reasonable to wrap the argument list width to the maximum of a) 80 characters, or b) maximum length of a line in the docstring body. This improves readability, without unduly affecting the appearence of the docstring body itself. closes I'm happy to add any additional tests or make any changes required to get this merged.

Thomas - - Load All Authors

File last commit:

r5882:fd2691c8


                r9846:43e0fc22

Download file

             pyfile.py
        
                    23 lines
            
             | 840 B
            
                | text/x-python
            
             |
                PythonLexer
            
             / IPython / utils / pyfile.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      """Utilities for working with Python source files.

      Exposes various functions from recent Python standard libraries, along with

      equivalents for older Python versions.

      """

      import os.path

      try:    # Python 3.2

          from imp import source_from_cache, cache_from_source

      except ImportError:

          # Python <= 3.1: .pyc files go next to .py

          def source_from_cache(path):

              basename, ext = os.path.splitext(path)

              if ext not in ('.pyc', '.pyo'):

                  raise ValueError('Not a cached Python file extension', ext)

              # Should we look for .pyw files?

              return basename + '.py'

          def cache_from_source(path, debug_override=None):

              if debug_override is None:

                  debug_override = __debug__

              basename, ext = os.path.splitext(path)

              return basename + '.pyc' if debug_override else '.pyo'

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				"""Utilities for working with Python source files.

				Exposes various functions from recent Python standard libraries, along with
				equivalents for older Python versions.
				"""
				import os.path

				try: # Python 3.2
				from imp import source_from_cache, cache_from_source
				except ImportError:
				# Python <= 3.1: .pyc files go next to .py
				def source_from_cache(path):
				basename, ext = os.path.splitext(path)
				if ext not in ('.pyc', '.pyo'):
				raise ValueError('Not a cached Python file extension', ext)
				# Should we look for .pyw files?
				return basename + '.py'

				def cache_from_source(path, debug_override=None):
				if debug_override is None:
				debug_override = __debug__
				basename, ext = os.path.splitext(path)
				return basename + '.pyc' if debug_override else '.pyo'