42 lines
1.2 KiB
Python
42 lines
1.2 KiB
Python
|
"""
|
||
|
|
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])
|