"""
سرویس‌های گیاه — دریافت مشخصات گیاه از API خارجی بر اساس نام.
"""

import logging

logger = logging.getLogger(__name__)


def fetch_plant_info_from_api(plant_name: str) -> dict | None:
    """
    اتصال به API خارجی و دریافت مشخصات گیاه بر اساس نام.

    TODO: پیاده‌سازی اتصال واقعی به API.
    در حال حاضر این تابع خالی است و None برمی‌گرداند.

    پارامترها:
        plant_name: نام گیاه

    خروجی مورد انتظار (وقتی پیاده‌سازی شود):
        {
            "name": "گوجه‌فرنگی",
            "light": "آفتاب کامل",
            "watering": "منظم، هفته‌ای ۲-۳ بار",
            "soil": "لومی، غنی از مواد آلی",
            "temperature": "۲۰-۳۰ درجه سانتی‌گراد",
            "planting_season": "بهار",
            "harvest_time": "۷۰-۹۰ روز پس از کاشت",
            "spacing": "۴۵-۶۰ سانتی‌متر",
            "fertilizer": "کود NPK متعادل",
        }
    """
    # TODO: اتصال واقعی به API
    return None