from iytdl import iYTDL

async def main():
    async with iYTDL(log_group_id=LOG_GROUP_ID, cache_path="cache") as ytdl:

        # 🔍 Search YouTube
        result = await ytdl.search("never gonna give you up")
        print(result.msg)

        # 🔗 Parse any supported URL
        result = await ytdl.parse("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

        # ⬇️ Download video
        key = await ytdl.download(
            url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
            uid="mp4",
            downtype="video",
            update=message,  # Pyrogram Message or CallbackQuery
        )

        # 📤 Upload to Telegram
        await ytdl.upload(client, key, "video", message)

iYTDL(
    log_group_id: Union[int, str],          # Telegram chat ID for uploading media
    session: Optional[ClientSession],        # aiohttp session (auto-created if None)
    silent: bool = False,                    # suppress yt-dlp stdout
    download_path: str = "downloads",        # local download directory
    cache_path: str = "",                    # SQLite cache directory
    delete_media: bool = False,              # auto-cleanup after upload
    external_downloader: Optional[ExternalDownloader] = None,  # e.g. Aria2c(...)
    ffmpeg_location: str = "ffmpeg",         # custom ffmpeg path
)

# Pagination (Back / Next)
r"^yt_(back|next)\|(?P<key>[\w-]{5,11})\|(?P<pg>\d+)$"

# List all results
r"^yt_listall\|(?P<key>[\w-]{5,11})$"

# Extract info
r"^yt_extract_info\|(?P<key>[\w-]{5,11})$"

# Download (generic + YouTube)
r"yt_(?P<mode>gen|dl)\|(?P<key>[\w-]+)\|(?P<choice>[\w-]+)\|(?P<dl_type>a|v)$"

# Cancel download/upload
r"^yt_cancel\|(?P<process_id>[\w\.]+)$"

from iytdl.types.external_downloader import Aria2c

async with iYTDL(
    log_group_id=LOG_GROUP_ID,
    external_downloader=Aria2c(executable_path="/usr/bin/aria2c"),
    cache_path="cache",
) as ytdl:
    ...