[build] Drop Python 3.7 and macos 13 support.

The macos13 builder will be retired soon so remove it early to avoid breaking the build.

Python 3.7 is not supported on all builders already and has been EOL for > 2 years now.

Author: Breakthrough

.github/workflows/build.yml

@@ -26,21 +26,11 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [macos-13, macos-14, ubuntu-22.04, ubuntu-latest, windows-latest]
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
-        exclude:
-          # macos-14 builders use M1 (ARM64) which does not have a Python 3.7 package available.
-          - os: macos-14
-            python-version: "3.7"
-          # ubuntu 24+ does not have Python 3.7
-          - os: ubuntu-latest
-            python-version: "3.7"
-
+        os: [macos-14, macos-latest, ubuntu-22.04, ubuntu-latest, windows-latest]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
     env:
       # Version is extracted below and used to find correct package install path.
       scenedetect_version: ""
-      # Setuptools must be pinned for the Python 3.7 builders.
-      setuptools_version: "${{ matrix.python-version == '3.7' && '==62.3.4' || '' }}"
 
     steps:
       - uses: actions/checkout@v4
@@ -61,7 +51,7 @@ jobs:
 
       - name: Install Dependencies
         run: |
-          python -m pip install --upgrade pip build wheel virtualenv setuptools${{ env.setuptools_version }}
+          python -m pip install --upgrade pip build wheel virtualenv setuptools
           pip install -r requirements_headless.txt --only-binary av,opencv-python-headless
 
       - name: Install MoviePy

scenedetect/backends/moviepy.py

@@ -116,7 +116,7 @@ def duration(self) -> ty.Optional[FrameTimecode]:
     @property
     def aspect_ratio(self) -> float:
         """Display/pixel aspect ratio as a float (1.0 represents square pixels)."""
-        # TODO: Use cached_property once Python 3.7 support is deprecated.
+        # TODO: Use cached_property.
         if self._aspect_ratio is None:
             # MoviePy doesn't support extracting the aspect ratio yet, so for now we just fall
             # back to using OpenCV to determine it.

scenedetect/common.py

@@ -352,6 +352,11 @@ def get_seconds(self) -> float:
         )
         return self.seconds
 
+    # TODO(https://scenedetect.com/issue/168): We should remove `nearest_frame` if possible, it
+    # assumes constant framerate and causes more problems than it solves. Setting it to False makes
+    # test_cli_load_scenes_with_time_frames in test_cli.py fail due to differences in end time.
+    # We may also just need to clamp end time to the one specified by the user, this may not be
+    # happening in the code.
     def get_timecode(
         self, precision: int = 3, use_rounding: bool = True, nearest_frame: bool = True
     ) -> str:

setup.cfg

@@ -23,7 +23,6 @@ classifiers =
     Intended Audience :: System Administrators
     Operating System :: OS Independent
     Programming Language :: Python :: 3
-    Programming Language :: Python :: 3.7
     Programming Language :: Python :: 3.8
     Programming Language :: Python :: 3.9
     Programming Language :: Python :: 3.10
@@ -50,7 +49,7 @@ packages =
     scenedetect.backends
     scenedetect.detectors
     scenedetect.output
-python_requires = >=3.7
+python_requires = >=3.8
 
 [options.extras_require]
 opencv = opencv-python

tests/test_cli.py

@@ -630,7 +630,7 @@ def test_cli_backend_unsupported():
     )
 
 
-def test_cli_load_scenes():
+def test_cli_load_scenes_options():
     """Ensure we can load scenes both with and without the cut row."""
     assert invoke_scenedetect("-i {VIDEO} time {TIME} {DETECTOR} list-scenes") == 0
     assert invoke_scenedetect("-i {VIDEO} time {TIME} load-scenes -i {VIDEO_NAME}-Scenes.csv") == 0
@@ -648,7 +648,7 @@ def test_cli_load_scenes():
     assert invoke_scenedetect("-i {VIDEO} time {TIME} load-scenes -i {VIDEO_NAME}-Scenes.csv") == 0
 
 
-def test_cli_load_scenes_with_time_frames():
+def test_cli_load_scenes_output():
     """Verify we can use `load-scenes` with the `time` command and get the desired output."""
     scenes_csv = """
 Scene Number,Start Frame

website/pages/changelog.md

@@ -671,20 +671,15 @@ Development
 
 PySceneDetect is a major breaking release which overhauls how timestamps are handled throughout the API. This allows PySceneDetect to properly process variable framerate (VFR) videos. A significant amount of technical debt has been addressed, including removal of deprecated or overly complicated APIs.
 
-Although there have been minimal changes to most API examples, there are several breaking changes. Applications written for the 0.6 API *may* require modification to work with the new API.
-
-### CLI Changes
+Although there have been minimal changes to most API examples, there are several breaking changes. Applications written for the 0.6 API *may* require modification to work with the new API.  Minimum supported Python version is now **Python 3.8**.
 
 ### CLI Changes
 
 - [feature] [WIP] New `save-xml` command supports saving scenes in Final Cut Pro format [#156](https://github.com/Breakthrough/PySceneDetect/issues/156)
 - [refactor] Remove deprecated `-d`/`--min-delta-hsv` option from `detect-adaptive` command
 
-
 ### API Changes
 
-#### Breaking
-
  * Replace `frame_num` parameter (`int`) with `timecode` (`FrameTimecode`) in `SceneDetector` interface (#168)[https://github.com/Breakthrough/PySceneDetect/issues/168]:
       * The detector interface: `SceneDetector.process_frame()` and `SceneDetector.post_process()`
       * Statistics: `StatsManager.get_metrics()`, `StatsManager.set_metrics()`, and `StatsManager.metrics_exist()`
@@ -707,9 +702,6 @@ Although there have been minimal changes to most API examples, there are several
  * Remove `advance` parameter from `VideoStream.read()`
  * Remove `SceneDetector.stats_manager_required` property, no longer required
  * `SceneDetector` is now a [Python abstract class](https://docs.python.org/3/library/abc.html)
-
- #### General
-
  * Deprecated functionality preserved from v0.6 now uses the `warnings` module
  * Add properties to access `frame_num`, `framerate`, and `seconds` from `FrameTimecode` instead of getter methods
  * Add new `Timecode` type to represent frame timings in terms of the video's source timebase

website/pages/download.md

@@ -3,7 +3,7 @@
 
 PySceneDetect is completely free software, and can be downloaded from the links below.  See the [license and copyright information](copyright.md) page for details.  If you have trouble running PySceneDetect, ensure that you have all the required dependencies listed in the [Dependencies](#dependencies) section below.
 
-PySceneDetect requires at least Python 3.7 or higher.
+PySceneDetect requires at least Python 3.8 or higher.
 
 
 ## Install via pip &nbsp; <span class="wy-text-neutral"><span class="fa fa-windows"></span> &nbsp; <span class="fa fa-linux"></span> &nbsp; <span class="fa fa-apple"></span></span></h3>