general: deprecate some old methods by hiding behind TYPE_CHECKING

my/hypothesis.py

@@ -6,7 +6,7 @@
 ]
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Iterator, Sequence
+from typing import Iterator, Sequence, TYPE_CHECKING
 
 from my.core import (
  get_files,
@@ -69,5 +69,7 @@ def stats() -> Stats:
  }
 
 
-get_highlights = highlights # todo deprecate
-get_pages = pages # todo deprecate
+if not TYPE_CHECKING:
+ # "deprecate" by hiding from mypy
+ get_highlights = highlights
+ get_pages = pages

my/pocket.py

@@ -5,6 +5,7 @@
  'git+https://github.com/karlicoss/pockexport',
 ]
 from dataclasses import dataclass
+from typing import TYPE_CHECKING
 
 from .core import Paths
 
@@ -61,5 +62,7 @@ def stats() -> Stats:
 
 
 # todo deprecate?
-def get_articles() -> Sequence[Article]:
- return list(articles())
+if not TYPE_CHECKING:
+ # "deprecate" by hiding from mypy
+ def get_articles() -> Sequence[Article]:
+ return list(articles())

my/polar.py

@@ -249,4 +249,6 @@ def get_entries() -> List[Result]:
 
 
 ## deprecated
-Error = Exception # for backwards compat with Orger; can remove later
+if not TYPE_CHECKING:
+ # "deprecate" by hiding from mypy
+ Error = Exception # for backwards compat with Orger; can remove later

my/youtube/takeout.py

@@ -1,4 +1,4 @@
-from typing import NamedTuple, List, Iterable
+from typing import NamedTuple, List, Iterable, TYPE_CHECKING
 
 from ..core import datetime_aware, Res, LazyLogger
 from ..core.compat import removeprefix
@@ -99,7 +99,9 @@ def stats() -> Stats:
 
 ### deprecated stuff (keep in my.media.youtube)
 
-get_watched = watched
+if not TYPE_CHECKING:
+ # "deprecate" by hiding from mypy
+ get_watched = watched
 
 
 def _watched_legacy() -> Iterable[Watched]: