perf(boot): lazy-import curl_cffi off the settings boot path

Defer the GestdownLookup import into the suggestion workers' execute()
so curl_cffi no longer loads during window boot (~170ms off the import
path). Add tools/boot_timer.py to profile settings-mode boot (pyinstrument
call tree, viztracer timeline, and cold-FS runs).

Author: vagabondHustler

.gitignore

@@ -183,3 +183,4 @@ memory/**
 .agents/**
 .github/workflows/release_v2.yml
 AGENTS.md
+tools/_boot_profiles/

pyproject.toml

@@ -84,7 +84,13 @@
         "tox==4.56.1",
         "python-dotenv==1.2.2",
     ]
-    tools = ["commitizen==4.16.4", "pre-commit==4.6.0", "pillow==12.2.0"]
+    tools = [
+        "commitizen==4.16.4",
+        "pre-commit==4.6.0",
+        "pillow==12.2.0",
+        "pyinstrument==5.1.2",
+        "viztracer==1.1.1",
+    ]
     type = ["mypy==2.1.0"]
 
 

src/subsearch/io/app_updater.py

@@ -2,8 +2,6 @@
 from pathlib import Path
 from typing import Callable, NamedTuple
 
-from curl_cffi.requests import exceptions
-
 from subsearch.io import file_system
 from subsearch.io.http import get_session
 from subsearch.runtime.config import APP_PATHS
@@ -25,6 +23,8 @@ class ReleasePage(NamedTuple):
 
 
 def fetch_latest_release_page() -> ReleasePage:
+    from curl_cffi.requests import exceptions
+
     try:
         response = get_session().get(LATEST_RELEASE_PAGE)
     except exceptions.RequestException as error:
@@ -41,6 +41,8 @@ def installer_url(version: str) -> str:
 def download_installer(version: str, on_progress: Callable[[float], None] | None = None) -> Path:
     APP_PATHS.tmp_dir.mkdir(parents=True, exist_ok=True)
     destination = APP_PATHS.tmp_dir / INSTALLER_NAME.format(version=version)
+    from curl_cffi.requests import exceptions
+
     try:
         response = get_session().get(installer_url(version), stream=True)
     except exceptions.RequestException as error:

src/subsearch/io/http.py

@@ -1,18 +1,24 @@
-from curl_cffi import requests
-from curl_cffi.requests import Response, exceptions
+from typing import TYPE_CHECKING
+
 from selectolax.lexbor import LexborHTMLParser
 
 from subsearch.parsing.html_parser import parse_html_response
 from subsearch.runtime.recorder import LogLevel, capture
 
+if TYPE_CHECKING:
+    from curl_cffi import requests
+    from curl_cffi.requests import Response
+
+
+def get_session() -> "requests.Session":
+    from curl_cffi import requests
 
-def get_session() -> requests.Session:
     return requests.Session(impersonate="chrome")
 
 
 def send_request(
-    url: str, session: requests.Session, timeout: tuple[int, int], header: dict[str, str] | None = None
-) -> Response:
+    url: str, session: "requests.Session", timeout: tuple[int, int], header: dict[str, str] | None = None
+) -> "Response":
     if header is None:
         return session.get(url, timeout=timeout)
     return session.get(url, timeout=timeout, headers=header)
@@ -21,6 +27,8 @@ def send_request(
 def request_parsed_response(
     url: str, timeout: tuple[int, int], header: dict[str, str] | None = None
 ) -> LexborHTMLParser | None:
+    from curl_cffi.requests import exceptions
+
     session = get_session()
     try:
         response = send_request(url, session, timeout=timeout, header=header)
@@ -34,6 +42,8 @@ def request_parsed_response(
 
 
 def request_parsed_post(url: str, data: dict[str, str], timeout: tuple[int, int]) -> LexborHTMLParser | None:
+    from curl_cffi.requests import exceptions
+
     session = get_session()
     try:
         response = session.post(url, data=data, timeout=timeout)

src/subsearch/parsing/html_parser.py

@@ -1,6 +1,10 @@
-from curl_cffi.requests import Response
+from typing import TYPE_CHECKING
+
 from selectolax.lexbor import LexborHTMLParser
 
+if TYPE_CHECKING:
+    from curl_cffi.requests import Response
+
 
-def parse_html_response(response: Response) -> LexborHTMLParser:
+def parse_html_response(response: "Response") -> LexborHTMLParser:
     return LexborHTMLParser(response.text)

src/subsearch/parsing/imdb_lookup.py

@@ -1,14 +1,27 @@
 from dataclasses import dataclass
-
-import imdbinfo
-from imdbinfo.exceptions import ImdbinfoError
+from types import ModuleType
 
 from subsearch.runtime.models import ProviderDiagnosticStatus
 from subsearch.runtime.recorder import LogLevel, capture
 
 SUGGESTION_LIMIT = 5
 _SUGGESTION_KINDS = {"movie", "tvSeries", "tvMiniSeries", "tvMovie"}
 
+imdbinfo: ModuleType
+ImdbinfoError: type[Exception]
+
+
+def _load_imdbinfo() -> None:
+    # Deferred so settings-mode boot, which never runs a lookup, skips the ~0.8s import.
+    global imdbinfo, ImdbinfoError
+    if "imdbinfo" in globals():
+        return
+    import imdbinfo as imdbinfo_module
+    from imdbinfo.exceptions import ImdbinfoError as ImdbinfoErrorType
+
+    imdbinfo = imdbinfo_module
+    ImdbinfoError = ImdbinfoErrorType
+
 
 @dataclass(frozen=True)
 class TitleSuggestion:
@@ -48,6 +61,7 @@ def display_text(self) -> str:
 
 
 def find_season_suggestions(imdb_id: str) -> list[SeasonSuggestion]:
+    _load_imdbinfo()
     try:
         season_episodes = imdbinfo.get_episodes(imdb_id, season=1)
     except ImdbinfoError:
@@ -60,6 +74,7 @@ def find_season_suggestions(imdb_id: str) -> list[SeasonSuggestion]:
 
 
 def find_episode_suggestions(imdb_id: str, season: int) -> list[EpisodeSuggestion]:
+    _load_imdbinfo()
     try:
         season_episodes = imdbinfo.get_episodes(imdb_id, season=season)
     except ImdbinfoError:
@@ -78,6 +93,7 @@ def find_episode_suggestions(imdb_id: str, season: int) -> list[EpisodeSuggestio
 
 
 def find_title_suggestions(typed_term: str, limit: int = SUGGESTION_LIMIT) -> list[TitleSuggestion]:
+    _load_imdbinfo()
     capture(f"Fuzzy matching {typed_term!r}")
     try:
         search_result = imdbinfo.search_title(typed_term)
@@ -115,6 +131,7 @@ def __init__(self, title: str, year: int, tvseries: bool) -> None:
         self.imdb_id = ""
         self.diagnostic_status = ProviderDiagnosticStatus.OK
 
+        _load_imdbinfo()
         try:
             search_result = imdbinfo.search_title(title)
         except ImdbinfoError:

src/subsearch/ui/services/season_episode_suggestions.py

@@ -1,6 +1,5 @@
 from PySide6.QtCore import QObject, Signal
 
-from subsearch.parsing.gestdown_lookup import GestdownLookup
 from subsearch.parsing.imdb_lookup import (
     EpisodeSuggestion,
     SeasonSuggestion,
@@ -17,6 +16,8 @@ def __init__(self, title: str, imdb_id: str) -> None:
         self.imdb_id = imdb_id
 
     def execute(self) -> list[SeasonSuggestion]:
+        from subsearch.parsing.gestdown_lookup import GestdownLookup
+
         return GestdownLookup().find_season_suggestions(self.title) or find_season_suggestions(self.imdb_id)
 
 
@@ -29,6 +30,8 @@ def __init__(self, title: str, imdb_id: str, season: int, language_name: str) ->
         self.language_name = language_name
 
     def execute(self) -> list[EpisodeSuggestion]:
+        from subsearch.parsing.gestdown_lookup import GestdownLookup
+
         gestdown = GestdownLookup().find_episode_suggestions(self.title, self.season, self.language_name)
         return gestdown or find_episode_suggestions(self.imdb_id, self.season)
 

tests/test_imdb_episode_lookup.py

@@ -1,5 +1,6 @@
 from dataclasses import dataclass
 
+import pytest
 from imdbinfo.exceptions import ImdbinfoError
 
 from subsearch.parsing import imdb_lookup
@@ -9,6 +10,11 @@
 )
 
 
+@pytest.fixture(autouse=True)
+def _load_imdbinfo() -> None:
+    imdb_lookup._load_imdbinfo()
+
+
 @dataclass
 class _FakeEpisode:
     season: int

tests/test_title_suggestions.py

@@ -1,8 +1,15 @@
 from types import SimpleNamespace
 
+import pytest
+
 from subsearch.parsing import imdb_lookup
 
 
+@pytest.fixture(autouse=True)
+def _load_imdbinfo() -> None:
+    imdb_lookup._load_imdbinfo()
+
+
 def _fake_search_result(titles: list[SimpleNamespace]) -> SimpleNamespace:
     return SimpleNamespace(titles=titles)