🎨 lint: use ruff 0.13 and enable future-annotations option

Author: SigureMo

pyproject.toml

@@ -29,10 +29,11 @@ dependencies = [
   "dict2xml>=1.7.7",
   "httpx[http2,socks]>=0.28.1",
   "tomli>=2.2.1; python_version < '3.11'",
-  "pydantic>=2.12.0a1",
+  # "pydantic>=2.12.0a1",
+  "pydantic==2.11.9",
   "returns>=0.26.0",
 ]
-optional-dependencies.mcp = ["fastmcp>=2.10.2"]
+optional-dependencies.mcp = ["fastmcp>=2.12.3"]
 
 [project.urls]
 Homepage = "https://github.com/yutto-dev/yutto"
@@ -45,11 +46,11 @@ yutto = "yutto.__main__:main"
 
 [dependency-groups]
 dev = [
-  "pyright>=1.1.404",
-  "ruff>=0.12.11",
-  "typos>=1.35.6",
-  "pytest>=8.4.1",
-  "pytest-rerunfailures>=16.0",
+  "pyright>=1.1.405",
+  "ruff>=0.13.0",
+  "typos>=1.36.2",
+  "pytest>=8.4.2",
+  "pytest-rerunfailures>=16.0.1",
   "syrupy>=4.9.1",
   "pytest-codspeed>=4.0.0",
 ]
@@ -111,11 +112,11 @@ select = [
   "RUF100",
 ]
 ignore = [
-  "E501",  # line too long, duplicate with ruff fmt
-  "F401",  # imported but unused, duplicate with pyright
-  "F841",  # local variable is assigned to but never used, duplicate with pyright
-  "UP038", # It will cause the performance regression on python3.10
+  "E501", # line too long, duplicate with ruff fmt
+  "F401", # imported but unused, duplicate with pyright
+  "F841", # local variable is assigned to but never used, duplicate with pyright
 ]
+future-annotations = true
 
 [tool.ruff.lint.isort]
 required-imports = ["from __future__ import annotations"]
@@ -124,6 +125,7 @@ combine-as-imports = true
 
 [tool.ruff.lint.flake8-type-checking]
 runtime-evaluated-base-classes = ["pydantic.BaseModel"]
+runtime-evaluated-decorators = ["fastmcp.FastMCP.tool"]
 
 [tool.ruff.lint.per-file-ignores]
 "setup.py" = ["I"]

src/yutto/api/bangumi.py

@@ -6,26 +6,30 @@
 from yutto.exceptions import NoAccessPermissionError, UnSupportedTypeError
 from yutto.media.codec import audio_codec_map, video_codec_map
 from yutto.types import (
-    AudioUrlMeta,
-    AvId,
     BvId,
     CId,
     EpisodeId,
-    MediaId,
-    MultiLangSubtitle,
     SeasonId,
-    VideoUrlMeta,
     format_ids,
 )
 from yutto.utils.console.logger import Logger
-from yutto.utils.fetcher import Fetcher, FetcherContext
+from yutto.utils.fetcher import Fetcher
 from yutto.utils.functional import data_has_chained_keys
 from yutto.utils.metadata import MetaData
 from yutto.utils.time import get_time_stamp_by_now
 
 if TYPE_CHECKING:
     from httpx import AsyncClient
 
+    from yutto.types import (
+        AudioUrlMeta,
+        AvId,
+        MediaId,
+        MultiLangSubtitle,
+        VideoUrlMeta,
+    )
+    from yutto.utils.fetcher import FetcherContext
+
 
 class BangumiListItem(TypedDict):
     id: int

src/yutto/api/cheese.py

@@ -6,24 +6,28 @@
 from yutto.media.codec import audio_codec_map, video_codec_map
 from yutto.types import (
     AId,
-    AudioUrlMeta,
-    AvId,
     CId,
     EpisodeId,
-    MultiLangSubtitle,
     SeasonId,
-    VideoUrlMeta,
     format_ids,
 )
 from yutto.utils.console.logger import Logger
-from yutto.utils.fetcher import Fetcher, FetcherContext
+from yutto.utils.fetcher import Fetcher
 from yutto.utils.functional import data_has_chained_keys
 from yutto.utils.metadata import MetaData
 from yutto.utils.time import get_time_stamp_by_now
 
 if TYPE_CHECKING:
     from httpx import AsyncClient
 
+    from yutto.types import (
+        AudioUrlMeta,
+        AvId,
+        MultiLangSubtitle,
+        VideoUrlMeta,
+    )
+    from yutto.utils.fetcher import FetcherContext
+
 
 class CheeseListItem(TypedDict):
     id: int

src/yutto/api/collection.py

@@ -4,12 +4,15 @@
 import math
 from typing import TYPE_CHECKING, TypedDict
 
-from yutto.types import AvId, BvId, MId, SeriesId
-from yutto.utils.fetcher import Fetcher, FetcherContext
+from yutto.types import BvId
+from yutto.utils.fetcher import Fetcher
 
 if TYPE_CHECKING:
     from httpx import AsyncClient
 
+    from yutto.types import AvId, MId, SeriesId
+    from yutto.utils.fetcher import FetcherContext
+
 
 class CollectionDetailsItem(TypedDict):
     id: int

src/yutto/api/danmaku.py

@@ -6,13 +6,14 @@
 from biliass import get_danmaku_meta_size
 
 from yutto.api.user_info import get_user_info
