fix(python): resolve native job types in API docs (#4170)

Native job metadata types report `builtins` as their module, so Griffe
cannot resolve the public `lancedb.job` re-exports and the Python API
reference build fails. Set the PyO3 module metadata for `JobInfo`,
`JobDescription`, and `JobFailureInfo`, and cover import resolution in
the existing package metadata tests.

Reproduced the failure and validated the fix with the docs CI toolchain
(`griffe==0.49.0`, `mkdocstrings==0.25.2`, and
`mkdocstrings-python==1.10.9`). After rebuilding the native extension,
the full `PYTHONPATH=. mkdocs build` succeeds and all three classes and
their public members appear in the generated reference.

python/python/tests/test_package_metadata.py

@@ -9,6 +9,15 @@ from pathlib import Path
 import pytest
 
 
+@pytest.mark.parametrize("name", ["JobInfo", "JobDescription", "JobFailureInfo"])
+def test_job_metadata_types_have_resolvable_modules(name):
+    """Documentation tools resolve re-exports through each type's module."""
+    public_type = getattr(importlib.import_module("lancedb.job"), name)
+    defining_module = importlib.import_module(public_type.__module__)
+
+    assert getattr(defining_module, public_type.__name__, None) is public_type
+
+
 def test_pyo3_abi_matches_minimum_supported_python():
     project_dir = Path(__file__).parents[2]
     pyproject = (project_dir / "pyproject.toml").read_text()

python/src/job.rs

@@ -151,7 +151,7 @@ impl Job {
 }
 
 /// A row from `Connection.list_jobs`: one server-side job.
-#[pyclass(get_all, skip_from_py_object)]
+#[pyclass(module = "lancedb._lancedb", get_all, skip_from_py_object)]
 #[derive(Clone)]
 pub struct JobInfo {
     job_id: String,
@@ -184,7 +184,7 @@ impl From<lancedb::database::JobInfo> for JobInfo {
 }
 
 /// The server's account of why a job failed.
-#[pyclass(get_all, skip_from_py_object)]
+#[pyclass(module = "lancedb._lancedb", get_all, skip_from_py_object)]
 #[derive(Clone)]
 pub struct JobFailureInfo {
     phase: Option<String>,
@@ -203,7 +203,7 @@ impl JobFailureInfo {
 }
 
 /// The server-side record behind a `Job` handle.
-#[pyclass(get_all, skip_from_py_object)]
+#[pyclass(module = "lancedb._lancedb", get_all, skip_from_py_object)]
 #[derive(Clone)]
 pub struct JobDescription {
     job_id: String,