datagokr-reader 1.0.0__tar.gz

datagokr_reader-1.0.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: datagokr_reader
+Version: 1.0.0
+Summary:  data.go.kr의 채권 관련 API를 사용하기 편하게 만든 라이브러리입니다.
+Author: WONWOO LEE
+License-Expression: MIT
+Project-URL: Repository, https://example.com
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+
+ ## DatagokrReader
+ 
+ data.go.kr의 채권 관련 API를 사용하기 편하게 만든 라이브러리입니다.
+ 
+ ### Example
+ 
+ ```python
+from datagokr_reader import run_bond_workflow
+
+# 띄어쓰기 및 대소문자 무관, 채권 관련 주요 데이터 모두 정리
+ result = run_bond_workflow(datagokr_api_key, "공공데이터포털1EB") 
+ ```

datagokr_reader-1.0.0/README.md

@@ -0,0 +1,12 @@
+ ## DatagokrReader
+ 
+ data.go.kr의 채권 관련 API를 사용하기 편하게 만든 라이브러리입니다.
+ 
+ ### Example
+ 
+ ```python
+from datagokr_reader import run_bond_workflow
+
+# 띄어쓰기 및 대소문자 무관, 채권 관련 주요 데이터 모두 정리
+ result = run_bond_workflow(datagokr_api_key, "공공데이터포털1EB") 
+ ```

