code-style

Code Style — Стиль кодирования пользователя

Описание

Этот навык описывает полный стиль кодирования, оформления репозиториев и проектов. Применяй ВСЕГДА при создании или изменении кода — для любых проектов и языков, если не указано иное.

📁 Структура проекта

ProjectName/
├── main.py                  # Монолитный файл (весь код в одном файле)
├── .env.example             # Пример конфигурации (НИКОГДА .env)
├── requirements.txt         # Зависимости Python
├── Dockerfile               # Docker-образ
├── deploy_bot.sh            # Скрипт деплоя на сервер
├── README.md                # Подробная документация
├── LICENSE                  # MIT License
├── langs/                   # Локализация (JSON)
├── data/                    # Данные (базы, конфиги)
├── logs/                    # Логи (по дням)
└── sessions/                # Сессии (если telethon)

Ключевой принцип: монолитная архитектура — один main.py для простоты деплоя.

🐍 Python: Стиль кода

Импорты

import asyncio
import html
import json
import logging
import os
import secrets
import sys
import time
from datetime import datetime, timedelta
from pathlib import Path
from typing import Any, Dict, List, Optional, Set, Tuple, Union

import aiofiles
import aiosqlite
from aiogram import Bot, Dispatcher, Router, F
from dotenv import load_dotenv

Порядок: стандартная библиотека → третьи стороны → локальные. Всегда импортируй конкретные типы из typing.

Типизация — СТРОГАЯ

def format_traffic(traffic_gb: Any, lang: str = DEFAULT_LANGUAGE) -> str:
    ...

async def create_subscription(
    user_id: int,
    plan: Dict[str, Any],
    *,
    extra_days: int = 0,
    days_override: Optional[int] = None,
    earn_trust: bool = True,
) -> Optional[str]:
    ...

• Optional[T] — НЕТ T | None
• Union[A, B] — НЕТ A | B
• Dict[str, Any] для общих словарей
• List[Dict[str, Any]] для списков
• Union[Message, CallbackQuery] для событий
• * для keyword-only аргументов
• **kwargs: Any в обработчиках