Update pre-commits hooks and prune unnecessary ones

I can always re-add them later but for now the removed ones don't really
apply.

Author: lagru

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ exclude: |
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: "2c9f875913ee60ca25ce70243dc24d5b6415598c"  # frozen: v4.6.0
+    rev: "cef0300fd0fc4d2a87a85fa2093c6b283ea36f4b"  # frozen: v5.0.0
     hooks:
       - id: check-added-large-files
       - id: check-ast
@@ -27,25 +27,13 @@ repos:
       - id: requirements-txt-fixer
       - id: trailing-whitespace
 
-  - repo: https://github.com/pre-commit/pygrep-hooks
-    rev: "3a6eb0fadf60b3cccfd80bad9dbb6fae7e47b316"  # frozen: v1.10.0
-    hooks:
-      - id: rst-backticks
-      - id: rst-directive-colons
-      - id: rst-inline-touching-normal
-
   - repo: https://github.com/psf/black
-    rev: "3702ba224ecffbcec30af640c149f231d90aebdb"  # frozen: 24.4.2
+    rev: "1b2427a2b785cc4aac97c19bb4b9a0de063f9547"  # frozen: 24.10.0
     hooks:
       - id: black
 
-  - repo: https://github.com/adamchainz/blacken-docs
-    rev: "960ead214cd1184149d366c6d27ca6c369ce46b6" # frozen: 1.16.0
-    hooks:
-      - id: blacken-docs
-
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "596470fba20d04adc68ec7903ff69a12e5e1a8d3"  # frozen: v0.4.2
+    rev: "75b98813cfb7e663870a28c74366a1e99d7bfe79"  # frozen: v0.6.9
     hooks:
       - id: ruff
         args: ["--fix", "--show-fixes", "--exit-non-zero-on-fix"]

src/docstub/_analysis.py

@@ -18,24 +18,33 @@
 logger = logging.getLogger(__name__)
 
 
-def _shared_leading_path(*paths):
-    """Identify the common leading parts between import paths.
+def _shared_leading_qualname(*qualnames):
+    """Identify the common leading parts between fully qualified names.
 
     Parameters
     ----------
-    *paths : tuple[str]
+    *qualnames : tuple[str]
 
     Returns
     -------
     shared : str
+        The names, still split by ".", that are common to the start of all given
+        `qualnames`. Empty string if nothing is common.
+
+    Examples
+    --------
+    >>> _shared_leading_qualname("foo.bar", "foo.baz")
+    'foo'
+    >>> _shared_leading_qualname("foo.bar", "faa.baz")
+    ''
     """
-    if len(paths) < 2:
+    if len(qualnames) < 2:
         raise ValueError("need more than two paths")
-    splits = (p.split(".") for p in paths)
+    splits = (p.split(".") for p in qualnames)
     shared = []
-    for paths in zip(*splits, strict=False):
-        if all(paths[0] == p for p in paths):
-            shared.append(paths[0])
+    for names in zip(*splits, strict=False):
+        if all(names[0] == p for p in names):
+            shared.append(names[0])
         else:
             break
     return ".".join(shared)
@@ -147,7 +156,7 @@ def format_import(self, relative_to=None):
         import_path = self.import_path
         if import_path:
             if relative_to:
-                shared = _shared_leading_path(relative_to, import_path)
+                shared = _shared_leading_qualname(relative_to, import_path)
                 if shared == import_path:
                     import_path = "."
                 else:

src/docstub/_version.pyi

@@ -0,0 +1,5 @@
+VERSION_TUPLE = tuple[int | str, ...]
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE