[api] Add backwards compat. helpers to avoid breaking imports

Author: Breakthrough

scenedetect/frame_timecode.py

@@ -0,0 +1,22 @@
+#
+#            PySceneDetect: Python-Based Video Scene Detector
+#   -------------------------------------------------------------------
+#     [  Site:    https://scenedetect.com                           ]
+#     [  Docs:    https://scenedetect.com/docs/                     ]
+#     [  Github:  https://github.com/Breakthrough/PySceneDetect/    ]
+#
+# Copyright (C) 2014-2025 Brandon Castellano <http://www.bcastell.com>.
+# PySceneDetect is licensed under the BSD 3-Clause License; see the
+# included LICENSE file, or visit one of the above pages for details.
+#
+"""DEPRECATED"""
+
+import warnings
+
+warnings.warn(
+    "The `frame_timecode` submodule is deprecated, import from the base package instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from scenedetect.common import *  # noqa: E402, F403

scenedetect/scene_detector.py

@@ -0,0 +1,22 @@
+#
+#            PySceneDetect: Python-Based Video Scene Detector
+#   -------------------------------------------------------------------
+#     [  Site:    https://scenedetect.com                           ]
+#     [  Docs:    https://scenedetect.com/docs/                     ]
+#     [  Github:  https://github.com/Breakthrough/PySceneDetect/    ]
+#
+# Copyright (C) 2014-2025 Brandon Castellano <http://www.bcastell.com>.
+# PySceneDetect is licensed under the BSD 3-Clause License; see the
+# included LICENSE file, or visit one of the above pages for details.
+#
+"""DEPRECATED"""
+
+import warnings
+
+warnings.warn(
+    "The `scene_detector` submodule is deprecated, import from the base package instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from scenedetect.detector import *  # noqa: E402, F403

tests/test_detectors.py

@@ -224,3 +224,12 @@ def test_detectors_with_stats(test_video_file):
         scene_manager.detect_scenes(video=video, end_time=end_time)
         scene_list = scene_manager.get_scene_list()
         assert len(scene_list) == initial_scene_len
+
+
+# TODO(v0.8): Remove this test during the removal of `scenedetect.scene_detector`.
+def test_deprecated_detector_module_emits_warning_on_import():
+    SCENE_DETECTOR_WARNING = (
+        "The `scene_detector` submodule is deprecated, import from the base package instead."
+    )
+    with pytest.warns(DeprecationWarning, match=SCENE_DETECTOR_WARNING):
+        from scenedetect.scene_detector import SceneDetector as _

tests/test_timecode.py

@@ -300,3 +300,12 @@ def test_precision():
     assert FrameTimecode(990, fps).get_timecode(precision=1, use_rounding=False) == "00:00:00.9"
     assert FrameTimecode(990, fps).get_timecode(precision=0, use_rounding=True) == "00:00:01"
     assert FrameTimecode(990, fps).get_timecode(precision=0, use_rounding=False) == "00:00:00"
+
+
+# TODO(v0.8): Remove this test during the removal of `scenedetect.scene_detector`.
+def test_deprecated_timecode_module_emits_warning_on_import():
+    FRAME_TIMECODE_WARNING = (
+        "The `frame_timecode` submodule is deprecated, import from the base package instead."
+    )
+    with pytest.warns(DeprecationWarning, match=FRAME_TIMECODE_WARNING):
+        from scenedetect.frame_timecode import FrameTimecode as _