datagokr_reader-1.0.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "datagokr_reader"
+version = "1.0.0"
+description = " data.go.kr의 채권 관련 API를 사용하기 편하게 만든 라이브러리입니다."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "WONWOO LEE" }]
+dependencies = [
+  "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+]
+
+[project.urls]
+Repository = "https://example.com"
+
+[project.scripts]
+datagokr-reader = "datagokr_reader.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

datagokr_reader-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

datagokr_reader-1.0.0/src/datagokr_reader/__init__.py

@@ -0,0 +1,27 @@
+# datagokr_reader 구조:
+#
+# src/datagokr_reader/
+# ├── __init__.py            
+# ├── getOptiExer.py             # 실제 주식 행사내역 다운로드
+# ├── getOptiExerPricAdju.py     # 주식 행사가 조정내역 다운로드
+# ├── getEarlExerOpti.py         # 옵션 행사 일정 다운로드
+# ├── getBondBasiInfo.py         # 채권 기본 정보 다운로드, Not reliable
+# ├── getBondWithOptiCallRede.py # 옵션 행사내역 다운로드
+# ├── getIssuIssuItemStat.py     # 발행인에 따른 채권 조회
+
+from .getOptiExer import get_OptiExer, parse_opti_exer
+from .getOptiExerPricAdju import get_OptiExerPricAdju, parse_opti_exer_pric_adju
+from .getEarlExerOpti import get_EarlExerOpti, parse_earl_exer_opti
+from .getBondBasiInfo import get_BondBasiInfo, parse_bond_basi_info
+from .getBondWithOptiCallRede import get_BondWithOptiCallRede, parse_bond_with_opti_call_rede
+from .getIssuIssuItemStat import get_IssuIssuItemStat, parse_issu_issu_item_stat
+from .workflow import run_bond_workflow
+__all__ = [
+    "get_OptiExer", "parse_opti_exer", 
+    "get_OptiExerPricAdju", "parse_opti_exer_pric_adju", 
+    "get_EarlExerOpti", "parse_earl_exer_opti", 
+    "get_BondBasiInfo", "parse_bond_basi_info",
+    "get_BondWithOptiCallRede", "parse_bond_with_opti_call_rede",
+    "get_IssuIssuItemStat", "parse_issu_issu_item_stat",
+    "run_bond_workflow",
+]

datagokr_reader-1.0.0/src/datagokr_reader/base_reader.py

@@ -0,0 +1,139 @@
+from __future__ import annotations
+
+from typing import Any
+
+import re
+import httpx
+
+
+def get_datagokr_data(
+    serviceUrl: str, params: dict[str, Any], timeout_seconds: float = 60.0
+) -> Any | None:
+    """ Datagokr API를 호출해서 응답 JSON을 반환한다. """
+    baseUrl = "http://apis.data.go.kr"
+    url = f"{baseUrl}/{serviceUrl}"
+    try:
+        resp = httpx.get(url, params=params, timeout=timeout_seconds)
+        resp.raise_for_status()
+        return resp.json()
+    except Exception:
+        return None
+
+def get_datagokr_document(
+    serviceUrl: str, params: dict[str, Any], timeout_seconds: float = 60.0,
+    numOfRows: int = 100, resultType: str = "json",
+) -> Any | None:
+    """
+    Datagokr API를 반복 호출해서 응답 JSON을 반환한다.
+    1. `pageNo = 1`부터 `pageNo = totalCount / numOfRows` 페이지까지 반복 호출한다.
+    2. 각 페이지의 items를 모두 모아서 반환한다. 
+        반환 형식은 기본 형식과 동일하며, items는 {"item": [...]} 구조와 단순 리스트 구조를 모두 지원한다. 
+    ```json
+    {
+      "response": {
+        "body": {
+          "pageNo": 1,
+          "numOfRows": 100,
+          "totalCount": ...,
+          "items": # contents
+        }
+      }
+    }
+    ```
+    """
+    # 공통 파라미터 설정 (기본값이 있으면 덮어쓰지 않음)
+    base_params: dict[str, Any] = dict(params)
+    base_params.setdefault("numOfRows", numOfRows)
+    base_params.setdefault("resultType", resultType)
+
+    # 1페이지 호출
+    first_params = dict(base_params)
+    first_params["pageNo"] = 1
+    first_doc = get_datagokr_data(serviceUrl, first_params, timeout_seconds)
+    if first_doc is None:
+        return None
+    try:
+        body = first_doc["response"]["body"]
+    except Exception:
+        return first_doc
+
+    # 전체 개수 확인
+    total_count_raw = body.get("totalCount", 0)
+    try:
+        total_count = int(total_count_raw)
+    except Exception:
+        total_count = 0
+    if total_count <= 0:
+        return first_doc
+
+    # items 추출
+    def extract_items(items_obj: Any) -> list[Any]:
+        # 1) items가 None인 경우 -> []
+        if items_obj is None:
+            return []
+        # 2) "items": {"item": [...]} OR "items": {"item": {...}} 인 경우
+        #    - inner가 리스트면 그대로 리스트 반환
+        #    - inner가 단일 객체면 리스트로 감싸서 반환
+        if isinstance(items_obj, dict) and "item" in items_obj:
+            inner = items_obj.get("item")
+            if inner is None:
+                return []
+            if isinstance(inner, list):
+                return inner
+            return [inner]
+        # 3) "items": [...] 인 경우 -> 그대로 리스트 반환
+        if isinstance(items_obj, list):
+            return items_obj
+        # 4) 그 외에는 리스트로 감싸서 반환
+        return [items_obj]
+
+    items_obj = body.get("items")
+    all_items: list[Any] = extract_items(items_obj)
+
+    # 총 페이지 수 계산
+    total_pages = (total_count + numOfRows - 1) // numOfRows
+
+    # 2페이지부터 마지막 페이지까지 반복 호출
+    for page_no in range(2, total_pages + 1):
+        page_params = dict(base_params)
+        page_params["pageNo"] = page_no
+        page_doc = get_datagokr_data(serviceUrl, page_params, timeout_seconds)
+        if page_doc is None:
+            break
+        try:
+            page_body = page_doc["response"]["body"]
+            page_items_obj = page_body.get("items")
+        except Exception:
+            break
+        all_items.extend(extract_items(page_items_obj))
+
+    # 첫 응답 객체에 모든 items를 합쳐서 세팅
+    if isinstance(items_obj, dict) and "item" in items_obj:
+        items_obj["item"] = all_items
+        body["items"] = items_obj
+    else:
+        body["items"] = all_items
+
+    # 메타 정보 정리 (pageNo는 1, numOfRows는 입력값, totalCount는 실제 아이템 개수)
+    body["pageNo"] = 1
+    body["numOfRows"] = numOfRows
+    body["totalCount"] = len(all_items)
+
+    return first_doc
+
+
+def normalize_name(name: str) -> str:
+    name_no_space = name.replace(" ", "")
+    name_no_space = re.sub(r"[A-Za-z]+", lambda m: m.group(0).lower(), name_no_space)
+    paren_index = name_no_space.find("(")
+    if paren_index != -1:
+        return name_no_space[:paren_index]
+    return name_no_space
+
+def issuer_name_from_bond_name(bond_name: str) -> str:
+    """ 채권명에서 발행사명을 추출. (숫자를 기준으로 절삭) """
+    normalized = normalize_name(bond_name)
+    m = re.search(r"\d", normalized)
+    if not m:
+        return normalized
+    return normalized[: m.start()]  

datagokr_reader-1.0.0/src/datagokr_reader/cli.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from datagokr_reader.workflow import run_bond_workflow
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(prog="datagokr-reader")
+    parser.add_argument("--api-key", required=True, help="data.go.kr serviceKey")
+    parser.add_argument("--bond-name", required=True, help="채권명 (띄어쓰기/대소문자 무관)")
+    parser.add_argument(
+        "--pretty",
+        action="store_true",
+        help="Pretty JSON 출력",
+    )
+    args = parser.parse_args(argv)
+
+    result = run_bond_workflow(args.api_key, args.bond_name)
+    if args.pretty:
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+    else:
+        print(json.dumps(result, ensure_ascii=False))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv[1:]))
+

