[python][daft] Add Daft-side scan explain diagnostics

paimon-python/pypaimon/daft/__init__.py

@@ -16,9 +16,9 @@
 # limitations under the License.
 ################################################################################
 
-from pypaimon.daft.daft_paimon import read_paimon, write_paimon
+from pypaimon.daft.daft_paimon import explain_paimon_scan, read_paimon, write_paimon
 
-__all__ = ["read_paimon", "write_paimon", "PaimonCatalog", "PaimonTable"]
+__all__ = ["explain_paimon_scan", "read_paimon", "write_paimon", "PaimonCatalog", "PaimonTable"]
 
 
 def __getattr__(name):

paimon-python/pypaimon/daft/daft_catalog.py

@@ -216,6 +216,29 @@ def read(self, **options: Any) -> DataFrame:
         Table._validate_options("Paimon read", options, set())
         return _read_table(self._inner, catalog_options=self._catalog_options)
 
+    def explain_scan(
+        self,
+        *,
+        filters: Any = None,
+        partition_filters: Any = None,
+        columns: list[str] | None = None,
+        limit: int | None = None,
+        io_config=None,
+        verbose: bool = False,
+    ) -> Any:
+        from pypaimon.daft.daft_paimon import _explain_table
+
+        return _explain_table(
+            self._inner,
+            catalog_options=self._catalog_options,
+            filters=filters,
+            partition_filters=partition_filters,
+            columns=columns,
+            limit=limit,
+            io_config=io_config,
+            verbose=verbose,
+        )
+
     def append(self, df: DataFrame, **options: Any) -> None:
         from pypaimon.daft.daft_paimon import _write_table