contracts-hj3415 0.1.1__py3-none-any.whl → 0.2.0__py3-none-any.whl

contracts/nfs/c101.py

@@ -0,0 +1,52 @@
+# 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/nfs/c103.py

@@ -0,0 +1,19 @@
+# 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/nfs/c104.py

@@ -0,0 +1,24 @@
+# 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/nfs/c106.py

@@ -0,0 +1,37 @@
+# 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/nfs/c108.py

@@ -0,0 +1,61 @@
+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

{contracts_hj3415-0.1.1.dist-info → contracts_hj3415-0.2.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: contracts-hj3415
-Version: 0.1.1
-Summary: A tiny example package
+Version: 0.2.0
+Summary: DTO pakages for hj3415
 Keywords: example,demo
 Author-email: Hyungjin Kim <hj3415@gmail.com>
 Requires-Python: >=3.11
@@ -11,10 +11,5 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Typing :: Typed
 License-File: LICENSE
 Requires-Dist: pydantic>=2.7
-Requires-Dist: pytest>=8 ; extra == "dev"
-Requires-Dist: pytest-cov>=7.0 ; extra == "dev"
-Requires-Dist: ruff>=0.5 ; extra == "dev"
-Requires-Dist: mypy>=1.10 ; extra == "dev"
-Provides-Extra: dev
 
 

contracts_hj3415-0.2.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+contracts/.DS_Store,sha256=Xf_I-6KjIMtAPAfhql2fkvFbFFnxThECsUIUP4jzjcw,6148
+contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+contracts/nfs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+contracts/nfs/c101.py,sha256=W5i_D7Icve6E_2sqtees-tm6WWC8nLh9-ZsVIlvRrZY,1301
+contracts/nfs/c103.py,sha256=6toVW_FE2xHgajg-6PDzUyaEcJt3T6uxi6Kjjk9Y710,756
+contracts/nfs/c104.py,sha256=y8f133MN0dVreRefMXltk_60CNz1ZFszxuAE02P5wRk,933
+contracts/nfs/c106.py,sha256=s96kPOBB1QiBGkE8jGKki1wsTBgXx7EOvF-1t3_5Q8I,1168
+contracts/nfs/c108.py,sha256=vNjq_TrBTdlJO_L6hgwZ1IUNAzjDSPFVWqO6_pKz7Ds,1816
+contracts_hj3415-0.2.0.dist-info/licenses/LICENSE,sha256=QBiVGQuKAESeCfQE344Ik2ex6g2zfYdu9WqrRWydxIs,1068
+contracts_hj3415-0.2.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+contracts_hj3415-0.2.0.dist-info/METADATA,sha256=m5qPOSW5Gs5vtGnnr4a7PLHxzSyYhbiWa0IZGwOoKE8,405
+contracts_hj3415-0.2.0.dist-info/RECORD,,

contracts_hj3415/common/base.py

@@ -1 +0,0 @@
-# Base DTO, mixins, timestamp helpers

contracts_hj3415/common/types.py

@@ -1 +0,0 @@
-# Literal, Enum 정의 등

contracts_hj3415/common.py

@@ -1,25 +0,0 @@
-#src/contracts_hj3415/common.py — 공용 타입, 베이스 모델, Enum 등
-
-from datetime import datetime
-from uuid import UUID, uuid4
-from enum import Enum
-from pydantic import BaseModel, Field
-
-class IDModel(BaseModel):
-    id: UUID = Field(default_factory=uuid4)
-
-class TimestampMixin(BaseModel):
-    created_at: datetime = Field(default_factory=datetime.utcnow)
-    updated_at: datetime | None = None
-
-class UserRole(str, Enum):
-    ADMIN = "admin"
-    STAFF = "staff"
-    CUSTOMER = "customer"
-
-# 공통 BaseModel
-class ContractModel(BaseModel):
-    class Config:
-        orm_mode = True
-        extra = "forbid"
-        from_attributes = True

contracts_hj3415/events.py

@@ -1,10 +0,0 @@
-# src/contracts_hj3415/events.py — 메시지 / 이벤트 스키마
-
-from datetime import datetime
-from uuid import UUID
-from pydantic import BaseModel
-
-class UserCreatedEvent(BaseModel):
-    event: str = "user.created"
-    user_id: UUID
-    timestamp: datetime

contracts_hj3415/items.py

@@ -1,14 +0,0 @@
-#src/contracts_hj3415/items.py — 아이템 관련 DTO
-
-from datetime import datetime
-from .common import IDModel, ContractModel
-
-class ItemBase(ContractModel):
-    name: str
-    description: str | None = None
-
-class ItemCreate(ItemBase):
-    pass
-
-class ItemRead(IDModel, ItemBase):
-    created_at: datetime

contracts_hj3415/nfs/dim_account.py

@@ -1,13 +0,0 @@
-# contracts_hj3415/nfs/dim_account.py
-from pydantic import BaseModel
-from typing import Optional
-
-class DimAccountDTO(BaseModel):
-    accode: str
-    account_name: str
-    level: Optional[int] = None
-    parent_accode: Optional[str] = None
-    group_type: Optional[int] = None
-    unit_type: Optional[int] = None
-    acc_kind: Optional[str] = None
-    precision: Optional[int] = None

contracts_hj3415/nfs/fact.py

@@ -1,22 +0,0 @@
-# contracts_hj3415/nfs/fact.py
-from pydantic import BaseModel, Field
-from datetime import date
-from typing import Optional
-
-class FactFinanceDTO(BaseModel):
-    cmp_cd: str
-    page: str
-    rpt: str
-    frq: str
-    accode: str
-    account_name: str
-    period: date
-    value: float
-    basis: Optional[str] = None
-    is_estimate: bool = False
-    unit_type: Optional[int] = None
-    level: Optional[int] = None
-    parent_accode: Optional[str] = None
-    group_type: Optional[int] = None
-    acc_kind: Optional[str] = None
-    precision: Optional[int] = None

contracts_hj3415/users.py

@@ -1,20 +0,0 @@
-#src/contracts_hj3415/users.py — 사용자 관련 DTO
-
-from datetime import datetime
-from pydantic import BaseModel, EmailStr
-from .common import IDModel, ContractModel, UserRole
-
-class UserBase(ContractModel):
-    email: EmailStr
-    nickname: str | None = None
-    role: UserRole = UserRole.CUSTOMER
-
-class UserCreate(UserBase):
-    password: str
-
-class UserUpdate(BaseModel):
-    nickname: str | None = None
-    role: UserRole | None = None
-
-class UserRead(IDModel, UserBase):
-    created_at: datetime

contracts_hj3415-0.1.1.dist-info/RECORD

@@ -1,17 +0,0 @@
-contracts_hj3415/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-contracts_hj3415/common.py,sha256=VDTSWDTYBC2kNX-GsogN3uualTUq5MMJ_rlGI_7RrPM,651
-contracts_hj3415/events.py,sha256=vQ14lksEsINW4Ud9sPbLj9ipDhoatWv4wYNU3E3zt9E,262
-contracts_hj3415/items.py,sha256=5f6KXoENO6iTPvXobZOZM8jjndBf6tXph0-HEgcMzOI,309
-contracts_hj3415/users.py,sha256=PlKWqvJMdjleZRSmvkvZrMpUG_3qmofR791I6i_jFog,506
-contracts_hj3415/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-contracts_hj3415/common/base.py,sha256=Iy0_CapYGG9w2FHOVorOyS0Ju8Kk6Yd5HU6nVZZ7SXw,37
-contracts_hj3415/common/types.py,sha256=jzcc0XiP8Nd9QzBucWswQwOHP0UcV_TQyC2pffFScMs,26
-contracts_hj3415/nfs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-contracts_hj3415/nfs/delta.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-contracts_hj3415/nfs/dim_account.py,sha256=DWjDi5exdcTSVy3r3vIV0jaFIVUOHGUJocXPNHxMnoQ,383
-contracts_hj3415/nfs/dim_period.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-contracts_hj3415/nfs/fact.py,sha256=_Bq7jW-l7eDpcs4gS2BYPlTX9MGKXFn-F7HozfVcgek,562
-contracts_hj3415-0.1.1.dist-info/licenses/LICENSE,sha256=QBiVGQuKAESeCfQE344Ik2ex6g2zfYdu9WqrRWydxIs,1068
-contracts_hj3415-0.1.1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-contracts_hj3415-0.1.1.dist-info/METADATA,sha256=EgkvOLZuM0bRdIkDAsvloWh_Sa-M9kUzSzjaPiTaqdA,600
-contracts_hj3415-0.1.1.dist-info/RECORD,,