imp.md

1> **Источник:** https://python-all.ru/3.0/library/imp.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `imp` – доступ к внутренностям [`import`](https://python-all.ru/3.0/reference/simple_stmts.html#import)89Этот модуль предоставляет интерфейс к механизмам, используемым для реализации оператора [`import`](https://python-all.ru/3.0/reference/simple_stmts.html#import). Он определяет следующие константы и функции:1011#### `[imp.get_magic]imp.get_magic()`1213Возвращает магическое строковое значение, используемое для распознавания байт-кодовых файлов (файлов `.pyc`). (Это значение может различаться для разных версий Python.)1415#### `[imp.get_suffixes]imp.get_suffixes()`1617Возвращает список трёхэлементных кортежей, каждый из которых описывает конкретный тип модуля. Каждая тройка имеет вид1819`(suffix, mode, type)`2021, где2223*suffix*2425– строка, добавляемая к имени модуля для формирования имени файла для поиска,2627*mode*2829– строка режима, передаваемая встроенной функции3031[`open()`](https://python-all.ru/3.0/library/functions.html#open)3233для открытия файла (это может быть3435`'r'`3637для текстовых файлов или3839`'rb'`4041для двоичных файлов), а4243*type*4445– тип файла, который принимает одно из значений4647[`PY_SOURCE`](https://python-all.ru/3.0/library/imp.html#imp.PY_SOURCE)4849,5051[`PY_COMPILED`](https://python-all.ru/3.0/library/imp.html#imp.PY_COMPILED)5253или5455[`C_EXTENSION`](https://python-all.ru/3.0/library/imp.html#imp.C_EXTENSION)5657, описанных ниже.5859#### `[imp.find_module]imp.find_module(name[, path])`6061Пытается найти модуль *name* на пути поиска *path*. Если *path* – список имён каталогов, каждый каталог проверяется на наличие файлов с любым из суффиксов, возвращаемых [`get_suffixes()`](https://python-all.ru/3.0/library/imp.html#imp.get_suffixes) выше. Некорректные имена в списке игнорируются без сообщений (но все элементы списка должны быть строками). Если *path* опущен или равен `None`, выполняется поиск по списку имён каталогов, заданному `sys.path`, но сначала проверяются несколько особых мест: предпринимается попытка найти встроенный модуль с указанным именем ([`C_BUILTIN`](https://python-all.ru/3.0/library/imp.html#imp.C_BUILTIN)), затем замороженный модуль ([`PY_FROZEN`](https://python-all.ru/3.0/library/imp.html#imp.PY_FROZEN)), а на некоторых системах также проверяются и другие места (в Windows – реестр, который может указывать на конкретный файл).6263Если поиск успешен, возвращаемое значение – трёхэлементный кортеж `(file, pathname, description)`:6465*file* – это открытый файловый объект, установленный в начало, *pathname* – это имя пути найденного файла, а *description* – кортеж из 3 элементов, как содержащийся в списке, возвращаемом [`get_suffixes()`](https://python-all.ru/3.0/library/imp.html#imp.get_suffixes), описывающий тип найденного модуля.6667Если модуль не находится в файле, возвращаемый *file* равен `None`, *pathname* – пустая строка, а кортеж *description* содержит пустые строки для суффикса и режима; тип модуля указывается, как показано выше в скобках. Если поиск неуспешен, возбуждается [`ImportError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.ImportError). Другие исключения указывают на проблемы с аргументами или окружением.6869Если модуль является пакетом, *file* равен `None`, *pathname* – путь к пакету, а последним элементом кортежа *description* является [`PKG_DIRECTORY`](https://python-all.ru/3.0/library/imp.html#imp.PKG_DIRECTORY).7071Эта функция не работает с иерархическими именами модулей (именами, содержащими точки). Чтобы найти *P*.\*M\*, то есть подмодуль *M* пакета *P*, используйте [`find_module()`](https://python-all.ru/3.0/library/imp.html#imp.find_module) и [`load_module()`](https://python-all.ru/3.0/library/imp.html#imp.load_module) для поиска и загрузки пакета *P*, а затем вызовите [`find_module()`](https://python-all.ru/3.0/library/imp.html#imp.find_module) с аргументом *path*, установленным в `P.__path__`. Если *P* сам содержит точку, применяйте этот рецепт рекурсивно.7273#### `[imp.load_module]imp.load_module(name, file, pathname, description)`7475Загружает модуль, который ранее был найден с помощью [`find_module()`](https://python-all.ru/3.0/library/imp.html#imp.find_module) (или другого поиска, давшего совместимые результаты). Эта функция делает больше, чем просто импорт модуля: если модуль уже был импортирован, она перезагружает его! Аргумент *name* указывает полное имя модуля (включая имя пакета, если это подмодуль пакета). Аргумент *file* – это открытый файл, а *pathname* – соответствующее имя файла; они могут быть `None` и `''` соответственно, когда модуль является пакетом или не загружается из файла. Аргумент *description* – это кортеж, такой, какой вернула бы [`get_suffixes()`](https://python-all.ru/3.0/library/imp.html#imp.get_suffixes), описывающий, какой тип модуля должен быть загружен.7677Если загрузка успешна, возвращается объект модуля; в противном случае возбуждается исключение (обычно [`ImportError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.ImportError)).7879**Важно:** вызывающий код отвечает за закрытие аргумента *file*, если он не был `None`, даже при возбуждении исключения. Лучше всего это делать с помощью оператора [`try`](https://python-all.ru/3.0/reference/compound_stmts.html#try) ... [`finally`](https://python-all.ru/3.0/reference/compound_stmts.html#finally).8081#### `[imp.new_module]imp.new_module(name)`8283Возвращает новый пустой объект модуля с именем8485*name*8687. Этот объект8889*не*9091вставляется в9293`sys.modules`9495.9697#### `[imp.lock_held]imp.lock_held()`9899Возвращает `True`, если блокировка импорта в данный момент удерживается, иначе `False`. На платформах без потоков всегда возвращает `False`.100101На платформах с потоками поток, выполняющий импорт, удерживает внутреннюю блокировку до завершения импорта. Эта блокировка не позволяет другим потокам выполнять импорт, пока исходный импорт не завершится, что, в свою очередь, предотвращает ситуацию, когда другие потоки могут увидеть незавершённые объекты модулей, созданные исходным потоком в процессе завершения его импорта (а также импортов, если таковые были, которые были вызваны этим).102103#### `[imp.acquire_lock]imp.acquire_lock()`104105Захватывает блокировку импорта интерпретатора для текущего потока. Эта блокировка должна использоваться хуками импорта для обеспечения потокобезопасности при импорте модулей. На платформах без поддержки потоков эта функция ничего не делает.106107После того как поток захватил блокировку импорта, тот же поток может захватить её снова без блокировки; поток должен освобождать её один раз за каждый захват.108109На платформах без потоков эта функция ничего не делает.110111#### `[imp.release_lock]imp.release_lock()`112113Освобождает блокировку импорта интерпретатора. На платформах без потоков эта функция ничего не делает.114115#### `[imp.reload]imp.reload(module)`116117Перезагружает ранее импортированный модуль *module*. Аргумент должен быть объектом модуля, то есть он должен быть успешно импортирован ранее. Это полезно, если вы отредактировали исходный файл модуля во внешнем редакторе и хотите опробовать новую версию, не выходя из интерпретатора Python. Возвращаемое значение – объект модуля (тот же, что и аргумент *module*).118119При выполнении `reload(module)`:120121- Код модулей Python перекомпилируется, и код уровня модуля выполняется заново, определяя новый набор объектов, которые привязываются к именам в словаре модуля. Функция `init` модулей расширения не вызывается второй раз.122- Как и в случае со всеми другими объектами в Python, старые объекты освобождаются только после того, как их счётчики ссылок упадут до нуля.123- Имена в пространстве имён модуля обновляются, чтобы указывать на любые новые или изменённые объекты.124- Другие ссылки на старые объекты (например, имена вне модуля) не перепривязываются для указания на новые объекты и должны быть обновлены в каждом пространстве имён, где они встречаются, если это необходимо.125126Существует ряд других предостережений:127128Если модуль синтаксически корректен, но его инициализация завершается ошибкой, первый оператор [`import`](https://python-all.ru/3.0/reference/simple_stmts.html#import) для него не связывает имя локально, но сохраняет (частично инициализированный) объект модуля в `sys.modules`. Чтобы перезагрузить модуль, сначала нужно снова выполнить [`import`](https://python-all.ru/3.0/reference/simple_stmts.html#import) (это свяжет имя с частично инициализированным объектом модуля), и только затем можно вызвать для него [`reload()`](https://python-all.ru/3.0/library/imp.html#imp.reload).129130При перезагрузке модуля его словарь (содержащий глобальные переменные модуля) сохраняется. Переопределения имён заменяют старые определения, так что обычно это не проблема. Если новая версия модуля не определяет имя, которое было определено в старой версии, старое определение остаётся. Эту возможность можно использовать в пользу модуля, если он поддерживает глобальную таблицу или кеш объектов – с помощью оператора [`try`](https://python-all.ru/3.0/reference/compound_stmts.html#try) он может проверить наличие таблицы и, если нужно, пропустить её инициализацию:131132```python133try:134    cache135except NameError:136    cache = {}137```138139Перезагрузка встроенных или динамически загружаемых модулей допустима, но обычно не очень полезна, за исключением [`sys`](https://python-all.ru/3.0/library/sys.html#module-sys), [`__main__`](https://python-all.ru/3.0/library/__main__.html#module-__main__) и `__builtin__`. Однако во многих случаях модули расширения не рассчитаны на инициализацию более одного раза и могут произвольно завершаться ошибкой при перезагрузке.140141Если модуль импортирует объекты из другого модуля с помощью [`from`](https://python-all.ru/3.0/reference/simple_stmts.html#from) ... [`import`](https://python-all.ru/3.0/reference/simple_stmts.html#import) ..., то вызов [`reload()`](https://python-all.ru/3.0/library/imp.html#imp.reload) для другого модуля не переопределяет импортированные из него объекты. Один из способов обойти это – повторно выполнить оператор [`from`](https://python-all.ru/3.0/reference/simple_stmts.html#from), другой – использовать [`import`](https://python-all.ru/3.0/reference/simple_stmts.html#import) и квалифицированные имена (*module*.\*name\*).142143Если модуль создаёт экземпляры класса, перезагрузка модуля, определяющего класс, не влияет на определения методов экземпляров – они продолжают использовать старое определение класса. То же самое верно для производных классов.144145#### `imp.acquire_lock()`146147Захватывает блокировку импорта интерпретатора для текущего потока. Эта блокировка должна использоваться хуками импорта для обеспечения потокобезопасности при импорте модулей. На платформах без поддержки потоков эта функция ничего не делает.148149#### `imp.release_lock()`150151Освобождает блокировку импорта интерпретатора. На платформах без потоков эта функция ничего не делает.152153Следующие константы с целочисленными значениями, определённые в этом модуле, используются для указания результата поиска [`find_module()`](https://python-all.ru/3.0/library/imp.html#imp.find_module).154155#### `[imp.PY_SOURCE]imp.PY_SOURCE`156157Модуль найден как исходный файл.158159#### `[imp.PY_COMPILED]imp.PY_COMPILED`160161Модуль найден как файл скомпилированного кода.162163#### `[imp.C_EXTENSION]imp.C_EXTENSION`164165Модуль найден как динамически загружаемая общая библиотека.166167#### `[imp.PKG_DIRECTORY]imp.PKG_DIRECTORY`168169Модуль найден как каталог пакета.170171#### `[imp.C_BUILTIN]imp.C_BUILTIN`172173Модуль найден как встроенный модуль.174175#### `[imp.PY_FROZEN]imp.PY_FROZEN`176177Модуль был найден как замороженный модуль (см.178179[`init_frozen()`](https://python-all.ru/3.0/library/imp.html#imp.init_frozen)180181).182183Следующая константа и функции устарели; их функциональность доступна через [`find_module()`](https://python-all.ru/3.0/library/imp.html#imp.find_module) или [`load_module()`](https://python-all.ru/3.0/library/imp.html#imp.load_module). Они сохранены для обратной совместимости:184185#### `[imp.SEARCH_ERROR]imp.SEARCH_ERROR`186187Не используется.188189#### `[imp.init_builtin]imp.init_builtin(name)`190191Инициализирует встроенный модуль с именем192193*name*194195и возвращает его объект модуля, а также сохраняет его в196197`sys.modules`198199. Если модуль уже был инициализирован, он будет инициализирован200201*заново*202203. Повторная инициализация включает копирование204205`__dict__`206207встроенного модуля из кешированного модуля в запись модуля в208209`sys.modules`210211. Если встроенный модуль с именем212213*name*214215отсутствует, возвращается216217`None`218219.220221#### `[imp.init_frozen]imp.init_frozen(name)`222223Инициализирует замороженный модуль с именем224225*name*226227и возвращает его объект модуля. Если модуль уже был инициализирован, он будет инициализирован228229*снова*230231. Если замороженный модуль с именем232233*name*234235отсутствует, возвращается236237`None`238239. (Замороженные модули – это модули, написанные на Python, чей скомпилированный байт-код включён в специально собранный интерпретатор Python с помощью утилиты240241**freeze**242243комплекта Python. См.244245`Tools/freeze/`246247пока.)248249#### `[imp.is_builtin]imp.is_builtin(name)`250251Возвращает252253`1`254255, если существует встроенный модуль с именем256257*name*258259, который можно инициализировать заново. Возвращает260261`-1`262263, если существует встроенный модуль с именем264265*name*266267, который нельзя инициализировать заново (см.268269[`init_builtin()`](https://python-all.ru/3.0/library/imp.html#imp.init_builtin)270271). Возвращает272273`0`274275, если нет встроенного модуля с именем276277*name*278279.280281#### `[imp.is_frozen]imp.is_frozen(name)`282283Возвращает284285`True`286287, если существует замороженный модуль (см.288289[`init_frozen()`](https://python-all.ru/3.0/library/imp.html#imp.init_frozen)290291) с именем292293*name*294295, или296297`False`298299, если такого модуля нет.300301#### `[imp.load_compiled]imp.load_compiled(name, pathname[, file])`302303Загружает и инициализирует модуль, реализованный как файл с байт-кодом, и возвращает его объект модуля. Если модуль уже был инициализирован, он будет инициализирован *заново*. Аргумент *name* используется для создания или доступа к объекту модуля. Аргумент *pathname* указывает на файл с байт-кодом. Аргумент *file* – это файл с байт-кодом, открытый для чтения в двоичном режиме с начала. В настоящее время это должен быть реальный файловый объект, а не пользовательский класс, эмулирующий файл.304305#### `[imp.load_dynamic]imp.load_dynamic(name, pathname[, file])`306307Загружает и инициализирует модуль, реализованный как динамически загружаемая разделяемая библиотека, и возвращает его объект модуля. Если модуль уже был инициализирован, он будет инициализирован308309*заново*310311. Повторная инициализация включает копирование атрибута312313`__dict__`314315кэшированного экземпляра модуля в значение, используемое в модуле, кэшированном в316317`sys.modules`318319. Аргумент320321*pathname*322323должен указывать на разделяемую библиотеку. Аргумент324325*name*326327используется для построения имени функции инициализации: вызывается внешняя C-функция с именем328329`initname()`330331в разделяемой библиотеке. Необязательный аргумент332333*file*334335игнорируется. (Примечание: использование разделяемых библиотек сильно зависит от системы, и не все системы их поддерживают.)336337#### `[imp.load_source]imp.load_source(name, pathname[, file])`338339Загружает и инициализирует модуль, реализованный как исходный файл Python, и возвращает его объект модуля. Если модуль уже был инициализирован, он будет инициализирован340341*заново*342343. Аргумент344345*name*346347используется для создания или доступа к объекту модуля. Аргумент348349*pathname*350351указывает на исходный файл. Аргумент352353*file*354355– это исходный файл, открытый для чтения как текст с начала. В настоящее время это должен быть реальный файловый объект, а не пользовательский класс, эмулирующий файл. Обратите внимание, что если существует соответствующий файл с байт-кодом (с суффиксом356357`.pyc`358359или360361`.pyo`362363), он будет использован вместо разбора данного исходного файла.364365#### `[imp.NullImporter]class imp.NullImporter(path_string)`366367Тип [`NullImporter`](https://python-all.ru/3.0/library/imp.html#imp.NullImporter) – это хук импорта по [**PEP 302**](https://python-all.ru/3.0/library/imp.html), который обрабатывает строки пути, не являющиеся каталогами, возвращая отказ в поиске любых модулей. Вызов этого типа с существующим каталогом или пустой строкой возбуждает [`ImportError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.ImportError). В противном случае возвращается экземпляр [`NullImporter`](https://python-all.ru/3.0/library/imp.html#imp.NullImporter).368369Python добавляет экземпляры этого типа в `sys.path_importer_cache` для любых записей пути, которые не являются каталогами и не обрабатываются никакими другими хуками пути из `sys.path_hooks`. Экземпляры имеют только один метод:370371#### `[imp.NullImporter.find_module]find_module(fullname[, path])`372373Этот метод всегда возвращает374375`None`376377, указывая, что запрошенный модуль не найден.378379## Примеры380381Следующая функция эмулирует то, что было стандартным оператором импорта до Python 1.4 (без иерархических имён модулей). (Эта *реализация* не работала бы в той версии, поскольку [`find_module()`](https://python-all.ru/3.0/library/imp.html#imp.find_module) была расширена, а [`load_module()`](https://python-all.ru/3.0/library/imp.html#imp.load_module) добавлена в версии 1.4.)382383```python384import imp385import sys386387def __import__(name, globals=None, locals=None, fromlist=None):388    # Fast path: see if the module has already been imported.389    try:390        return sys.modules[name]391    except KeyError:392        pass393394    # If any of the following calls raises an exception,395    # there's a problem we can't handle -- let the caller handle it.396397    fp, pathname, description = imp.find_module(name)398399    try:400        return imp.load_module(name, fp, pathname, description)401    finally:402        # Since we may exit via an exception, close fp explicitly.403        if fp:404            fp.close()405```406407Более полный пример, который реализует иерархические имена модулей и содержит функцию [`reload()`](https://python-all.ru/3.0/library/imp.html#imp.reload), можно найти в модуле `knee`. Модуль `knee` находится в каталоге `Demo/imputil/` дистрибутива исходного кода Python.408