imp.md
1> **Источник:** https://python-all.ru/3.4/library/imp.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 36.2. [`imp`](https://python-all.ru/3.4/library/imp.html#module-imp) – Доступ к внутренним механизмам [*импорта*](https://python-all.ru/3.4/reference/import.html#importsystem)89Устарело с версии 3.4: Пакет [`imp`](https://python-all.ru/3.4/library/imp.html#module-imp) находится в процессе устаревания в пользу [`importlib`](https://python-all.ru/3.4/library/importlib.html#module-importlib).1011Этот модуль предоставляет интерфейс к механизмам, используемым для реализации оператора [`import`](https://python-all.ru/3.4/reference/simple_stmts.html#import). Он определяет следующие константы и функции:1213#### `imp.get_magic()`1415Возвращает магическое строковое значение, используемое для распознавания байт-кодовых файлов (файлов `.pyc`). (Это значение может различаться для разных версий Python.)1617Устарело с версии 3.4: Вместо этого используйте [`importlib.util.MAGIC_NUMBER`](https://python-all.ru/3.4/library/importlib.html#importlib.util.MAGIC_NUMBER).1819#### `imp.get_suffixes()`2021Возвращает список трёхэлементных кортежей, каждый из которых описывает конкретный тип модуля. Каждая тройка имеет вид `(suffix, mode, type)`, где *suffix* – строка, добавляемая к имени модуля для формирования имени файла для поиска, *mode* – строка режима, передаваемая встроенной функции [`open()`](https://python-all.ru/3.4/library/functions.html#open) для открытия файла (это может быть `'r'` для текстовых файлов или `'rb'` для двоичных файлов), а *type* – тип файла, который принимает одно из значений [`PY_SOURCE`](https://python-all.ru/3.4/library/imp.html#imp.PY_SOURCE), [`PY_COMPILED`](https://python-all.ru/3.4/library/imp.html#imp.PY_COMPILED) или [`C_EXTENSION`](https://python-all.ru/3.4/library/imp.html#imp.C_EXTENSION), описанных ниже.2223Устарело с версии 3.3: Вместо этого используйте константы, определённые в [`importlib.machinery`](https://python-all.ru/3.4/library/importlib.html#module-importlib.machinery).2425#### `imp.find_module(name[, path])`2627Пытается найти модуль *name*. Если *path* опущен или равен `None`, выполняется поиск по списку имён каталогов, заданному `sys.path`, но сначала ищется в нескольких особых местах: функция пытается найти встроенный модуль с указанным именем ([`C_BUILTIN`](https://python-all.ru/3.4/library/imp.html#imp.C_BUILTIN)), затем замороженный модуль ([`PY_FROZEN`](https://python-all.ru/3.4/library/imp.html#imp.PY_FROZEN)), а в некоторых системах также проверяются и другие места (в Windows – реестр, который может указывать на конкретный файл).2829В противном случае *path* должен быть списком имён каталогов; в каждом каталоге выполняется поиск файлов с любым из суффиксов, возвращаемых [`get_suffixes()`](https://python-all.ru/3.4/library/imp.html#imp.get_suffixes) выше. Некорректные имена в списке молча игнорируются (но все элементы списка должны быть строками).3031Если поиск успешен, возвращаемое значение – трёхэлементный кортеж `(file, pathname, description)`:3233*file* – открытый [*файловый объект*](https://python-all.ru/3.4/glossary.html#term-file-object), позиционированный на начало; *pathname* – путь к найденному файлу; а *description* – трёхэлементный кортеж, как в списке, возвращаемом [`get_suffixes()`](https://python-all.ru/3.4/library/imp.html#imp.get_suffixes), описывающий тип найденного модуля.3435Если модуль не находится в файле, возвращаемый *file* равен `None`, *pathname* – пустая строка, а кортеж *description* содержит пустые строки для суффикса и режима; тип модуля указывается, как показано выше в скобках. Если поиск неуспешен, возбуждается [`ImportError`](https://python-all.ru/3.4/library/exceptions.html#ImportError). Другие исключения указывают на проблемы с аргументами или окружением.3637Если модуль является пакетом, *file* равен `None`, *pathname* – путь к пакету, а последним элементом кортежа *description* является [`PKG_DIRECTORY`](https://python-all.ru/3.4/library/imp.html#imp.PKG_DIRECTORY).3839Эта функция не работает с иерархическими именами модулей (именами, содержащими точки). Чтобы найти *P.M*, то есть подмодуль *M* пакета *P*, используйте [`find_module()`](https://python-all.ru/3.4/library/imp.html#imp.find_module) и [`load_module()`](https://python-all.ru/3.4/library/imp.html#imp.load_module) для поиска и загрузки пакета *P*, а затем используйте [`find_module()`](https://python-all.ru/3.4/library/imp.html#imp.find_module) с аргументом *path*, установленным в `P.__path__`. Если *P* сам имеет точечное имя, применяйте этот рецепт рекурсивно.4041Устарело с версии 3.3: Используйте [`importlib.util.find_spec()`](https://python-all.ru/3.4/library/importlib.html#importlib.util.find_spec), если только не требуется совместимость с Python 3.3; в этом случае используйте [`importlib.find_loader()`](https://python-all.ru/3.4/library/importlib.html#importlib.find_loader).4243#### `imp.load_module(name, file, pathname, description)`4445Загружает модуль, который ранее был найден с помощью [`find_module()`](https://python-all.ru/3.4/library/imp.html#imp.find_module) (или другого поиска, давшего совместимые результаты). Эта функция делает больше, чем просто импорт модуля: если модуль уже был импортирован, она перезагружает его! Аргумент *name* указывает полное имя модуля (включая имя пакета, если это подмодуль пакета). Аргумент *file* – это открытый файл, а *pathname* – соответствующее имя файла; они могут быть `None` и `''` соответственно, когда модуль является пакетом или не загружается из файла. Аргумент *description* – это кортеж, такой, какой вернула бы [`get_suffixes()`](https://python-all.ru/3.4/library/imp.html#imp.get_suffixes), описывающий, какой тип модуля должен быть загружен.4647Если загрузка успешна, возвращается объект модуля; в противном случае возбуждается исключение (обычно [`ImportError`](https://python-all.ru/3.4/library/exceptions.html#ImportError)).4849**Важно:** вызывающий код отвечает за закрытие аргумента *file*, если он не был `None`, даже при возбуждении исключения. Лучше всего это делать с помощью оператора [`try`](https://python-all.ru/3.4/reference/compound_stmts.html#try) ... [`finally`](https://python-all.ru/3.4/reference/compound_stmts.html#finally).5051Устарело с версии 3.3: Если ранее использовалось совместно с [`imp.find_module()`](https://python-all.ru/3.4/library/imp.html#imp.find_module), то рассмотрите возможность использования [`importlib.import_module()`](https://python-all.ru/3.4/library/importlib.html#importlib.import_module); в противном случае используйте загрузчик, возвращённый заменой, которую вы выбрали для [`imp.find_module()`](https://python-all.ru/3.4/library/imp.html#imp.find_module). Если вы вызывали [`imp.load_module()`](https://python-all.ru/3.4/library/imp.html#imp.load_module) и связанные функции напрямую, то используйте классы в [``importlib.machinery](https://python-all.ru/3.4/library/importlib.html#module-importlib.machinery), например `importlib.machinery.SourceFileLoader(name, path).load_module()`.5253#### `imp.new_module(name)`5455Возвращает новый пустой объект модуля с именем *name*. Этот объект *не* вставляется в `sys.modules`.5657Устарело с версии 3.4: Вместо этого используйте [`types.ModuleType`](https://python-all.ru/3.4/library/types.html#types.ModuleType).5859#### `imp.reload(module)`6061Перезагружает ранее импортированный модуль *module*. Аргумент должен быть объектом модуля, то есть он должен быть успешно импортирован ранее. Это полезно, если вы отредактировали исходный файл модуля во внешнем редакторе и хотите опробовать новую версию, не выходя из интерпретатора Python. Возвращаемое значение – объект модуля (тот же, что и аргумент *module*).6263При выполнении `reload(module)`:6465- Код модулей Python перекомпилируется, и код уровня модуля выполняется заново, определяя новый набор объектов, которые привязываются к именам в словаре модуля. Функция `init` модулей расширения не вызывается второй раз.66- Как и в случае со всеми другими объектами в Python, старые объекты освобождаются только после того, как их счётчики ссылок упадут до нуля.67- Имена в пространстве имён модуля обновляются, чтобы указывать на любые новые или изменённые объекты.68- Другие ссылки на старые объекты (например, имена вне модуля) не перепривязываются для указания на новые объекты и должны быть обновлены в каждом пространстве имён, где они встречаются, если это необходимо.6970Существует ряд других предостережений:7172При перезагрузке модуля его словарь (содержащий глобальные переменные модуля) сохраняется. Переопределения имён заменяют старые определения, так что обычно это не проблема. Если новая версия модуля не определяет имя, которое было определено в старой версии, старое определение остаётся. Эту возможность можно использовать в пользу модуля, если он поддерживает глобальную таблицу или кеш объектов – с помощью оператора [`try`](https://python-all.ru/3.4/reference/compound_stmts.html#try) он может проверить наличие таблицы и, если нужно, пропустить её инициализацию:7374```python75try:76 cache77except NameError:78 cache = {}79```8081Перезагружать встроенные или динамически загружаемые модули допустимо, хотя обычно не очень полезно, за исключением [`sys`](https://python-all.ru/3.4/library/sys.html#module-sys), [`__main__`](https://python-all.ru/3.4/library/__main__.html#module-__main__) и [``builtins](https://python-all.ru/3.4/library/builtins.html#module-builtins). Однако во многих случаях модули расширения не предназначены для инициализации более одного раза и могут произвольно аварийно завершаться при перезагрузке.8283Если модуль импортирует объекты из другого модуля с помощью [`from`](https://python-all.ru/3.4/reference/simple_stmts.html#from) ... [`import`](https://python-all.ru/3.4/reference/simple_stmts.html#import) ..., то вызов [`reload()`](https://python-all.ru/3.4/library/imp.html#imp.reload) для другого модуля не переопределяет импортированные из него объекты. Один из способов обойти это – повторно выполнить оператор [`from`](https://python-all.ru/3.4/reference/simple_stmts.html#from), другой – использовать [`import`](https://python-all.ru/3.4/reference/simple_stmts.html#import) и квалифицированные имена (*module*.\*name\*).8485Если модуль создаёт экземпляры класса, перезагрузка модуля, определяющего класс, не влияет на определения методов экземпляров – они продолжают использовать старое определение класса. То же самое верно для производных классов.8687Изменено в версии 3.3: Теперь полагается на то, что в перезагружаемом модуле определены как `__name__`, так и `__loader__`, а не только `__name__`.8889Устарело с версии 3.4: Вместо этого используйте [`importlib.reload()`](https://python-all.ru/3.4/library/importlib.html#importlib.reload).9091Следующие функции предоставляют удобные средства для работы с путями к [**PEP 3147**](https://python-all.ru/3.4/library/imp.html) скомпилированным в байт-код файлам.9293Новое в версии 3.2.9495#### `imp.cache_from_source(path, debug_override=None)`9697Возвращает путь в формате [**PEP 3147**](https://python-all.ru/3.4/library/imp.html) к файлу с байт-кодом, соответствующему исходному файлу *path*. Например, если *path* – это `/foo/bar/baz.py`, то для Python 3.2 возвращаемое значение будет `/foo/bar/__pycache__/baz.cpython-32.pyc`. Строка `cpython-32` берётся из текущего magic-тега (см. [`get_tag()`](https://python-all.ru/3.4/library/imp.html#imp.get_tag); если `sys.implementation.cache_tag` не определён, то будет возбуждено [`NotImplementedError`](https://python-all.ru/3.4/library/exceptions.html#NotImplementedError)). Возвращаемый путь будет заканчиваться на `.pyc`, когда `__debug__` равно `True`, или на `.pyo` для оптимизированного Python (т.е. `__debug__` равно `False`). Передавая `True` или `False` в *debug\_override*, можно переопределить системное значение `__debug__` для выбора расширения.9899*path* не обязан существовать.100101Изменено в версии 3.3: Если `sys.implementation.cache_tag` равен `None`, то возбуждается [`NotImplementedError`](https://python-all.ru/3.4/library/exceptions.html#NotImplementedError).102103Устарело с версии 3.4: Вместо этого используйте [`importlib.util.cache_from_source()`](https://python-all.ru/3.4/library/importlib.html#importlib.util.cache_from_source).104105#### `imp.source_from_cache(path)`106107По заданному *path* к имени файла в формате [**PEP 3147**](https://python-all.ru/3.4/library/imp.html) возвращает путь к соответствующему исходному файлу. Например, если *path* равен `/foo/bar/__pycache__/baz.cpython-32.pyc`, то возвращаемый путь будет `/foo/bar/baz.py`. Файл по *path* не обязан существовать, однако если он не соответствует формату [**PEP 3147**](https://python-all.ru/3.4/library/imp.html), возбуждается `ValueError`. Если `sys.implementation.cache_tag` не определён, возбуждается [`NotImplementedError`](https://python-all.ru/3.4/library/exceptions.html#NotImplementedError).108109Изменено в версии 3.3: Возбуждает [`NotImplementedError`](https://python-all.ru/3.4/library/exceptions.html#NotImplementedError), когда `sys.implementation.cache_tag` не определён.110111Устарело с версии 3.4: Вместо этого используйте [`importlib.util.source_from_cache()`](https://python-all.ru/3.4/library/importlib.html#importlib.util.source_from_cache).112113#### `imp.get_tag()`114115Возвращает строку magic-тега в формате [**PEP 3147**](https://python-all.ru/3.4/library/imp.html), соответствующую magic-числу данной версии Python, как возвращается [`get_magic()`](https://python-all.ru/3.4/library/imp.html#imp.get_magic).116117Устарело с версии 3.4: Начиная с Python 3.3 используйте напрямую `sys.implementation.cache_tag`.118119Следующие функции помогают взаимодействовать с внутренним механизмом блокировок системы импорта. Семантика блокировок импорта является деталью реализации, которая может меняться от версии к версии. Однако Python гарантирует, что циклические импорты работают без взаимных блокировок.120121#### `imp.lock_held()`122123Возвращает `True`, если глобальная блокировка импорта в данный момент удерживается, иначе `False`. На платформах без потоков всегда возвращает `False`.124125На платформах с потоками поток, выполняющий импорт, сначала удерживает глобальную блокировку импорта, затем устанавливает блокировку на каждый модуль для остальной части импорта. Это блокирует другие потоки от импорта того же модуля до завершения исходного импорта, предотвращая появление у других потоков неполных объектов модуля, созданных исходным потоком. Исключение делается для циклических импортов, которые по своей природе должны в какой-то момент предоставить неполный объект модуля.126127Изменено в версии 3.3: Схема блокировки в основном изменилась на блокировки для каждого модуля. Глобальная блокировка импорта сохраняется для некоторых критических задач, таких как инициализация блокировок отдельных модулей.128129Устарело с версии 3.4.130131#### `imp.acquire_lock()`132133Захватывает глобальную блокировку импорта интерпретатора для текущего потока. Эта блокировка должна использоваться хуками импорта для обеспечения потокобезопасности при импорте модулей.134135После того как поток захватил блокировку импорта, тот же поток может захватить её снова без блокировки; поток должен освобождать её один раз за каждый захват.136137На платформах без потоков эта функция ничего не делает.138139Изменено в версии 3.3: Схема блокировки в основном изменилась на блокировки для каждого модуля. Глобальная блокировка импорта сохраняется для некоторых критических задач, таких как инициализация блокировок отдельных модулей.140141Устарело с версии 3.4.142143#### `imp.release_lock()`144145Освобождает глобальную блокировку импорта интерпретатора. На платформах без поддержки потоков эта функция ничего не делает.146147Изменено в версии 3.3: Схема блокировки в основном изменилась на блокировки для каждого модуля. Глобальная блокировка импорта сохраняется для некоторых критических задач, таких как инициализация блокировок отдельных модулей.148149Устарело с версии 3.4.150151Следующие константы с целочисленными значениями, определённые в этом модуле, используются для указания результата поиска [`find_module()`](https://python-all.ru/3.4/library/imp.html#imp.find_module).152153#### `imp.PY_SOURCE`154155Модуль найден как исходный файл.156157Устарело с версии 3.3.158159#### `imp.PY_COMPILED`160161Модуль найден как файл скомпилированного кода.162163Устарело с версии 3.3.164165#### `imp.C_EXTENSION`166167Модуль найден как динамически загружаемая общая библиотека.168169Устарело с версии 3.3.170171#### `imp.PKG_DIRECTORY`172173Модуль найден как каталог пакета.174175Устарело с версии 3.3.176177#### `imp.C_BUILTIN`178179Модуль найден как встроенный модуль.180181Устарело с версии 3.3.182183#### `imp.PY_FROZEN`184185Модуль найден как замороженный модуль.186187Устарело с версии 3.3.188189#### `class imp.NullImporter(path_string)`190191Тип [`NullImporter`](https://python-all.ru/3.4/library/imp.html#imp.NullImporter) – это хук импорта по [**PEP 302**](https://python-all.ru/3.4/library/imp.html), который обрабатывает строки пути, не являющиеся каталогами, возвращая отказ в поиске любых модулей. Вызов этого типа с существующим каталогом или пустой строкой возбуждает [`ImportError`](https://python-all.ru/3.4/library/exceptions.html#ImportError). В противном случае возвращается экземпляр [`NullImporter`](https://python-all.ru/3.4/library/imp.html#imp.NullImporter).192193Экземпляры имеют только один метод:194195#### `find_module(fullname[, path])`196197Этот метод всегда возвращает `None`, указывая, что запрошенный модуль не найден.198199Изменено в версии 3.3: В `sys.path_importer_cache` теперь вставляется `None` вместо экземпляра [`NullImporter`](https://python-all.ru/3.4/library/imp.html#imp.NullImporter).200201Устарело с версии 3.4: Вставляйте `None` в `sys.path_importer_cache` вместо этого.202203## 36.2.1. Примеры204205Следующая функция эмулирует то, что было стандартным оператором импорта до Python 1.4 (без иерархических имён модулей). (Эта *реализация* не работала бы в той версии, поскольку [`find_module()`](https://python-all.ru/3.4/library/imp.html#imp.find_module) была расширена, а [`load_module()`](https://python-all.ru/3.4/library/imp.html#imp.load_module) добавлена в версии 1.4.)206207```python208import imp209import sys210211def __import__(name, globals=None, locals=None, fromlist=None):212 # Быстрый путь: проверить, импортирован ли модуль ранее.213 try:214 return sys.modules[name]215 except KeyError:216 pass217218 # Если любой из следующих вызовов вызывает исключение,219 # возникает проблема, которую мы не можем обработать – пусть вызывающий код обработает её.220221 fp, pathname, description = imp.find_module(name)222223 try:224 return imp.load_module(name, fp, pathname, description)225 finally:226 # Так как возможен выход через исключение, необходимо явно закрыть fp.227 if fp:228 fp.close()229```230