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

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/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/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/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/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/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/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/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/universe/constants.py

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

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/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.1.1.dist-info → contracts_hj3415-0.4.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.4.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.4.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+contracts_hj3415/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+contracts_hj3415/nfs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+contracts_hj3415/nfs/c101_dto.py,sha256=nKKlMhz3jFPAb5JC8ZrgFjhmt7y8ZtamFmqNep2jy0U,686
+contracts_hj3415/nfs/c103_dto.py,sha256=PSAJ3sx77BqBSOm-D_yVQXxTbYVfQ1-711DuOVxVpHY,988
+contracts_hj3415/nfs/c104_dto.py,sha256=uO0-EGb3O5LiLSJ0oCg8TaHjLnInVFyAZDJkYUq26Is,1265
+contracts_hj3415/nfs/c106_dto.py,sha256=TYTgkAHD5vwUo6jn4f0rXaLojUeO9tQ7ZreBj0Uc_oc,541
+contracts_hj3415/nfs/c108_dto.py,sha256=H5eVFAADOAHL_vS_GHiBcYDoTuMg1WlFNgSYKtC7zls,387
+contracts_hj3415/nfs/constants.py,sha256=qUs4EekAbnBFh0wk4tSlmAgxQG9sak-2YZuAjnNt4ak,850
+contracts_hj3415/nfs/nfs_dto.py,sha256=R9Jy3oU8YCuNaYlwjEmFNE7FNNLST-Y5VlnYbfJyLg4,335
+contracts_hj3415/nfs/types.py,sha256=6tUnaXOg0-_JE9wite5toz5CiGgmJtpqjiFD6qoYt2Y,1116
+contracts_hj3415/universe/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+contracts_hj3415/universe/constants.py,sha256=vYAwhTBFSQhxyzIz8EK3gxwUX6cHdDdezE0KygzAQvU,122
+contracts_hj3415/universe/dto.py,sha256=fR17Cgo8XKT26KDzoqGOltDYTNYvcz2JmMBKhAdbp90,478
+contracts_hj3415/universe/types.py,sha256=OkYoMOHbP6UufOdRL3M8c9orNf_2g-E98fMI7ayG6Fg,134
+contracts_hj3415-0.4.0.dist-info/licenses/LICENSE,sha256=QBiVGQuKAESeCfQE344Ik2ex6g2zfYdu9WqrRWydxIs,1068
+contracts_hj3415-0.4.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+contracts_hj3415-0.4.0.dist-info/METADATA,sha256=nD0xPnBGQi65M19_bAOIZlSDungkYC7yDxHN_FOn8RA,405
+contracts_hj3415-0.4.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,,