fix: default to validate=False for Altair chart creation

Boxplots (and potentially other specs) use Vega-Lite features that
Altair's schema validation rejects. Disabling validation by default
avoids spurious ValidationErrors while still rendering correctly.

Author: cpsievert

CHANGELOG.md

@@ -1,10 +1,16 @@
 # Changelog
 
-## 0.3.0 (unreleased)
+## 0.3.2 (unreleased)
 
 ### Changed
 
-- Upgraded to ggsql Rust crate v0.3.0. See the [upstream changelog](https://github.com/posit-dev/ggsql/blob/main/CHANGELOG.md) for details on new features, bug fixes, and breaking changes.
+- `render_altair()` and `VegaLiteWriter.render_chart()` now default to `validate=False` when creating Altair chart objects. This avoids `ValidationError`s for valid specs (e.g., boxplots) that use Vega-Lite features not yet reflected in Altair's schema. Pass `validate=True` to re-enable.
+
+## 0.3.1
+
+### Changed
+
+- Upgraded to ggsql Rust crate v0.3.1.
 - Replaced polars with Arrow (via pyarrow) for the Rust↔Python data bridge. `DuckDBReader.execute_sql()`, `Spec.data()`, `Spec.layer_data()`, and `Spec.stat_data()` now return `pyarrow.Table` instead of `polars.DataFrame`. `DuckDBReader.register()` accepts `pyarrow.Table` (polars DataFrames are still accepted via automatic conversion). Custom readers returning polars DataFrames from `execute_sql()` continue to work without changes.
 - Runtime dependency changed from `polars` to `pyarrow`.
 

python/ggsql/__init__.py

@@ -49,6 +49,7 @@
 
 def _json_to_altair_chart(vegalite_json: str, **kwargs: Any) -> AltairChart:
     """Convert a Vega-Lite JSON string to the appropriate Altair chart type."""
+    kwargs.setdefault("validate", False)
     spec = json.loads(vegalite_json)
 
     if "layer" in spec:
@@ -94,7 +95,8 @@ def render_chart(self, spec: Spec, **kwargs: Any) -> AltairChart:
             The resolved visualization specification from ``reader.execute()``.
         **kwargs
             Additional keyword arguments passed to ``altair.Chart.from_json()``.
-            Common options include ``validate=False`` to skip schema validation.
+            Vega-Lite schema validation is disabled by default; pass
+            ``validate=True`` to re-enable it.
 
         Returns
         -------
@@ -121,7 +123,8 @@ def render_altair(
         VISUALISE spec string (e.g., "VISUALISE x, y DRAW point")
     **kwargs
         Additional keyword arguments passed to `from_json()`.
-        Common options include `validate=False` to skip schema validation.
+        Vega-Lite schema validation is disabled by default; pass
+        `validate=True` to re-enable it.
 
     Returns
     -------