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

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: contracts-hj3415
-Version: 0.1.0
-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,11 +11,5 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Typing :: Typed
 License-File: LICENSE
 Requires-Dist: pydantic>=2.7
-Requires-Dist: contract-hj3415>=0.1
-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.1.0 → contracts_hj3415-0.2.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "contracts-hj3415"                          # PyPI 이름 (하이픈 허용)
-version = "0.1.0"
-description = "A tiny example package"
+version = "0.2.0"
+description = "DTO pakages for hj3415"
 readme = "README.md"
 requires-python = ">=3.11"
 license = { file = "LICENSE" }
@@ -19,9 +19,8 @@ classifiers = [
 
 dependencies = [
   "pydantic>=2.7",
-  "contract-hj3415>=0.1",
 ]
 
-# 선택적 의존성 (pip install your-pkg[dev] 형태)
-[project.optional-dependencies]
-dev = ["pytest>=8", "pytest-cov>=7.0", "ruff>=0.5", "mypy>=1.10"]
+[tool.flit.module]
+name = "contracts"
+path = "src/contracts"

contracts_hj3415-0.2.0/src/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_hj3415-0.2.0/src/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_hj3415-0.2.0/src/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_hj3415-0.2.0/src/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_hj3415-0.2.0/src/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.0/pytest.ini

@@ -1,6 +0,0 @@
-#pytest.ini
-[pytest]
-addopts = -q -s --cov=contract_hj3415 --cov-report=term-missing
-testpaths = tests
-python_files = test_*.py *_test.py
-filterwarnings = ignore::DeprecationWarning

contracts_hj3415-0.1.0/requirements.txt

@@ -1,2 +0,0 @@
-pydantic>=2.7
-contract-hj3415>=0.1

contracts_hj3415-0.1.0/src/contracts_hj3415/common/base.py

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

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

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

contracts_hj3415-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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