programgarden-core 1.2.0__tar.gz → 1.3.0__tar.gz

{programgarden_core-1.2.0 → programgarden_core-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: programgarden-core
-Version: 1.2.0
+Version: 1.3.0
 Summary: ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의
 Author: 프로그램동산
 Author-email: coding@programgarden.com

{programgarden_core-1.2.0 → programgarden_core-1.3.0}/programgarden_core/i18n/locales/en.json

@@ -36,6 +36,8 @@
   "nodes.AIAgentNode.name": "AI Agent",
   "nodes.AggregateNode.description": "Collect individual items into a list. Use with SplitNode.",
   "nodes.AggregateNode.name": "Aggregate",
+  "nodes.IfNode.description": "Branch execution flow based on a condition (if/else)",
+  "nodes.IfNode.name": "If Branch",
   "nodes.AlertNode.description": "Send notifications (email, SMS, webhook).",
   "nodes.AlertNode.name": "Alert",
   "nodes.BacktestEngineNode.description": "Run backtest with signals and historical data, calculate performance metrics.",
@@ -182,6 +184,9 @@
   "fields.AggregateNode.mode": "Select aggregation mode",
   "fields.AggregateNode.value_field": "Field name for calculation (for sum/avg/min/max modes)",
   "fields.AggregateNode.value_field_helper": "Specify a field containing numeric values",
+  "fields.IfNode.left": "Left value (comparison target)",
+  "fields.IfNode.operator": "Comparison operator",
+  "fields.IfNode.right": "Right value (comparison reference)",
   "fields.AlertNode.credential_id": "Alert service credential",
   "fields.AlertNode.message_template": "Message template (variables supported)",
   "fields.BacktestEngineNode.allow_fractional": "Allow fractional shares",
@@ -437,6 +442,9 @@
   "fieldNames.AggregateNode.filter_field": "Filter Field",
   "fieldNames.AggregateNode.mode": "Mode",
   "fieldNames.AggregateNode.value_field": "Value Field",
+  "fieldNames.IfNode.left": "Left Value",
+  "fieldNames.IfNode.operator": "Operator",
+  "fieldNames.IfNode.right": "Right Value",
   "fieldNames.BacktestEngineNode.allow_fractional": "Allow Fractional",
   "fieldNames.BacktestEngineNode.allow_short": "Allow Short",
   "fieldNames.BacktestEngineNode.atr_period": "ATR Period",
@@ -666,6 +674,9 @@
   "ports.aggregate_count": "Item count",
   "ports.aggregate_item": "Item to collect",
   "ports.aggregate_value": "Calculated result (sum/avg/min/max)",
+  "ports.if_true": "Output when condition is true",
+  "ports.if_false": "Output when condition is false",
+  "ports.if_result": "Condition evaluation result (boolean)",
   "ports.allocated_capital": "Allocated capital",
   "ports.allocation_weights": "Allocation weights",
   "ports.approved_symbols": "Approved symbols",
@@ -800,6 +811,18 @@
   "enums.aggregate_mode.max": "Maximum",
   "enums.aggregate_mode.min": "Minimum",
   "enums.aggregate_mode.sum": "Sum",
+  "enums.if_operator.eq": "Equals (==)",
+  "enums.if_operator.ne": "Not equals (!=)",
+  "enums.if_operator.gt": "Greater than (>)",
+  "enums.if_operator.gte": "Greater or equal (>=)",
+  "enums.if_operator.lt": "Less than (<)",
+  "enums.if_operator.lte": "Less or equal (<=)",
+  "enums.if_operator.in": "Is in (in)",
+  "enums.if_operator.not_in": "Is not in (not in)",
+  "enums.if_operator.contains": "Contains",
+  "enums.if_operator.not_contains": "Does not contain",
+  "enums.if_operator.is_empty": "Is empty",
+  "enums.if_operator.is_not_empty": "Is not empty",
   "enums.allocation_method.custom": "Custom Allocation",
   "enums.allocation_method.equal": "Equal Weight",
   "enums.allocation_method.momentum": "Momentum Based",

{programgarden_core-1.2.0 → programgarden_core-1.3.0}/programgarden_core/i18n/locales/ko.json

@@ -36,6 +36,8 @@
   "nodes.AIAgentNode.name": "AI 에이전트",
   "nodes.AggregateNode.description": "개별 아이템을 리스트로 수집합니다. SplitNode와 함께 사용하세요.",
   "nodes.AggregateNode.name": "집계",
+  "nodes.IfNode.description": "조건에 따라 실행 흐름을 분기합니다 (if/else)",
+  "nodes.IfNode.name": "조건 분기",
   "nodes.AlertNode.description": "알림 발송 (이메일, SMS, 웹훅).",
   "nodes.AlertNode.name": "알림",
   "nodes.BacktestEngineNode.description": "시그널과 과거 데이터로 백테스트 실행 및 성과 지표 계산.",
@@ -182,6 +184,9 @@
   "fields.AggregateNode.mode": "집계 방식을 선택하세요",
   "fields.AggregateNode.value_field": "계산에 사용할 필드명 (sum/avg/min/max 모드용)",
   "fields.AggregateNode.value_field_helper": "숫자 값이 있는 필드를 지정하세요",
+  "fields.IfNode.left": "왼쪽 값 (비교 대상)",
+  "fields.IfNode.operator": "비교 연산자",
+  "fields.IfNode.right": "오른쪽 값 (비교 기준)",
   "fields.AlertNode.credential_id": "알림 서비스 인증정보",
   "fields.AlertNode.message_template": "메시지 템플릿 (변수 사용 가능)",
   "fields.BacktestEngineNode.allow_fractional": "소수점 주식 허용",
@@ -437,6 +442,9 @@
   "fieldNames.AggregateNode.filter_field": "필터필드",
   "fieldNames.AggregateNode.mode": "집계방식",
   "fieldNames.AggregateNode.value_field": "값필드",
+  "fieldNames.IfNode.left": "왼쪽 값",
+  "fieldNames.IfNode.operator": "연산자",
+  "fieldNames.IfNode.right": "오른쪽 값",
   "fieldNames.BacktestEngineNode.allow_fractional": "소수점매매허용",
   "fieldNames.BacktestEngineNode.allow_short": "공매도허용",
   "fieldNames.BacktestEngineNode.atr_period": "ATR기간",
@@ -666,6 +674,9 @@
   "ports.aggregate_count": "아이템 개수",
   "ports.aggregate_item": "수집할 아이템",
   "ports.aggregate_value": "계산 결과 (sum/avg/min/max)",
+  "ports.if_true": "조건이 참일 때 출력",
+  "ports.if_false": "조건이 거짓일 때 출력",
+  "ports.if_result": "조건 평가 결과 (boolean)",
   "ports.allocated_capital": "배분된 자본",
   "ports.allocation_weights": "배분 비중",
   "ports.approved_symbols": "승인된 종목",
@@ -800,6 +811,18 @@
   "enums.aggregate_mode.max": "최댓값",
   "enums.aggregate_mode.min": "최솟값",
   "enums.aggregate_mode.sum": "합계",
+  "enums.if_operator.eq": "같음 (==)",
+  "enums.if_operator.ne": "다름 (!=)",
+  "enums.if_operator.gt": "초과 (>)",
+  "enums.if_operator.gte": "이상 (>=)",
+  "enums.if_operator.lt": "미만 (<)",
+  "enums.if_operator.lte": "이하 (<=)",
+  "enums.if_operator.in": "포함됨 (in)",
+  "enums.if_operator.not_in": "미포함됨 (not in)",
+  "enums.if_operator.contains": "포함함 (contains)",
+  "enums.if_operator.not_contains": "미포함함 (not contains)",
+  "enums.if_operator.is_empty": "비어있음",
+  "enums.if_operator.is_not_empty": "비어있지 않음",
   "enums.allocation_method.custom": "커스텀 배분",
   "enums.allocation_method.equal": "균등 배분",
   "enums.allocation_method.momentum": "모멘텀 기반",

{programgarden_core-1.2.0 → programgarden_core-1.3.0}/programgarden_core/models/edge.py

@@ -58,6 +58,10 @@ class Edge(BaseModel):
         alias="to",
         description="도착 노드 ID",
     )
