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

Fix wrong u-prefix for strings in magics docs. (#14161)...

Fix wrong u-prefix for strings in magics docs. (#14161) `%precision` doesn't output `u'%r'` on Python 3, but `'%r'`. (Note that the point of this PR is explicitly not to remove u-prefixes on all strings -- something that would likely be better done by automated tooling anyways -- but only on those occurring within some docstrings that end up in the rendered docs, which would more likely not have been found by tooling.)

Matthias Bussonnier - - Load All Authors

File last commit:

r26419:7663c521


                r28396:f5856e4b

Download file

             importstring.py
        
                    39 lines
            
             | 1.0 KiB
            
                | text/x-python
            
             |
                PythonLexer
            
             / IPython / utils / importstring.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      # encoding: utf-8

      """

      A simple utility to import something by its string name.

      """

      # Copyright (c) IPython Development Team.

      # Distributed under the terms of the Modified BSD License.

      def import_item(name):

          """Import and return ``bar`` given the string ``foo.bar``.

          Calling ``bar = import_item("foo.bar")`` is the functional equivalent of

          executing the code ``from foo import bar``.

          Parameters

          ----------

          name : string

              The fully qualified name of the module/package being imported.

          Returns

          -------

          mod : module object

              The module that was imported.

          """

          parts = name.rsplit('.', 1)

          if len(parts) == 2:

              # called with 'foo.bar....'

              package, obj = parts

              module = __import__(package, fromlist=[obj])

              try:

                  pak = getattr(module, obj)

              except AttributeError as e:

                  raise ImportError('No module named %s' % obj) from e

              return pak

          else:

              # called with un-dotted string

              return __import__(parts[0])

	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

				# encoding: utf-8
				"""
				A simple utility to import something by its string name.
				"""

				# Copyright (c) IPython Development Team.
				# Distributed under the terms of the Modified BSD License.


				def import_item(name):
				"""Import and return ``bar`` given the string ``foo.bar``.

				Calling ``bar = import_item("foo.bar")`` is the functional equivalent of
				executing the code ``from foo import bar``.

				Parameters
				----------
				name : string
				The fully qualified name of the module/package being imported.

				Returns
				-------
				mod : module object
				The module that was imported.
				"""

				parts = name.rsplit('.', 1)
				if len(parts) == 2:
				# called with 'foo.bar....'
				package, obj = parts
				module = __import__(package, fromlist=[obj])
				try:
				pak = getattr(module, obj)
				except AttributeError as e:
				raise ImportError('No module named %s' % obj) from e
				return pak
				else:
				# called with un-dotted string
				return __import__(parts[0])