subliminal 2.7.0__tar.gz → 2.8.0__tar.gz

{subliminal-2.7.0 → subliminal-2.8.0}/.github/actions/prepare-tests/action.yaml

@@ -10,13 +10,13 @@ runs:
       run: |
         echo "::error title=⛔ error hint::Support Linux, Windows, and macOS Only"
         exit 1
-    - uses: actions/checkout@v7
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       with:
         persist-credentials: false
         fetch-depth: 0
     - name: Cache test data
       id: cache-test-data
-      uses: actions/cache@v5
+      uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
       with:
         path: tests/data/
         enableCrossOsArchive: true
@@ -30,11 +30,11 @@ runs:
         exit 1
     - name: Install other test software (on Linux only)
       if: steps.cache-test-data.outputs.cache-hit != 'true'
-      uses: awalsh128/cache-apt-pkgs-action@v1
+      uses: awalsh128/cache-apt-pkgs-action@553a35bb8ebd9fcabcb1c9451aa4c98e1b4ca8a9 # v1.6.3
       with:
         packages: rar
         version: 1.0
-    - uses: actions/setup-python@v6
+    - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
       if: steps.cache-test-data.outputs.cache-hit != 'true'
       with:
         python-version-file: .python-version-default

{subliminal-2.7.0 → subliminal-2.8.0}/.github/workflows/CI.yaml

@@ -20,7 +20,7 @@ jobs:
   check-manifest:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
       - run: pipx run check-manifest --ignore "_version.py"
@@ -28,23 +28,23 @@ jobs:
   pre-commit:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version-file: .python-version-default
-      - uses: pre-commit/action@v3.0.1
+      - uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1
 
   typing:
     runs-on: ubuntu-latest
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version-file: .python-version-default
       - name: Install hatch
@@ -58,10 +58,10 @@ jobs:
     name: Build docs and run doctests
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           # Keep in sync with tox/docs, hatch.toml and .readthedocs.yaml.
           python-version-file: .python-version-default
@@ -76,7 +76,7 @@ jobs:
       - name: Check changelog
         run: hatch run changelog:run
 
-      - uses: actions/upload-artifact@v7
+      - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: docs
           path: docs/_build/
@@ -86,10 +86,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version-file: .python-version-default
           cache: pip
@@ -104,12 +104,12 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
           fetch-depth: 0
 
-      - uses: hynek/build-and-inspect-python-package@v2
+      - uses: hynek/build-and-inspect-python-package@2abe76da66d0a6a4a227101f9348ee855797cfa5 # v3.0.1
         id: baipp
 
     outputs:
@@ -122,7 +122,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
           fetch-depth: 0
@@ -142,10 +142,10 @@ jobs:
         # Created by the build-and-inspect-python-package action above.
         py: ${{ fromJson(needs.build-package.outputs.supported-python-versions) }}
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version: ${{ matrix.py }}
           allow-prereleases: true
@@ -181,32 +181,74 @@ jobs:
         shell: bash
 
       - name: Store coverage file
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: coverage-${{ matrix.os }}-${{ matrix.py }}
           path: .coverage*
           include-hidden-files: true
           if-no-files-found: error
 
+  test-freebsd:
+    name: Test on FreeBSD
+    runs-on: ubuntu-latest
+    needs: prepare-test
+    timeout-minutes: 10
+    if: github.event_name == 'push'
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - name: Prepare tests
+        uses: ./.github/actions/prepare-tests
+      - name: Display downloaded files
+        run: ls -R tests/data
+      - name: Test in FreeBSD
+        uses: vmactions/freebsd-vm@c46abacb49f09938ca4e1702d15d836285d694cc # v1.5.9
+        with:
+          release: "15.0"
+          usesh: true
+          prepare: |
+            pkg install -y python3 databases/py-sqlite3 devel/py-hatch git-lite
+          run: |
+            set -e
+            PY_VERSION=$(python3 -c 'import platform; print(".".join(platform.python_version_tuple()[:2]))')
+            echo "Picked Python ${PY_VERSION}"
+            export ENV="tests.py${PY_VERSION}"
+            export FORCE_COLOR="1"
+            export CI_RUN="yes"
+            export COVERAGE_FILE=".coverage.freebsd.${PY_VERSION}"
+            hatch -v env create "${ENV}"
+            hatch -v run "${ENV}:test-cov"
+
+      - name: Store coverage file
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: coverage-freebsd
+          path: .coverage*
+          include-hidden-files: true
+          if-no-files-found: error
+
   coverage:
     name: Coverage
     runs-on: ubuntu-latest
