sphinx-lua-ls 3.8.0__tar.gz → 3.8.1__tar.gz

{sphinx_lua_ls-3.8.0 → sphinx_lua_ls-3.8.1}/.github/workflows/ci.yaml

@@ -26,17 +26,17 @@ jobs:
       - name: Install dependencies
         run: python -m pip install '.'
       - name: Download LuaLs for Linux
-        run: python sphinx_lua_ls/lua_ls.py linux x86_64 --runtime luals --skip 3.16.0 ~/lua_ls_release/ubuntu-latest
+        run: python -m sphinx_lua_ls.lua_ls linux x86_64 --runtime luals ~/lua_ls_release/ubuntu-latest
       - name: Download LuaLs for Windows
-        run: python sphinx_lua_ls/lua_ls.py win32 amd64 --runtime luals --skip 3.16.0 ~/lua_ls_release/windows-latest
+        run: python -m sphinx_lua_ls.lua_ls win32 amd64 --runtime luals ~/lua_ls_release/windows-latest
       - name: Download LuaLs for MacOs
-        run: python sphinx_lua_ls/lua_ls.py darwin arm --runtime luals --skip 3.16.0 ~/lua_ls_release/macos-latest
+        run: python -m sphinx_lua_ls.lua_ls darwin arm --runtime luals ~/lua_ls_release/macos-latest
       - name: Download EmmyLua for Linux
-        run: python sphinx_lua_ls/lua_ls.py linux x86_64 --runtime emmylua ~/lua_ls_release/ubuntu-latest
+        run: python -m sphinx_lua_ls.lua_ls linux x86_64 --runtime emmylua ~/lua_ls_release/ubuntu-latest
       - name: Download EmmyLua for Windows
-        run: python sphinx_lua_ls/lua_ls.py win32 amd64 --runtime emmylua ~/lua_ls_release/windows-latest
+        run: python -m sphinx_lua_ls.lua_ls win32 amd64 --runtime emmylua ~/lua_ls_release/windows-latest
       - name: Download EmmyLua for MacOs
-        run: python sphinx_lua_ls/lua_ls.py darwin arm --runtime emmylua ~/lua_ls_release/macos-latest
+        run: python -m sphinx_lua_ls.lua_ls darwin arm --runtime emmylua ~/lua_ls_release/macos-latest
       - name: Upload artifact
         uses: actions/upload-artifact@v4
         with:

{sphinx_lua_ls-3.8.0 → sphinx_lua_ls-3.8.1}/CHANGELOG.md

@@ -2,9 +2,13 @@
 
 ## [Unreleased]
 
