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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: contracts-hj3415
-Version: 0.2.0
+Version: 0.4.0
 Summary: DTO pakages for hj3415
 Keywords: example,demo
 Author-email: Hyungjin Kim <hj3415@gmail.com>

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

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "contracts-hj3415"                          # PyPI 이름 (하이픈 허용)
-version = "0.2.0"
+version = "0.4.0"
 description = "DTO pakages for hj3415"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -22,5 +22,5 @@ dependencies = [
 ]
 
 [tool.flit.module]
-name = "contracts"
-path = "src/contracts"
+name = "contracts_hj3415"
+path = "src/contracts_hj3415"

contracts_hj3415-0.4.0/src/contracts_hj3415/nfs/c101_dto.py

@@ -0,0 +1,27 @@
+# contracts_hj3415/nfs/c101_dto.py
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+from typing import Any
+from .nfs_dto import NfsDTO
+from .types import PeriodKey, Num, MetricKey
+
+Scalar = str | float | int | None
+ValuesMap = 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]
+    연간컨센서스: dict[MetricKey, ValuesMap]
+
+class C101Payload(TypedDict):
+    blocks: C101Blocks
+
+class C101DTO(NfsDTO):
+    payload: C101Payload

contracts_hj3415-0.4.0/src/contracts_hj3415/nfs/c103_dto.py

@@ -0,0 +1,35 @@
+# contracts_hj3415/nfs/c103_dto.py
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+from .nfs_dto import NfsDTO
+from .types import Num, MetricKey, PeriodKey
+
+
+C103ValuesMap = 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):
+    blocks: C103Blocks
+    labels: C103Labels
+
+
+class C103DTO(NfsDTO):
+    payload: C103Payload

contracts_hj3415-0.4.0/src/contracts_hj3415/nfs/c104_dto.py

@@ -0,0 +1,44 @@
+# contracts_hj3415/nfs/c104_dto.py
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+from .nfs_dto import NfsDTO
+from .types import Num, MetricKey, PeriodKey
+
+
+C104ValuesMap = 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):
+    blocks: C104Blocks
+    labels: C104Labels
+
+
+class C104DTO(NfsDTO):
+    payload: C104Payload

contracts_hj3415-0.4.0/src/contracts_hj3415/nfs/c106_dto.py

@@ -0,0 +1,28 @@
+# contracts_hj3415/nfs/c106_dto.py
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+from .nfs_dto import NfsDTO
+from .types import Num, MetricKey, CodeKey
+
+
+C106ValuesMap = 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):
+    blocks: C106Blocks
+    labels: C106Labels
+
+
+class C106DTO(NfsDTO):
+    payload: C106Payload

contracts_hj3415-0.4.0/src/contracts_hj3415/nfs/c108_dto.py

@@ -0,0 +1,21 @@
+# contracts_hj3415/nfs/c108_dto.py
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+from .nfs_dto import NfsDTO
+from .types import MetricKey
+
+
+C108ValuesMap = dict[MetricKey, str|int|None]
+
+
+class C108Blocks(TypedDict):
+    리포트: list[C108ValuesMap]
+
+
+class C108Payload(TypedDict):
+    blocks: C108Blocks
+
+
+class C108DTO(NfsDTO):
+    payload: C108Payload

contracts_hj3415-0.4.0/src/contracts_hj3415/nfs/constants.py

@@ -0,0 +1,49 @@
+# contracts_hj3415/nfs/constants.py
+from __future__ import annotations
+
+
+ENDPOINTS: tuple[str, ...] = ("c101", "c103", "c104", "c106", "c108")
+
+
+C101_BLOCK_KEYS: tuple[str, ...] = (
+    "요약",
+    "시세",
+    "주주현황",
+    "기업개요",
+    "펀더멘털",
+    "어닝서프라이즈",
+    "연간컨센서스",
+)
+
+
+C103_BLOCK_KEYS: tuple[str, ...] = (
+    "손익계산서y",
+    "손익계산서q",
+    "재무상태표y",
+    "재무상태표q",
+    "현금흐름표y",
+    "현금흐름표q",
+)
+
+
+C104_BLOCK_KEYS: tuple[str, ...] = (
+    "수익성y",
+    "성장성y",
+    "안정성y",
+    "활동성y",
+    "가치분석y",
+    "수익성q",
+    "성장성q",
+    "안정성q",
+    "활동성q",
+    "가치분석q",
+)
+
+
+C106_BLOCK_KEYS: tuple[str, ...] = (
+    "y",
+    "q",
+)
+
+
+C108_BLOCK_KEYS: tuple[str, ...] = ("리포트",)

contracts_hj3415-0.4.0/src/contracts_hj3415/nfs/nfs_dto.py

@@ -0,0 +1,17 @@
+# contracts_hj3415/nfs/nfs_dto.py
+from __future__ import annotations
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict
+from .types import Endpoints, Payload
+
+
+class NfsDTO(BaseModel):
+    code: str
+    asof: datetime
+    endpoint: Endpoints
+    payload: Payload
+
+    model_config = ConfigDict(extra="ignore")
+
+

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

@@ -0,0 +1,61 @@
+# contracts_hj3415/nfs/types.py
+from __future__ import annotations
+
+from typing import Mapping, Any, Literal, TypeAlias
+
+C101BlockKeys = Literal[
+    "요약", "시세", "주주현황", "기업개요", "펀더멘털", "어닝서프라이즈", "연간컨센서스"
+]
+
+C103BlockKeys = Literal[
+    "손익계산서y",
+    "손익계산서q",
+    "재무상태표y",
+    "재무상태표q",
+    "현금흐름표y",
+    "현금흐름표q",
+]
+
+
+C104BlockKeys = Literal[
+    "수익성y",
+    "성장성y",
+    "안정성y",
+    "활동성y",
+    "가치분석y",
+    "수익성q",
+    "성장성q",
+    "안정성q",
+    "활동성q",
+    "가치분석q",
+]
+
+
+# C106===========================
+
+C106BlockKeys = Literal[
+    "y",
+    "q",
+]
+
+
+# C108============================
+
+C108BlockKeys = Literal["리포트",]
+
+
+# General====================
+
+MetricKey = str
+PeriodKey = str
+CodeKey = str
+Num = float | int | None
+
+Endpoints = Literal["c101", "c103", "c104", "c106", "c108"]
+
+
+Payload = Mapping[str, Any]
+
+BlockKeys: TypeAlias = (
+    C101BlockKeys | C103BlockKeys | C104BlockKeys | C106BlockKeys | C108BlockKeys
+)

contracts_hj3415-0.4.0/src/contracts_hj3415/universe/constants.py

@@ -0,0 +1,4 @@
+# contracts_hj3415/universe/constants.py
+from __future__ import annotations
+
+UNIVERSE_NAMES: tuple[str, ...] = ("krx300",)

contracts_hj3415-0.4.0/src/contracts_hj3415/universe/dto.py

@@ -0,0 +1,17 @@
+# contracts_hj3415/universe/dto.py
+from __future__ import annotations
+
+from typing import Any, TypedDict
+
+class UniverseItemDTO(TypedDict, total=False):
+    code: str              # required by convention
+    name: str
+    market: str
+    meta: dict[str, Any]
+
+
+class UniversePayloadDTO(TypedDict):
+    universe: str
+    asof: str              # ISO string 권장 (UTC). datetime을 넘겨도 되지만 계약은 str이 깔끔함
+    source: str
+    items: list[UniverseItemDTO]

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

@@ -0,0 +1,6 @@
+# contracts_hj3415/universe/dto.py
+from __future__ import annotations
+
+from typing import Literal
+
+UniverseNames = 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