-    needs: test
+    needs: [test, test-freebsd]
+    if: ${{ !cancelled() && needs.test.result == 'success' && (needs.test-freebsd.result == 'success' || needs.test-freebsd.result == 'skipped') }}
     permissions:
       pull-requests: write
       contents: write
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           # py-cov-action/python-coverage-comment-action needs git credentials
           persist-credentials: true
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version-file: .python-version-default
-      - uses: hynek/setup-cached-uv@v2
+      - uses: hynek/setup-cached-uv@34e35d30f1ebc7421a5cc733bca38dcc62603960 # v2.6.0
 
       - name: Download coverage data
-        uses: actions/download-artifact@v8
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           pattern: coverage-*
           merge-multiple: true
@@ -222,19 +264,19 @@ jobs:
           coverage report --skip-covered --skip-empty --show-missing --format=markdown >> $GITHUB_STEP_SUMMARY
 
       - name: Upload HTML report if check failed.
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: html-report
           path: htmlcov
 
       - name: Coverage comment
         id: coverage_comment
-        uses: py-cov-action/python-coverage-comment-action@v3
+        uses: py-cov-action/python-coverage-comment-action@e5fb2218463c3377f3504b0c5b5646ed53da7a2f # v4.5
         with:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Store Pull Request comment to be posted
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         if: steps.coverage_comment.outputs.COMMENT_FILE_WRITTEN == 'true'
         with:
           # If you use a different name, update COMMENT_ARTIFACT_NAME accordingly
@@ -247,10 +289,10 @@ jobs:
     runs-on: ubuntu-latest
     needs: [build-package, prepare-test]
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         id: setup
         with:
           python-version-file: .python-version-default
@@ -287,7 +329,7 @@ jobs:
         shell: bash
 
       - name: Store coverage file
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         if: ${{ failure() }}
         with:
           name: core-coverage
@@ -313,6 +355,6 @@ jobs:
 
     steps:
       - name: Decide whether the needed jobs succeeded or failed
-        uses: re-actors/alls-green@release/v1
+        uses: re-actors/alls-green@b5b5b37504aa4183270bd3d855c52a67f212be35 # v1.3.0
         with:
           jobs: ${{ toJSON(needs) }}

{subliminal-2.7.0 → subliminal-2.8.0}/.github/workflows/coverage.yaml

@@ -30,7 +30,7 @@ jobs:
       # DO NOT run actions/checkout here, for security reasons
       # For details, refer to https://securitylab.github.com/research/github-actions-preventing-pwn-requests/
       - name: Post comment
-        uses: py-cov-action/python-coverage-comment-action@v3
+        uses: py-cov-action/python-coverage-comment-action@e5fb2218463c3377f3504b0c5b5646ed53da7a2f # v4.5
         with:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           GITHUB_PR_RUN_ID: ${{ github.event.workflow_run.id }}

{subliminal-2.7.0 → subliminal-2.8.0}/.github/workflows/docker-build.yaml

@@ -35,12 +35,12 @@ jobs:
     steps:
       - name: Checkout repository
         if: github.event_name == 'push' || github.event_name == 'pull_request'
-        uses: actions/checkout@v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
       - name: Checkout repository
         if: github.event_name == 'workflow_call' || github.event_name == 'workflow_dispatch'
-        uses: actions/checkout@v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           ref: ${{ inputs.tag-name }}
           persist-credentials: false
@@ -50,15 +50,15 @@ jobs:
           github.event_name == 'push'
           || github.event_name == 'workflow_call'
           || github.event_name == 'workflow_dispatch'
-        uses: docker/setup-qemu-action@v4
+        uses: docker/setup-qemu-action@99012661954931238ded8c8b007157a8430204e1 # v4.4.0
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v4
+        uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
         with:
           cache-binary: false
 
       - name: Log in to the Container registry
