contracts-hj3415 0.2.0__tar.gz → 0.5.0__tar.gz

{contracts_hj3415-0.2.0 → contracts_hj3415-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: contracts-hj3415
-Version: 0.2.0
+Version: 0.5.0
 Summary: DTO pakages for hj3415
 Keywords: example,demo
 Author-email: Hyungjin Kim <hj3415@gmail.com>
@@ -10,6 +10,5 @@ Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Typing :: Typed
 License-File: LICENSE
-Requires-Dist: pydantic>=2.7
 
 

{contracts_hj3415-0.2.0 → contracts_hj3415-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "contracts-hj3415"                          # PyPI 이름 (하이픈 허용)
-version = "0.2.0"
+version = "0.5.0"
 description = "DTO pakages for hj3415"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -18,9 +18,26 @@ classifiers = [
 ]
 
 dependencies = [
-  "pydantic>=2.7",
 ]
 
 [tool.flit.module]
-name = "contracts"
-path = "src/contracts"
+name = "contracts_hj3415"
+path = "src/contracts_hj3415"
+
+
+[tool.pyright]
+typeCheckingMode = "strict"
+
+pythonVersion = "3.11"
+pythonPlatform = "All"
+
+reportMissingImports = true
+reportMissingTypeStubs = false
+
+exclude = [
+  "**/__pycache__",
+  ".venv",
+  "build",
+  "tests",
+  "dist",
+]

contracts_hj3415-0.5.0/src/contracts_hj3415/analysis/features.py

@@ -0,0 +1,34 @@
+# contracts_hj3415/analysis/features.py
+from __future__ import annotations
+
+from typing import Any, Literal, TypedDict
+
+from contracts_hj3415.nfs.types import Endpoint, MetricKey
+
+AggKind = Literal["sum", "avg"]
+PeriodKind = Literal["y", "q"]
+
+
+class FeatureValue(TypedDict):
+    value: float | None
+    picked: str | None
+    from_kind: PeriodKind | None
+
+
+class MetricDiagnostics(TypedDict):
+    ok: bool
+    reason: str | None
+    details: dict[str, Any]  # pyright: ignore[reportExplicitAny]
+
+
+class LatestAndTtm(TypedDict):
+    latest_y: FeatureValue
+    latest_q: FeatureValue
+    ttm_q: FeatureValue
+    chosen: FeatureValue
+    diag: MetricDiagnostics
+
+
+class FeaturesPayload(TypedDict):
+    endpoint: Endpoint
+    blocks: dict[MetricKey, LatestAndTtm]

contracts_hj3415-0.5.0/src/contracts_hj3415/analysis/payloads.py

@@ -0,0 +1,8 @@
+# contracts_hj3415/analysis/payloads.py
+from __future__ import annotations
+
+from typing import TypeAlias
+
+from contracts_hj3415.analysis.features import FeaturesPayload
+
+AnalysisPayloadDTO: TypeAlias = FeaturesPayload

contracts_hj3415-0.5.0/src/contracts_hj3415/analysis/types.py

@@ -0,0 +1,9 @@
+# contracts_hj3415/analysis/types.py
+from __future__ import annotations
+
+from typing import Literal, TypeAlias
+
+AnalysisService: TypeAlias = Literal[
+    "features",
+    "red",
+]

contracts_hj3415-0.5.0/src/contracts_hj3415/common/envelope.py

@@ -0,0 +1,46 @@
+# contracts_hj3415/common/envelope.py
+from __future__ import annotations
+
+from datetime import datetime
+from typing import TypedDict
+
+from contracts_hj3415.analysis.payloads import AnalysisPayloadDTO
+from contracts_hj3415.common.types import EnvelopeMeta, Topic
+
+# topic별 payload 유니온
+from contracts_hj3415.nfs.payloads import NfsPayloadDTO
+from contracts_hj3415.universe.payloads import UniversePayloadDTO
+
+
+class EnvelopeDTO(TypedDict):
+    """
+    모노레포 공통 운반 상자 DTO
+
+    - key: topic별 식별자(문자열). 예)
+      - nfs: "005930"
+      - universe: "krx300"
+      - analysis: "red:005930"
+    """
+
+    topic: Topic
+    key: str
+    asof: datetime
+    payload: NfsPayloadDTO | UniversePayloadDTO | AnalysisPayloadDTO
+    meta: EnvelopeMeta
+
+
+def make_envelope(
+    *,
+    topic: Topic,
+    key: str,
+    asof: datetime,
+    payload: NfsPayloadDTO | UniversePayloadDTO | AnalysisPayloadDTO,
+    meta: EnvelopeMeta | None = None,
+) -> EnvelopeDTO:
+    return {
+        "topic": topic,
+        "key": key,
+        "asof": asof,
+        "payload": payload,
+        "meta": meta or EnvelopeMeta(),
+    }

contracts_hj3415-0.5.0/src/contracts_hj3415/common/types.py

@@ -0,0 +1,17 @@
+# contracts_hj3415/common/types.py
+from __future__ import annotations
+
+from typing import Literal, TypeAlias, TypedDict
+
+Topic: TypeAlias = Literal["nfs", "universe", "analysis"]
+
+CodeKey: TypeAlias = str
+
+Num: TypeAlias = float | int | None
+
+
+class EnvelopeMeta(TypedDict, total=False):
+    source: str  # "scraper2" / "krx" / "analyser2" / ...
+    trace_id: str
+    note: str
+    tags: list[str]

contracts_hj3415-0.5.0/src/contracts_hj3415/nfs/c101.py

@@ -0,0 +1,28 @@
+# contracts_hj3415/nfs/c101.py
+from __future__ import annotations
+
+from typing import Any, Literal, TypeAlias
+
+from contracts_hj3415.common.types import Num
+from typing_extensions import TypedDict
+
+from .types import MetricKey, PeriodKey
+
+Scalar: TypeAlias = str | float | int | None
+ValuesMap: TypeAlias = dict[PeriodKey, Num]
+
+
+class C101Blocks(TypedDict):
+    요약: dict[str, Scalar]
+    시세: dict[str, Scalar]
+    주주현황: list[dict[str, Scalar]]
+    기업개요: dict[str, Scalar]
+    펀더멘털: dict[MetricKey, ValuesMap]
+
+    어닝서프라이즈: dict[str, Any]  # pyright: ignore[reportExplicitAny]
+    연간컨센서스: dict[MetricKey, ValuesMap]
+
+
+class C101Payload(TypedDict):
+    endpoint: Literal["c101"]
+    blocks: C101Blocks

contracts_hj3415-0.5.0/src/contracts_hj3415/nfs/c103.py

@@ -0,0 +1,35 @@
+# contracts_hj3415/nfs/c103.py
+from __future__ import annotations
+
+from typing import Literal, TypeAlias
+
+from contracts_hj3415.common.types import Num
+from typing_extensions import TypedDict
+
+from .types import MetricKey, PeriodKey
+
+C103ValuesMap: TypeAlias = dict[PeriodKey, Num]
+
+
+class C103Blocks(TypedDict):
+    손익계산서y: dict[MetricKey, C103ValuesMap]
+    손익계산서q: dict[MetricKey, C103ValuesMap]
+    재무상태표y: dict[MetricKey, C103ValuesMap]
+    재무상태표q: dict[MetricKey, C103ValuesMap]
+    현금흐름표y: dict[MetricKey, C103ValuesMap]
+    현금흐름표q: dict[MetricKey, C103ValuesMap]
+
+
+class C103Labels(TypedDict):
+    손익계산서y: dict[MetricKey, str]
+    손익계산서q: dict[MetricKey, str]
+    재무상태표y: dict[MetricKey, str]
+    재무상태표q: dict[MetricKey, str]
+    현금흐름표y: dict[MetricKey, str]
+    현금흐름표q: dict[MetricKey, str]
+
+
+class C103Payload(TypedDict):
+    endpoint: Literal["c103"]
+    blocks: C103Blocks
+    labels: C103Labels

contracts_hj3415-0.5.0/src/contracts_hj3415/nfs/c104.py

@@ -0,0 +1,40 @@
+# contracts_hj3415/nfs/c104.py
+from __future__ import annotations
+from typing import Literal, TypeAlias
+
+from contracts_hj3415.common.types import Num
+from typing_extensions import TypedDict
+from .types import MetricKey, PeriodKey
+
+C104ValuesMap:TypeAlias = dict[PeriodKey, Num]
+
+class C104Blocks(TypedDict):
+    수익성y: dict[MetricKey, C104ValuesMap]
+    성장성y: dict[MetricKey, C104ValuesMap]
+    안정성y: dict[MetricKey, C104ValuesMap]
+    활동성y: dict[MetricKey, C104ValuesMap]
+    가치분석y: dict[MetricKey, C104ValuesMap]
+    수익성q: dict[MetricKey, C104ValuesMap]
+    성장성q: dict[MetricKey, C104ValuesMap]
+    안정성q: dict[MetricKey, C104ValuesMap]
+    활동성q: dict[MetricKey, C104ValuesMap]
+    가치분석q: dict[MetricKey, C104ValuesMap]
+
+
+class C104Labels(TypedDict):
+    수익성y: dict[MetricKey, str]
+    성장성y: dict[MetricKey, str]
+    안정성y: dict[MetricKey, str]
+    활동성y: dict[MetricKey, str]
+    가치분석y: dict[MetricKey, str]
+    수익성q: dict[MetricKey, str]
+    성장성q: dict[MetricKey, str]
+    안정성q: dict[MetricKey, str]
+    활동성q: dict[MetricKey, str]
+    가치분석q: dict[MetricKey, str]
+
+
+class C104Payload(TypedDict):
+    endpoint: Literal["c104"]
+    blocks: C104Blocks
+    labels: C104Labels

contracts_hj3415-0.5.0/src/contracts_hj3415/nfs/c106.py

@@ -0,0 +1,27 @@
+# contracts_hj3415/nfs/c106.py
+from __future__ import annotations
+
+from typing import Literal, TypeAlias
+
+from contracts_hj3415.common.types import CodeKey, Num
+from typing_extensions import TypedDict
+
+from .types import MetricKey
+
+C106ValuesMap: TypeAlias = dict[CodeKey, Num]
+
+
+class C106Blocks(TypedDict):
+    y: dict[MetricKey, C106ValuesMap]
+    q: dict[MetricKey, C106ValuesMap]
+
+
+class C106Labels(TypedDict):
+    y: dict[MetricKey, str]
+    q: dict[MetricKey, str]
+
+
+class C106Payload(TypedDict):
+    endpoint: Literal["c106"]
+    blocks: C106Blocks
+    labels: C106Labels

contracts_hj3415-0.5.0/src/contracts_hj3415/nfs/c108.py

@@ -0,0 +1,19 @@
+# contracts_hj3415/nfs/c108.py
+from __future__ import annotations
+
+from typing import Literal, TypeAlias
+
+from typing_extensions import TypedDict
+
+from .types import MetricKey
+
+C108ValuesMap: TypeAlias = dict[MetricKey, str | int | None]
+
+
+class C108Blocks(TypedDict):
+    리포트: list[C108ValuesMap]
+
+
+class C108Payload(TypedDict):
+    endpoint: Literal["c108"]
+    blocks: C108Blocks

contracts_hj3415-0.5.0/src/contracts_hj3415/nfs/payloads.py

@@ -0,0 +1,14 @@
+# contracts_hj3415/nfs/payloads.py
+from __future__ import annotations
+
+from typing import TypeAlias
+
+from contracts_hj3415.nfs.c101 import C101Payload
+from contracts_hj3415.nfs.c103 import C103Payload
+from contracts_hj3415.nfs.c104 import C104Payload
+from contracts_hj3415.nfs.c106 import C106Payload
+from contracts_hj3415.nfs.c108 import C108Payload
+
+NfsPayloadDTO: TypeAlias = (
+    C101Payload | C103Payload | C104Payload | C106Payload | C108Payload
+)

contracts_hj3415-0.5.0/src/contracts_hj3415/nfs/types.py

@@ -0,0 +1,49 @@
+# contracts_hj3415/nfs/types.py
+from __future__ import annotations
+
+from typing import Literal, TypeAlias
+
+C101BlockKey: TypeAlias = Literal[
+    "요약", "시세", "주주현황", "기업개요", "펀더멘털", "어닝서프라이즈", "연간컨센서스"
+]
+
+C103BlockKey: TypeAlias = Literal[
+    "손익계산서y",
+    "손익계산서q",
+    "재무상태표y",
+    "재무상태표q",
+    "현금흐름표y",
+    "현금흐름표q",
+]
+
+C104BlockKey: TypeAlias = Literal[
+    "수익성y",
+    "성장성y",
+    "안정성y",
+    "활동성y",
+    "가치분석y",
+    "수익성q",
+    "성장성q",
+    "안정성q",
+    "활동성q",
+    "가치분석q",
+]
+
+C106BlockKey: TypeAlias = Literal[
+    "y",
+    "q",
+]
+
+C108BlockKey: TypeAlias = Literal["리포트",]
+
+
+# General====================
+
+MetricKey: TypeAlias = str
+PeriodKey: TypeAlias = str
+
+Endpoint: TypeAlias = Literal["c101", "c103", "c104", "c106", "c108"]
+
+BlockKey: TypeAlias = (
+    C101BlockKey | C103BlockKey | C104BlockKey | C106BlockKey | C108BlockKey
+)

contracts_hj3415-0.5.0/src/contracts_hj3415/universe/krx300.py

@@ -0,0 +1,20 @@
+# contracts_hj3415/universe/dto.py
+from __future__ import annotations
+
+from typing import Any, TypedDict
+
+from contracts_hj3415.common.types import CodeKey
+from contracts_hj3415.universe.types import Universe
+
+
+class UniverseItem(TypedDict, total=False):
+    code: CodeKey
+    name: str
+    market: str
+    meta: dict[str, Any]  # pyright: ignore[reportExplicitAny]
+
+
+class KRX300Payload(TypedDict):
+    source: str
+    universe: Universe
+    blocks: list[UniverseItem]

contracts_hj3415-0.5.0/src/contracts_hj3415/universe/payloads.py

@@ -0,0 +1,8 @@
+# contracts_hj3415/universe/payloads.py
+from __future__ import annotations
+
+from typing import TypeAlias
+
+from contracts_hj3415.universe.krx300 import KRX300Payload
+
+UniversePayloadDTO: TypeAlias = KRX300Payload

contracts_hj3415-0.5.0/src/contracts_hj3415/universe/types.py

@@ -0,0 +1,6 @@
+# contracts_hj3415/universe/types.py
+from __future__ import annotations
+
+from typing import Literal, TypeAlias
+
+Universe: TypeAlias = Literal["KRX300",]

contracts_hj3415-0.2.0/src/contracts/nfs/c101.py

@@ -1,52 +0,0 @@
-# contracts/nfs/c101.py
-from __future__ import annotations
-
-from pydantic import BaseModel, Field
-from typing import Optional
-
-
-class C101DTO(BaseModel):
-    # 기본 식별 정보
-    종목명: str
-    코드: str
-    날짜: str
-    업종: str
-
-    # 재무 지표
-    eps: Optional[int] = None
-    bps: Optional[int] = None
-    per: Optional[float] = None
-    업종per: Optional[float] = None
-    pbr: Optional[float] = None
-    배당수익률: Optional[float] = None
-
-    # 주가 정보
-    주가: Optional[int] = None
-    전일대비: Optional[int] = None
-    수익률: Optional[float] = None
-
-    최고52: Optional[int] = None
-    최저52: Optional[int] = None
-
-    거래량: Optional[int] = None
-    거래대금: Optional[int] = None
-    시가총액: Optional[int] = None
-
-    베타52주: Optional[float] = None
-
-    발행주식: Optional[int] = None
-    유동비율: Optional[float] = None
-    외국인지분율: Optional[float] = None
-
-    # 기간 수익률
-    수익률1M: Optional[float] = None
-    수익률3M: Optional[float] = None
-    수익률6M: Optional[float] = None
-    수익률1Y: Optional[float] = None
-
-    # 텍스트 정보
-    개요: str = ""
-
-    class Config:
-        # 한글 필드명을 그대로 쓰기 위한 옵션
-        populate_by_name = True

contracts_hj3415-0.2.0/src/contracts/nfs/c103.py

@@ -1,19 +0,0 @@
-# contracts/nfs/c103.py
-from __future__ import annotations
-
-from pydantic import BaseModel, ConfigDict, Field
-
-Num = float | int | None
-Row = dict[str, Num]                 # 예: {"2020/12": 1.0, "전년대비": 2.0, ...}
-ItemsMap = dict[str, Row]            # 예: {"매출액(수익)": {...}, ...}
-
-class C103DTO(BaseModel):
-    코드: str
-    손익계산서y: ItemsMap = Field(default_factory=dict)
-    손익계산서q: ItemsMap = Field(default_factory=dict)
-    재무상태표y: ItemsMap = Field(default_factory=dict)
-    재무상태표q: ItemsMap = Field(default_factory=dict)
-    현금흐름표y: ItemsMap = Field(default_factory=dict)
-    현금흐름표q: ItemsMap = Field(default_factory=dict)
-
-    model_config = ConfigDict(extra="ignore")

contracts_hj3415-0.2.0/src/contracts/nfs/c104.py

@@ -1,24 +0,0 @@
-# contracts/nfs/c104.py
-from __future__ import annotations
-
-from pydantic import BaseModel, ConfigDict, Field
-
-Num = float | int | None
-Row = dict[str, Num]                 # 예: {"2020/12": 1.0, "전년대비": 2.0, ...}
-ItemsMap = dict[str, Row]            # 예: {"ROE": {...}, ...}
-
-class C104DTO(BaseModel):
-    코드: str
-    수익성y: ItemsMap = Field(default_factory=dict)
-    수익성q: ItemsMap = Field(default_factory=dict)
-    성장성y: ItemsMap = Field(default_factory=dict)
-    성장성q: ItemsMap = Field(default_factory=dict)
-    안정성y: ItemsMap = Field(default_factory=dict)
-    안정성q: ItemsMap = Field(default_factory=dict)
-    활동성y: ItemsMap = Field(default_factory=dict)
-    활동성q: ItemsMap = Field(default_factory=dict)
-    가치분석y: ItemsMap = Field(default_factory=dict)
-    가치분석q: ItemsMap = Field(default_factory=dict)
-
-
-    model_config = ConfigDict(extra="ignore")

contracts_hj3415-0.2.0/src/contracts/nfs/c106.py

@@ -1,37 +0,0 @@
-# contracts/nfs/c106.py
-from __future__ import annotations
-
-from pydantic import BaseModel, Field, ConfigDict
-
-NumMap = dict[str, float | None]
-
-
-class C106Block(BaseModel):
-    전일종가: NumMap = Field(default_factory=dict)
-    시가총액: NumMap = Field(default_factory=dict)
-    자산총계: NumMap = Field(default_factory=dict)
-    부채총계: NumMap = Field(default_factory=dict)
-
-    매출액: NumMap = Field(default_factory=dict)
-    영업이익: NumMap = Field(default_factory=dict)
-    당기순이익: NumMap = Field(default_factory=dict)
-    당기순이익_지배: NumMap = Field(default_factory=dict)
-
-    영업이익률: NumMap = Field(default_factory=dict)
-    순이익률: NumMap = Field(default_factory=dict)
-    ROE: NumMap = Field(default_factory=dict)
-    부채비율: NumMap = Field(default_factory=dict)
-
-    PER: NumMap = Field(default_factory=dict)
-    PBR: NumMap = Field(default_factory=dict)
-
-    투자의견: NumMap = Field(default_factory=dict)
-    목표주가: NumMap = Field(default_factory=dict)
-
-    model_config = ConfigDict(extra="ignore")
-
-
-class C106DTO(BaseModel):
-    코드: str
-    q: C106Block
-    y: C106Block

contracts_hj3415-0.2.0/src/contracts/nfs/c108.py

@@ -1,61 +0,0 @@
-import math
-from pydantic import BaseModel, field_validator
-from typing import List, Optional, Any
-import re
-
-class C108DTO(BaseModel):
-    코드: str
-    날짜: Optional[str]
-    제목: str
-    작성자: Optional[str]
-    제공처: Optional[str]
-    투자의견: Optional[str]
-    목표가: Optional[float]
-    분량: Optional[str]
-    내용: List[str]
-
-
-    @field_validator("투자의견", mode="before")
-    @classmethod
-    def _coerce_opinion(cls, v):
-        # pandas/bs4 parsing sometimes yields float('nan') for empty cells
-        if v is None:
-            return None
-        if isinstance(v, float) and math.isnan(v):
-            return None
-        if isinstance(v, str):
-            s = v.strip()
-            if not s or s.lower() == "nan" or s in {"-", "N/A", "NA"}:
-                return None
-            return s
-        # Any other type -> string fallback (keeps validation tolerant)
-        return str(v)
-
-    @field_validator("목표가", mode="before")
-    @classmethod
-    def _v_target_price(cls, v: Any):
-        if v is None:
-            return None
-
-        # nan 방어
-        if isinstance(v, float) and math.isnan(v):
-            return None
-
-        # 안내 문구/결측 문자열 방어
-        if isinstance(v, str):
-            s = v.strip()
-            if not s or s in {"-", "N/A"} or "검색된 데이터가 없습니다" in s:
-                return None
-
-            # "123,456원" 같은 케이스에서 숫자만 추출
-            m = re.findall(r"\d+(?:,\d+)*", s)
-            if not m:
-                return None
-            return float(m[0].replace(",", ""))
-
-        # 숫자면 그대로 float로
-        if isinstance(v, (int, float)):
-            return float(v)
-
-        # 그 외 타입은 None 처리(또는 raise로 엄격하게)
-        return None