+## [3.8.1] - 2025-12-08
+
+- Added LuaLs 3.16.0 to the list of known broken releases ([LuaLS#3301]).
+
 ## [3.8.0] - 2025-12-03
 
-- Added support Sphinx 9.
+- Added support for Sphinx 9.
 
 - Added `lua_ls_skip_versions` config option to selectively avoid certain language server
   releases.
@@ -265,6 +269,8 @@ Initial release.
 [3.7.0]: https://github.com/sphinx-contrib/lua-ls/compare/v3.6.0...v3.7.0
 [3.7.0-post1]: https://github.com/sphinx-contrib/lua-ls/compare/v3.7.0...v3.7.0-post1
 [3.8.0]: https://github.com/sphinx-contrib/lua-ls/compare/v3.7.0-post1...v3.8.0
+[3.8.1]: https://github.com/sphinx-contrib/lua-ls/compare/v3.8.0...v3.8.1
 [@bkoropoff]: https://github.com/bkoropoff
 [emmylua]: https://github.com/EmmyLuaLs/emmylua-analyzer-rust/
-[unreleased]: https://github.com/sphinx-contrib/lua-ls/compare/v3.8.0...HEAD
+[luals#3301]: https://github.com/LuaLS/lua-language-server/issues/3301
+[unreleased]: https://github.com/sphinx-contrib/lua-ls/compare/v3.8.1...HEAD

{sphinx_lua_ls-3.8.0/sphinx_lua_ls.egg-info → sphinx_lua_ls-3.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sphinx-lua-ls
-Version: 3.8.0
+Version: 3.8.1
 Summary: Automatic documentation generation via EmmyLua/LuaLs
 Author-email: Tamika Nomara <taminomara@gmail.com>
 License-Expression: MIT

{sphinx_lua_ls-3.8.0 → sphinx_lua_ls-3.8.1}/docs/source/settings.rst

@@ -63,6 +63,10 @@ Settings
    This setting can be used to avoid broken releases without limiting max version
    of the lua analyzer.
 
+   Default is to avoid known broken releases:
+
+   - LuaLs ``3.16.0`` — broken on Linux, fixed in ``3.16.1``.
+
 .. py:data:: lua_ls_default_options
    :type: dict[str, str]
 

{sphinx_lua_ls-3.8.0 → sphinx_lua_ls-3.8.1}/sphinx_lua_ls/__init__.py

@@ -58,27 +58,13 @@ def run_lua_ls(app: sphinx.application.Sphinx):
     if not modified:
         return
 
-    min_version = domain.config.min_version
-    if min_version is None:
-        if domain.config.backend == "luals":
-            min_version = "3.0.0"
-        else:
-            min_version = "0.11.0"
-    max_version = domain.config.max_version
-    if max_version == "__auto__":
-        if domain.config.backend == "luals":
-            max_version = "4.0.0"
-        else:
-            max_version = "2.0.0"
-    skip_versions = domain.config.skip_versions
-
     cwd = pathlib.Path.cwd()
     try:
         runner = sphinx_lua_ls.lua_ls.resolve(
             backend=domain.config.backend,
-            min_version=min_version,
-            max_version=max_version,
-            skip_versions=skip_versions or [],
+            min_version=domain.config.min_version,
+            max_version=domain.config.max_version,
+            skip_versions=domain.config.skip_versions,
             cwd=root_dir,
             reporter=sphinx_lua_ls.lua_ls.SphinxProgressReporter(app.verbosity),
             install=domain.config.auto_install,

{sphinx_lua_ls-3.8.0 → sphinx_lua_ls-3.8.1}/sphinx_lua_ls/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '3.8.0'
-__version_tuple__ = version_tuple = (3, 8, 0)
+__version__ = version = '3.8.1'
+__version_tuple__ = version_tuple = (3, 8, 1)
 
-__commit_id__ = commit_id = 'g871de2611'
+__commit_id__ = commit_id = 'g03b365db2'

{sphinx_lua_ls-3.8.0 → sphinx_lua_ls-3.8.1}/sphinx_lua_ls/lua_ls.py

@@ -26,6 +26,10 @@ from sphinx.errors import SphinxError
 from sphinx.util import logging
 from sphinx.util.console import bold, red  # type: ignore
 
+KNOWN_BROKEN_LUA_LS_RELEASES = ["3.16.0"]
+KNOWN_BROKEN_EMMYLUA_RELEASES = []
+
+
 _PathLike: _t.TypeAlias = str | os.PathLike[str]
 
 
@@ -307,9 +311,9 @@ class SphinxProgressReporter(DefaultProgressReporter):
 def resolve(
     *,
     backend: _t.Literal["emmylua", "luals"],
-    min_version: str,
+    min_version: str | None,
     max_version: str | None,
-    skip_versions: list[str],
+    skip_versions: list[str] | None,
     cache_path: _PathLike | None = None,
     quiet: bool = True,
     env: dict[str, str] | None = None,
@@ -371,6 +375,23 @@ def resolve(
     if retry is None:
         retry = urllib3.Retry(10, backoff_factor=0.1)
 
+    print(min_version, max_version, skip_versions)
+    if min_version is None:
+        if backend == "luals":
+            min_version = "3.0.0"
+        else:
+            min_version = "0.11.0"
+    if max_version == "__auto__":
+        if backend == "luals":
+            max_version = "4.0.0"
+        else:
+            max_version = "2.0.0"
+    if skip_versions is None:
+        if backend == "luals":
+            skip_versions = KNOWN_BROKEN_LUA_LS_RELEASES
+        else:
+            skip_versions = KNOWN_BROKEN_EMMYLUA_RELEASES
+
     reporter.start()
     try:
         bin_path, path = _check_and_install(
@@ -960,7 +981,7 @@ if __name__ == "__main__":
         parser.add_argument("machine")
         parser.add_argument("--min", default="0.0.0")
         parser.add_argument("--max", default=None)
-        parser.add_argument("--skip", action="append", default=[])
+        parser.add_argument("--skip", action="append", default=None)
         parser.add_argument("path", type=pathlib.Path)
 
         _logger.setLevel("DEBUG")
@@ -970,6 +991,12 @@ if __name__ == "__main__":
 
         args = parser.parse_args()
 
+        if args.skip is None:
+            if args.runtime == "luals":
+                args.skip = KNOWN_BROKEN_LUA_LS_RELEASES
+            else:
+                args.skip = KNOWN_BROKEN_EMMYLUA_RELEASES
+
         match args.runtime:
             case "luals":
                 _install_lua_ls(

{sphinx_lua_ls-3.8.0 → sphinx_lua_ls-3.8.1/sphinx_lua_ls.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sphinx-lua-ls
-Version: 3.8.0
+Version: 3.8.1
 Summary: Automatic documentation generation via EmmyLua/LuaLs
 Author-email: Tamika Nomara <taminomara@gmail.com>
 License-Expression: MIT