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

docs/autogen_shortcuts.py: support Python 3.8...

docs/autogen_shortcuts.py: support Python 3.8 In 64e72a955 (Restore shortcuts in documentation, define identifiers, 2023-01-08), some typing annotations were added to docs/autogen_shortcuts.py using the builtin container type 'list'. This feature is only available starting in Python 3.9 [1], but setup.cfg lists Python 3.8 as the earliest supported Python version. This leads to a failing documentation build in a Python 3.8 virtual environment. Fix this by using the capitalized name 'List' from the 'typing' module to keep Python 3.8 compatibility. [1] https://docs.python.org/3/whatsnew/3.9.html#type-hinting-generics-in-standard-collections

Matthias Bussonnier - - Load All Authors

File last commit:

r26419:7663c521


                r28181:2c9a826a

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])