Как импортировать модуль hello: варианты и нюансы

Раздел: Основы Python -> Импорт модулей

Импорт модуля hello в Python

Модуль hello - это обычный файл hello.py, который содержит функции, классы или переменные. Импорт позволяет использовать код из этого файла в других скриптах. Рассмотрим несколько способов импорта с примерами и типичными ошибками.

Как импортировать модуль hello целиком и вызвать его функции?

Самый простой способ - использовать import hello. После этого все объекты модуля доступны через точечную нотацию.


# hello.py
def greet(name):
    return f"Привет, {name}!"

# main.py
import hello
print(hello.greet("Мир"))

Python import (импорт в python)

Привет, Мир!

Import модуля python (импорт модуля в python)

Проблема: ModuleNotFoundError

Если файл hello.py не находится в том же каталоге или в путях поиска Python, возникает ошибка ModuleNotFoundError: No module named 'hello'. Решение: убедиться, что файл существует и Python его видит (например, добавить папку в sys.path).

Как импортировать только одну функцию, чтобы не загромождать пространство имён?

Используйте from hello import greet. После этого функцию можно вызывать напрямую, без префикса hello..


from hello import greet
print(greet("Алиса"))

Import hello python (импорт модуля hello в python (пример))

Привет, Алиса!

Python 3 import file (импорт файла в python 3)

Ошибка: AttributeError возникает, если имя функции указано неверно или её нет в модуле. Перед импортом проверьте содержимое модуля с помощью dir(hello).

Как задать короткий псевдоним для модуля?

При импорте с псевдонимом (import hello as h) обращение к объектам становится короче.


import hello as h
print(h.greet("Боб"))
  
Привет, Боб!

Конфликты имён возможны, если псевдоним уже занят другой переменной. Выбирайте уникальные краткие имена.

Как импортировать несколько функций с переименованием?

Допустим, в hello.py есть функции greet и farewell. Импортируем их с другими именами:


from hello import greet as g, farewell as f
print(g("Иван"))
print(f("Мария"))

Если модуль содержит много объектов, лучше импортировать его целиком, чтобы сохранить читаемость.

Как импортировать модуль из подкаталога (пакета)?

Предположим, структура: my_package/hello.py. Импорт:
import my_package.hello или from my_package import hello.


# my_package/__init__.py (может быть пустым)
import my_package.hello
print(my_package.hello.greet("Анна"))

Без файла __init__.py папка не считается пакетом. В Python 3.3+ это требование смягчено для обычных пакетов, но рекомендуется для явности.

Как импортировать модуль, если он лежит в другом каталоге, не входящем в sys.path?

Временно добавляем путь через sys.path.append('/путь/к/папке') перед импортом.


import sys
sys.path.append('/home/user/my_modules')
import hello
print(hello.greet("Петр"))

Такой подход непостоянен и затрудняет переносимость. Лучше использовать установку пакета или переменную окружения PYTHONPATH.

Как динамически импортировать модуль по имени (строке)?

Используйте importlib.import_module('hello').


import importlib
hello_mod = importlib.import_module('hello')
print(hello_mod.greet("Динамика"))

Если модуль не найден, возникнет ModuleNotFoundError. Подходит для плагинов или конфигураций, где имя модуля задаётся переменной.

Расширенные примеры импорта модуля hello

Импорт с проверкой выполнения модуля как скрипта

В hello.py можно добавить блок if __name__ == '__main__', чтобы код выполнялся только при прямом запуске, а не при импорте.

Пример 

# hello.py
def greet(name):
    return f"Привет, {name}!"

if __name__ == '__main__':
    print("Модуль запущен как скрипт")
    print(greet("Тест"))

# main.py
import hello
print(hello.greet("Коля"))

Привет, Коля!

Импорт с использованием __all__ для контроля экспорта

В модуле можно задать список __all__, который определяет, что импортируется при from hello import *.

Пример 

# hello.py
__all__ = ['greet']

def greet(name):
    return f"Здравствуйте, {name}!"

def hidden():
    return "Эта функция невидима для *"

# main.py
from hello import *
print(greet("Оля"))
# print(hidden())  # NameError

Здравствуйте, Оля!

Импорт из ZIP-архива

Python может импортировать модули прямо из ZIP-файлов, если добавить путь к архиву в sys.path.

Пример 

# Создаём archive.zip, внутри hello.py
def salute():
    return "Салют из ZIP!"

# main.py
import sys
sys.path.insert(0, '/path/to/archive.zip')
import hello
print(hello.salute())

Салют из ZIP!

Динамическая загрузка с помощью importlib.util

Можно загрузить модуль из произвольного файла, даже если он не в путях поиска.

Пример 

import importlib.util
import sys

spec = importlib.util.spec_from_file_location("hello", "/home/user/hello.py")
hello = importlib.util.module_from_spec(spec)
sys.modules["hello"] = hello
spec.loader.exec_module(hello)

print(hello.greet("Виталий"))

Привет, Виталий!

Импорт модуля, написанного на другом языке (C-расширение)

Если модуль hello реализован как compiled extension, импорт происходит так же, но требует компиляции. Для примера используем гипотетический hello.cpython-310-x86_64-linux-gnu.so.

Пример 

import hello
print(hello.fast_greet("Cython"))

Fast Hello from C extension!

Импорт модуля по относительному пути внутри пакета

Если hello.py находится в одном пакете с другим модулем, используется относительный импорт.

Пример 

# Структура:
# my_package/
#   __init__.py
#   hello.py
#   test.py

# test.py
from . import hello
print(hello.greet("Сосед"))

Привет, Сосед!

Импорт с проверкой наличия модуля (try-except)

Позволяет gracefully обработать отсутствие модуля.

Пример 

try:
    import hello
except ImportError:
    print("Модуль hello не найден, используем заглушку")
    def greet(name):
        return f"Hi, {name}"
else:
    greet = hello.greet

print(greet("Гость"))

Привет, Гость!

Импорт модуля hello в Python (пример) - comments

En
Import hello python (python)