datagokr_reader-1.0.0/src/datagokr_reader/getBondBasiInfo.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .base_reader import get_datagokr_document
+
+"""
+BondBasiInfo : (bondIsurNm|crno) 
+-> bondBal(발행잔액) +
+    "basDt": 채권의 기준일
+    "crno": 기업의 법인등록번호
+    "bondIsurNm": 채권의 발행사명
+    "isinCdNm": 채권의 ISIN 종목명
+    "bondIssuDt": 채권의 발행일
+    "bondExprDt": 채권의 만기일
+    "bondIssuAmt": 채권의 발행액
+    "bondPymtAmt": 채권의 납입액
+    "issuDptyNm": 주간사명
+"""
+def get_BondBasiInfo(serviceKey: str, basDt: str, bondIsurNm: str, crno: str, timeout_seconds: float = 60.0) -> Any | None:
+    """ 채권 기본 정보 다운로드. """
+    service_url = "1160100/service/GetBondIssuInfoService/getBondBasiInfo"
+    if not bondIsurNm and not crno:
+        raise ValueError("bondIsurNm 또는 crno가 없습니다.")
+
+    params: dict[str, Any] = {
+        "serviceKey": serviceKey
+    }
+    if basDt:
+        params["basDt"] = basDt
+    if bondIsurNm:
+        params["bondIsurNm"] = bondIsurNm
+    if crno:
+        params["crno"] = crno
+
+    return get_datagokr_document(
+        serviceUrl=service_url,
+        params=params,
+        timeout_seconds=timeout_seconds
+    )
+
+
+def parse_bond_basi_info(serviceKey: str, basDt: str, bondIsurNm: str, crno: str, timeout_seconds: float = 60.0) -> dict[str, Any] | None:
+    """ Parse get_BondBasiInfo results. """
+    raw = get_BondBasiInfo(serviceKey=serviceKey, basDt=basDt, bondIsurNm=bondIsurNm, crno=crno, timeout_seconds=timeout_seconds)
+    if raw is None:
+        return None
+
+    try:
+        body = raw["response"]["body"]
+        items_obj = body.get("items")
+    except Exception:
+        return None
+
+    def extract_items(items: Any) -> list[dict[str, Any]]:
+        if items is None:
+            return []
+        if isinstance(items, dict) and "item" in items:
+            inner = items.get("item")
+            if inner is None:
+                return []
+            if isinstance(inner, list):
+                return [i for i in inner if isinstance(i, dict)]
+            return [inner] if isinstance(inner, dict) else []
+        if isinstance(items, list):
+            return [i for i in items if isinstance(i, dict)]
+        return [items] if isinstance(items, dict) else []
+
+    items = extract_items(items_obj)
+    if not items:
+        return {}
+
+    result: dict[str, Any] = {}
+    for it in items:
+        isin = it.get("isinCd")
+        if not isin:
+            continue
+
+        meta = result.setdefault(
+            isin,
+            {
+                "metadata": {
+                    "basDt": it.get("basDt"),
+                    "crno": it.get("crno"),
+                    "bondIsurNm": it.get("bondIsurNm"),
+                    "isinCd": it.get("isinCd"),
+                    "isinCdNm": it.get("isinCdNm"),
+                    "bondIssuDt": it.get("bondIssuDt"),
+                    "bondIssuAmt": it.get("bondIssuAmt"),
+                    "bondExprDt": it.get("bondExprDt"),
+                    "bondPymtAmt": it.get("bondPymtAmt"),
+                    # "bondSrfcInrt": it.get("bondSrfcInrt"), # 표면이자율(추후 복원 가능하도록 주석 처리)
+                    "issuDptyNm": it.get("issuDptyNm"),
+                },
+                "items": [],
+            },
+        )
+
+        meta["items"].append(
+            {
+                "bondBal": it.get("bondBal"),
+            }
+        )
+
+    return result
+
+

