importstring.py
39 lines
| 1.0 KiB
| text/x-python
|
PythonLexer
Brian Granger
|
r2229 | # encoding: utf-8 | ||
""" | ||||
A simple utility to import something by its string name. | ||||
""" | ||||
Min RK
|
r20859 | # Copyright (c) IPython Development Team. | ||
# Distributed under the terms of the Modified BSD License. | ||||
Brian Granger
|
r2229 | |||
def import_item(name): | ||||
Fernando Perez
|
r11016 | """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 | ||||
Matthias Bussonnier
|
r26419 | The fully qualified name of the module/package being imported. | ||
Fernando Perez
|
r11016 | |||
Returns | ||||
------- | ||||
mod : module object | ||||
Matthias Bussonnier
|
r26419 | The module that was imported. | ||
Fernando Perez
|
r11016 | """ | ||
Fernando Perez
|
r3121 | |||
Fernando Perez
|
r11018 | parts = name.rsplit('.', 1) | ||
if len(parts) == 2: | ||||
# called with 'foo.bar....' | ||||
package, obj = parts | ||||
module = __import__(package, fromlist=[obj]) | ||||
Fernando Perez
|
r6738 | try: | ||
Min RK
|
r20859 | pak = getattr(module, obj) | ||
Ram Rachum
|
r25833 | except AttributeError as e: | ||
raise ImportError('No module named %s' % obj) from e | ||||
Fernando Perez
|
r6738 | return pak | ||
Thomas Kluyver
|
r3108 | else: | ||
Fernando Perez
|
r11018 | # called with un-dotted string | ||
return __import__(parts[0]) | ||||