Что такое Google code style

Google Code Style — это набор рекомендаций по оформлению кода, разработанный Google для различных языков программирования, включая Python. Основная цель — обеспечить единообразие кода в больших проектах, упрощая чтение и поддержку.

Основные правила для Python:

• Отступы: 2 пробела (не табы).
• Длина строки: максимум 80 символов.
• Именование:
  • snake_case для функций и переменных.
  • PascalCase для классов.
  • CAPS_SNAKE_CASE для констант.
• Импорты: группируются (stdlib, third-party, local), каждый на новой строке.
• Docstrings: обязательны для модулей, классов и публичных методов.

Пример:

import os
from typing import Optional

MAX_RETRIES = 3

def fetch_data(url: str, timeout: Optional[int] = None) -> str:
    """Получает данные по указанному URL.  

    Args:
        url: Адрес для запроса.  
        timeout: Таймаут в секундах.  

    Returns:
        Ответ сервера в виде строки.  
    """
    # ...  

Соблюдение стиля помогает избежать хаоса в кодовой базе, особенно в команде.