datagokr_reader-1.0.0/src/datagokr_reader/getBondWithOptiCallRede.py

@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .base_reader import get_datagokr_document
+
+
+def get_BondWithOptiCallRede(
+    serviceKey: str,
+    crno: str,
+    opbdIsurNm: str,
+    timeout_seconds: float = 60.0,
+    numOfRows: int = 100,
+    resultType: str = "json",
+) -> Any | None:
+    """ 옵션 행사내역 다운로드. """
+    service_url = "1160100/service/GetBondRedeInfoService/getBondWithOptiCallRede"
+    if not crno and not opbdIsurNm:
+        raise ValueError("crno 또는 opbdIsurNm가 없습니다.")
+
+    params: dict[str, Any] = {
+        "serviceKey": serviceKey,
+    }
+    if crno:
+        params["crno"] = crno
+    if opbdIsurNm:
+        params["opbdIsurNm"] = opbdIsurNm
+
+    return get_datagokr_document(
+        serviceUrl=service_url,
+        params=params,
+        timeout_seconds=timeout_seconds,
+        numOfRows=numOfRows,
+        resultType=resultType,
+    )
+
+
+def parse_bond_with_opti_call_rede(
+    serviceKey: str,
+    crno: str,
+    opbdIsurNm: str,
+    timeout_seconds: float = 60.0,
+    raw: Any | None = None,
+    isinCdKey: str | None = None,
+) -> list[dict[str, Any]] | None:
+    """ Parse get_BondWithOptiCallRede results. """
+    if raw is None:
+        raw = get_BondWithOptiCallRede(
+            serviceKey=serviceKey,
+            crno=crno,
+            opbdIsurNm=opbdIsurNm,
+            timeout_seconds=timeout_seconds,
+        )
+    if raw is None:
+        return None
+
+    try:
+        body = raw["response"]["body"]
+        items_obj = body.get("items")
+    except Exception:
+        return None
+
+    def extract_items(items: Any) -> list[dict[str, Any]]:
+        if items is None:
+            return []
+        if isinstance(items, dict) and "item" in items:
+            inner = items.get("item")
+            if inner is None:
+                return []
+            if isinstance(inner, list):
+                return [i for i in inner if isinstance(i, dict)]
+            return [inner] if isinstance(inner, dict) else []
+        if isinstance(items, list):
+            return [i for i in items if isinstance(i, dict)]
+        return [items] if isinstance(items, dict) else []
+
+    items = extract_items(items_obj)
+    if not items:
+        return []
+
+    # 아래 항목들은 it에 존재하지만, 현재 라이브러리 목적상 파싱하지 않음
+    # "isinCd": it.get("isinCd"),            # ISIN 종목번호, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "crno": it.get("crno"),                # 기업의 법인등록번호, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "isinCdNm": it.get("isinCdNm"),        # ISIN 종목명, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "opbdIsurNm": it.get("opbdIsurNm"),    # 채권의 발행사명, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "opbdIssuDt": it.get("opbdIssuDt"),    # 채권의 발행일, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "opbdExprDt": it.get("opbdExprDt"),    # 채권의 만기일, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "opbdIssuAmt": it.get("opbdIssuAmt"),  # 최초발행액, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "bondIssuAmt": it.get("bondIssuAmt"),  # 발행잔액, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+
+    out: list[dict[str, Any]] = []
+    for it in items:
+        isin = it.get("isinCd")
+        if isinCdKey:
+            if not isin or isin != isinCdKey:
+                continue
+        else:
+            if not isin:
+                continue
+        out.append(
+            {
+                "isinCd": isin,
+                "optnTcdNm": it.get("optnTcdNm"),
+                "opbdClrdDt": it.get("opbdClrdDt"),
+                "opbdPamtPayAmt": it.get("opbdPamtPayAmt"),
+            }
+        )
+
+    return out
+
+

datagokr_reader-1.0.0/src/datagokr_reader/getEarlExerOpti.py

