Method query

bindings/python/graphlite/graphlite.py:258–297

Execute a GQL query Args: session_id: Session ID from create_session() query: GQL query string Returns: QueryResult with rows and metadata Raises: GraphLiteError: If query execution fails

(self, session_id: str, query: str)

        return session_id

    def query(self, session_id: str, query: str) -> QueryResult:
        """
        Execute a GQL query

        Args:
            session_id: Session ID from create_session()
            query: GQL query string

        Returns:
            QueryResult with rows and metadata

        Raises:
            GraphLiteError: If query execution fails
        """
        if not self._db:
            raise GraphLiteError(ErrorCode.NULL_POINTER, "Database is closed")

        error = ctypes.c_int(0)
        result_ptr = _lib.graphlite_query(
            self._db,
            session_id.encode('utf-8'),
            query.encode('utf-8'),
            ctypes.byref(error)
        )

        if not result_ptr:
            raise GraphLiteError(
                ErrorCode(error.value),
                f"Query failed: {query[:100]}"
            )

        try:
            # Copy the string before freeing
            result_json = ctypes.string_at(result_ptr).decode('utf-8')
            result_data = json.loads(result_json)
            return QueryResult(result_data)
        except json.JSONDecodeError as e:
            raise GraphLiteError(ErrorCode.JSON_ERROR, f"Invalid JSON response: {e}")
        finally:
            _lib.graphlite_free_string(result_ptr)

    def execute(self, session_id: str, statement: str) -> None:
        """