-        uses: docker/login-action@v4
+        uses: docker/login-action@dbcb813823bdd20940b903addbd779551569679f # v4.6.0
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
@@ -66,7 +66,7 @@ jobs:
 
       - name: Extract metadata (tags, labels) for Docker
         id: meta
-        uses: docker/metadata-action@v6
+        uses: docker/metadata-action@dc802804100637a589fabce1cb79ff13a1411302 # v6.2.0
         with:
           images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
           tags: |
@@ -76,7 +76,7 @@ jobs:
             type=semver,pattern={{major}},enable=${{ !startsWith(github.ref, 'refs/tags/0.') }}
 
       - name: Test building Docker image
-        uses: docker/build-push-action@v7
+        uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
         if: github.event_name == 'pull_request'
         with:
           context: .
@@ -86,7 +86,7 @@ jobs:
           cache-to: type=gha,mode=max
 
       - name: Build and push Docker image
-        uses: docker/build-push-action@v7
+        uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
         if: |
           github.event_name == 'push'
           || github.event_name == 'workflow_call'

{subliminal-2.7.0 → subliminal-2.8.0}/.github/workflows/prepare-release-pr.yaml

@@ -29,14 +29,14 @@ jobs:
       pull-requests: write
 
     steps:
-    - uses: actions/checkout@v7
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       with:
         fetch-depth: 0
         # persist-credentials is needed in order for us to push the release branch.
         persist-credentials: true
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
       with:
         python-version-file: .python-version-default
         cache: pip

{subliminal-2.7.0 → subliminal-2.8.0}/.github/workflows/publish-release.yaml

@@ -31,12 +31,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         if: github.event_name == 'push'
         with:
           persist-credentials: false
       - name: Checkout
-        uses: actions/checkout@v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         if: |
           github.event_name == 'workflow_dispatch'
           || github.event_name == 'workflow_call'
@@ -44,7 +44,7 @@ jobs:
           ref: ${{ inputs.tag-name }}
           persist-credentials: false
       - name: Build dist
-        uses: hynek/build-and-inspect-python-package@v2
+        uses: hynek/build-and-inspect-python-package@2abe76da66d0a6a4a227101f9348ee855797cfa5 # v3.0.1
         id: baipp
     outputs:
       tag: ${{ steps.baipp.outputs.package_version }}
@@ -63,19 +63,19 @@ jobs:
     # Publish a Github release when a tag was pushed, or it's called with a tag.
     steps:
       - name: Checkout
-        uses: actions/checkout@v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-tags: true
           ref: ${{ needs.build-package.outputs.tag }}
           persist-credentials: false
 
       - name: Download packages built by build-and-inspect-python-package
-        uses: actions/download-artifact@v8
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: Packages
           path: dist
       - name: Publish GitHub Release