-from yutto.utils.fetcher import Fetcher, FetcherContext
+from yutto.utils.fetcher import Fetcher
 
 if TYPE_CHECKING:
     import httpx
 
     from yutto.types import AvId, CId
     from yutto.utils.danmaku import DanmakuData, DanmakuSaveType
+    from yutto.utils.fetcher import FetcherContext
 
 
 async def get_xml_danmaku(ctx: FetcherContext, client: httpx.AsyncClient, cid: CId) -> str:

src/yutto/api/space.py

@@ -5,13 +5,16 @@
 
 from yutto.api.user_info import encode_wbi, get_wbi_img
 from yutto.exceptions import NotLoginError
-from yutto.types import AvId, BvId, FavouriteMetaData, FId, MId, SeriesId
+from yutto.types import BvId, FavouriteMetaData, FId
 from yutto.utils.console.logger import Logger
-from yutto.utils.fetcher import Fetcher, FetcherContext
+from yutto.utils.fetcher import Fetcher
 
 if TYPE_CHECKING:
     from httpx import AsyncClient
 
+    from yutto.types import AvId, MId, SeriesId
+    from yutto.utils.fetcher import FetcherContext
+
 
 # 个人空间·全部
 async def get_user_space_all_videos_avids(ctx: FetcherContext, client: AsyncClient, mid: MId) -> list[AvId]:

src/yutto/api/ugc_video.py

@@ -11,24 +11,29 @@
 from yutto.media.codec import audio_codec_map, video_codec_map
 from yutto.types import (
     AId,
-    AudioUrlMeta,
-    AvId,
     BvId,
     CId,
     EpisodeId,
-    MultiLangSubtitle,
-    VideoUrlMeta,
     format_ids,
 )
 from yutto.utils.console.logger import Logger
-from yutto.utils.fetcher import Fetcher, FetcherContext
+from yutto.utils.fetcher import Fetcher
 from yutto.utils.functional.data_access import data_has_chained_keys
-from yutto.utils.metadata import Actor, ChapterInfoData, MetaData
+from yutto.utils.metadata import Actor, MetaData
 from yutto.utils.time import get_time_stamp_by_now
 
 if TYPE_CHECKING:
     from httpx import AsyncClient
 
+    from yutto.types import (
+        AudioUrlMeta,
+        AvId,
+        MultiLangSubtitle,
+        VideoUrlMeta,
+    )
+    from yutto.utils.fetcher import FetcherContext
+    from yutto.utils.metadata import ChapterInfoData
+
 
 class _UgcVideoPageInfo(TypedDict):
     part: str

src/yutto/api/user_info.py

@@ -11,11 +11,13 @@
 
 from yutto.types import UserInfo
 from yutto.utils.asynclib import async_cache
-from yutto.utils.fetcher import Fetcher, FetcherContext
+from yutto.utils.fetcher import Fetcher
 
 if TYPE_CHECKING:
     from httpx import AsyncClient
 
+    from yutto.utils.fetcher import FetcherContext
+
 
 class WbiImg(TypedDict):
     img_key: str

src/yutto/download_manager.py

@@ -9,8 +9,7 @@
 
 import httpx
 from biliass import BlockOptions
-from httpx import AsyncClient
-from returns.maybe import Maybe, Nothing, Some
+from returns.maybe import Nothing, Some
 
 from yutto.downloader.downloader import DownloadState, process_download
 from yutto.exceptions import ErrorCode
@@ -33,7 +32,7 @@
 from yutto.utils.asynclib import sleep_with_status_bar_refresh
 from yutto.utils.console.logger import Badge, Logger
 from yutto.utils.danmaku import DanmakuOptions
-from yutto.utils.fetcher import Fetcher, FetcherContext, create_client
+from yutto.utils.fetcher import Fetcher, create_client
 from yutto.utils.time import TIME_FULL_FMT
 from yutto.validator import (
     validate_batch_arguments,
@@ -44,7 +43,11 @@
     import argparse
     from collections.abc import Callable
 
+    from httpx import AsyncClient
+    from returns.maybe import Maybe
+
     from yutto.types import EpisodeData
+    from yutto.utils.fetcher import FetcherContext
 
 
 @dataclass

src/yutto/downloader/downloader.py

@@ -13,11 +13,11 @@
 from yutto.utils.console.colorful import colored_string
 from yutto.utils.console.logger import Badge, Logger
 from yutto.utils.danmaku import write_danmaku
-from yutto.utils.fetcher import Fetcher, FetcherContext
+from yutto.utils.fetcher import Fetcher
 from yutto.utils.ffmpeg import FFmpeg, FFmpegCommandBuilder
 from yutto.utils.file_buffer import AsyncFileBuffer
 from yutto.utils.functional import filter_none_values, xmerge
-from yutto.utils.metadata import ChapterInfoData, write_chapter_info, write_metadata
+from yutto.utils.metadata import write_chapter_info, write_metadata
 from yutto.utils.subtitle import write_subtitle
 
 if TYPE_CHECKING:
@@ -27,6 +27,8 @@
     import httpx
 
     from yutto.types import AudioUrlMeta, DownloaderOptions, EpisodeData, VideoUrlMeta
+    from yutto.utils.fetcher import FetcherContext
+    from yutto.utils.metadata import ChapterInfoData
 
 
 def slice_blocks(start: int, total_size: int | None, block_size: int | None = None) -> list[tuple[int, int | None]]: