sphinx-lua-ls 3.2.0__tar.gz → 3.4.0__tar.gz

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/.github/dependabot.yml

@@ -7,15 +7,20 @@ updates:
     groups:
       dev:
         patterns:
-          - "black"
+          - "beautifulsoup4"
           - "furo"
-          - "isort"
-          - "pre-commit"
+          - "myst-parser"
           - "pyright"
           - "pytest_image_diff"
           - "pytest-cov"
+          - "pytest-regressions"
           - "pytest"
           - "reportlab"
           - "sphinx_design"
           - "svglib"
           - "sybil"
+      style:
+        patterns:
+          - "black"
+          - "isort"
+          - "pre-commit"

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/.github/workflows/ci.yaml

@@ -23,6 +23,8 @@ jobs:
     steps:
       - name: Checkout source
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - name: Set up python ${{ matrix.python-version }}
         uses: actions/setup-python@v4
         with:
@@ -79,6 +81,8 @@ jobs:
     steps:
       - name: Checkout source
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - name: Set up python ${{ matrix.python-version }}
         uses: actions/setup-python@v4
         with:
@@ -88,7 +92,7 @@ jobs:
       # Tests
       - name: Install test dependencies
         if: ${{ matrix.type == 'test' }}
-        run: python -m pip install '.[test]'
+        run: python -m pip install . --group test
       - name: Download LuaLs
         if: ${{ matrix.type == 'test' }}
         uses: actions/download-artifact@v4
@@ -106,7 +110,7 @@ jobs:
       # Lint
       - name: Install lint dependencies
         if: ${{ matrix.type == 'code style' }}
-        run: python -m pip install '.[lint]'
+        run: python -m pip install . --group lint
       - name: Check code style
         if: ${{ matrix.type == 'code style' }}
         run: pre-commit run -a
@@ -124,10 +128,26 @@ jobs:
       name: pypi
       url: https://pypi.org/p/sphinx-lua-ls
     permissions:
+      contents: write
       id-token: write
     steps:
       - name: Checkout source
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Generate release metadata
+        id: metadata
+        run: |
+          ref="${{ github.ref }}";
+          version=${ref#refs/tags/v};
+          link="https://pypi.org/p/${{ github.repository }}/${version}";
+          echo "version=${version}" >> $GITHUB_OUTPUT
+          echo "link=${link}" >> $GITHUB_OUTPUT
+      - name: Parse Changelog
+        id: changelog
+        uses: mindsers/changelog-reader-action@v2
+        with:
+          version: ${{ steps.metadata.outputs.version }}
       - name: Set up python 3.12
         uses: actions/setup-python@v4
         with:
@@ -147,6 +167,17 @@ jobs:
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           attestations: false
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          prerelease: ${{ steps.changelog.outputs.status == 'prereleased' }}
+          draft: ${{ steps.changelog.outputs.status == 'unreleased' }}
+          body: |
+            ## Changelog
+
+            ${{ steps.changelog.outputs.changes }}
+
+            [See release on PyPi](${{ steps.metadata.outputs.link }})
 
   # Builds sphinx documentation.
   #
@@ -160,6 +191,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - name: Set up python 3.12
         uses: actions/setup-python@v4
         with:
@@ -167,7 +200,7 @@ jobs:
       - name: Install package
         run: |
           python -m pip install --upgrade pip
-          python -m pip install '.[doc]'
+          python -m pip install . --group doc
       - name: Download LuaLs
         uses: actions/download-artifact@v4
         with:
@@ -175,7 +208,7 @@ jobs:
           path: ~/lua_ls_release
       - name: Build docs
         env:
-          SPHINXOPTS: "-j auto"
+          SPHINXOPTS: "-j auto -n"
           LUA_LS_CACHE_PATH: ~/lua_ls_release/ubuntu-latest
         run: |
           cd docs
@@ -203,6 +236,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - name: Download artifact
         uses: actions/download-artifact@v4
         with:

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/.pre-commit-config.yaml

@@ -5,28 +5,22 @@ repos:
         name: black
         language: system
         entry: black
-        types: [python]
-        files: ^(?!docs)
+        types_or: [python, pyi]
         require_serial: true
       - id: isort
         name: isort
         language: system
-        entry: isort
-        types: [python]
-        files: ^(?!docs)
+        entry: isort --filter-files
+        types_or: [python, pyi]
         require_serial: true
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
-        require_serial: true
       - id: end-of-file-fixer
-        require_serial: true
       - id: fix-byte-order-marker
-        require_serial: true
       - id: mixed-line-ending
         args: [--fix=lf]
-        require_serial: true
       - id: check-added-large-files
       - id: check-yaml
       - id: check-toml

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/CHANGELOG.md

@@ -1,6 +1,46 @@
 # Changelog
 
-## v3.2.0
+## [unreleased]
+
+## [3.4.0]
+
+- **Potential breaking change:** use `confdir` instead of `srcdir` as base path
+  for `lua_ls_project_root`.
+
+  Prior to this change, `lua_ls_project_root` was resolved relative to the directory
+  containing source `.rst` files. Documentation, however, was saying that it's resolved
+  relative to the directory with `conf.py`.
+
+  This is not an issue, because in most projects `conf.py` and source `.rst` files
+  are located in the same directory. Still, I've decided to be consistent with
+  other Sphinx extensions and use `confdir` instead of `srcdir`.
+
+  This is a breaking change, but I don't believe there are any projects that
+  use separate `confdir` and `srcdir` (the only reason to do this is if you're
+  hosting multiple documentation sites in the same repo.) For this reason,
+  this change is released as a minor version change.
+
+## [3.3.0]
+
+- Added an option to extend list options (like `:exclude-members:`) without overriding
+  defaults:
+
+  ```rst
+  .. lua:autoobject::
+     :exclude-members: +foo
+  ```
+
+  Also added `:no-*:` options to ignore defaults.
+
+- Improved display of members which use types instead of names,
+  i.e. `[<type>]` ([#19] by [@bkoropoff]).
+
+- Added a warning for situations when `lua_ls_project_directories` contains directories
+  outside of the current VCS root.
+
+[#19]: https://github.com/taminomara/sphinx-lua-ls/pull/19
+
+## [3.2.0]
 
 - Updated a few dependencies. Most notably, restricted `sphinx` to `<9`.
 
@@ -13,7 +53,7 @@
 [#18]: https://github.com/taminomara/sphinx-lua-ls/pull/18
 [@bkoropoff]: https://github.com/bkoropoff
 
-## v3.1.0
+## [3.1.0]
 
 - Added pygments lexer for Lua that highlights documentation tags.
 
@@ -26,7 +66,7 @@
 
 - Fixed some edge cases in parsing of type expressions.
 
-## v3.0.0
+## [3.0.0]
 
 - **Breaking change:** changed how `apidoc` generates file names to avoid collisions.
 
@@ -94,18 +134,18 @@
 [EmmyLua]: https://github.com/EmmyLuaLs/emmylua-analyzer-rust/
 [#3]: https://github.com/taminomara/sphinx-lua-ls/issues/3
 
-**Migrating to 3.0.0:**
+### Migrating to 3.0.0
 
 - If you're using `apidoc`, you'll need to update links to your documentation.
 
 - You'll need to explicitly specify which language server to use
   by including `lua_ls_backend` to your `conf.py`.
 
-## v2.0.1
+## [2.0.1]
 
 - Fixed documentation not being rebuilt after changing lua source code.
 
-## v2.0.0
+## [2.0.0]
 
 - **Breaking change:** don't implicitly convert classes that're derived from `table`
   to modules. Users should use a `!doctype` comment instead.
@@ -118,7 +158,7 @@
 
 - Improved test coverage and fixed found bugs.
 
-**Migrating to 2.0.0:**
+### Migrating to 2.0.0
 
 In your Lua code base, perform global replace by regexp:
 
@@ -137,7 +177,7 @@ Make sure that you only use `!doctype module` on the top-level
 tables that can be imported via `require`. On other objects,
 use `!doctype table` instead, otherwise you'll get errors that modules are not allowed within other objects.
 
-## v1.1.0
+## [1.1.0]
 
 - Added support for `!doc` and `!doctype` comments.
 
@@ -156,6 +196,17 @@ use `!doctype table` instead, otherwise you'll get errors that modules are not a
 
 - Fixed types when `lua:autoobject` would infer incorrect types for `data`.
 
-## v1.0.0
+## [1.0.0]
 
 Initial release.
+
+[unreleased]: https://github.com/taminomara/sphinx-lua-ls/compare/v3.4.0...HEAD
+[3.4.0]: https://github.com/taminomara/sphinx-lua-ls/compare/v3.3.0...v3.4.0
+[3.3.0]: https://github.com/taminomara/sphinx-lua-ls/compare/v3.2.0...v3.3.0
+[3.2.0]: https://github.com/taminomara/sphinx-lua-ls/compare/v3.1.0...v3.2.0
+[3.1.0]: https://github.com/taminomara/sphinx-lua-ls/compare/v3.0.0...v3.1.0
+[3.0.0]: https://github.com/taminomara/sphinx-lua-ls/compare/v2.0.1...v3.0.0
+[2.0.1]: https://github.com/taminomara/sphinx-lua-ls/compare/v2.0.0...v2.0.1
+[2.0.0]: https://github.com/taminomara/sphinx-lua-ls/compare/v1.1.0...v2.0.0
+[1.1.0]: https://github.com/taminomara/sphinx-lua-ls/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/taminomara/sphinx-lua-ls/releases/tag/v1.0.0

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/CONTRIBUTING.md

@@ -13,7 +13,7 @@
 3. Install Sphinx-LuaLs in development mode, and install dev dependencies:
 
    ```shell
-   pip install -e .[dev]
+   pip install -e . --group dev
    ```
 
 4. Install pre-commit hooks:

{sphinx_lua_ls-3.2.0/sphinx_lua_ls.egg-info → sphinx_lua_ls-3.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sphinx-lua-ls
-Version: 3.2.0
+Version: 3.4.0
 Summary: Automatic documentation generation via EmmyLua/LuaLs
 Author-email: Tamika Nomara <taminomara@gmail.com>
 License-Expression: MIT
@@ -27,25 +27,6 @@ License-File: LICENSE
 Requires-Dist: sphinx<9.0,>=8.0
 Requires-Dist: PyGithub<3.0,>=1.59
 Requires-Dist: requests~=2.31
-Provides-Extra: dev
-Requires-Dist: pytest-cov==6.2.1; extra == "dev"
-Requires-Dist: sphinx-lua-ls[doc,lint,test]; extra == "dev"
-Provides-Extra: lint
-Requires-Dist: black==25.1.0; extra == "lint"
-Requires-Dist: isort==6.0.1; extra == "lint"
-Requires-Dist: pre-commit==4.3.0; extra == "lint"
-Provides-Extra: test
-Requires-Dist: pyright==1.1.404; extra == "test"
-Requires-Dist: pytest==8.4.1; extra == "test"
-Requires-Dist: sybil==9.2.0; extra == "test"
-Requires-Dist: pytest-regressions==2.8.2; extra == "test"
-Requires-Dist: beautifulsoup4==4.13.5; extra == "test"
-Requires-Dist: myst-parser==4.0.1; extra == "test"
-Provides-Extra: doc
-Requires-Dist: sybil==9.2.0; extra == "doc"
-Requires-Dist: furo==2025.7.19; extra == "doc"
-Requires-Dist: sphinx_design==0.6.1; extra == "doc"
-Requires-Dist: myst-parser==4.0.1; extra == "doc"
 Dynamic: license-file
 
 # Sphinx plugin for Lua and Lua Language Server
@@ -58,9 +39,9 @@ Document Lua projects using Lua Language Server's output. This plugin features:
 ## Resources
 
 - [Documentation](https://taminomara.github.io/sphinx-lua-ls/)
-- [Installation](https://taminomara.github.io/sphinx-lua-ls/#installation)
-- [Quickstart](https://taminomara.github.io/sphinx-lua-ls/#quickstart)
-- [Example output](https://taminomara.github.io/sphinx-lua-ls/#example-output)
+- [Installation](https://taminomara.github.io/sphinx-lua-ls/installation.html)
+- [Quickstart](https://taminomara.github.io/sphinx-lua-ls/quickstart.html)
+- [Example output](https://taminomara.github.io/sphinx-lua-ls/example.html)
 
 ## Requirements
 

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/README.md

@@ -8,9 +8,9 @@ Document Lua projects using Lua Language Server's output. This plugin features:
 ## Resources
 
 - [Documentation](https://taminomara.github.io/sphinx-lua-ls/)
-- [Installation](https://taminomara.github.io/sphinx-lua-ls/#installation)
-- [Quickstart](https://taminomara.github.io/sphinx-lua-ls/#quickstart)
-- [Example output](https://taminomara.github.io/sphinx-lua-ls/#example-output)
+- [Installation](https://taminomara.github.io/sphinx-lua-ls/installation.html)
+- [Quickstart](https://taminomara.github.io/sphinx-lua-ls/quickstart.html)
+- [Example output](https://taminomara.github.io/sphinx-lua-ls/example.html)
 
 ## Requirements
 

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/docs/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line, and also
 # from the environment for the first two.
-SPHINXOPTS    ?=
+SPHINXOPTS    ?= -j auto -n
 SPHINXBUILD   ?= sphinx-build
 SOURCEDIR     = source
 BUILDDIR      = build

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/docs/source/autodoc.rst

@@ -16,10 +16,10 @@ can be slightly different:
       comments.
 
       When generating documentation for a module, Sphinx-LuaLs will include
-      all module's objects returned by `require`, as well as all types located
+      all module's objects returned by ``require``, as well as all types located
       in the same namespace.
 
-      That is, for module `meow`, it will list everything in the ``require("meow")``,
+      That is, for module ``meow``, it will list everything in the ``require("meow")``,
       as well as all classes, aliases, and enums that have prefix ``meow.*``.
 
       Thus, a typical Lua module will look like this:
@@ -185,7 +185,7 @@ Autodoc directive
    .. rst:directive:option:: undoc-members
 
       Include undocumented members to the object's description. By default,
-      they are skipped even if :rst:dir:`members` is passed.
+      they are skipped even if :rst:dir:`members <lua:autoobject:members>` is passed.
 
       Accepts a comma-separated list of names; if list is empty,
       adds all undoc members.
@@ -293,19 +293,14 @@ Autodoc directive
       for all objects nested within the root. That is, object's members,
       their members, and so on.
 
-      If
-      :rst:dir:`lua:autoobject:members`,
-      :rst:dir:`lua:autoobject:globals`,
-      :rst:dir:`lua:autoobject:undoc-members`,
-      :rst:dir:`lua:autoobject:private-members`,
-      :rst:dir:`lua:autoobject:special-members`,
-      or :rst:dir:`lua:autoobject:inherited-members`
-      are given as flags, they are propagated to all documented objects.
+      Options like ``no-index`` or :rst:dir:`lua:autoobject:member-order` are always
+      passed down to all members.
 
-      If they're given as list, they are not propagated.
-
-      Options from :py:data:`lua_ls_default_options` are applied to all recursively
-      documented objects.
+      List options like :rst:dir:`lua:autoobject:members`
+      or :rst:dir:`lua:autoobject:globals`
+      are passed down if they're empty or start with ``+``
+      (see :py:data:`lua_ls_default_options` for info on ``+``
+      and overriding defaults).
 
    .. rst:directive:option:: member-order
 

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/docs/source/conf.py

@@ -12,6 +12,7 @@ release = version = sphinx_lua_ls.__version__
 
 extensions = [
     "sphinx.ext.githubpages",
+    "sphinx.ext.intersphinx",
     "sphinx_design",
     "sphinx_lua_ls",
     "myst_parser",
@@ -23,9 +24,14 @@ exclude_patterns = []
 primary_domain = "lua"
 default_role = "lua:obj"
 
-lua_ls_project_root = "../example"
+lua_ls_project_root = "example"
 lua_ls_backend = "emmylua"
 
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3", None),
+    "sphinx": ("https://www.sphinx-doc.org/", None),
+}
+
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/docs/source/example.rst

@@ -31,15 +31,18 @@ This output is generated with the following directive:
          :module-member-order: groupwise
          ```
 
-See ``logging.lua`` `on github`_.
+.. tab-set::
+
+   .. tab-item:: Result
 
-.. _on github: https://github.com/taminomara/sphinx-lua-ls/blob/main/docs/example/logging.lua
+      .. lua:autoobject:: logging
+         :members:
+         :globals:
+         :recursive:
+         :index-table:
+         :module-member-order: groupwise
 
-----
+   .. tab-item:: logging.lua
 
-.. lua:autoobject:: logging
-   :members:
-   :globals:
-   :recursive:
-   :index-table:
-   :module-member-order: groupwise
+      .. literalinclude:: /example/logging.lua
+         :language: lua

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/docs/source/index.rst

@@ -22,9 +22,8 @@ See an example output: `logging`.
    settings
    example
 
+.. toctree::
+    :hidden:
+    :caption: Links
 
-Indices and tables
-------------------
-
-* :ref:`genindex`
-* :ref:`search`
+    GitHub <https://github.com/taminomara/sphinx-lua-ls/>

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/docs/source/settings.rst

@@ -56,6 +56,25 @@ Settings
           # And so on...
       }
 
+   If using defaults for the ``:members:``, ``:exclude-members:``, and other
+   list options, setting the option on a directive will override the default.
+   Instead, to extend the default list with the per-directive option,
+   the list may be prepended with a plus sign (``+``), as follows:
+
+   .. code-block:: rst
+
+      .. lua:autoobject:: Noodle
+         :members: eat
+         :private-members: +_spicy, _garlickly
+
+   Also, the defaults can be disabled per-directive with the negated form,
+   ``:no-option:`` as an option of the directive:
+
+   .. code-block:: rst
+
+      .. lua:autoobject:: foo
+         :no-undoc-members:
+
 .. py:data:: class_default_function_name
    :type: str
 
@@ -70,14 +89,14 @@ Settings
 .. py:data:: class_default_force_non_colon
    :type:
 
-   If `true`, Sphinx-LuaLs will remove ``self`` from class constructor's signature.
+   If ``True``, Sphinx-LuaLs will remove ``self`` from class constructor's signature.
 
    If using EmmyLua as lua analyzer, this option will be inferred from ``.emmyrc.json``.
 
 .. py:data:: class_default_force_return_self
    :type:
 
-   If `true`, Sphinx-LuaLs will replace class constructor's return type with ``self``.
+   If ``True``, Sphinx-LuaLs will replace class constructor's return type with ``self``.
 
    If using EmmyLua as lua analyzer, this option will be inferred from ``.emmyrc.json``.
 
@@ -90,7 +109,7 @@ Settings
    Can be either ``"5.1"``, ``"5.2"``, ``"5.3"``, ``"5.4"``, or ``"jit"``.
 
    By default, Sphinx-LuaLs will choose this setting
-   based on your `.emmyrc.json`/`.luarc.json` file.
+   based on your ``.emmyrc.json``/``.luarc.json`` file.
 
 .. py:data:: lua_ls_apidoc_roots
    :type: dict[str, str | dict[str, Any]]
@@ -146,7 +165,7 @@ Settings
       This option might not work correctly on case-insensitive file systems.
 
       It will generate a separate file for every member of a module;
-      if there are members that only differ in case (i.e. `Class` vs `class`),
+      if there are members that only differ in case (i.e. ``Class`` vs ``class``),
       one of them will overwrite the file for another.
 
       If you're on Windows, and you experience difficulties because of it,
@@ -196,7 +215,7 @@ Settings
 
    Default value is ``50``, which is suitable for most Sphinx themes.
 
-   Setting this value to `None` will cause signature formatter
+   Setting this value to ``None`` will cause signature formatter
    to use Sphinx's global setting ``maximum_signature_line_length``.
    If ``maximum_signature_line_length`` is also ``None``,
    signature wrapping will be disabled.

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/pyproject.toml

@@ -27,27 +27,29 @@ dependencies = [
     "requests~=2.31",
 ]
 
-[project.optional-dependencies]
+[dependency-groups]
 dev = [
-    "pytest-cov==6.2.1",
-    "sphinx-lua-ls[test,lint,doc]",
+    "pytest-cov==7.0.0",
+    {include-group = "test"},
+    {include-group = "lint"},
+    {include-group = "doc"},
 ]
 lint = [
-    "black==25.1.0",
+    "black==25.9.0",
     "isort==6.0.1",
     "pre-commit==4.3.0",
 ]
 test = [
-    "pyright==1.1.404",
-    "pytest==8.4.1",
+    "pyright==1.1.405",
+    "pytest==8.4.2",
     "sybil==9.2.0",
-    "pytest-regressions==2.8.2",
-    "beautifulsoup4==4.13.5",
+    "pytest-regressions==2.8.3",
+    "beautifulsoup4==4.14.0",
     "myst-parser==4.0.1"
 ]
 doc = [
     "sybil==9.2.0",
-    "furo==2025.7.19",
+    "furo==2025.9.25",
     "sphinx_design==0.6.1",
     "myst-parser==4.0.1"
 ]
@@ -90,10 +92,6 @@ reportUnnecessaryIsInstance = "none"
 reportConstantRedefinition = "none"
 reportRedeclaration = "none"
 
-[tool.black]
-extend-exclude = '^/docs'
-
 [tool.isort]
 profile = "black"
-extend_skip_glob = ["docs/*"]
 skip_gitignore = true

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/sphinx_lua_ls/__init__.py

@@ -9,6 +9,7 @@ import sphinx.builders
 import sphinx.builders.html
 import sphinx.domains
 import sphinx.errors
+from sphinx.util import logging
 from sphinx.util.display import progress_message
 from sphinx.util.fileutil import copy_asset_file
 
@@ -21,9 +22,12 @@ import sphinx_lua_ls.inherited
 import sphinx_lua_ls.intersphinx
 import sphinx_lua_ls.lua_ls
 import sphinx_lua_ls.objtree
+import sphinx_lua_ls.utils
 from sphinx_lua_ls._version import __version__, __version_tuple__
 from sphinx_lua_ls.pygments import LuaLexer
 
+logger = logging.getLogger("sphinx_lua_ls")
+
 
 def run_lua_ls(app: sphinx.application.Sphinx):
     domain: sphinx_lua_ls.domain.LuaDomain = app.env.get_domain("lua")  # type: ignore
@@ -88,11 +92,23 @@ def run_lua_ls(app: sphinx.application.Sphinx):
         configs.append(path)
     parser.files.update(configs)
 
+    vcs_root = sphinx_lua_ls.utils.find_topmost_vcs_root(root_dir)
+
     for dir in project_directories:
+        if vcs_root and not dir.is_relative_to(vcs_root):
+            logger.warning(
+                "project directory %s appears to be outside of your VCS root %s",
+                dir,
+                vcs_root,
+                type="lua-ls",
+            )
+
         try:
             relpath = dir.relative_to(cwd, walk_up=True)
         except ValueError:
             relpath = dir
+        if str(relpath).endswith(".."):
+            relpath = dir
         with progress_message(f"running lua language server in {relpath or '.'}"):
             parser.class_default_function_name = (
                 domain.config.class_default_function_name

{sphinx_lua_ls-3.2.0 → sphinx_lua_ls-3.4.0}/sphinx_lua_ls/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '3.2.0'
-__version_tuple__ = version_tuple = (3, 2, 0)
+__version__ = version = '3.4.0'
+__version_tuple__ = version_tuple = (3, 4, 0)
 
-__commit_id__ = commit_id = 'g226dbf0db'
+__commit_id__ = commit_id = 'g02703ee01'