@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .base_reader import get_datagokr_document
+
+def get_EarlExerOpti(
+    serviceKey: str,
+    basDt: str | None,
+    bondIsurNm: str,
+    crno: str,
+    timeout_seconds: float = 60.0,
+) -> Any | None:
+    """ 옵션 행사 일정 다운로드. 
+        사모 사채는 콜옵션이 공시되지 않는 경우가 있으니 주의. 
+    """
+    service_url = "1160100/service/GetBondRedeInfoService/getEarlExerOpti"
+    if not bondIsurNm and not crno:
+        raise ValueError("bondIsurNm 또는 crno가 없습니다.")
+
+    params: dict[str, Any] = {
+        "serviceKey": serviceKey
+    }
+    if basDt:
+        params["basDt"] = basDt
+    if bondIsurNm: 
+        params["bondIsurNm"] = bondIsurNm
+    if crno: 
+        params["crno"] = crno
+    return get_datagokr_document(
+        serviceUrl=service_url,
+        params=params,
+        timeout_seconds=timeout_seconds
+    )
+
+
+def parse_earl_exer_opti(
+    serviceKey: str,
+    basDt: str | None,
+    bondIsurNm: str,
+    crno: str,
+    timeout_seconds: float = 60.0,
+    isinCdKey: str | None = None,
+) -> list[dict[str, Any]] | None:
+    """ Parse get_EarlExerOpti results. """
+    raw = get_EarlExerOpti(serviceKey=serviceKey, basDt=basDt, bondIsurNm=bondIsurNm, crno=crno, timeout_seconds=timeout_seconds)
+    if raw is None:
+        return None
+
+    try:
+        body = raw["response"]["body"]
+        items_obj = body.get("items")
+    except Exception:
+        return None
+
+    def extract_items(items: Any) -> list[dict[str, Any]]:
+        if items is None:
+            return []
+        if isinstance(items, dict) and "item" in items:
+            inner = items.get("item")
+            if inner is None:
+                return []
+            if isinstance(inner, list):
+                return [i for i in inner if isinstance(i, dict)]
+            return [inner] if isinstance(inner, dict) else []
+        if isinstance(items, list):
+            return [i for i in items if isinstance(i, dict)]
+        return [items] if isinstance(items, dict) else []
+
+    items = extract_items(items_obj)
+    if not items:
+        return []
+
+    # 아래 항목들은 it에 존재하지만, 현재 라이브러리 목적상 파싱하지 않음
+    # "isinCd": it.get("isinCd"),           # ISIN 종목번호, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "basDt": it.get("basDt"),             # 채권의 기준일, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "crno": it.get("crno"),               # 기업의 법인등록번호, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "bondIsurNm": it.get("bondIsurNm"),   # 채권의 발행사명, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "isinCdNm": it.get("isinCdNm"),       # ISIN 종목명, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+
+    out: list[dict[str, Any]] = []
+    for it in items:
+        isin = it.get("isinCd")
+        if not isin:
+            continue
+        if isinCdKey and isin != isinCdKey:
+            continue
+        out.append(
+            {
+                "isinCd": isin,
+                "type": it.get("optnTcdNm"),
+                "dates": [
+                    it.get("optnExertSttgDt"),
+                    it.get("optnExertEdDt"),
+                    it.get("clrdDt"),
+                ],
+            }
+        )
+
+    return out