+    from_port: Optional[str] = Field(
+        default=None,
+        description="출발 포트 (예: IfNode의 true/false)",
+    )
     edge_type: EdgeType = Field(
         default=EdgeType.MAIN,
         alias="type",
@@ -78,20 +82,27 @@ class Edge(BaseModel):
     @classmethod
     def extract_node_ids(cls, values: dict) -> dict:
         """
-        from/to 값에서 노드 ID만 추출 (하위호환성)
-        
-        "nodeA.portX" → "nodeA"
-        "nodeA" → "nodeA"
+        from/to 값에서 노드 ID만 추출하고 포트 정보를 보존
+
+        "nodeA.portX" → from="nodeA", from_port="portX"
+        "nodeA" → from="nodeA"
         """
         if isinstance(values, dict):
             from_val = values.get('from') or values.get('from_node')
             to_val = values.get('to') or values.get('to_node')
-            
+
             if from_val:
-                values['from'] = from_val.split('.')[0]
+                from_str = str(from_val)
+                if '.' in from_str:
+                    parts = from_str.split('.', 1)
+                    values['from'] = parts[0]
+                    if not values.get('from_port'):
+                        values['from_port'] = parts[1]
+                else:
+                    values['from'] = from_str
             if to_val:
-                values['to'] = to_val.split('.')[0]
-        
+                values['to'] = str(to_val).split('.')[0]
+
         return values
 
     # 하위호환성을 위한 property (기존 코드가 참조하는 경우)

{programgarden_core-1.2.0 → programgarden_core-1.3.0}/programgarden_core/nodes/__init__.py

@@ -2,7 +2,7 @@
 ProgramGarden Core - 노드 타입 정의
 
 48개 노드 타입을 카테고리로 분류:
-- infra (4): StartNode, ThrottleNode, SplitNode, AggregateNode
+- infra (5): StartNode, ThrottleNode, SplitNode, AggregateNode, IfNode
 - broker (2): OverseasStockBrokerNode, OverseasFuturesBrokerNode
 - market (12): OverseasStockMarketDataNode, OverseasFuturesMarketDataNode, OverseasStockHistoricalDataNode, OverseasFuturesHistoricalDataNode,
               OverseasStockRealMarketDataNode, OverseasFuturesRealMarketDataNode, OverseasStockSymbolQueryNode, OverseasFuturesSymbolQueryNode,
@@ -22,7 +22,7 @@ ProgramGarden Core - 노드 타입 정의
 """
 
 from programgarden_core.nodes.base import BaseNode, NodeCategory, Position
-from programgarden_core.nodes.infra import StartNode, ThrottleNode, SplitNode, AggregateNode
+from programgarden_core.nodes.infra import StartNode, ThrottleNode, SplitNode, AggregateNode, IfNode
 from programgarden_core.nodes.broker import OverseasStockBrokerNode, OverseasFuturesBrokerNode
 # Market - 상품별 분리 노드
 from programgarden_core.nodes.data_stock import OverseasStockMarketDataNode
@@ -95,6 +95,7 @@ __all__ = [
     "ThrottleNode",
     "SplitNode",
     "AggregateNode",
+    "IfNode",
     # Broker (상품별 분리)
     "OverseasStockBrokerNode",
     "OverseasFuturesBrokerNode",

{programgarden_core-1.2.0 → programgarden_core-1.3.0}/programgarden_core/nodes/infra.py

@@ -6,6 +6,7 @@ Infrastructure nodes:
 - ThrottleNode: Data flow control
 - SplitNode: Split list into individual items (item-based execution)
 - AggregateNode: Aggregate individual items into a list
+- IfNode: Conditional branching (if/else)
 """
 
 from typing import Optional, List, Literal, Dict, TYPE_CHECKING, ClassVar, Any
@@ -309,3 +310,106 @@ class AggregateNode(BaseNode):
                 helper_text="i18n:fields.AggregateNode.value_field_helper",
             ),
         }
