docs fix (claude)

Author: akdor1154

csql/_/models/query.py

@@ -233,6 +233,11 @@ def preview_pl(
 		newParams: Mapping[str, ParameterValue] | None = None,
 		overrides: csql.overrides.Overrides | None = None,
 	) -> pl.DataFrame:
+		"""
+		Return a small polars DataFrame to preview the results of this query.
+
+		:rtype: :class:`polars.DataFrame`
+		"""
 		import polars as pl
 
 		from ..utils import limit_query

csql/__init__.py

@@ -9,20 +9,25 @@
 	ParameterList as _Deprecated_ParameterList,
 )
 from ._.models.query import (
+	ClickhouseQueryArgs,
+	DuckDBQueryArgs,
 	ParameterPlaceholder,
 	Parameters,
 	ParameterValue,
+	PolarsQueryArgs,
 	Query,
 	QueryBit,
 	RenderedQuery,
 )
 from .overrides import Overrides as _Deprecated_Overrides
 
 __all__ = [
+	"ClickhouseQueryArgs",
+	"DuckDBQueryArgs",
 	"ParameterPlaceholder",
 	"ParameterValue",
 	"Parameters",
-	"Parameters",
+	"PolarsQueryArgs",
 	"Q",
 	"Query",
 	"QueryBit",

docs/conf.py

@@ -131,8 +131,12 @@ def check_output(self, want, got, optionflags):
 intersphinx_mapping = {
 	"python": ("https://docs.python.org/3", None),
 	"pandas": ("https://pandas.pydata.org/docs/", None),
+	"polars": ("https://docs.pola.rs/api/python/stable/", None),
 }
 
+# polars's published inventory doesn't index the DataFrame class itself, only its methods.
+nitpick_ignore = [("py:class", "polars.DataFrame")]
+
 autosummary_generate = False
 autosummary_imported_members = True
 autosummary_ignore_module_all = False