datagokr_reader-1.0.0/src/datagokr_reader/getIssuIssuItemStat.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .base_reader import get_datagokr_document, normalize_name
+
+def get_IssuIssuItemStat(serviceKey: str, bondIsurNm: str, timeout_seconds: float = 60.0) -> Any | None:
+    """ 발행인에 따른 채권 조회. """
+    service_url = "1160100/service/GetBondTradInfoService/getIssuIssuItemStat"
+
+    params: dict[str, Any] = {
+        "serviceKey": serviceKey,
+        "bondIsurNm": bondIsurNm
+    }
+    return get_datagokr_document(
+        serviceUrl=service_url,
+        params=params,
+        timeout_seconds=timeout_seconds
+    )
+
+
+def parse_issu_issu_item_stat(
+    serviceKey: str,
+    bondIsurNm: str,
+    bondNm: str,
+    timeout_seconds: float = 60.0,
+    raw: Any | None = None,
+) -> dict[str, Any] | None:
+    """ Parse get_IssuIssuItemStat results. """
+    if raw is None:
+        raw = get_IssuIssuItemStat(serviceKey=serviceKey, bondIsurNm=bondIsurNm, timeout_seconds=timeout_seconds)
+    if raw is None:
+        return None
+
+    try:
+        body = raw["response"]["body"]
+        items_obj = body.get("items")
+    except Exception:
+        return None
+
+    def extract_items(items: Any) -> list[dict[str, Any]]:
+        if items is None:
+            return []
+        if isinstance(items, dict) and "item" in items:
+            inner = items.get("item")
+            if inner is None:
+                return []
+            if isinstance(inner, list):
+                return [i for i in inner if isinstance(i, dict)]
+            return [inner] if isinstance(inner, dict) else []
+        if isinstance(items, list):
+            return [i for i in items if isinstance(i, dict)]
+        return [items] if isinstance(items, dict) else []
+
+    items = extract_items(items_obj)
+    if not items:
+        return None
+    for it in items:
+        normalized_isinCdNm = normalize_name(it.get("isinCdNm"))
+        normalized_bondNm = normalize_name(bondNm)
+        if normalized_isinCdNm == normalized_bondNm:
+            result = {
+                "basDt": it.get("basDt"),
+                "crno": it.get("crno"),
+                "isinCd": it.get("isinCd"),
+
+                "bondExprDt": it.get("bondExprDt"),
+                "bondIssuDt": it.get("bondIssuDt"),
+                "bondIssuAmt": it.get("bondIssuAmt"),
+
+                "isinCdNm": it.get("isinCdNm"),
+                "bondPymtAmt": it.get("bondPymtAmt"),
+            }
+            return result
+    return None

datagokr_reader-1.0.0/src/datagokr_reader/getOptiExer.py

@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .base_reader import get_datagokr_document
+
+
+def get_OptiExer(serviceKey: str, crno: str, timeout_seconds: float = 60.0) -> str | None:
+    """ 옵션 실제 행사내역 다운로드. """
+    service_url = "1160100/service/GetBondRedeInfoService/getOptiExer"
+    if not crno:
+        raise ValueError("crno가 없습니다.")
+
+    params: dict[str, Any] = {
+        "serviceKey": serviceKey,
+        "crno": crno,
+    }
+    return get_datagokr_document(
+        serviceUrl=service_url,
+        params=params,
+        timeout_seconds=timeout_seconds
+    )
+
+
+def parse_opti_exer(
+    serviceKey: str,
+    crno: str,
+    timeout_seconds: float = 60.0,
+    raw: Any | None = None,
+    isinCdKey: str | None = None,
+) -> list[dict[str, Any]] | None:
+    """ Parse get_OptiExer results. """
+    if raw is None:
+        raw = get_OptiExer(serviceKey=serviceKey, crno=crno, timeout_seconds=timeout_seconds)
+    if raw is None:
+        return None
+
+    try:
+        body = raw["response"]["body"]
+        items_obj = body.get("items")
+    except Exception:
+        return None
+
+    def extract_items(items: Any) -> list[dict[str, Any]]:
+        if items is None:
+            return []
+        if isinstance(items, dict) and "item" in items:
+            inner = items.get("item")
+            if inner is None:
+                return []
+            if isinstance(inner, list):
+                return [i for i in inner if isinstance(i, dict)]
+            return [inner] if isinstance(inner, dict) else []
+        if isinstance(items, list):
+            return [i for i in items if isinstance(i, dict)]
+        return [items] if isinstance(items, dict) else []
+
+    items = extract_items(items_obj)
+    if not items:
+        return []
+
+    # 아래 항목들은 it에 존재하지만, 현재 라이브러리 목적상 파싱하지 않음
+    # "basDt": it.get("basDt"),                       # 채권의 기준일, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "crno": it.get("crno"),                         # 기업의 법인등록번호, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "isinCdNm": it.get("isinCdNm"),                 # ISIN 종목명, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "scrsIsurNm": it.get("scrsIsurNm"),             # 채권의 발행사명, BasiInfo에서 이미 있음(추후 복원 가능하도록 주석 처리)
+    # "trgtStckIsinCd": it.get("trgtStckIsinCd"),     # 대상 주식의 ISIN 종목번호, 현재 프로젝트에서 사용하지 않음(추후 복원 가능하도록 주석 처리)
+    # "trgtStckIsinCdNm": it.get("trgtStckIsinCdNm"), # 대상 주식의 ISIN 종목명, 현재 프로젝트에서 사용하지 않음(추후 복원 가능하도록 주석 처리)
+
+    out: list[dict[str, Any]] = []
+    for it in items:
+        isin = it.get("isinCd")
+        if not isin:
+            continue
+        if isinCdKey and isin != isinCdKey:
+            continue
+        out.append(
+            {
+                "isinCd": isin,
+                "optnExertPrc": it.get("optnExertPrc"),
+                "rgtOccrBasDt": it.get("rgtOccrBasDt"),
+                "exertPric": it.get("exertPric"),
+                "exertAmt": it.get("exertAmt"),
+            }
+        )
+
+    # items 에 "rgtOccrBasDt": "00010101" 하나만 있으면 items 를 None 으로 처리
+    out = [x for x in out if (x.get("rgtOccrBasDt") != "00010101")]
+    return out

datagokr_reader-1.0.0/src/datagokr_reader/getOptiExerPricAdju.py

@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .base_reader import get_datagokr_document
+
+
+def get_OptiExerPricAdju(
+    serviceKey: str,
+    crno: str,
+    timeout_seconds: float = 60.0,
+    numOfRows: int = 100,
+    resultType: str = "json",
+) -> Any | None:
+    """ 행사가 변동내역 및 현재 행사가 다운로드. """
+    service_url = "1160100/service/GetBondRedeInfoService/getOptiExerPricAdju"
+    if not crno:
+        raise ValueError("crno가 없습니다.")
+
+    params: dict[str, Any] = {
+        "serviceKey": serviceKey,
+        "crno": crno,
+    }
+
+    return get_datagokr_document(
+        serviceUrl=service_url,
+        params=params,
+        timeout_seconds=timeout_seconds,
+        numOfRows=numOfRows,
+        resultType=resultType,
+    )
+
+
+def parse_opti_exer_pric_adju(
+    serviceKey: str,
+    crno: str,
+    timeout_seconds: float = 60.0,
+    raw: Any | None = None,
+    isinCdKey: str | None = None,
+) -> list[dict[str, Any]] | None:
+    """ Parse get_OptiExerPricAdju results. """
+    if raw is None:
+        raw = get_OptiExerPricAdju(
+            serviceKey=serviceKey,
+            crno=crno,
+            timeout_seconds=timeout_seconds,
+        )
+    if raw is None:
+        return None
+
+    try:
+        body = raw["response"]["body"]
+        items_obj = body.get("items")
+    except Exception:
+        return None
+
+    def extract_items(items: Any) -> list[dict[str, Any]]:
+        if items is None:
+            return []
+        if isinstance(items, dict) and "item" in items:
+            inner = items.get("item")
+            if inner is None:
+                return []
+            if isinstance(inner, list):
+                return [i for i in inner if isinstance(i, dict)]
+            return [inner] if isinstance(inner, dict) else []
+        if isinstance(items, list):
+            return [i for i in items if isinstance(i, dict)]
+        return [items] if isinstance(items, dict) else []
+
+    items = extract_items(items_obj)
+    if not items:
+        return []
+
+    out: list[dict[str, Any]] = []
+    # "trgtStckIsinCd": it.get("trgtStckIsinCd"),       # 대상 주식의 ISIN 종목번호, 현재 프로젝트에서 사용하지 않음(추후 복원 가능하도록 주석 처리)
+    # "trgtStckIsinCdNm": it.get("trgtStckIsinCdNm"),   # 대상 주식의 ISIN 종목명, 현재 프로젝트에서 사용하지 않음(추후 복원 가능하도록 주석 처리)
+    for it in items:
+        isin = it.get("isinCd")
+        if not isin:
+            continue
+        if isinCdKey and isin != isinCdKey:
+            continue
+        out.append(
+            {
+                "isinCd": isin,
+                "basDt": it.get("basDt"),
+                "crno": it.get("crno"),
+                "isinCdNm": it.get("isinCdNm"),
+                "scrsIsurNm": it.get("scrsIsurNm"),
+                "optnExertPrc": it.get("optnExertPrc"),
+                "rgtExertPricAdjDt": it.get("rgtExertPricAdjDt"),
+                "rgtBchgExertPrc": it.get("rgtBchgExertPrc"),
+                "rgtAchgExertPrc": it.get("rgtAchgExertPrc"),
+            }
+        )
+
+    # items 에 "rgtExertPricAdjDt": "00010101" 하나만 있으면 items 를 None 으로 처리
+    out = [x for x in out if (x.get("rgtExertPricAdjDt") != "00010101")]
+    return out
+