+
+
+class IfNode(BaseNode):
+    """
+    조건 분기 노드
+
+    left와 right 값을 operator로 비교하여 true/false 브랜치로 실행 흐름을 분기합니다.
+    조건이 참이면 true 포트로, 거짓이면 false 포트로 데이터가 전달됩니다.
+
+    Edge에 from_port를 지정하여 분기 경로를 설정합니다:
+    - {"from": "if1", "to": "order", "from_port": "true"}
+    - {"from": "if1", "to": "notify", "from_port": "false"}
+    """
+
+    type: Literal["IfNode"] = "IfNode"
+    category: NodeCategory = NodeCategory.INFRA
+    description: str = "i18n:nodes.IfNode.description"
+
+    _img_url: ClassVar[str] = "https://cdn.programgarden.io/nodes/if.svg"
+
+    # 비교 연산 필드
+    left: Any = Field(default=None, description="왼쪽 피연산자 (표현식 바인딩 가능)")
+    operator: Literal[
+        "==", "!=", ">", ">=", "<", "<=",
+        "in", "not_in",
+        "contains", "not_contains",
+        "is_empty", "is_not_empty",
+    ] = Field(default="==", description="비교 연산자")
+    right: Any = Field(default=None, description="오른쪽 피연산자 (표현식 바인딩 가능)")
+
+    _inputs: List[InputPort] = [
+        InputPort(name="trigger", type="signal", description="i18n:ports.trigger"),
+    ]
+    _outputs: List[OutputPort] = [
+        OutputPort(name="true", type="any", description="i18n:ports.if_true"),
+        OutputPort(name="false", type="any", description="i18n:ports.if_false"),
+        OutputPort(name="result", type="boolean", description="i18n:ports.if_result"),
+    ]
+
+    @classmethod
+    def get_field_schema(cls) -> Dict[str, "FieldSchema"]:
+        from programgarden_core.models.field_binding import (
+            FieldSchema, FieldType, FieldCategory, ExpressionMode,
+        )
+        return {
+            "left": FieldSchema(
+                name="left",
+                type=FieldType.STRING,
+                description="i18n:fields.IfNode.left",
+                required=True,
+                expression_mode=ExpressionMode.BOTH,
+                category=FieldCategory.PARAMETERS,
+                placeholder="{{ nodes.account.balance }}",
+                example="{{ nodes.account.balance }}",
+                expected_type="any",
+            ),
+            "operator": FieldSchema(
+                name="operator",
+                type=FieldType.ENUM,
+                description="i18n:fields.IfNode.operator",
+                default="==",
+                enum_values=[
+                    "==", "!=", ">", ">=", "<", "<=",
+                    "in", "not_in",
+                    "contains", "not_contains",
+                    "is_empty", "is_not_empty",
+                ],
+                enum_labels={
+                    "==": "i18n:enums.if_operator.eq",
+                    "!=": "i18n:enums.if_operator.ne",
+                    ">": "i18n:enums.if_operator.gt",
+                    ">=": "i18n:enums.if_operator.gte",
+                    "<": "i18n:enums.if_operator.lt",
+                    "<=": "i18n:enums.if_operator.lte",
+                    "in": "i18n:enums.if_operator.in",
+                    "not_in": "i18n:enums.if_operator.not_in",
+                    "contains": "i18n:enums.if_operator.contains",
+                    "not_contains": "i18n:enums.if_operator.not_contains",
+                    "is_empty": "i18n:enums.if_operator.is_empty",
+                    "is_not_empty": "i18n:enums.if_operator.is_not_empty",
+                },
+                required=True,
+                expression_mode=ExpressionMode.FIXED_ONLY,
+                category=FieldCategory.PARAMETERS,
+            ),
+            "right": FieldSchema(
+                name="right",
+                type=FieldType.STRING,
+                description="i18n:fields.IfNode.right",
+                required=False,
+                expression_mode=ExpressionMode.BOTH,
+                category=FieldCategory.PARAMETERS,
+                placeholder="1000000",
+                example="1000000",
+                expected_type="any",
+                visible_when={
+                    "operator": [
+                        "==", "!=", ">", ">=", "<", "<=",
+                        "in", "not_in", "contains", "not_contains",
+                    ],
+                },
+            ),
+        }

