[upd] pypi: Bump sphinx from 7.4.7 to 8.2.3 (#5252)

- supersede: https://github.com/searxng/searxng/pull/4377

Sphinx 8.2 dropped Python 3.10 support, last versions supporting Python 3.10:

- Sphinx==8.1.3
- sphinx-autobuild==2024.10.3

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>

.github/workflows/checker.yml

@@ -34,7 +34,7 @@ jobs:
           persist-credentials: "false"
 
       - name: Setup cache Python
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"

.github/workflows/container.yml

@@ -50,7 +50,7 @@ jobs:
       - if: github.repository_owner == 'searxng'
         name: Check cache apko
         id: cache-apko
-        uses: actions/cache/restore@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache/restore@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           # yamllint disable-line rule:line-length
           key: "apko-${{ steps.date.outputs.date }}-${{ hashFiles('./container/base.yml', './container/base-builder.yml') }}"
@@ -59,7 +59,7 @@ jobs:
 
       - if: github.repository_owner == 'searxng' && steps.cache-apko.outputs.cache-hit != 'true'
         name: Setup cache apko
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           # yamllint disable-line rule:line-length
           key: "apko-${{ steps.date.outputs.date }}-${{ hashFiles('./container/base.yml', './container/base-builder.yml') }}"
@@ -137,14 +137,14 @@ jobs:
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
           path: "./local/"
 
       - name: Setup cache container uv
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "container-uv-${{ matrix.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "container-uv-${{ matrix.arch }}-"

.github/workflows/data-update.yml

@@ -50,7 +50,7 @@ jobs:
           persist-credentials: "false"
 
       - name: Setup cache Python
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"

.github/workflows/documentation.yml

@@ -43,7 +43,7 @@ jobs:
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"

.github/workflows/integration.yml

@@ -46,7 +46,7 @@ jobs:
           persist-credentials: "false"
 
       - name: Setup cache Python
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "python-${{ matrix.python-version }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "python-${{ matrix.python-version }}-${{ runner.arch }}-"
@@ -79,13 +79,13 @@ jobs:
           node-version-file: "./.nvmrc"
 
       - name: Setup cache Node.js
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "nodejs-${{ runner.arch }}-${{ hashFiles('./.nvmrc', './package.json') }}"
           path: "./client/simple/node_modules/"
 
       - name: Setup cache Python
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"

.github/workflows/l10n.yml

@@ -46,7 +46,7 @@ jobs:
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
@@ -93,7 +93,7 @@ jobs:
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809  # v4.2.4
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"

requirements-dev.txt

@@ -1,19 +1,21 @@
 mock==5.2.0
 nose2[coverage_plugin]==0.15.1
 cov-core==1.15.0
-black==24.3.0
+black==25.9.0
 pylint==3.3.8
 splinter==0.21.0
 selenium==4.35.0
 Pallets-Sphinx-Themes==2.3.0
-Sphinx==7.4.7
+Sphinx==8.2.3 ; python_version >= '3.11'
+Sphinx==8.1.3 ; python_version < '3.11'
 sphinx-issues==5.0.1
 sphinx-jinja==2.0.2
 sphinx-tabs==3.4.7
 sphinxcontrib-programoutput==0.18
-sphinx-autobuild==2024.10.3
+sphinx-autobuild==2025.8.25 ; python_version >= '3.11'
+sphinx-autobuild==2024.10.3 ; python_version < '3.11'
 sphinx-notfound-page==1.1.0
-myst-parser==3.0.1
+myst-parser==4.0.1
 linuxdoc==20240924
 aiounittest==1.5.0
 yamllint==1.37.1

searx/autocomplete.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""This module implements functions needed for the autocompleter.
-
-"""
+"""This module implements functions needed for the autocompleter."""
 # pylint: disable=use-dict-literal
 
 import json

searx/data/__init__.py

@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """This module holds the *data* created by::
 
-  make data.all
+make data.all
 
 """
 # pylint: disable=invalid-name

searx/engines/1337x.py

@@ -1,8 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 # pylint: disable=invalid-name
-"""1337x
-
-"""
+"""1337x"""
 
 from urllib.parse import quote, urljoin
 from lxml import html

searx/engines/ahmia.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Ahmia (Onions)
+Ahmia (Onions)
 """
 
 from urllib.parse import urlencode, urlparse, parse_qs

searx/engines/apkmirror.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""APKMirror
-"""
+"""APKMirror"""
 
 # pylint: disable=invalid-name
 

searx/engines/apple_app_store.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Apple App Store
-
-"""
+"""Apple App Store"""
 
 from json import loads
 from urllib.parse import urlencode

searx/engines/base.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""BASE (Scholar publications)
-
-"""
+"""BASE (Scholar publications)"""
 from datetime import datetime
 import re
 

searx/engines/bing_images.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Bing-Images: description see :py:obj:`searx.engines.bing`.
-"""
+"""Bing-Images: description see :py:obj:`searx.engines.bing`."""
 # pylint: disable=invalid-name
 import json
 from urllib.parse import urlencode

searx/engines/bing_videos.py

@@ -1,7 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 # pylint: disable=invalid-name
-"""Bing-Videos: description see :py:obj:`searx.engines.bing`.
-"""
+"""Bing-Videos: description see :py:obj:`searx.engines.bing`."""
 
 import json
 from urllib.parse import urlencode

searx/engines/btdigg.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- BTDigg (Videos, Music, Files)
+BTDigg (Videos, Music, Files)
 """
 
 from urllib.parse import quote, urljoin

searx/engines/chefkoch.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Chefkoch is a German database of recipes.
-"""
+"""Chefkoch is a German database of recipes."""
 
 from datetime import datetime
 from urllib.parse import urlencode

searx/engines/cppreference.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Cppreference
-"""
+"""Cppreference"""
 from lxml import html
 from searx.utils import eval_xpath
 

searx/engines/deezer.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Deezer (Music)
+Deezer (Music)
 """
 
 from json import loads

searx/engines/destatis.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""DeStatis
-"""
+"""DeStatis"""
 
 from urllib.parse import urlencode
 from lxml import html

searx/engines/deviantart.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Deviantart (Images)
-
-"""
+"""Deviantart (Images)"""
 
 import urllib.parse
 from lxml import html

searx/engines/dictzone.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Dictzone
+Dictzone
 """
 
 import urllib.parse

searx/engines/digbt.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- DigBT (Videos, Music, Files)
+DigBT (Videos, Music, Files)
 """
 
 from urllib.parse import urljoin

searx/engines/docker_hub.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Docker Hub (IT)
-
-"""
+"""Docker Hub (IT)"""
 # pylint: disable=use-dict-literal
 
 from urllib.parse import urlencode

searx/engines/doku.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Doku Wiki
+Doku Wiki
 """
 
 from urllib.parse import urlencode

searx/engines/duden.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Duden
-
-"""
+"""Duden"""
 
 import re
 from urllib.parse import quote, urljoin

searx/engines/dummy-offline.py

@@ -1,8 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 # pylint: disable=invalid-name
-"""Dummy Offline
-
-"""
+"""Dummy Offline"""
 
 
 # about

searx/engines/dummy.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Dummy
-
-"""
+"""Dummy"""
 
 # about
 about = {

searx/engines/ebay.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Ebay (Videos, Music, Files)
+Ebay (Videos, Music, Files)
 """
 
 from urllib.parse import quote

searx/engines/fdroid.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- F-Droid (a repository of FOSS applications for Android)
+F-Droid (a repository of FOSS applications for Android)
 """
 
 from urllib.parse import urlencode

searx/engines/flickr.py

@@ -1,8 +1,8 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Flickr (Images)
+Flickr (Images)
 
- More info on api-key : https://www.flickr.com/services/apps/create/
+More info on api-key : https://www.flickr.com/services/apps/create/
 """
 
 from json import loads

searx/engines/flickr_noapi.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Flickr (Images)
-
-"""
+"""Flickr (Images)"""
 
 import json
 from time import time

searx/engines/frinkiac.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Frinkiac (Images)
+Frinkiac (Images)
 """
 
 from json import loads

searx/engines/fyyd.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Fyyd (podcasts)
-"""
+"""Fyyd (podcasts)"""
 
 from datetime import datetime
 from urllib.parse import urlencode

searx/engines/genius.py

@@ -1,8 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 # pylint: disable=invalid-name
-"""Genius
-
-"""
+"""Genius"""
 
 from urllib.parse import urlencode
 from datetime import datetime

searx/engines/github.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Github (IT)
-
-"""
+"""Github (IT)"""
 
 from urllib.parse import urlencode
 from dateutil import parser

searx/engines/goodreads.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Goodreads (books)
-"""
+"""Goodreads (books)"""
 
 from urllib.parse import urlencode
 

searx/engines/google_play.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Google Play Apps & Google Play Movies
-"""
+"""Google Play Apps & Google Play Movies"""
 
 from urllib.parse import urlencode
 from lxml import html

searx/engines/hackernews.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Hackernews
-"""
+"""Hackernews"""
 
 from datetime import datetime
 from urllib.parse import urlencode

searx/engines/imgur.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Imgur (images)
-"""
+"""Imgur (images)"""
 
 from urllib.parse import urlencode
 from lxml import html

searx/engines/ina.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- INA (Videos)
+INA (Videos)
 """
 
 from html import unescape

searx/engines/mediathekviewweb.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""MediathekViewWeb (API)
-
-"""
+"""MediathekViewWeb (API)"""
 
 import datetime
 from json import loads, dumps

searx/engines/metacpan.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""metacpan
-"""
+"""metacpan"""
 
 from urllib.parse import urlunparse
 

searx/engines/mixcloud.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Mixcloud (Music)
-
-"""
+"""Mixcloud (Music)"""
 
 from urllib.parse import urlencode
 from dateutil import parser

searx/engines/npm.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""npms.io
-
-"""
+"""npms.io"""
 
 from urllib.parse import urlencode
 from dateutil import parser

searx/engines/nyaa.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Nyaa.si (Anime Bittorrent tracker)
-
-"""
+"""Nyaa.si (Anime Bittorrent tracker)"""
 
 from urllib.parse import urlencode
 

searx/engines/opensemantic.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Open Semantic Search
-
-"""
+"""Open Semantic Search"""
 
 from json import loads
 from urllib.parse import quote

searx/engines/openstreetmap.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""OpenStreetMap (Map)
-
-"""
+"""OpenStreetMap (Map)"""
 
 import re
 import urllib.parse

searx/engines/openverse.py

@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
 
- Openverse (formerly known as: Creative Commons search engine) [Images]
+Openverse (formerly known as: Creative Commons search engine) [Images]
 
 """
 

searx/engines/pdbe.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- PDBe (Protein Data Bank in Europe)
+PDBe (Protein Data Bank in Europe)
 """
 
 from json import loads

searx/engines/photon.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Photon (Map)
+Photon (Map)
 """
 
 from json import loads

searx/engines/piratebay.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Piratebay (Videos, Music, Files)
+Piratebay (Videos, Music, Files)
 """
 
 from json import loads

searx/engines/podcastindex.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Podcast Index
-"""
+"""Podcast Index"""
 
 from urllib.parse import quote_plus
 from datetime import datetime

searx/engines/pypi.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""pypi.org
-
-"""
+"""pypi.org"""
 
 from urllib.parse import urlencode
 from dateutil import parser

searx/engines/reddit.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Reddit
-
-"""
+"""Reddit"""
 
 import json
 from datetime import datetime

searx/engines/rottentomatoes.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""RottenTomatoes (movies)
-"""
+"""RottenTomatoes (movies)"""
 
 from urllib.parse import quote_plus
 from lxml import html

searx/engines/rumble.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Rumble (Videos)
-
-"""
+"""Rumble (Videos)"""
 
 from datetime import datetime
 

searx/engines/scanr_structures.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- ScanR Structures (Science)
+ScanR Structures (Science)
 """
 
 from json import loads, dumps

searx/engines/searx_engine.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Searx (all)
+Searx (all)
 """
 
 from json import loads

searx/engines/senscritique.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""SensCritique (movies)
-"""
+"""SensCritique (movies)"""
 
 import typing as t
 

searx/engines/seznam.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Seznam
-
-"""
+"""Seznam"""
 
 from urllib.parse import urlencode
 from lxml import html

searx/engines/solidtorrents.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""SolidTorrents
-
-"""
+"""SolidTorrents"""
 
 from datetime import datetime
 from urllib.parse import urlencode

searx/engines/spotify.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Spotify (Music)
-
-"""
+"""Spotify (Music)"""
 
 from json import loads
 from urllib.parse import urlencode

searx/engines/svgrepo.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Svgrepo (icons)
-"""
+"""Svgrepo (icons)"""
 
 from lxml import html
 from searx.utils import extract_text, eval_xpath, eval_xpath_list

searx/engines/tokyotoshokan.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Tokyo Toshokan (A BitTorrent Library for Japanese Media)
-
-"""
+"""Tokyo Toshokan (A BitTorrent Library for Japanese Media)"""
 
 import re
 from datetime import datetime

searx/engines/tootfinder.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Tootfinder (social media)
-"""
+"""Tootfinder (social media)"""
 
 from datetime import datetime
 from json import loads

searx/engines/translated.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""MyMemory Translated
-
-"""
+"""MyMemory Translated"""
 
 import urllib.parse
 

searx/engines/unsplash.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Unsplash
-
-"""
+"""Unsplash"""
 
 from urllib.parse import urlencode, urlparse, urlunparse, parse_qsl
 from json import loads

searx/engines/vimeo.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Wikipedia (Web
+Wikipedia (Web
 """
 
 from urllib.parse import urlencode

searx/engines/wikicommons.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Wikimedia Commons (images)
-
-"""
+"""Wikimedia Commons (images)"""
 
 import datetime
 

searx/engines/wolframalpha_api.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Wolfram|Alpha (Science)
-
-"""
+"""Wolfram|Alpha (Science)"""
 
 from urllib.parse import urlencode
 

searx/engines/wolframalpha_noapi.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Wolfram|Alpha (Science)
+Wolfram|Alpha (Science)
 """
 
 

searx/engines/www1x.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""1x (Images)
-
-"""
+"""1x (Images)"""
 
 from urllib.parse import urlencode, urljoin
 from lxml import html, etree

searx/engines/yep.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Yep (general, images, news)
-"""
+"""Yep (general, images, news)"""
 
 from datetime import datetime
 from urllib.parse import urlencode

searx/engines/youtube_api.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """
- Youtube (Videos)
+Youtube (Videos)
 """
 
 from json import loads

searx/engines/youtube_noapi.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Youtube (Videos)
-
-"""
+"""Youtube (Videos)"""
 
 from functools import reduce
 from json import loads, dumps

searx/exceptions.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Exception types raised by SearXNG modules.
-"""
+"""Exception types raised by SearXNG modules."""
 
 import typing as t
 from lxml.etree import XPath

searx/network/raise_for_httperror.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Raise exception for an HTTP response is an error.
-
-"""
+"""Raise exception for an HTTP response is an error."""
 
 import typing as t
 from searx.exceptions import (

searx/preferences.py

@@ -1,6 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Searx preferences implementation.
-"""
+"""Searx preferences implementation."""
 
 # pylint: disable=useless-object-inheritance
 

searx/searxng.msg

@@ -1,7 +1,6 @@
 # -*- mode: python -*-
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""A SearXNG message file, see :py:obj:`searx.babel`
-"""
+"""A SearXNG message file, see :py:obj:`searx.babel`"""
 
 import typing
 

searx/settings_defaults.py

@@ -1,7 +1,5 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
-"""Implementation of the default settings.
-
-"""
+"""Implementation of the default settings."""
 from __future__ import annotations
 
 import typing as t

searxng_extra/update/update_engine_traits.py

@@ -50,7 +50,7 @@ A list of five-digit tuples:
    Empty string for language tags.
 3. English language name (from :py:obj:`babel.core.Locale.english_name`)
 4. Unicode flag (emoji) that fits to SearXNG's internal region tag. Languages
-   are represented by a globe (\U0001F310)
+   are represented by a globe (\U0001f310)
 
 .. code:: python
 
@@ -68,11 +68,11 @@ A list of five-digit tuples:
 
 
 lang2emoji = {
-    'ha': '\U0001F1F3\U0001F1EA',  # Hausa / Niger
-    'bs': '\U0001F1E7\U0001F1E6',  # Bosnian / Bosnia & Herzegovina
-    'jp': '\U0001F1EF\U0001F1F5',  # Japanese
-    'ua': '\U0001F1FA\U0001F1E6',  # Ukrainian
-    'he': '\U0001F1EE\U0001F1F1',  # Hebrew
+    'ha': '\U0001f1f3\U0001f1ea',  # Hausa / Niger
+    'bs': '\U0001f1e7\U0001f1e6',  # Bosnian / Bosnia & Herzegovina
+    'jp': '\U0001f1ef\U0001f1f5',  # Japanese
+    'ua': '\U0001f1fa\U0001f1e6',  # Ukrainian
+    'he': '\U0001f1ee\U0001f1f1',  # Hebrew
 }
 
 
@@ -178,7 +178,7 @@ def get_unicode_flag(locale: babel.Locale):
         return emoji
 
     if not locale.territory:
-        return '\U0001F310'
+        return '\U0001f310'
 
     emoji = lang2emoji.get(locale.territory.lower())
     if emoji: