| 1234567891011121314151617181920212223242526272829303132333435363738394041 |
- """
- A simple utility to import something by its string name.
- """
- # Copyright (c) IPython Development Team.
- # Distributed under the terms of the Modified BSD License.
- from __future__ import annotations
- from typing import Any
- def import_item(name: str) -> Any:
- """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.
- """
- if not isinstance(name, str):
- raise TypeError("import_item accepts strings, not '%s'." % type(name))
- 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])
|
