nonebot-plugin-parser 2.0.1__tar.gz → 2.0.3__tar.gz

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nonebot-plugin-parser
-Version: 2.0.1
+Version: 2.0.3
 Summary: NoneBot2 链接分享解析器自动解析, BV号/链接/小程序/卡片 | B站/抖音/快手/微博/小红书/youtube/tiktok/twitter/acfun
 Keywords: nonebot,nonebot2,video,bilibili,youtube,tiktok,twitter,kuaishou,acfun,weibo,xiaohongshu,nga,douyin
 Author: fllesser
@@ -42,8 +42,7 @@ Description-Content-Type: text/markdown
 <br/>
 [![pre-commit](https://results.pre-commit.ci/badge/github/fllesser/nonebot-plugin-parser/master.svg)](https://results.pre-commit.ci/latest/github/fllesser/nonebot-plugin-parser/master)
 [![codecov](https://codecov.io/gh/fllesser/nonebot-plugin-parser/graph/badge.svg?token=VCS8IHSO7U)](https://codecov.io/gh/fllesser/nonebot-plugin-parser)
-[![pepy](https://static.pepy.tech/badge/nonebot-plugin-parser)](https://pepy.tech/projects/nonebot-plugin-parser)
-
+[![qqgroup](https://img.shields.io/badge/QQ%E7%BE%A4-820082006-orange?style=flat-square)](https://qm.qq.com/q/y4T4CjHimc)
 </div>
 
 > [!IMPORTANT]

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/README.md

@@ -12,8 +12,7 @@
 <br/>
 [![pre-commit](https://results.pre-commit.ci/badge/github/fllesser/nonebot-plugin-parser/master.svg)](https://results.pre-commit.ci/latest/github/fllesser/nonebot-plugin-parser/master)
 [![codecov](https://codecov.io/gh/fllesser/nonebot-plugin-parser/graph/badge.svg?token=VCS8IHSO7U)](https://codecov.io/gh/fllesser/nonebot-plugin-parser)
-[![pepy](https://static.pepy.tech/badge/nonebot-plugin-parser)](https://pepy.tech/projects/nonebot-plugin-parser)
-
+[![qqgroup](https://img.shields.io/badge/QQ%E7%BE%A4-820082006-orange?style=flat-square)](https://qm.qq.com/q/y4T4CjHimc)
 </div>
 
 > [!IMPORTANT]

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-parser"
-version = "2.0.1"
+version = "2.0.3"
 description = "NoneBot2 链接分享解析器自动解析, BV号/链接/小程序/卡片 | B站/抖音/快手/微博/小红书/youtube/tiktok/twitter/acfun"
 authors = [{ "name" = "fllesser", "email" = "fllessive@gmail.com" }]
 readme = "README.md"
@@ -185,7 +185,7 @@ build-backend = "uv_build"
 
 
 [tool.bumpversion]
-current_version = "2.0.1"
+current_version = "2.0.3"
 commit = true
 message = "🔖 release: bump vesion from {current_version} to {new_version}"
 tag = true

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/src/nonebot_plugin_parser/download/__init__.py

@@ -8,7 +8,7 @@ from tqdm.asyncio import tqdm
 
 from ..config import pconfig
 from ..constants import COMMON_HEADER, DOWNLOAD_TIMEOUT
-from ..exception import DownloadException, DownloadSizeLimitException
+from ..exception import DownloadException, SizeLimitException, ZeroSizeException
 from ..utils import generate_file_name, merge_av, safe_unlink
 from .task import auto_task
 from .ytdlp import YtdlpDownloader
@@ -50,7 +50,6 @@ class StreamDownloader:
         if not file_name:
             file_name = generate_file_name(url)
         file_path = self.cache_dir / file_name
-
         # 如果文件存在，则直接返回
         if file_path.exists():
             return file_path
@@ -61,11 +60,15 @@ class StreamDownloader:
             async with self.client.stream("GET", url, headers=headers, follow_redirects=True) as response:
                 response.raise_for_status()
                 content_length = response.headers.get("Content-Length")
-                content_length = int(content_length) if content_length else None
+                content_length = int(content_length) if content_length else 0
+
+                if content_length == 0:
+                    logger.warning(f"媒体 url: {url}, 大小为 0, 取消下载")
+                    raise ZeroSizeException
 
-                if content_length and (file_size := content_length / 1024 / 1024) > pconfig.max_size:
-                    logger.warning(f"{file_name} 大小 {file_size:.2f} MB 超过 {pconfig.max_size} MB, 取消下载")
-                    raise DownloadSizeLimitException
+                if (file_size := content_length / 1024 / 1024) > pconfig.max_size:
+                    logger.warning(f"媒体 url: {url} 大小 {file_size:.2f} MB 超过 {pconfig.max_size} MB, 取消下载")
+                    raise SizeLimitException
 
                 with self.get_progress_bar(file_name, content_length) as bar:
                     async with aiofiles.open(file_path, "wb") as file:

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/src/nonebot_plugin_parser/download/task.py

@@ -13,6 +13,7 @@ def auto_task(func: Callable[P, Coroutine[Any, Any, T]]) -> Callable[P, Task[T]]
     @wraps(func)
     def wrapper(*args: P.args, **kwargs: P.kwargs) -> Task[T]:
         coro = func(*args, **kwargs)
-        return create_task(coro)
+        name = " | ".join(str(arg) for arg in args if isinstance(arg, str))
+        return create_task(coro, name=func.__name__ + " | " + name)
 
     return wrapper

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/src/nonebot_plugin_parser/download/ytdlp.py

@@ -7,7 +7,7 @@ from msgspec import Struct
 import yt_dlp
 
 from ..config import pconfig
-from ..exception import ParseException
+from ..exception import DurationLimitException, ParseException
 from ..utils import LimitedSizeDict, generate_file_name
 from .task import auto_task
 
@@ -39,7 +39,7 @@ class YtdlpDownloader:
     """YtdlpDownloader class"""
 
     def __init__(self):
-        self._url_info_mapping = LimitedSizeDict[str, VideoInfo]()
+        self._video_info_mapping = LimitedSizeDict[str, VideoInfo]()
         self._ydl_extract_base_opts: dict[str, Any] = {
             "quiet": True,
             "skip_download": True,
@@ -60,9 +60,9 @@ class YtdlpDownloader:
         Returns:
             dict[str, str]: video info
         """
-        info_dict = self._url_info_mapping.get(url, None)
-        if info_dict:
-            return info_dict
+        video_info = self._video_info_mapping.get(url, None)
+        if video_info:
+            return video_info
         ydl_opts = {} | self._ydl_extract_base_opts
 
         if cookiefile:
@@ -72,8 +72,9 @@ class YtdlpDownloader:
             info_dict = await asyncio.to_thread(ydl.extract_info, url, download=False)
             if not info_dict:
                 raise ParseException("获取视频信息失败")
+
         video_info = msgspec.convert(info_dict, VideoInfo)
-        self._url_info_mapping[url] = video_info
+        self._video_info_mapping[url] = video_info
         return video_info
 
     @auto_task
@@ -87,8 +88,11 @@ class YtdlpDownloader:
         Returns:
             Path: video file path
         """
-        info_dict = await self.extract_video_info(url, cookiefile)
-        duration = info_dict.duration
+        video_info = await self.extract_video_info(url, cookiefile)
+        duration = video_info.duration
+        if duration > pconfig.duration_maximum:
+            raise DurationLimitException
+
         video_path = pconfig.cache_dir / generate_file_name(url, ".mp4")
         if video_path.exists():
             return video_path
@@ -121,6 +125,7 @@ class YtdlpDownloader:
         audio_path = pconfig.cache_dir / f"{file_name}.flac"
         if audio_path.exists():
             return audio_path
+
         ydl_opts = {
             "outtmpl": f"{pconfig.cache_dir / file_name}.%(ext)s",
             "format": "bestaudio/best",

nonebot_plugin_parser-2.0.3/src/nonebot_plugin_parser/exception.py

@@ -0,0 +1,40 @@
+class ParseException(Exception):
+    """异常基类"""
+
+    def __init__(self, message: str):
+        self.message = message
+
+
+class DownloadException(ParseException):
+    """下载异常"""
+
+    def __init__(self, message: str | None = None):
+        self.message = message or "媒体下载失败"
+
+
+class DownloadLimitException(DownloadException):
+    """下载超过限制异常"""
+
+    def __init__(self):
+        raise NotImplementedError
+
+
+class SizeLimitException(DownloadLimitException):
+    """下载大小超过限制异常"""
+
+    def __init__(self):
+        self.message = "媒体大小超过配置限制，取消下载"
+
+
+class DurationLimitException(DownloadLimitException):
+    """下载时长超过限制异常"""
+
+    def __init__(self):
+        self.message = "媒体时长超过配置限制，取消下载"
+
+
+class ZeroSizeException(DownloadException):
+    """下载大小为 0 异常"""
+
+    def __init__(self):
+        self.message = "媒体大小为 0, 取消下载"

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/src/nonebot_plugin_parser/helper.py

@@ -7,19 +7,19 @@ from nonebot_plugin_alconna.uniseg import Segment, UniMessage, Voice
 from nonebot_plugin_alconna.uniseg.segment import CustomNode, Reference
 
 from .config import pconfig
-from .exception import ParseException
+
+ForwardNodeInner = str | Segment | UniMessage
+"""转发消息节点内部允许的类型"""
 
 
 class UniHelper:
     @staticmethod
-    def construct_forward_message(
-        segments: Sequence[str | Segment | UniMessage], user_id: str | None = None
-    ) -> Reference:
+    def construct_forward_message(segments: Sequence[ForwardNodeInner], user_id: str | None = None) -> Reference:
         """构造转发消息
 
         Args:
             user_id (str): 用户ID
-            segments (Sequence[Segment | str]): 消息段
+            segments (Sequence[ForwardNode]): 消息段
 
         Returns:
             Reference: 转发消息
@@ -39,23 +39,6 @@ class UniHelper:
 
         return Reference(nodes=nodes)
 
-    @classmethod
-    async def send_segments(cls, segments: Sequence[Segment | str]) -> None:
-        """发送消息段
-
-        Args:
-            segments (Sequence[Segment | str]): 消息段
-        """
-
-        if len(segments) > 2:
-            forward_msg = cls.construct_forward_message(segments)
-            await UniMessage([forward_msg]).send()
-
-        else:
-            segments = list(segments)
-            segments[:-1] = [Text(seg + "\n") if isinstance(seg, str) else seg for seg in segments[:-1]]
-            await UniMessage(segments).send()
-
     @staticmethod
     def img_seg(img_path: Path | None = None, raw: bytes | None = None) -> Image:
         """获取图片 Seg
@@ -103,7 +86,7 @@ class UniHelper:
         # 检测文件大小
         file_size_byte_count = int(video_path.stat().st_size)
         if file_size_byte_count == 0:
-            raise ParseException("视频文件大小为 0")
+            return Text("视频文件大小为 0")
         elif file_size_byte_count > 100 * 1024 * 1024:
             # 转为文件 Seg
             return cls.file_seg(video_path, display_name=video_path.name)

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/src/nonebot_plugin_parser/matchers/__init__.py

@@ -62,15 +62,11 @@ async def _(
     await _message_reaction(event, "resolving")
 
     cache_key = matched.group(0)
-    if result := RESULT_CACHE.get(cache_key):
-        logger.debug(f"命中缓存: {cache_key}")
-    else:
-        # 获取对应平台 parser
-        parser = KEYWORD_PARSER_MAP.get(keyword)
-
-        if parser is None:
-            logger.warning("没有找到对应平台的 Parser")
-            return
+    # 1. 获取缓存结果
+    result = RESULT_CACHE.get(cache_key)
+    if result is None:
+        # 2. 获取对应平台 parser
+        parser = KEYWORD_PARSER_MAP[keyword]
 
         try:
             result = await parser.parse(matched)
@@ -78,16 +74,23 @@ async def _(
             # await UniMessage(str(e)).send()
             await _message_reaction(event, "fail")
             raise
-
-        # 缓存解析结果
-        RESULT_CACHE[cache_key] = result
+        logger.debug(f"解析结果: {result}")
+    else:
+        logger.debug(f"命中缓存: {cache_key}, 结果: {result}")
 
     # 3. 渲染内容消息并发送
-    renderer = get_renderer(result.platform.name)
-    async for message in renderer.render_messages(result):
-        await message.send()
-
-    # 4. 添加成功的消息响应
+    try:
+        renderer = get_renderer(result.platform.name)
+        async for message in renderer.render_messages(result):
+            await message.send()
+    except Exception:
+        await _message_reaction(event, "fail")
+        raise
+
+    # 4. 无 raise 再缓存解析结果
+    RESULT_CACHE[cache_key] = result
+
+    # 5. 添加成功的消息响应
     await _message_reaction(event, "done")
 
 

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/src/nonebot_plugin_parser/matchers/preprocess.py

@@ -112,47 +112,6 @@ def extract_msg_text(message: UniMsg, state: T_State) -> None:
         state[R_EXTRACT_KEY] = text
 
 
-class UrlKeywordsRule:
-    """检查消息是否含有关键词 增强版"""
-
-    __slots__ = ("keywords",)
-
-    def __init__(self, *keywords: str):
-        self.keywords = keywords
-
-    def __repr__(self) -> str:
-        return f"UrlKeywords(keywords={self.keywords})"
-
-    def __eq__(self, other: object) -> bool:
-        return isinstance(other, UrlKeywordsRule) and frozenset(self.keywords) == frozenset(other.keywords)
-
-    def __hash__(self) -> int:
-        return hash(frozenset(self.keywords))
-
-    async def __call__(self, state: T_State, text: str = ExtractText()) -> bool:
-        if not text:
-            return False
-        if key := next((k for k in self.keywords if k in text), None):
-            state[R_KEYWORD_KEY] = key
-            return True
-        return False
-
-
-def url_keywords(*keywords: str) -> Rule:
-    return Rule(UrlKeywordsRule(*keywords))
-
-
-def on_url_keyword(*keywords: str, priority: int = 5) -> type[Matcher]:
-    matcher = Matcher.new(
-        "message",
-        is_not_in_disabled_groups & url_keywords(*keywords),
-        priority=priority,
-        block=True,
-        source=get_matcher_source(1),
-    )
-    return matcher
-
-
 class KeyPatternList(list[tuple[str, re.Pattern[str]]]):
     def __init__(self, *args: tuple[str, str | re.Pattern[str]]):
         super().__init__()

{nonebot_plugin_parser-2.0.1 → nonebot_plugin_parser-2.0.3}/src/nonebot_plugin_parser/parsers/acfun.py

@@ -2,11 +2,12 @@ import asyncio
 import json
 from pathlib import Path
 import re
+import time
 from typing import ClassVar
 from typing_extensions import override
 
 import aiofiles
-import httpx
+from httpx import AsyncClient, HTTPError
 from nonebot import logger
 
 from ..config import pconfig
@@ -14,8 +15,7 @@ from ..constants import COMMON_TIMEOUT, DOWNLOAD_TIMEOUT
 from ..download import DOWNLOADER
 from ..exception import DownloadException, ParseException
 from ..utils import safe_unlink
-from .base import BaseParser
-from .data import Author, ParseResult, Platform, VideoContent
+from .base import BaseParser, Platform
 
 
 class AcfunParser(BaseParser):
@@ -40,10 +40,11 @@ class AcfunParser(BaseParser):
         Returns:
             tuple: (m3u8_url, title, description, author, upload_time)
         """
+
         # 拼接查询参数
         url = f"{url}?quickViewId=videoInfo_new&ajaxpipe=1"
 
-        async with httpx.AsyncClient(headers=self.headers, timeout=COMMON_TIMEOUT) as client:
+        async with AsyncClient(headers=self.headers, timeout=COMMON_TIMEOUT) as client:
             response = await client.get(url)
             response.raise_for_status()
             raw = response.text
@@ -88,7 +89,7 @@ class AcfunParser(BaseParser):
             max_size_in_bytes = pconfig.max_size * 1024 * 1024
             async with (
                 aiofiles.open(video_file, "wb") as f,
-                httpx.AsyncClient(headers=self.headers, timeout=DOWNLOAD_TIMEOUT) as client,
+                AsyncClient(headers=self.headers, timeout=DOWNLOAD_TIMEOUT) as client,
             ):
                 total_size = 0
                 with DOWNLOADER.get_progress_bar(video_file.name) as bar:
@@ -101,7 +102,7 @@ class AcfunParser(BaseParser):
                         if total_size > max_size_in_bytes:
                             # 直接截断
                             break
-        except httpx.HTTPError:
+        except HTTPError:
             await safe_unlink(video_file)
             logger.exception("acfun 视频下载失败")
             raise DownloadException("acfun 视频下载失败")
@@ -116,7 +117,7 @@ class AcfunParser(BaseParser):
         Returns:
             list[str]: 视频链接
         """
-        async with httpx.AsyncClient(headers=self.headers, timeout=COMMON_TIMEOUT) as client:
+        async with AsyncClient(headers=self.headers, timeout=COMMON_TIMEOUT) as client:
             response = await client.get(m3u8_url)
             m3u8_file = response.text
         # 分离ts文件链接
@@ -135,14 +136,14 @@ class AcfunParser(BaseParser):
         return m3u8_full_urls
 
     @override
-    async def parse(self, matched: re.Match[str]) -> ParseResult:
+    async def parse(self, matched: re.Match[str]):
         """解析 URL 获取内容信息并下载资源
 
         Args:
             matched: 正则表达式匹配对象，由平台对应的模式匹配得到
 
         Returns:
-            ParseResult: 解析结果（已下载资源，包含 Path）
+            ParseResult: 解析结果
 
         Raises:
             ParseException: 解析失败时抛出
@@ -152,19 +153,19 @@ class AcfunParser(BaseParser):
         url = f"https://www.acfun.cn/v/ac{acid}"
 
         m3u8_url, title, description, author, upload_time = await self.parse_video_info(url)
+        author = self.create_author(author) if author else None
 
-        extra_info = f"简介: {description}\n上传于 {upload_time}" if description or upload_time else None
+        # 2024-12-1 -> timestamp
+        timestamp = int(time.mktime(time.strptime(upload_time, "%Y-%m-%d")))
+        text = f"简介: {description}"
 
         # 下载视频
         video_task = asyncio.create_task(self.download_video(m3u8_url, acid))
 
-        extra = {}
-        if extra_info:
-            extra["info"] = extra_info
-
         return self.result(
             title=title,
-            author=Author(name=author) if author else None,
-            contents=[VideoContent(video_task)],
-            extra=extra,
+            text=text,
+            author=author,
+            timestamp=timestamp,
+            contents=[self.create_video_content(video_task)],
         )

nonebot_plugin_parser-2.0.3/src/nonebot_plugin_parser/parsers/base.py

@@ -0,0 +1,144 @@
+"""Parser 基类定义"""
+
+from abc import ABC, abstractmethod
+from asyncio import Task
+from collections.abc import Sequence
+from pathlib import Path
+import re
+from typing import ClassVar
+from typing_extensions import Unpack
+
+from ..constants import ANDROID_HEADER, COMMON_HEADER, COMMON_TIMEOUT, IOS_HEADER
+from .data import ParseResult, ParseResultKwargs, Platform
+
+
+class BaseParser(ABC):
+    """所有平台 Parser 的抽象基类
+
+    子类必须实现：
+    - platform: 平台信息（包含名称和显示名称）
+    - patterns: URL 正则表达式模式列表
+    - parse: 解析 URL 的方法（接收正则表达式对象）
+    """
+
+    # 类变量：存储所有已注册的 Parser 类
+    _registry: ClassVar[list[type["BaseParser"]]] = []
+
+    platform: ClassVar[Platform]
+    """ 平台信息（包含名称和显示名称） """
+
+    patterns: ClassVar[list[tuple[str, str]]]
+    """ URL 正则表达式模式列表 [(keyword, pattern), ...] """
+
+    def __init__(self):
+        self.headers = COMMON_HEADER.copy()
+        self.ios_headers = IOS_HEADER.copy()
+        self.android_headers = ANDROID_HEADER.copy()
+        self.timeout = COMMON_TIMEOUT
+
+    def __init_subclass__(cls, **kwargs):
+        """自动注册子类到 _registry"""
+        super().__init_subclass__(**kwargs)
+        if ABC not in cls.__bases__:  # 跳过抽象类
+            BaseParser._registry.append(cls)
+
+    @classmethod
+    def get_all_subclass(cls) -> list[type["BaseParser"]]:
+        """获取所有已注册的 Parser 类"""
+        return cls._registry
+
+    @abstractmethod
+    async def parse(self, matched: re.Match[str]) -> ParseResult:
+        """解析 URL 获取内容信息并下载资源
+
+        Args:
+            matched: 正则表达式匹配对象，由平台对应的模式匹配得到
+
+        Returns:
+            ParseResult: 解析结果（已下载资源，包含 Path）
+
+        Raises:
+            ParseException: 解析失败时抛出
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def search_url(cls, url: str) -> re.Match[str]:
+        from nonebot import logger
+
+        """搜索 URL 匹配模式"""
+        for keyword, pattern in cls.patterns:
+            if keyword not in url:
+                continue
+            if searched := re.search(pattern, url):
+                return searched
+            logger.debug(f"keyword '{keyword}' is in '{url}', but not matched")
+        raise ValueError(f"无法匹配 {url}")
+
+    @classmethod
+    def result(cls, **kwargs: Unpack[ParseResultKwargs]) -> ParseResult:
+        """构建解析结果"""
+        return ParseResult(platform=cls.platform, **kwargs)
+
+    @staticmethod
+    async def get_redirect_url(url: str, headers: dict[str, str] | None = None) -> str:
+        """获取重定向后的URL"""
+        from httpx import AsyncClient
+
+        headers = headers or COMMON_HEADER.copy()
+        async with AsyncClient(headers=headers, verify=False, follow_redirects=False, timeout=COMMON_TIMEOUT) as client:
+            response = await client.get(url)
+            if response.status_code >= 400:
+                response.raise_for_status()
+            return response.headers.get("Location", url)
+
+    def create_author(self, name: str, avatar_url: str | None = None, description: str | None = None):
+        """创建作者对象"""
+        from ..download import DOWNLOADER
+        from .data import Author
+
+        avatar_task = None
+        if avatar_url:
+            avatar_task = DOWNLOADER.download_img(avatar_url, ext_headers=self.headers)
+        return Author(name=name, avatar=avatar_task, description=description)
+
+    def create_video_content(self, url_or_task: str | Task[Path], cover_url: str | None = None, duration: float = 0.0):
+        """创建视频内容"""
+        from ..download import DOWNLOADER
+        from .data import VideoContent
+
+        cover_task = None
+        if cover_url:
+            cover_task = DOWNLOADER.download_img(cover_url, ext_headers=self.headers)
+        if isinstance(url_or_task, str):
+            video_task = DOWNLOADER.download_video(url_or_task, ext_headers=self.headers)
+        else:
+            video_task = url_or_task
+        return VideoContent(video_task, cover_task, duration)
+
+    def create_image_contents(self, image_urls: Sequence[str]):
+        """创建图片内容列表"""
+        from ..download import DOWNLOADER
+        from .data import ImageContent
+
+        img_tasks = [DOWNLOADER.download_img(url, ext_headers=self.headers) for url in image_urls]
+        return [ImageContent(task) for task in img_tasks]
+
+    def create_dynamic_contents(self, dynamic_urls: Sequence[str]):
+        """创建动态内容列表"""
+        from ..download import DOWNLOADER
+        from .data import DynamicContent
+
+        dynamic_tasks = [DOWNLOADER.download_video(url, ext_headers=self.headers) for url in dynamic_urls]
+        return [DynamicContent(task) for task in dynamic_tasks]
+
+    def create_audio_content(self, url_or_task: str | Task[Path], duration: float = 0.0):
+        """创建音频内容"""
+        from ..download import DOWNLOADER
+        from .data import AudioContent
+
+        if isinstance(url_or_task, str):
+            audio_task = DOWNLOADER.download_audio(url_or_task, ext_headers=self.headers)
+        else:
+            audio_task = url_or_task
+        return AudioContent(audio_task, duration)