{programgarden_core-1.2.0 → programgarden_core-1.3.0}/programgarden_core/registry/node_registry.py

@@ -76,7 +76,7 @@ class NodeTypeRegistry:
         """Register built-in node types"""
         # 지연 임포트로 순환 참조 방지
         from programgarden_core.nodes import (
-            StartNode, ThrottleNode, SplitNode, AggregateNode,
+            StartNode, ThrottleNode, SplitNode, AggregateNode, IfNode,
             OverseasStockBrokerNode, OverseasFuturesBrokerNode,
             # Market - Stock (해외주식)
             OverseasStockMarketDataNode, OverseasStockHistoricalDataNode,
@@ -110,7 +110,7 @@ class NodeTypeRegistry:
 
         node_classes = [
             # Infra
-            StartNode, ThrottleNode, SplitNode, AggregateNode,
+            StartNode, ThrottleNode, SplitNode, AggregateNode, IfNode,
             # Broker (상품별 분리)
             OverseasStockBrokerNode, OverseasFuturesBrokerNode,
             # Market - Stock (해외주식)

{programgarden_core-1.2.0 → programgarden_core-1.3.0}/pyproject.toml

@@ -5,7 +5,7 @@ authors = [
 homepage = "https://programgarden.com"
 requires-python = ">=3.12"
 name = "programgarden-core"
-version = "1.2.0"
+version = "1.3.0"
 description = "ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의"
 readme = "README.md"