Python для начинающих

Python для начинающих: как приручить модули и относительные импорты

Когда скрипт вырастает до 300+ строк, его уже страшно открывать, не то что править. Решение простое и взрослое — разбивать код на модули и пакеты. Давай разберёмся, как это делать аккуратно и зачем вообще нужны относительные импорты.

---

## Модули и пакеты по-простому

- Модуль — любой .py файл.
- Пакет — папка с файлом __init__.py (может быть пустым).

Пример структуры проекта:

my_project/
    app.py
    core/
        __init__.py
        models.py
        services.py
        utils/
            __init__.py
            validators.py

Теперь core и core.utils — это пакеты, а остальные .py — модули.

---

## Абсолютный импорт

Самый прямолинейный способ:

# app.py
from core.models import User
from core.services import UserService
from core.utils.validators import validate_email

Плюс: ясно, откуда что приезжает.
Минус: если переименуешь пакет core в backend, придется править полпроекта.

---

## Зачем нужны относительные импорты

Внутри пакета можно ссылаться на «соседей» относительно текущего модуля, а не от корня проекта.
Используются точки:

- . — текущий пакет
- .. — на уровень вверх
- ... — на два уровня вверх и т.д.

### Пример

# core/services.py
from .models import User          # из того же пакета core
from .utils.validators import validate_email  # из подпакета utils

# core/utils/validators.py
from ..models import User  # поднялись из core/utils в core и взяли models

Это удобно, если структура пакетов логична сама по себе и ты не хочешь, чтобы имя «корневого» пакета было зашито в каждый импорт.

---

## Важный момент: как запускать проект

Относительные импорты корректно работают, если запускать код как модуль, а не «проваливаться» внутрь пакета.

Правильно:

python -m my_project.app

Неправильно:

cd my_project/core
python services.py  # относительные импорты могут упасть

Когда запускаешь модуль через -m, Python понимает структуру пакетов и не путается с путями.

---

## Практический мини-шаблон

# core/models.py
class User:
    def __init__(self, email: str):
        self.email = email

# core/utils/validators.py
def validate_email(email: str) -> bool:
    return "@" in email and "." in email

# core/services.py
from .models import User
from .utils.validators import validate_email

def create_user(email: str) -> User:
    if not validate_email(email):
        raise ValueError("Invalid email")
    return User(email=email)

# app.py
from core.services import create_user

if __name__ == "__main__":
    user = create_user("test@example.com")
    print(user.email)

---

Главная идея: модули — это способ разрезать код на логические куски, а относительные импорты — способ связывать эти куски так, чтобы проект можно было безболезненно переорганизовывать. Как только твой файл перестанет влезать «на один экран», самое время завести свой первый пакет.

👍2🔥1

159 views04:20