programgarden-community 2.1.0__tar.gz → 2.3.0__tar.gz

{programgarden_community-2.1.0 → programgarden_community-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden-community
-Version: 2.1.0
+Version: 2.3.0
 Summary: ProgramGarden Community - 전략 플러그인 모음
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산
@@ -18,7 +18,7 @@ Provides-Extra: portfolio
 Provides-Extra: quant-all
 Provides-Extra: xlsx
 Requires-Dist: packaging (>=23) ; extra == "portfolio" or extra == "quant-all"
-Requires-Dist: programgarden-core (>=2.1.0,<3.0.0)
+Requires-Dist: programgarden-core (>=2.5.0,<3.0.0)
 Requires-Dist: pypdf (>=4.0.0)
 Requires-Dist: pyportfolioopt (>=1.6,<2) ; (python_version < "3.15") and (extra == "portfolio" or extra == "quant-all")
 Requires-Dist: quantstats (>=0.0.81,<0.1) ; extra == "perf" or extra == "quant-all"
@@ -119,13 +119,12 @@ poetry add programgarden-community
 | DynamicStopLoss | ATR 기반 동적 손절 |
 | LevelTouch | 레벨 터치/돌파/역할전환 감지 |
 
-### 커뮤니티 노드 (4개)
+### 커뮤니티 노드 (2개)
 
 | 노드 | 카테고리 | 설명 |
 |------|----------|------|
 | TelegramNode | messaging | Telegram Bot API 메시지 전송 |
-| FearGreedIndexNode | market | CNN Fear & Greed Index 조회 |
-| FileReaderNode | data | 파일 파싱 (PDF, TXT, CSV, JSON, MD, DOCX, XLSX) |
+| PerformanceReportNode | analysis | 성과/리스크 리포트 (Sharpe, Sortino, drawdown, CAGR, beta) |
 
 ## 사용법
 

{programgarden_community-2.1.0 → programgarden_community-2.3.0}/README.md

@@ -92,13 +92,12 @@ poetry add programgarden-community
 | DynamicStopLoss | ATR 기반 동적 손절 |
 | LevelTouch | 레벨 터치/돌파/역할전환 감지 |
 
-### 커뮤니티 노드 (4개)
+### 커뮤니티 노드 (2개)
 
 | 노드 | 카테고리 | 설명 |
 |------|----------|------|
 | TelegramNode | messaging | Telegram Bot API 메시지 전송 |
-| FearGreedIndexNode | market | CNN Fear & Greed Index 조회 |
-| FileReaderNode | data | 파일 파싱 (PDF, TXT, CSV, JSON, MD, DOCX, XLSX) |
+| PerformanceReportNode | analysis | 성과/리스크 리포트 (Sharpe, Sortino, drawdown, CAGR, beta) |
 
 ## 사용법
 

programgarden_community-2.3.0/programgarden_community/nodes/__init__.py

@@ -0,0 +1,18 @@
+"""
+ProgramGarden Community - 커뮤니티 노드
+
+커뮤니티에서 기여한 커스텀 노드 타입.
+- messaging: TelegramNode 등 알림/메시징 노드
+- analysis: PerformanceReportNode 등 성과 분석 노드
+
+사용 방법:
+    from programgarden_community.nodes import TelegramNode, PerformanceReportNode
+"""
+
+from programgarden_community.nodes.messaging import TelegramNode
+from programgarden_community.nodes.analysis import PerformanceReportNode
+
+__all__ = [
+    "TelegramNode",
+    "PerformanceReportNode",
+]

{programgarden_community-2.1.0 → programgarden_community-2.3.0}/programgarden_community/nodes/messaging/telegram.py

@@ -46,6 +46,17 @@ class TelegramNode(BaseMessagingNode):
     """
     
     type: Literal["TelegramNode"] = "TelegramNode"
+
+    # 연결(자격증명) 선언 — 챗봇/편집기/검증기 공용. 텔레그램 봇 토큰은 발송에 필요하다.
+    _connection: ClassVar[Dict[str, Any]] = {
+        "purpose": "notify",
+        "need": "run",
+        "when": "always",
+        "label_key": "connection.TelegramNode.label",
+        "presets": [],
+        "missing": "draft",
+    }
+
     description: str = "Send Telegram messages using a registered bot token and receiving chat ID; key-free drafts can be saved before linking credentials."
     
     # 노드 아이콘 (텔레그램 로고)

{programgarden_community-2.1.0 → programgarden_community-2.3.0}/programgarden_community/nodes_registry.py

@@ -46,40 +46,6 @@ def register_all_nodes() -> None:
             # 이미 등록된 경우 무시 (중복 호출 방지)
             pass
 
-    # === Market Nodes ===
-    from programgarden_community.nodes.market import FearGreedIndexNode
-
-    market_nodes = [
-        FearGreedIndexNode,
-    ]
-
-    for node_class in market_nodes:
-        try:
-            registry.register_community(
-                node_class,
-                source="community",
-                trust_level="community",
-            )
-        except ValueError as e:
-            pass
-
-    # === Data Nodes ===
-    from programgarden_community.nodes.data import FileReaderNode
-
-    data_nodes = [
-        FileReaderNode,
-    ]
-
-    for node_class in data_nodes:
-        try:
-            registry.register_community(
-                node_class,
-                source="community",
-                trust_level="community",
-            )
-        except ValueError as e:
-            pass
-
     # === Analysis Nodes ===
     from programgarden_community.nodes.analysis import PerformanceReportNode
 
@@ -109,18 +75,6 @@ def get_community_node_list() -> list:
             "description": "Send messages via Telegram Bot API",
             "requires_credential": True,
         },
-        {
-            "type": "FearGreedIndexNode",
-            "category": "market",
-            "description": "CNN Fear & Greed Index (0=Extreme Fear, 100=Extreme Greed)",
-            "requires_credential": False,
-        },
-        {
-            "type": "FileReaderNode",
-            "category": "data",
-            "description": "Read and parse files (PDF, TXT, CSV, JSON, MD)",
-            "requires_credential": False,
-        },
         {
             "type": "PerformanceReportNode",
             "category": "analysis",

{programgarden_community-2.1.0 → programgarden_community-2.3.0}/pyproject.toml

@@ -5,7 +5,7 @@ authors = [
 homepage = "https://programgarden.com"
 requires-python = ">=3.12"
 name = "programgarden-community"
-version = "2.1.0"
+version = "2.3.0"
 license = "AGPL-3.0-or-later"
 description = "ProgramGarden Community - 전략 플러그인 모음"
 readme = "README.md"
@@ -16,7 +16,7 @@ packages = [
 ]
 
 [tool.poetry.dependencies]
-programgarden-core = "^2.1.0"
+programgarden-core = "^2.5.0"
 pypdf = ">=4.0.0"
 # Optional heavy quant deps (extras). 3.14 wheels validated (plan §1.3).
 # Only pyportfolioopt carries a python<3.15 marker to fence scikit-base (hard-capped

programgarden_community-2.1.0/programgarden_community/nodes/__init__.py

@@ -1,23 +0,0 @@
-"""
-ProgramGarden Community - 커뮤니티 노드
-
-커뮤니티에서 기여한 커스텀 노드 타입.
-- messaging: TelegramNode 등 알림/메시징 노드
-- market: FearGreedIndexNode 등 외부 시장 데이터 노드
-- data: FileReaderNode 등 데이터 처리 노드
-
-사용 방법:
-    from programgarden_community.nodes import TelegramNode, FearGreedIndexNode, FileReaderNode
-"""
-
-from programgarden_community.nodes.messaging import TelegramNode
-from programgarden_community.nodes.market import FearGreedIndexNode
-from programgarden_community.nodes.data import FileReaderNode
-from programgarden_community.nodes.analysis import PerformanceReportNode
-
-__all__ = [
-    "TelegramNode",
-    "FearGreedIndexNode",
-    "FileReaderNode",
-    "PerformanceReportNode",
-]

programgarden_community-2.1.0/programgarden_community/nodes/data/__init__.py

@@ -1,14 +0,0 @@
-"""
-ProgramGarden Community - 데이터 노드
-
-파일 읽기/파싱 등 데이터 처리 노드.
-
-사용 방법:
-    from programgarden_community.nodes.data import FileReaderNode
-"""
-
-from programgarden_community.nodes.data.file_reader import FileReaderNode
-
-__all__ = [
-    "FileReaderNode",
-]

programgarden_community-2.1.0/programgarden_community/nodes/data/_parsers.py

@@ -1,343 +0,0 @@
-"""
-FileReaderNode 내부 파서 모듈
-
-포맷별 파일 파싱 함수. 외부에서 직접 사용하지 않음.
-각 파서는 (text, data, extra_metadata) 튜플을 반환합니다.
-"""
-
-import csv
-import io
-import json
-from typing import Any, Dict, List, Optional, Tuple
-
-
-def parse_pdf(
-    file_bytes: bytes,
-    pages: Optional[str] = None,
-    extract_tables: bool = False,
-) -> Tuple[str, Any, Dict[str, Any]]:
-    """
-    PDF 파싱 (pypdf 사용)
-
-    Args:
-        file_bytes: PDF 파일 바이트
-        pages: 페이지 범위 ("1-5", "1,3,5", None=전체)
-        extract_tables: 테이블 추출 여부 (pdfplumber 필요)
-
-    Returns:
-        (text, data, extra_metadata)
-    """
-    try:
-        from pypdf import PdfReader
-    except ImportError:
-        raise ImportError(
-            "PDF 파싱에 pypdf가 필요합니다. "
-            "설치: pip install pypdf"
-        )
-
-    reader = PdfReader(io.BytesIO(file_bytes))
-    total_pages = len(reader.pages)
-
-    # 페이지 범위 파싱
-    page_indices = _parse_page_range(pages, total_pages)
-
-    # 텍스트 추출
-    texts = []
-    for idx in page_indices:
-        page = reader.pages[idx]
-        text = page.extract_text() or ""
-        texts.append(text)
-
-    full_text = "\n".join(texts)
-
-    # 테이블 추출 (pdfplumber)
-    table_data = None
-    if extract_tables:
-        table_data = _extract_pdf_tables(file_bytes, page_indices)
-
-    extra = {
-        "page_count": total_pages,
-        "extracted_pages": len(page_indices),
-    }
-
-    return full_text, table_data, extra
-
-
-def _parse_page_range(pages: Optional[str], total: int) -> List[int]:
-    """
-    페이지 범위 문자열 → 0-based 인덱스 리스트
-
-    Examples:
-        "1-5" → [0,1,2,3,4]
-        "1,3,5" → [0,2,4]
-        "2-4,7" → [1,2,3,6]
-        None → [0..total-1]
-    """
-    if not pages:
-        return list(range(total))
-
-    indices = set()
-    for part in pages.split(","):
-        part = part.strip()
-        if "-" in part:
-            start_str, end_str = part.split("-", 1)
-            start = max(1, int(start_str.strip()))
-            end = min(total, int(end_str.strip()))
-            for i in range(start, end + 1):
-                indices.add(i - 1)  # 0-based
-        else:
-            page_num = int(part)
-            if 1 <= page_num <= total:
-                indices.add(page_num - 1)
-
-    return sorted(indices)
-
-
-def _extract_pdf_tables(
-    file_bytes: bytes, page_indices: List[int]
-) -> Optional[List[List[List[str]]]]:
-    """pdfplumber로 PDF 테이블 추출"""
-    try:
-        import pdfplumber
-    except ImportError:
-        raise ImportError(
-            "PDF 테이블 추출에 pdfplumber가 필요합니다. "
-            "설치: pip install pdfplumber"
-        )
-
-    tables = []
-    with pdfplumber.open(io.BytesIO(file_bytes)) as pdf:
-        for idx in page_indices:
-            if idx < len(pdf.pages):
-                page_tables = pdf.pages[idx].extract_tables()
-                if page_tables:
-                    tables.extend(page_tables)
-
-    return tables if tables else None
-
-
-def parse_txt(
-    file_bytes: bytes,
-    encoding: str = "utf-8",
-) -> Tuple[str, Any, Dict[str, Any]]:
-    """TXT/MD 파싱"""
-    text = file_bytes.decode(encoding)
-    line_count = text.count("\n") + (1 if text and not text.endswith("\n") else 0)
-    return text, None, {"line_count": line_count}
-
-
-def parse_csv(
-    file_bytes: bytes,
-    encoding: str = "utf-8",
-    delimiter: str = ",",
-    has_header: bool = True,
-) -> Tuple[str, Any, Dict[str, Any]]:
-    """CSV 파싱 → 구조화 데이터 (list[dict]) + 원본 텍스트"""
-    text = file_bytes.decode(encoding)
-    reader = csv.reader(io.StringIO(text), delimiter=delimiter)
-    rows = list(reader)
-
-    if not rows:
-        return text, [], {"row_count": 0, "column_count": 0}
-
-    if has_header and len(rows) > 1:
-        headers = rows[0]
-        data = [dict(zip(headers, row)) for row in rows[1:]]
-        row_count = len(data)
-    elif has_header and len(rows) == 1:
-        # 헤더만 있는 경우
-        data = []
-        row_count = 0
-    else:
-        data = rows
-        row_count = len(rows)
-
-    column_count = len(rows[0]) if rows else 0
-
-    return text, data, {"row_count": row_count, "column_count": column_count}
-
-
-def parse_json(
-    file_bytes: bytes,
-    encoding: str = "utf-8",
-) -> Tuple[str, Any, Dict[str, Any]]:
-    """JSON 파싱 → 파싱된 객체 + 원본 텍스트"""
-    text = file_bytes.decode(encoding)
-    data = json.loads(text)
-
-    extra: Dict[str, Any] = {}
-    if isinstance(data, list):
-        extra["item_count"] = len(data)
-    elif isinstance(data, dict):
-        extra["key_count"] = len(data)
-
-    return text, data, extra
-
-
-def parse_docx(
-    file_bytes: bytes,
-) -> Tuple[str, Any, Dict[str, Any]]:
-    """
-    DOCX 파싱 (python-docx 사용)
-
-    Returns:
-        (text, data, extra_metadata)
-        - text: 전체 문단 텍스트 (줄바꿈 연결)
-        - data: 테이블 목록 (list[list[list[str]]]) 또는 None
-        - extra_metadata: paragraph_count, table_count
-    """
-    try:
-        from docx import Document
-    except ImportError:
-        raise ImportError(
-            "DOCX 파싱에 python-docx가 필요합니다. "
-            "설치: pip install python-docx"
-        )
-
-    doc = Document(io.BytesIO(file_bytes))
-
-    # 문단 텍스트 추출
-    paragraphs = [p.text for p in doc.paragraphs]
-    full_text = "\n".join(paragraphs)
-
-    # 테이블 추출
-    tables = []
-    for table in doc.tables:
-        rows = []
-        for row in table.rows:
-            rows.append([cell.text for cell in row.cells])
-        tables.append(rows)
-
-    table_data = tables if tables else None
-
-    extra = {
-        "paragraph_count": len(paragraphs),
-        "table_count": len(doc.tables),
-    }
-
-    return full_text, table_data, extra
-
-
-def parse_xlsx(
-    file_bytes: bytes,
-    sheet_name: Optional[str] = None,
-) -> Tuple[str, Any, Dict[str, Any]]:
-    """
-    XLSX 파싱 (openpyxl 사용)
-
-    Args:
-        file_bytes: XLSX 파일 바이트
-        sheet_name: 시트명 (None=활성 시트)
-
-    Returns:
-        (text, data, extra_metadata)
-        - text: CSV 형식 텍스트
-        - data: list[dict] (첫 행을 헤더로 사용) 또는 list[list]
-        - extra_metadata: sheet_name, row_count, column_count, sheet_names
-    """
-    try:
-        from openpyxl import load_workbook
-    except ImportError:
-        raise ImportError(
-            "XLSX 파싱에 openpyxl이 필요합니다. "
-            "설치: pip install openpyxl"
-        )
-
-    wb = load_workbook(io.BytesIO(file_bytes), read_only=True, data_only=True)
-    sheet_names = wb.sheetnames
-
-    if sheet_name and sheet_name in sheet_names:
-        ws = wb[sheet_name]
-    else:
-        ws = wb.active
-        sheet_name = ws.title
-
-    # 모든 행 읽기
-    rows = []
-    for row in ws.iter_rows(values_only=True):
-        rows.append([str(cell) if cell is not None else "" for cell in row])
-
-    wb.close()
-
-    if not rows:
-        return "", [], {
-            "sheet_name": sheet_name,
-            "row_count": 0,
-            "column_count": 0,
-            "sheet_names": sheet_names,
-        }
-
-    # 첫 행을 헤더로 사용
-    headers = rows[0]
-    column_count = len(headers)
-
-    if len(rows) > 1:
-        data = [dict(zip(headers, row)) for row in rows[1:]]
-        row_count = len(data)
-    else:
-        data = []
-        row_count = 0
-
-    # CSV 형식 텍스트 생성
-    text_lines = [",".join(row) for row in rows]
-    text = "\n".join(text_lines)
-
-    extra = {
-        "sheet_name": sheet_name,
-        "row_count": row_count,
-        "column_count": column_count,
-        "sheet_names": sheet_names,
-    }
-
-    return text, data, extra
-
-
-# 포맷 → 확장자 매핑
-EXTENSION_MAP = {
-    ".pdf": "pdf",
-    ".txt": "txt",
-    ".csv": "csv",
-    ".json": "json",
-    ".md": "md",
-    ".docx": "docx",
-    ".xlsx": "xlsx",
-}
-
-# PDF 매직 바이트
-_PDF_MAGIC = b"%PDF-"
-
-
-def detect_format(
-    file_name: Optional[str] = None,
-    file_path: Optional[str] = None,
-    file_bytes: Optional[bytes] = None,
-) -> str:
-    """
-    파일 포맷 자동 감지
-
-    우선순위:
-    1. file_name 확장자
-    2. file_path 확장자
-    3. 매직 바이트 (PDF)
-    4. txt fallback
-    """
-    import os
-
-    # 1. file_name 확장자
-    if file_name:
-        ext = os.path.splitext(file_name)[1].lower()
-        if ext in EXTENSION_MAP:
-            return EXTENSION_MAP[ext]
-
-    # 2. file_path 확장자
-    if file_path:
-        ext = os.path.splitext(file_path)[1].lower()
-        if ext in EXTENSION_MAP:
-            return EXTENSION_MAP[ext]
-
-    # 3. 매직 바이트
-    if file_bytes and file_bytes[:5] == _PDF_MAGIC:
-        return "pdf"
-
-    # 4. fallback
-    return "txt"