datagokr_reader-1.0.0/src/datagokr_reader/workflow.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from datagokr_reader import (
+    parse_bond_with_opti_call_rede,
+    parse_earl_exer_opti,
+    parse_issu_issu_item_stat,
+    parse_opti_exer,
+    parse_opti_exer_pric_adju,
+)
+from datagokr_reader.base_reader import issuer_name_from_bond_name, normalize_name
+
+
+def run_bond_workflow(datagokr_api_key: str, bond_name: str):
+    """
+    채권명 to {"함수명": 결과, ...} dict
+    """
+    bond_name_normalized = normalize_name(bond_name)
+    issuer_name = issuer_name_from_bond_name(bond_name)
+
+    issu = parse_issu_issu_item_stat(
+        serviceKey=datagokr_api_key,
+        bondIsurNm=issuer_name,
+        bondNm=bond_name_normalized,
+    )
+
+    crno = issu.get("crno") if isinstance(issu, dict) else ""
+    isinCdKey = issu.get("isinCd") if isinstance(issu, dict) else None
+    basDt = issu.get("basDt") if isinstance(issu, dict) else None
+
+    bond_with = parse_bond_with_opti_call_rede(
+        serviceKey=datagokr_api_key,
+        crno=crno,
+        opbdIsurNm=issuer_name,
+        isinCdKey=isinCdKey,
+    )
+    opti_exer = parse_opti_exer(
+        serviceKey=datagokr_api_key,
+        crno=crno,
+        isinCdKey=isinCdKey,
+    )
+    opti_adju = parse_opti_exer_pric_adju(
+        serviceKey=datagokr_api_key,
+        crno=crno,
+        isinCdKey=isinCdKey,
+    )
+    earl = parse_earl_exer_opti(
+        serviceKey=datagokr_api_key,
+        basDt=basDt,
+        bondIsurNm=issuer_name,
+        crno=crno,
+        isinCdKey=isinCdKey,
+    )
+
+    return {
+        "parse_issu_issu_item_stat": issu,
+        "parse_bond_with_opti_call_rede": bond_with,
+        "parse_opti_exer": opti_exer,
+        "parse_opti_exer_pric_adju": opti_adju,
+        "parse_earl_exer_opti": earl,
+    }
+

datagokr_reader-1.0.0/src/datagokr_reader.egg-info/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: datagokr_reader
+Version: 1.0.0
+Summary:  data.go.kr의 채권 관련 API를 사용하기 편하게 만든 라이브러리입니다.
+Author: WONWOO LEE
+License-Expression: MIT
+Project-URL: Repository, https://example.com
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+
+ ## DatagokrReader
+ 
+ data.go.kr의 채권 관련 API를 사용하기 편하게 만든 라이브러리입니다.
+ 
+ ### Example
+ 
+ ```python
+from datagokr_reader import run_bond_workflow
+
+# 띄어쓰기 및 대소문자 무관, 채권 관련 주요 데이터 모두 정리
+ result = run_bond_workflow(datagokr_api_key, "공공데이터포털1EB") 
+ ```

datagokr_reader-1.0.0/src/datagokr_reader.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+src/datagokr_reader/__init__.py
+src/datagokr_reader/base_reader.py
+src/datagokr_reader/cli.py
+src/datagokr_reader/getBondBasiInfo.py
+src/datagokr_reader/getBondWithOptiCallRede.py
+src/datagokr_reader/getEarlExerOpti.py
+src/datagokr_reader/getIssuIssuItemStat.py
+src/datagokr_reader/getOptiExer.py
+src/datagokr_reader/getOptiExerPricAdju.py
+src/datagokr_reader/workflow.py
+src/datagokr_reader.egg-info/PKG-INFO
+src/datagokr_reader.egg-info/SOURCES.txt
+src/datagokr_reader.egg-info/dependency_links.txt
+src/datagokr_reader.egg-info/entry_points.txt
+src/datagokr_reader.egg-info/requires.txt
+src/datagokr_reader.egg-info/top_level.txt

datagokr_reader-1.0.0/src/datagokr_reader.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

datagokr_reader-1.0.0/src/datagokr_reader.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+datagokr-reader = datagokr_reader.cli:main

datagokr_reader-1.0.0/src/datagokr_reader.egg-info/requires.txt

@@ -0,0 +1,4 @@
+httpx>=0.27
+
+[dev]
+pytest>=8.0

datagokr_reader-1.0.0/src/datagokr_reader.egg-info/top_level.txt

@@ -0,0 +1 @@
+datagokr_reader