pylegend 0.8.0__py3-none-any.whl → 0.10.0__py3-none-any.whl

pylegend/core/language/shared/operations/nary_expression.py

@@ -0,0 +1,104 @@
+# Copyright 2025 Goldman Sachs
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from abc import ABCMeta
+from pylegend._typing import (
+    PyLegendSequence,
+    PyLegendDict,
+    PyLegendCallable,
+    PyLegendList,
+    PyLegendOptional
+)
+from pylegend.core.language.shared.expression import (
+    PyLegendExpression,
+)
+from pylegend.core.language.shared.helpers import expr_has_matching_start_and_end_parentheses
+from pylegend.core.sql.metamodel import (
+    Expression,
+    QuerySpecification,
+)
+from pylegend.core.tds.tds_frame import FrameToSqlConfig
+from pylegend.core.tds.tds_frame import FrameToPureConfig
+
+__all__: PyLegendSequence[str] = [
+    "PyLegendNaryExpression"
+]
+
+
+class PyLegendNaryExpression(PyLegendExpression, metaclass=ABCMeta):
+    __operands: PyLegendList[PyLegendExpression]
+    __to_sql_func: PyLegendCallable[
+        [PyLegendList[Expression], PyLegendDict[str, QuerySpecification], FrameToSqlConfig],
+        Expression
+    ]
+    __to_pure_func: PyLegendCallable[
+        [PyLegendList[str], FrameToPureConfig],
+        str
+    ]
+    __non_nullable: bool
+    __operands_non_nullable_flags: PyLegendList[bool]
+
+    def __init__(
+            self,
+            operands: PyLegendList[PyLegendExpression],
+            to_sql_func: PyLegendCallable[
+                [PyLegendList[Expression], PyLegendDict[str, QuerySpecification], FrameToSqlConfig],
+                Expression
+            ],
+            to_pure_func: PyLegendCallable[
+                [PyLegendList[str], FrameToPureConfig],
+                str
+            ],
+            non_nullable: bool = False,
+            operands_non_nullable_flags: PyLegendOptional[PyLegendList[bool]] = None
+    ) -> None:
+        self.__operands = operands
+        self.__to_sql_func = to_sql_func
+        self.__to_pure_func = to_pure_func
+        self.__non_nullable = non_nullable
+        self.__operands_non_nullable_flags = (
+            operands_non_nullable_flags
+            if operands_non_nullable_flags is not None
+            else [False] * len(operands)
+        )
+
+    def to_sql_expression(
+            self,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        sql_operands = [
+            operand.to_sql_expression(frame_name_to_base_query_map, config)
+            for operand in self.__operands
+        ]
+        return self.__to_sql_func(sql_operands, frame_name_to_base_query_map, config)
+
+    def to_pure_expression(self, config: FrameToPureConfig) -> str:
+        pure_operands: PyLegendList[str] = []
+
+        for operand, must_be_non_nullable in zip(self.__operands, self.__operands_non_nullable_flags):
+            expr = operand.to_pure_expression(config)
+
+            if must_be_non_nullable:
+                expr = (
+                    expr if operand.is_non_nullable() else
+                    f"toOne({expr[1:-1] if expr_has_matching_start_and_end_parentheses(expr) else expr})"
+                )
+
+            pure_operands.append(expr)
+
+        return self.__to_pure_func(pure_operands, config)
+
+    def is_non_nullable(self) -> bool:
+        return self.__non_nullable

pylegend/core/language/shared/operations/number_operation_expressions.py

@@ -22,6 +22,7 @@ from pylegend.core.language.shared.expression import (
     PyLegendExpressionBooleanReturn,
 )
 from pylegend.core.language.shared.operations.binary_expression import PyLegendBinaryExpression
+from pylegend.core.language.shared.operations.nullary_expression import PyLegendNullaryExpression
 from pylegend.core.language.shared.operations.unary_expression import PyLegendUnaryExpression
 from pylegend.core.language.shared.helpers import generate_pure_functional_call
 from pylegend.core.tds.tds_frame import FrameToSqlConfig
@@ -34,6 +35,8 @@ from pylegend.core.sql.metamodel import (
     ComparisonOperator,
     ComparisonExpression,
     NegativeExpression,
+    FunctionCall,
+    QualifiedName
 )
 from pylegend.core.sql.metamodel_extension import (
     AbsoluteExpression,
@@ -85,6 +88,14 @@ __all__: PyLegendSequence[str] = [
     "PyLegendNumberArcTanExpression",
     "PyLegendNumberArcTan2Expression",
     "PyLegendNumberCotExpression",
+    "PyLegendNumberLog10Expression",
+    "PyLegendNumberDegreesExpression",
+    "PyLegendNumberRadiansExpression",
+    "PyLegendNumberSignExpression",
+    "PyLegendNumberHyperbolicSinExpression",
+    "PyLegendNumberHyperbolicCosExpression",
+    "PyLegendNumberHyperbolicTanExpression",
+    "PyLegendNumberPiExpression"
 ]
 
 
@@ -821,3 +832,256 @@ class PyLegendNumberCotExpression(PyLegendUnaryExpression, PyLegendExpressionNum
             non_nullable=True,
             operand_needs_to_be_non_nullable=True,
         )
+
+
+class PyLegendNumberLog10Expression(PyLegendUnaryExpression, PyLegendExpressionNumberReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            expression: Expression,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return FunctionCall(
+            name=QualifiedName(parts=["LOG10"]),
+            distinct=False,
+            arguments=[expression],
+            filter_=None,
+            window=None
+        )
+
+    @staticmethod
+    def __to_pure_func(op_expr: str, config: FrameToPureConfig) -> str:
+        return generate_pure_functional_call("log10", [op_expr])
+
+    def __init__(self, operand: PyLegendExpressionNumberReturn) -> None:
+        PyLegendExpressionNumberReturn.__init__(self)
+        PyLegendUnaryExpression.__init__(
+            self,
+            operand,
+            PyLegendNumberLog10Expression.__to_sql_func,
+            PyLegendNumberLog10Expression.__to_pure_func,
+            non_nullable=True,
+            operand_needs_to_be_non_nullable=True,
+        )
+
+
+class PyLegendNumberDegreesExpression(PyLegendUnaryExpression, PyLegendExpressionNumberReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            expression: Expression,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return FunctionCall(
+            name=QualifiedName(parts=["DEGREES"]),
+            distinct=False,
+            arguments=[expression],
+            filter_=None,
+            window=None
+        )
+
+    @staticmethod
+    def __to_pure_func(op_expr: str, config: FrameToPureConfig) -> str:
+        return generate_pure_functional_call("toDegrees", [op_expr])
+
+    def __init__(self, operand: PyLegendExpressionNumberReturn) -> None:
+        PyLegendExpressionNumberReturn.__init__(self)
+        PyLegendUnaryExpression.__init__(
+            self,
+            operand,
+            PyLegendNumberDegreesExpression.__to_sql_func,
+            PyLegendNumberDegreesExpression.__to_pure_func,
+            non_nullable=True,
+            operand_needs_to_be_non_nullable=True,
+        )
+
+
+class PyLegendNumberRadiansExpression(PyLegendUnaryExpression, PyLegendExpressionNumberReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            expression: Expression,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return FunctionCall(
+            name=QualifiedName(parts=["RADIANS"]),
+            distinct=False,
+            arguments=[expression],
+            filter_=None,
+            window=None
+        )
+
+    @staticmethod
+    def __to_pure_func(op_expr: str, config: FrameToPureConfig) -> str:
+        return generate_pure_functional_call("toRadians", [op_expr])
+
+    def __init__(self, operand: PyLegendExpressionNumberReturn) -> None:
+        PyLegendExpressionNumberReturn.__init__(self)
+        PyLegendUnaryExpression.__init__(
+            self,
+            operand,
+            PyLegendNumberRadiansExpression.__to_sql_func,
+            PyLegendNumberRadiansExpression.__to_pure_func,
+            non_nullable=True,
+            operand_needs_to_be_non_nullable=True,
+        )
+
+
+class PyLegendNumberSignExpression(PyLegendUnaryExpression, PyLegendExpressionNumberReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            expression: Expression,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return FunctionCall(
+            name=QualifiedName(parts=["SIGN"]),
+            distinct=False,
+            arguments=[expression],
+            filter_=None,
+            window=None
+        )
+
+    @staticmethod
+    def __to_pure_func(op_expr: str, config: FrameToPureConfig) -> str:
+        return generate_pure_functional_call("sign", [op_expr])
+
+    def __init__(self, operand: PyLegendExpressionNumberReturn) -> None:
+        PyLegendExpressionNumberReturn.__init__(self)
+        PyLegendUnaryExpression.__init__(
+            self,
+            operand,
+            PyLegendNumberSignExpression.__to_sql_func,
+            PyLegendNumberSignExpression.__to_pure_func,
+            non_nullable=True,
+            operand_needs_to_be_non_nullable=True,
+        )
+
+
+class PyLegendNumberHyperbolicSinExpression(PyLegendUnaryExpression, PyLegendExpressionNumberReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            expression: Expression,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return FunctionCall(
+            name=QualifiedName(parts=["SINH"]),
+            distinct=False,
+            arguments=[expression],
+            filter_=None,
+            window=None
+        )
+
+    @staticmethod
+    def __to_pure_func(op_expr: str, config: FrameToPureConfig) -> str:
+        return generate_pure_functional_call("sinh", [op_expr])
+
+    def __init__(self, operand: PyLegendExpressionNumberReturn) -> None:
+        PyLegendExpressionNumberReturn.__init__(self)
+        PyLegendUnaryExpression.__init__(
+            self,
+            operand,
+            PyLegendNumberHyperbolicSinExpression.__to_sql_func,
+            PyLegendNumberHyperbolicSinExpression.__to_pure_func,
+            non_nullable=True,
+            operand_needs_to_be_non_nullable=True,
+        )
+
+
+class PyLegendNumberHyperbolicCosExpression(PyLegendUnaryExpression, PyLegendExpressionNumberReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            expression: Expression,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return FunctionCall(
+            name=QualifiedName(parts=["COSH"]),
+            distinct=False,
+            arguments=[expression],
+            filter_=None,
+            window=None
+        )
+
+    @staticmethod
+    def __to_pure_func(op_expr: str, config: FrameToPureConfig) -> str:
+        return generate_pure_functional_call("cosh", [op_expr])
+
+    def __init__(self, operand: PyLegendExpressionNumberReturn) -> None:
+        PyLegendExpressionNumberReturn.__init__(self)
+        PyLegendUnaryExpression.__init__(
+            self,
+            operand,
+            PyLegendNumberHyperbolicCosExpression.__to_sql_func,
+            PyLegendNumberHyperbolicCosExpression.__to_pure_func,
+            non_nullable=True,
+            operand_needs_to_be_non_nullable=True,
+        )
+
+
+class PyLegendNumberHyperbolicTanExpression(PyLegendUnaryExpression, PyLegendExpressionNumberReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            expression: Expression,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return FunctionCall(
+            name=QualifiedName(parts=["TANH"]),
+            distinct=False,
+            arguments=[expression],
+            filter_=None,
+            window=None
+        )
+
+    @staticmethod
+    def __to_pure_func(op_expr: str, config: FrameToPureConfig) -> str:
+        return generate_pure_functional_call("tanh", [op_expr])
+
+    def __init__(self, operand: PyLegendExpressionNumberReturn) -> None:
+        PyLegendExpressionNumberReturn.__init__(self)
+        PyLegendUnaryExpression.__init__(
+            self,
+            operand,
+            PyLegendNumberHyperbolicTanExpression.__to_sql_func,
+            PyLegendNumberHyperbolicTanExpression.__to_pure_func,
+            non_nullable=True,
+            operand_needs_to_be_non_nullable=True,
+        )
+
+
+class PyLegendNumberPiExpression(PyLegendNullaryExpression, PyLegendExpressionNumberReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return FunctionCall(
+            name=QualifiedName(parts=["PI"]),
+            distinct=False,
+            arguments=[],
+            filter_=None,
+            window=None
+        )
+
+    @staticmethod
+    def __to_pure_func(config: FrameToPureConfig) -> str:
+        return "pi()"
+
+    def __init__(self) -> None:
+        PyLegendExpressionNumberReturn.__init__(self)
+        PyLegendNullaryExpression.__init__(
+            self,
+            PyLegendNumberPiExpression.__to_sql_func,
+            PyLegendNumberPiExpression.__to_pure_func,
+            non_nullable=True
+        )

pylegend/core/language/shared/operations/primitive_operation_expressions.py

@@ -19,6 +19,7 @@ from pylegend._typing import (
 from pylegend.core.language.shared.expression import (
     PyLegendExpression,
     PyLegendExpressionBooleanReturn,
+    PyLegendExpressionStringReturn
 )
 from pylegend.core.language.shared.helpers import generate_pure_functional_call
 from pylegend.core.language.shared.operations.binary_expression import PyLegendBinaryExpression
@@ -30,6 +31,8 @@ from pylegend.core.sql.metamodel import (
     ComparisonOperator,
     IsNullPredicate,
     IsNotNullPredicate,
+    Cast,
+    ColumnType
 )
 from pylegend.core.tds.tds_frame import FrameToSqlConfig
 from pylegend.core.tds.tds_frame import FrameToPureConfig
@@ -40,6 +43,7 @@ __all__: PyLegendSequence[str] = [
     "PyLegendPrimitiveNotEqualsExpression",
     "PyLegendIsEmptyExpression",
     "PyLegendIsNotEmptyExpression",
+    "PyLegendPrimitiveToStringExpression"
 ]
 
 
@@ -145,3 +149,29 @@ class PyLegendIsNotEmptyExpression(PyLegendUnaryExpression, PyLegendExpressionBo
             PyLegendIsNotEmptyExpression.__to_pure_func,
             non_nullable=True,
         )
+
+
+class PyLegendPrimitiveToStringExpression(PyLegendUnaryExpression, PyLegendExpressionStringReturn):
+
+    @staticmethod
+    def __to_sql_func(
+            expression: Expression,
+            frame_name_to_base_query_map: PyLegendDict[str, QuerySpecification],
+            config: FrameToSqlConfig
+    ) -> Expression:
+        return Cast(expression, ColumnType(name="TEXT", parameters=[]))
+
+    @staticmethod
+    def __to_pure_func(op_expr: str, config: FrameToPureConfig) -> str:
+        return generate_pure_functional_call("toString", [op_expr])
+
+    def __init__(self, operand: PyLegendExpression) -> None:
+        PyLegendExpressionStringReturn.__init__(self)
+        PyLegendUnaryExpression.__init__(
+            self,
+            operand,
+            PyLegendPrimitiveToStringExpression.__to_sql_func,
+            PyLegendPrimitiveToStringExpression.__to_pure_func,
+            non_nullable=True,
+            operand_needs_to_be_non_nullable=True,
+        )