sqlobjects 1.6.0__tar.gz → 1.7.0__tar.gz

{sqlobjects-1.6.0 → sqlobjects-1.7.0}/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 1.7.0 (2026-03-26)
+
+### Feat
+
+- **metadata**: add foreignkey() constraint builder
+
+### Fix
+
+- **raw**: allow SA expressions as arguments in raw() methods
+
 ## 1.6.0 (2026-03-18)
 
 ### Feat

{sqlobjects-1.6.0/sqlobjects.egg-info → sqlobjects-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlobjects
-Version: 1.6.0
+Version: 1.7.0
 Summary: Django-style async ORM library based on SQLAlchemy with chainable queries, Q objects, and relationship loading
 Author-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>
 Maintainer-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>

{sqlobjects-1.6.0 → sqlobjects-1.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sqlobjects"
-version = "1.6.0"
+version = "1.7.0"
 description = "Django-style async ORM library based on SQLAlchemy with chainable queries, Q objects, and relationship loading"
 readme = "README.md"
 license = "MIT"

{sqlobjects-1.6.0 → sqlobjects-1.7.0}/sqlobjects/expressions/function.py

@@ -183,7 +183,9 @@ class FunctionExpression:
 
         Args:
             sql: Raw SQL function name or expression
-            *args: Arguments to pass to the function. Use ... (Ellipsis) as placeholder for current expression
+            *args: Arguments to pass to the function. Use ... (Ellipsis) as placeholder for current expression.
+                   SQLAlchemy expressions (ColumnElement, FunctionExpression) are passed through as-is;
+                   plain Python values are wrapped with literal().
             **kwargs: Additional keyword arguments passed to the function
 
         Returns:
@@ -198,12 +200,17 @@ class FunctionExpression:
             User.age.avg().raw('CUSTOM_FUNCTION', 'param1', ..., 'param2')
             # Generates: CUSTOM_FUNCTION('param1', avg(age), 'param2')
 
-            # Only current expression
-            User.age.raw('CUSTOM_FUNCTION')
-            # Generates: CUSTOM_FUNCTION(age)
+            # Passing another SA expression as argument
+            User.name.raw('CUSTOM_FUNCTION', other_func_expr)
+            # Generates: CUSTOM_FUNCTION(name, other_func_expr)
         """
         from sqlalchemy import literal
 
+        def _to_sql_arg(arg):
+            if isinstance(arg, (ColumnElement, FunctionExpression)):
+                return arg
+            return literal(arg)
+
         # Check if ... (Ellipsis) is used as placeholder
         if ... in args:
             # Replace ... with current expression
@@ -212,12 +219,10 @@ class FunctionExpression:
                 if arg is ...:
                     all_args.append(self.expression)
                 else:
-                    all_args.append(literal(arg))
+                    all_args.append(_to_sql_arg(arg))
         else:
             # Default behavior: current expression as first argument
-            all_args = [self.expression]
-            for arg in args:
-                all_args.append(literal(arg))
+            all_args = [self.expression] + [_to_sql_arg(arg) for arg in args]
 
         # Use func to create the raw function call
         raw_func = getattr(_sa_func, sql)
@@ -425,6 +430,38 @@ class _FuncWrapper:
 
         def nth_value(self, col: Any, n: int) -> NthValueFunction: ...
 
+        def raw(self, sql: str, *args) -> FunctionExpression: ...
+
+    def raw(self, sql: str, *args) -> "FunctionExpression":
+        """Call an arbitrary SQL function by name.
+
+        Unlike col.raw() / FunctionExpression.raw() which insert the current
+        expression as the first argument, this standalone form takes the function
+        name and all arguments explicitly.
+
+        Args:
+            sql: SQL function name (e.g. "ts_rank", "to_tsvector")
+            *args: Arguments passed to the function. SQLAlchemy expressions
+                   (ColumnElement, FunctionExpression) are used as-is; plain
+                   Python values are wrapped with literal().
+
+        Examples:
+            func.raw("ts_rank", DocumentIndexes.content_vector, query_vec)
+            # → ts_rank(document_indexes.content_vector, <query_vec>)
+
+            func.raw("to_tsvector", "'simple'::regconfig", "some text")
+            # → to_tsvector('simple'::regconfig, 'some text')
+        """
+        from sqlalchemy import literal
+
+        def _to_sql_arg(arg):
+            if isinstance(arg, (ColumnElement, FunctionExpression)):
+                return arg
+            return literal(arg)
+
+        sa_func = getattr(_sa_func, sql)
+        return FunctionExpression(sa_func(*[_to_sql_arg(a) for a in args]))
+
     def __getattr__(self, name: str) -> Any:
         """Delegate to SQLAlchemy func for all other functions."""
         return getattr(_sa_func, name)

{sqlobjects-1.6.0 → sqlobjects-1.7.0}/sqlobjects/fields/types/comparators.py

@@ -50,6 +50,12 @@ class ComparatorMixin:
 
     def raw(self, sql: str, *args, **kwargs) -> FunctionExpression:
         from sqlalchemy import literal
+        from sqlalchemy.sql.elements import ColumnElement
+
+        def _to_sql_arg(arg):
+            if isinstance(arg, (ColumnElement, FunctionExpression)):
+                return arg
+            return literal(arg)
 
         if ... in args:
             all_args = []
@@ -57,9 +63,9 @@ class ComparatorMixin:
                 if arg is ...:
                     all_args.append(self)
                 else:
-                    all_args.append(literal(arg))
+                    all_args.append(_to_sql_arg(arg))
         else:
-            all_args = [self] + [literal(arg) for arg in args]
+            all_args = [self] + [_to_sql_arg(arg) for arg in args]
         raw_func = getattr(func, sql)
         return FunctionExpression(raw_func(*all_args, **kwargs))
 

{sqlobjects-1.6.0 → sqlobjects-1.7.0/sqlobjects.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlobjects
-Version: 1.6.0
+Version: 1.7.0
 Summary: Django-style async ORM library based on SQLAlchemy with chainable queries, Q objects, and relationship loading
 Author-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>
 Maintainer-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>