0.5.12

Author: joocer

dev/build_counter.py

@@ -29,7 +29,7 @@ class VersionStatus(Enum):
 
 __major_version__ = 0
 __minor_version__ = 5
-__revision_version__ = 11
+__revision_version__ = 12
 __author__ = "@joocer"
 __status__ = VersionStatus.RELEASE
 

opteryx/__init__.py

@@ -94,6 +94,7 @@ def is_mac() -> bool:  # pragma: no cover
     "Connection",
     "query",
     "query_to_arrow",
+    "plan",
     "register_workspace",
     "set_default_connector",
     "__author__",
@@ -272,6 +273,29 @@ def analyze_query(sql: str) -> Dict[str, Any]:
     return _parse_query_info(sql)
 
 
+def plan(
+    operation: str,
+    params: Optional[Iterable] = None,
+    visibility_filters: Optional[Dict[str, Any]] = None,
+    **kwargs,
+) -> dict:
+    """
+    Produce a planner-only representation of the given SQL without executing it.
+
+    This convenience wrapper creates a temporary `Connection` and `Cursor`, calls
+    `Cursor.plan(...)`, then closes the cursor and connection.
+    """
+    from opteryx.connection import Connection
+
+    conn = Connection(**kwargs)
+    cur = conn.cursor()
+    cur._owns_connection = True
+    try:
+        return cur.plan(operation=operation, params=params, visibility_filters=visibility_filters)
+    finally:
+        cur.close()
+
+
 # Enable all warnings, including DeprecationWarning
 warnings.simplefilter("once", DeprecationWarning)
 

opteryx/__version__.py

@@ -1,11 +1,11 @@
 # THIS FILE IS AUTOMATICALLY UPDATED DURING THE BUILD PROCESS
 # DO NOT EDIT THIS FILE DIRECTLY
 
-__build__ = 142
+__build__ = 143
 __author__ = "@joocer"
-__version__ = "0.5.11"
+__version__ = "0.5.12"
 __lib__ = "opteryx-core"
-__build_date__ = "2026-01-04T19:23:09.463740+00:00Z"
+__build_date__ = "2026-01-04T19:54:33.432905+00:00Z"
 
 # Store the version here so:
 # 1) we don't load dependencies by storing it in __init__.py

opteryx/models/manifest.py

@@ -110,12 +110,10 @@ def prune_files(self, predicates: List) -> List[FileEntry]:
         pruned_files = []
 
         for file_entry in self.files:
-            print("Evaluating file:", file_entry.file_path)
             skip_file = False
 
             # Check each predicate
             for predicate in predicates:
-                print("  Predicate:", predicate.left.value, predicate.value, predicate.right.value)
                 # Handle simple comparisons: column op literal
                 if (
                     predicate.node_type == NodeType.COMPARISON_OPERATOR

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "opteryx_core"
-version = "0.5.11"
+version = "0.5.12"
 description = "Opteryx Query Engine"
 requires-python = '>=3.13'
 readme = {file = "README.md", content-type = "text/markdown"}