programgarden 1.16.2__tar.gz → 1.18.0__tar.gz

{programgarden-1.16.2 → programgarden-1.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: programgarden
-Version: 1.16.2
+Version: 1.18.0
 Summary: ProgramGarden - 노드 기반 자동매매 DSL 실행 엔진
 Author: 프로그램동산
 Author-email: coding@programgarden.com
@@ -14,8 +14,8 @@ Requires-Dist: croniter (>=6.0.0,<7.0.0)
 Requires-Dist: fastembed (>=0.4.0)
 Requires-Dist: litellm (>=1.40.0)
 Requires-Dist: lxml (>=6.0.2,<7.0.0)
-Requires-Dist: programgarden-community (>=1.10.5,<2.0.0)
-Requires-Dist: programgarden-core (>=1.9.9,<2.0.0)
+Requires-Dist: programgarden-community (>=1.11.0,<2.0.0)
+Requires-Dist: programgarden-core (>=1.10.0,<2.0.0)
 Requires-Dist: programgarden-finance (>=1.4.4,<2.0.0)
 Requires-Dist: psutil (>=6.0.0,<7.0.0)
 Requires-Dist: psycopg2-binary (>=2.9.11,<3.0.0)
@@ -90,6 +90,24 @@ job = await pg.run_async(
 await job.stop()
 ```
 
+### Dry Run (워크플로우 검증용 모의 실행)
+
+실제 주문/알림/Realtime WebSocket 연결 없이 워크플로우를 검증합니다.
+
+- ScheduleNode / TradingHoursFilterNode → 1 cycle 후 즉시 종료
+- 주문 노드 → LS API 미호출, `{"order_id": "DRYRUN-<uuid>", "status": "simulated", ...}` 반환
+- Realtime 노드 → WebSocket 미개방, `{"status": "skipped_dry_run"}` 반환
+- Messaging 노드(Telegram 등) → no-op, `{"status": "simulated"}` 반환
+- 조회/백테스트 노드 → 기존 동작 유지 (실제 API 경로)
+
+```python
+job = await pg.run_async(
+    definition=workflow_definition,
+    context={"dry_run": True},
+    secrets={...},
+)
+```
+
 ### 워크플로우 정의 (JSON)
 
 ```json

{programgarden-1.16.2 → programgarden-1.18.0}/README.md

@@ -62,6 +62,24 @@ job = await pg.run_async(
 await job.stop()
 ```
 
+### Dry Run (워크플로우 검증용 모의 실행)
+
+실제 주문/알림/Realtime WebSocket 연결 없이 워크플로우를 검증합니다.
+
+- ScheduleNode / TradingHoursFilterNode → 1 cycle 후 즉시 종료
+- 주문 노드 → LS API 미호출, `{"order_id": "DRYRUN-<uuid>", "status": "simulated", ...}` 반환
+- Realtime 노드 → WebSocket 미개방, `{"status": "skipped_dry_run"}` 반환
+- Messaging 노드(Telegram 등) → no-op, `{"status": "simulated"}` 반환
+- 조회/백테스트 노드 → 기존 동작 유지 (실제 API 경로)
+
+```python
+job = await pg.run_async(
+    definition=workflow_definition,
+    context={"dry_run": True},
+    secrets={...},
+)
+```
+
 ### 워크플로우 정의 (JSON)
 
 ```json

{programgarden-1.16.2 → programgarden-1.18.0}/programgarden/__init__.py

@@ -80,7 +80,7 @@ except ImportError:
     # Community package not installed
     pass
 
-__version__ = "1.7.0"
+__version__ = "1.18.0"
 __all__ = [
     # Core
     "ProgramGarden",

{programgarden-1.16.2 → programgarden-1.18.0}/programgarden/client.py

@@ -83,6 +83,14 @@ class ProgramGarden:
             ...     secrets={"credential_id": {"appkey": "...", "appsecret": "..."}},
             ...     storage_dir="./my_data",
             ... )
+
+            # Dry run (검증용): 주문/Realtime/알림 노드 실제 호출 없이 시뮬레이션
+            >>> job = pg.run(
+            ...     workflow,
+            ...     context={"dry_run": True},
+            ...     wait=True,
+            ...     timeout=60,
+            ... )
         """
         # Parse resource_limits if provided
         limits = None

{programgarden-1.16.2 → programgarden-1.18.0}/programgarden/context.py

@@ -278,6 +278,19 @@ class ExecutionContext:
         db_dir.mkdir(parents=True, exist_ok=True)
         return str(db_dir / db_filename)
 
+    # === Dry Run ===
+
+    @property
+    def is_dry_run(self) -> bool:
+        """Workflow is running in dry_run mode.
+
+        When True, side-effectful nodes (주문/Realtime/알림) skip external calls
+        and return simulated responses. Query/백테스트 nodes still execute normally.
+
+        Enable via ``context_params={"dry_run": True}`` in ``pg.run_async``.
+        """
+        return bool(self.context_params.get("dry_run", False))
+
     # === DAG Index Building ===
 
     def _build_dag_index(

{programgarden-1.16.2 → programgarden-1.18.0}/programgarden/executor.py

@@ -364,7 +364,23 @@ class GenericNodeExecutor(NodeExecutorBase):
         except Exception as e:
             context.log("error", f"Failed to create node instance: {e}", node_id)
             return {"error": str(e)}
-        
+
+        # dry_run 가드: Messaging/Notification 노드는 no-op 반환
+        if context.is_dry_run:
+            try:
+                from programgarden_core.nodes.base import NodeCategory
+                node_category = getattr(node_instance, "category", None)
+                if node_category == NodeCategory.MESSAGING:
+                    context.log(
+                        "info",
+                        f"[dry_run] {node_type} skipped (messaging node)",
+                        node_id,
+                    )
+                    return {"status": "simulated", "dry_run": True}
+            except Exception:
+                # NodeCategory import 실패는 무시 — dry_run 가드가 동작 안 할 뿐
+                pass
+
         # execute() 메서드 호출
         if hasattr(node_instance, "execute"):
             try:
@@ -916,6 +932,25 @@ class ScheduleNodeExecutor(NodeExecutorBase):
                     itr = croniter(cron_expr, datetime.now(tz))
 
                 while cnt < count and context.is_running:
+                    # dry_run: 루프 진입 즉시 1회 emit 후 종료
+                    if context.is_dry_run:
+                        cnt += 1
+                        context.log(
+                            "info",
+                            f"[dry_run] Schedule tick #{cnt} (single cycle), exiting scheduler",
+                            node_id,
+                        )
+                        await context.emit_event(
+                            event_type="schedule_tick",
+                            source_node_id=node_id,
+                            data={
+                                "cron": cron_expr,
+                                "count": cnt,
+                                "triggered_at": datetime.now(tz).isoformat(),
+                                "dry_run": True,
+                            },
+                        )
+                        break
                     # M-6: max_duration_hours 초과 시 스케줄 종료
                     if (_time.monotonic() - start_mono) >= max_duration_sec:
                         context.log(
@@ -3800,14 +3835,24 @@ class RealAccountNodeExecutor(NodeExecutorBase):
         **kwargs,
     ) -> Dict[str, Any]:
         import sys
+
+        # dry_run: WebSocket 미개방, skip 반환
+        if context.is_dry_run:
+            context.log(
+                "warning",
+                f"[dry_run] {node_type} skipped (realtime WebSocket disabled)",
+                node_id,
+            )
+            return {"status": "skipped_dry_run", "dry_run": True}
+
         # 옵션 확인
         stay_connected = config.get("stay_connected", True)
         sync_interval_sec = config.get("sync_interval_sec", 60)
-        
-        
+
+
         # config에서 connection 확인 (자동 주입 또는 명시적 바인딩)
         broker_connection = config.get("connection")
-        
+
         # connection 없으면 에러 - 자동 주입 또는 명시적 바인딩 필요
         if not broker_connection:
             context.log("error", "RealAccountNode: connection이 자동 주입되지 않았습니다. 매칭되는 BrokerNode가 워크플로우에 있는지 확인하세요.", node_id)
@@ -4682,12 +4727,21 @@ class RealMarketDataNodeExecutor(NodeExecutorBase):
         **kwargs,
     ) -> Dict[str, Any]:
         from programgarden_core.exceptions import ValidationError, ConnectionError
-        
+
+        # dry_run: WebSocket 미개방, skip 반환
+        if context.is_dry_run:
+            context.log(
+                "warning",
+                f"[dry_run] {node_type} skipped (realtime WebSocket disabled)",
+                node_id,
+            )
+            return {"status": "skipped_dry_run", "dry_run": True}
+
         # ========================================
         # 1. BrokerNode connection 획득 (config 바인딩 필수)
         # ========================================
         broker_connection = config.get("connection")
-        
+
         # connection 없으면 에러 - 자동 주입 또는 명시적 바인딩 필요
         if not broker_connection:
             error_msg = (
@@ -5343,9 +5397,18 @@ class RealOrderEventNodeExecutor(NodeExecutorBase):
         context: ExecutionContext,
         **kwargs,
     ) -> Dict[str, Any]:
+        # dry_run: WebSocket 미개방, skip 반환
+        if context.is_dry_run:
+            context.log(
+                "warning",
+                f"[dry_run] {node_type} skipped (realtime WebSocket disabled)",
+                node_id,
+            )
+            return {"status": "skipped_dry_run", "dry_run": True}
+
         # 옵션 확인
         stay_connected = config.get("stay_connected", True)
-        
+
         # config에서 connection 확인 (자동 주입 또는 명시적 바인딩)
         broker_connection = config.get("connection")
 
@@ -10830,6 +10893,22 @@ class NewOrderNodeExecutor(NodeExecutorBase):
     ) -> Dict[str, Any]:
         """신규 주문 실행"""
 
+        # dry_run: LS API 미호출, 모의 응답 반환
+        if context.is_dry_run:
+            import uuid
+            order_id = f"DRYRUN-{uuid.uuid4()}"
+            context.log(
+                "info",
+                f"[dry_run] {node_type} simulated order → {order_id}",
+                node_id,
+            )
+            return {
+                "order_id": order_id,
+                "status": "simulated",
+                "dry_run": True,
+                "requested": config,
+            }
+
         # M-10: Risk halt 체크 - critical risk event로 주문 중단
         if context.is_risk_halted:
             context.log(
@@ -11566,6 +11645,22 @@ class ModifyOrderNodeExecutor(NodeExecutorBase):
     ) -> Dict[str, Any]:
         """주문 정정 실행"""
 
+        # dry_run: LS API 미호출, 모의 응답 반환
+        if context.is_dry_run:
+            import uuid
+            order_id = f"DRYRUN-{uuid.uuid4()}"
+            context.log(
+                "info",
+                f"[dry_run] {node_type} simulated modify → {order_id}",
+                node_id,
+            )
+            return {
+                "order_id": order_id,
+                "status": "simulated",
+                "dry_run": True,
+                "requested": config,
+            }
+
         # M-10: Risk halt 체크
         if context.is_risk_halted:
             context.log("warning", f"{node_type}: 위험 이벤트로 인해 주문 정정이 중단되었습니다", node_id)
@@ -11975,6 +12070,22 @@ class CancelOrderNodeExecutor(NodeExecutorBase):
     ) -> Dict[str, Any]:
         """주문 취소 실행"""
 
+        # dry_run: LS API 미호출, 모의 응답 반환
+        if context.is_dry_run:
+            import uuid
+            order_id = f"DRYRUN-{uuid.uuid4()}"
+            context.log(
+                "info",
+                f"[dry_run] {node_type} simulated cancel → {order_id}",
+                node_id,
+            )
+            return {
+                "order_id": order_id,
+                "status": "simulated",
+                "dry_run": True,
+                "requested": config,
+            }
+
         # === 1. Connection 확인 ===
         broker_connection = config.get("connection")
         if not broker_connection:

{programgarden-1.16.2 → programgarden-1.18.0}/pyproject.toml

@@ -5,7 +5,7 @@ authors = [
 homepage = "https://programgarden.com"
 requires-python = ">=3.12"
 name = "programgarden"
-version = "1.16.2"
+version = "1.18.0"
 description = "ProgramGarden - 노드 기반 자동매매 DSL 실행 엔진"
 readme = "README.md"
 
@@ -29,9 +29,9 @@ pytickersymbols = {version = ">=1.17.5", python = ">=3.12,<4.0"}
 aiosqlite = "^0.20.0"
 litellm = ">=1.40.0"
 fastembed = ">=0.4.0"
-programgarden-core = "^1.9.9"
+programgarden-core = "^1.10.0"
 programgarden-finance = "^1.4.4"
-programgarden-community = "^1.10.5"
+programgarden-community = "^1.11.0"
     
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.0.0"
@@ -42,11 +42,6 @@ fastapi = "^0.128.0"
 uvicorn = "^0.40.0"
 
 
-[[tool.poetry.source]]
-name = "testpypi"
-url = "https://test.pypi.org/simple/"
-priority = "supplemental"
-
 [build-system]
 requires = ["poetry-core>=2.0.0,<3.0.0"]
 build-backend = "poetry.core.masonry.api"