-        uses: softprops/action-gh-release@v3
+        uses: softprops/action-gh-release@efb35369e0ad2afab669f228072c1b0d510eae64 # v3.0.3
         with:
           files: dist/*
           generate_release_notes: true

{subliminal-2.7.0 → subliminal-2.8.0}/.github/workflows/publish.yaml

@@ -20,12 +20,12 @@ jobs:
     name: Build & verify package
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
 
-      - uses: hynek/build-and-inspect-python-package@v2
+      - uses: hynek/build-and-inspect-python-package@2abe76da66d0a6a4a227101f9348ee855797cfa5 # v3.0.1
         id: baipp
 
   publish-to-pypi:
@@ -45,9 +45,9 @@ jobs:
       && github.event.action == 'published'
     steps:
       - name: Download packages built by build-and-inspect-python-package
-        uses: actions/download-artifact@v8
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: Packages
           path: dist
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

{subliminal-2.7.0 → subliminal-2.8.0}/.github/workflows/scheduled-tests.yaml

@@ -24,10 +24,10 @@ jobs:
       || github.event_name == 'workflow_dispatch'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version: "3.x"
       - name: Prepare tests

{subliminal-2.7.0 → subliminal-2.8.0}/.github/workflows/tag-release.yaml

@@ -24,12 +24,12 @@ jobs:
     name: Build & verify package
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
 
-      - uses: hynek/build-and-inspect-python-package@v2
+      - uses: hynek/build-and-inspect-python-package@2abe76da66d0a6a4a227101f9348ee855797cfa5 # v3.0.1
 
   define-tag:
     name: Define tag
@@ -72,7 +72,7 @@ jobs:
     env:
       RELEASE_VERSION: ${{ needs.define-tag.outputs.tag }}
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           # keep credentials to create a tag

{subliminal-2.7.0 → subliminal-2.8.0}/HISTORY.rst

@@ -2,6 +2,49 @@
 
 .. towncrier release notes start
 
+2.8.0 (2026-10-13)
+^^^^^^^^^^^^^^^^^^
+
+Changes
+-------
+
+- Added `ProviderPool.failed_providers` - a set of providers that had an error.
+  Changed the user-facing error messages of the `download` command to explicitly distinguish
+  discarded providers, which are not used for the rest of the download, from those that errored
+  out but were still kept in the pool. (`#1374 <https://github.com/Diaoul/subliminal/issues/1374>`__)
+- add ProviderResult class to keep track of queries to providers (`#1381 <https://github.com/Diaoul/subliminal/issues/1381>`__)
+
+
+Provider Changes
+----------------
+
+- Stop the opensubtitlescom pagination when a page fails and keep the subtitles already found (`#1373 <https://github.com/Diaoul/subliminal/issues/1373>`__)
+- fix: OpenSubtitlesCom was not using hash if OpenSubtitles was not used also (`#1382 <https://github.com/Diaoul/subliminal/issues/1382>`__)
+- Search episodes with OpenSubtitlesCom by the show's IMDb/TMDB id. (`#1384 <https://github.com/Diaoul/subliminal/issues/1384>`__)
+
+
+Refiner Changes
+---------------
+
+- omdb: use the IMDB id to backfill missing title and year metadata (`#1375 <https://github.com/Diaoul/subliminal/issues/1375>`__)
+
+
+CLI Changes
+-----------
+
+- improve message for ignored videos (`#1387 <https://github.com/Diaoul/subliminal/issues/1387>`__)
+
+
+2.7.1 (2026-07-22)
+^^^^^^^^^^^^^^^^^^
+
+Misc
+----
+
+- fix test for compatibility with guessit>=4 (`#1368 <https://github.com/Diaoul/subliminal/issues/1368>`__)
+- add CI tests for FreeBSD (`#1370 <https://github.com/Diaoul/subliminal/issues/1370>`__)
+
+
 2.7.0 (2026-07-21)
 ^^^^^^^^^^^^^^^^^^
 

{subliminal-2.7.0 → subliminal-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: subliminal
-Version: 2.7.0
+Version: 2.8.0
 Summary: Subtitles, faster than your thoughts
 Project-URL: homepage, https://github.com/Diaoul/subliminal
 Project-URL: repository, https://github.com/Diaoul/subliminal
@@ -39,6 +39,7 @@ Requires-Dist: requests>=2.0
 Requires-Dist: srt>=3.5
 Requires-Dist: stevedore>=3.0
 Requires-Dist: tomlkit>=0.13.2
+Requires-Dist: typing-extensions>=4.10
 Provides-Extra: dev
 Requires-Dist: pre-commit>=2.9.3; extra == 'dev'
 Requires-Dist: tox; extra == 'dev'
@@ -55,6 +56,7 @@ Requires-Dist: rarfile>=2.7; extra == 'rar'
 Provides-Extra: tests
 Requires-Dist: colorama; extra == 'tests'
 Requires-Dist: coverage[toml]>=7; extra == 'tests'
+Requires-Dist: packaging; extra == 'tests'
 Requires-Dist: pytest-cov; extra == 'tests'
 Requires-Dist: pytest-xdist; extra == 'tests'
 Requires-Dist: pytest>=6.0; extra == 'tests'

{subliminal-2.7.0 → subliminal-2.8.0}/docs/conf.py

@@ -311,15 +311,18 @@ intersphinx_mapping = {
 }
 
 
-# -- Options for autodoc -----------------------------------------------------
+# -- Options for autodoc -------------------------------------------------------
 autodoc_member_order = 'bysource'
 
 autodoc_default_flags = ['members']
 
 
-# -- Options for sphinx-autodoc-typehints ------------------------------------
+# -- Options for sphinx-autodoc-typehints --------------------------------------
 # https://github.com/tox-dev/sphinx-autodoc-typehints
 
 always_use_bars_union = True
 
 set_type_checking_flag = False
+
+# -- Options for the linkcheck builder -----------------------------------------
+linkcheck_ignore = [r'https://stackoverflow.com/.*']

{subliminal-2.7.0 → subliminal-2.8.0}/pyproject.toml

@@ -49,6 +49,7 @@ dependencies = [
     "srt>=3.5",
     "stevedore>=3.0",
     "tomlkit>=0.13.2",
+    "typing_extensions>=4.10",  # TypedDict extra_items
 ]
 
 # extras
@@ -67,6 +68,7 @@ docs = [
 tests = [
     "subliminal[rar]",
     "coverage[toml]>=7",
+    "packaging",
     "pytest>=6.0",
     "pytest-cov",
     "pytest-xdist",

{subliminal-2.7.0 → subliminal-2.8.0}/src/subliminal/cli/commands/_format.py

@@ -5,12 +5,15 @@ from __future__ import annotations
 import logging
 import re
 from datetime import timedelta
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
 import click
 from babelfish import Error as BabelfishError  # type: ignore[import-untyped]
 from babelfish import Language
 
+if TYPE_CHECKING:
+    from collections.abc import Set
+
 logger = logging.getLogger(__name__)
 
 
@@ -54,6 +57,22 @@ class AgeParamType(click.ParamType):
         return timedelta(**{k: int(v) for k, v in match.groupdict(0).items()})
 
 
+def format_provider_errors(failed_providers: Set[str], discarded_providers: Set[str], *, video_count: int) -> str:
+    """Tell the user which providers had an error, and how the error affected the end results.
+
+    With one video both kinds of error have the same result, so one sentence covers them.
+    """
+    if video_count == 1:
+        return f'These providers had an error and found no subtitles: {", ".join(sorted(failed_providers))}.'
+
+    groups = (
+        ('These providers had an error and were skipped for the rest of the download', sorted(discarded_providers)),
+        ('These providers had an error on some videos', sorted(failed_providers - discarded_providers)),
+    )
+    sentences = [f'{label}: {", ".join(names)}.' for label, names in groups if names]
+    return ' '.join([*sentences, 'Some subtitles can be missing.'])
+
+
 def plural(quantity: int, name: str, *, bold: bool = True, **kwargs: Any) -> str:
     """Format a quantity with plural."""
     return '{} {}{}'.format(

{subliminal-2.7.0 → subliminal-2.8.0}/src/subliminal/cli/commands/download_best.py

@@ -35,7 +35,7 @@ from subliminal.exceptions import GuessingError
 from subliminal.extensions import get_default_providers, get_default_refiners
 from subliminal.utils import NameResolver, merge_extend_and_ignore_unions
 
-from ._format import AgeParamType, LanguageParamType, plural
+from ._format import AgeParamType, LanguageParamType, format_provider_errors, plural
 
 if TYPE_CHECKING:
     from collections.abc import Sequence
@@ -530,10 +530,14 @@ def download(
         for video in ignored_videos:
             video_name = os.path.split(video.name)[1]
             msg = f'{video_name!r} ignored'
+            # Add information about existing subtitle languages
+            langs = ', '.join(str(s) for s in video.subtitle_languages) or 'none'
+            days = f'{video.age.days:d} day{"s" if video.age.days > 1 else ""}'
+            msg += f' - existing subtitles: {langs}'
+            # Add information about the video age
             if video.exists:
-                langs = ', '.join(str(s) for s in video.subtitle_languages) or 'none'
                 days = f'{video.age.days:d} day{"s" if video.age.days > 1 else ""}'
-                msg += f' - subtitles: {langs} / age: {days}'
+                msg += f' - age: {days}'
             else:
                 msg += ' - not a video file'
             click.secho(msg, fg='yellow')
@@ -591,9 +595,9 @@ def download(
                 )
                 downloaded_subtitles[v] = subtitles
 
-        if pp.discarded_providers:  # pragma: no cover
+        if pp.failed_providers:
             click.secho(
-                f'Some providers have been discarded due to unexpected errors: {", ".join(pp.discarded_providers)}',
+                format_provider_errors(pp.failed_providers, pp.discarded_providers, video_count=len(videos)),
                 fg='yellow',
             )