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