ecos-reader 0.2.1__tar.gz → 0.3.0__tar.gz

ecos_reader-0.3.0/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# 전역 코드 소유자 — 모든 PR에 자동 리뷰 요청
+* @choo121600

ecos_reader-0.3.0/.github/dependabot.yml

@@ -0,0 +1,32 @@
+version: 2
+updates:
+  # Python 의존성 (pyproject.toml / uv.lock) — 주간, 묶음 PR
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    groups:
+      python-dependencies:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+    commit-message:
+      prefix: "deps"
+
+  # GitHub Actions — 주간, 묶음 PR
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    groups:
+      github-actions:
+        patterns:
+          - "*"
+    commit-message:
+      prefix: "ci"

ecos_reader-0.3.0/.github/workflows/codeql.yml

@@ -0,0 +1,38 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    # 매주 월요일 03:00 UTC — main에 머지된 코드의 정기 재스캔
+    - cron: "0 3 * * 1"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: codeql-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  analyze:
+    name: Analyze (Python)
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: python
+          queries: security-extended
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3
+        with:
+          category: "/language:python"

{ecos_reader-0.2.1 → ecos_reader-0.3.0}/.github/workflows/docs.yml

@@ -17,17 +17,18 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
         with:
-          python-version: '3.10'
+          enable-cache: true
 
-      - name: Install dependencies
-        run: |
-          pip install mkdocs mkdocs-material
+      - name: Set up Python
+        run: uv python install 3.12
 
-      - name: Build documentation
-        run: mkdocs build
+      # docs extras(mkdocstrings 포함)로 빌드. --strict로 깨진 링크/누락을
+      # 빌드 실패로 검출 (#18). PR에서도 동일 검증이 실행된다.
+      - name: Build documentation (strict)
+        run: uv run --extra docs --python 3.12 mkdocs build --strict
 
       - name: Deploy to GitHub Pages
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'

ecos_reader-0.3.0/.github/workflows/nightly-e2e.yml

@@ -0,0 +1,43 @@
+name: Nightly E2E
+
+# 실 ECOS Open API를 호출하는 e2e 테스트를 매일 1회 실행해 외부 API 회귀를 감시한다.
+# PR CI(ci.yml)는 `pytest -m "not e2e"`로 빠른 피드백만 담당하고, 실 API 검증은
+# 여기서 분리 실행한다. (ECOS rate limit: 3분간 300회 / 초과 시 30분 차단)
+
+on:
+  schedule:
+    # 매일 18:00 UTC (= 03:00 KST)
+    - cron: "0 18 * * *"
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: false
+
+jobs:
+  e2e:
+    name: E2E (real ECOS API)
+    runs-on: ubuntu-latest
+    # fork에는 secret이 없어 의미가 없으므로 upstream 레포에서만 실행
+    if: github.repository == 'choo121600/ecos-reader'
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Sync dev dependencies
+        run: uv sync --extra dev --python 3.12
+
+      - name: Run e2e tests
+        env:
+          ECOS_API_KEY: ${{ secrets.ECOS_API_KEY }}
+        run: uv run pytest -m "e2e"

ecos_reader-0.3.0/.github/workflows/security.yml

@@ -0,0 +1,39 @@
+name: Security
+
+on:
+  # pip-audit는 신규 공시 취약점을 주기적으로 점검하는 용도(이슈 #19).
+  # PR 게이트는 CodeQL이 담당하므로 여기서는 주간 스케줄 + 수동 실행만 둔다.
+  schedule:
+    # 매주 월요일 04:00 UTC
+    - cron: "0 4 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: security-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  pip-audit:
+    name: pip-audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      # 모든 extras를 포함해 .venv를 구성한 뒤, 설치된 환경을 직접 감사한다.
+      # requirements 파일 감사는 pip-audit가 격리 venv를 빌드하므로 환경 감사가 더 견고.
+      - name: Sync dependencies
+        run: uv sync --all-extras --python 3.12
+
+      - name: Run pip-audit
+        run: uv run --with pip-audit pip-audit

{ecos_reader-0.2.1 → ecos_reader-0.3.0}/.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v5.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -24,4 +24,7 @@ repos:
     rev: v1.13.0
     hooks:
       - id: mypy
+        # mypy strict(#17)는 src 패키지에만 적용 — CI(ci.yml)의 `mypy src/ecos`와
+        # 동일 범위. 테스트는 무타입 함수가 정상이므로 strict 대상에서 제외.
+        files: ^src/ecos/
         additional_dependencies: [types-requests]

{ecos_reader-0.2.1 → ecos_reader-0.3.0}/CHANGELOG.md

@@ -5,6 +5,61 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-05-31
+
+> Epic #56(Partial-coverage 재설계)의 **BREAKING** 릴리스. 함수명이 전체 시리즈를
+> 시사하지만 단일 ECOS 항목만 반환하던 함수들을 전체 시리즈 long-format +
+> `sub_category` 선택으로 재설계했습니다. 마이그레이션: 사용자 가이드 > v0.3.0 마이그레이션.
+
+### Changed (BREAKING)
+- partial-coverage 함수들의 기본 반환이 **단일 시계열 → 전체 분류 long-format**
+  (`date, category_value, value, unit`)으로 변경. 단일 시계열은 `sub_category` 로 선택.
+  - `get_gdp_by_industry` / `get_gdp_by_expenditure` / `get_gdp_deflator_by_industry` — PR #85 (#59)
+  - `get_stock_index(monthly)`(item_code 1010000 회사수 → 1070000 KOSPI 종가 정정) /
+    `get_investor_trading`(`action`·`metric` 인자 추가) — PR #86 (#60)
+  - `get_cpi_monthly` — PR #87 (#61)
+  - `get_household_lending_detail` — PR #88 (#62)
+  - `get_bond_yield`(`measure` 인자 추가, 종류별/시장별 분류) — PR #89 (#63)
+- 공통 헬퍼 `select_subcategory` 도입(규약: 개발 > Partial-coverage 재설계 규약). PR #68 (#58).
+
+### Removed (BREAKING)
+- `EcosPartialCoverageWarning` 클래스 및 내부 `ecos.indicators._deprecations` 모듈 제거.
+  모든 partial-coverage 함수가 재설계되어 더 이상 경고를 내지 않습니다. (#64)
+
+### Added
+- v0.3.0 마이그레이션 가이드(사용자 가이드). (#64)
+
+## [0.2.2] - 2026-05-30
+
+> Epic #3(Extensibility & Long-term Design)의 하위 작업을 정리한 릴리스.
+> 모든 변경이 하위호환이라, `0.3.0`(시그니처 breaking 재설계용 예약)을 침범하지
+> 않도록 patch(0.2.2) 로 릴리스합니다.
+
+### Added
+- `frequency` 어휘를 풀네임으로 통일: `daily` / `monthly` / `quarterly` / `annual`.
+  카테고리마다 달랐던 표기(`growth` 의 `Q`/`A`, `interest_rate` 의 `D`/`M`,
+  `stock` 의 `daily`/`monthly`)를 정식 어휘로 일원화. PR #51 (#20).
+- `EcosDeprecationWarning` 공개 export (`from ecos import EcosDeprecationWarning`).
+  레거시 입력값 사용 시 발생하며, 기본 경고 필터에서도 보이도록 `UserWarning` 기반.
+- `mkdocstrings` 도입으로 indicator/클라이언트/예외 API 문서를 docstring 기반
+  자동 생성. PR #53 (#18).
+
+### Deprecated
+- 레거시 단일 문자 `frequency`(`"D"`/`"M"`/`"Q"`/`"A"`). 당분간 동작하되
+  `EcosDeprecationWarning` 을 발생시키며 **v0.4.0** 에서 제거 예정. 정식 어휘로
+  마이그레이션하세요(문서: 사용자 가이드 > frequency 마이그레이션). PR #51 (#20).
+
+### Changed
+- `mypy strict` 모드 적용 — `py.typed` 광고와 실제 타입 안전성을 일치. CI 의
+  `mypy src/ecos` 가 strict 를 강제. PR #52 (#17).
+- `mkdocs build --strict` 적용 — 깨진 링크/누락 페이지를 빌드 실패로 검출,
+  PR 에서도 docs 빌드 검증. PR #53 (#18).
+
+### Internal
+- 보안/유지보수 자동화: `dependabot`(pip·github-actions), `CodeQL`(Python),
+  `pip-audit`(주간), `CODEOWNERS` 추가. `ruff` 규칙에 `S`(bandit)/`RUF`/`PT`/
+  `TC`/`N` 추가. PR #50 (#19).
+
 ## [0.2.1] - 2026-05-29
 
 > 0.3.0 은 시그니처 breaking 재설계(epic #3)를 위해 예약돼 있어, 본 하위호환
@@ -265,6 +320,7 @@ v0.1.6 라이브 e2e 검증에서 드러난 follow-up(#2 Reliability epic)을
   - 기본 사용법 (`examples/basic_usage.py`)
   - 거시경제 대시보드 (`examples/macro_dashboard.py`)
 
+[0.3.0]: https://github.com/choo121600/ecos-reader/compare/v0.2.2...v0.3.0
 [0.1.2]: https://github.com/choo121600/ecos-reader/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/choo121600/ecos-reader/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/choo121600/ecos-reader/releases/tag/v0.1.0

{ecos_reader-0.2.1 → ecos_reader-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ecos-reader
-Version: 0.2.1
+Version: 0.3.0
 Summary: 한국은행 ECOS Open API Python 클라이언트
 Project-URL: Homepage, https://github.com/choo121600/ecos-reader
 Project-URL: Documentation, https://choo121600.github.io/ecos-reader/
@@ -36,8 +36,10 @@ Requires-Dist: responses>=0.23.0; extra == 'dev'
 Requires-Dist: ruff>=0.1.0; extra == 'dev'
 Requires-Dist: types-requests>=2.28.0; extra == 'dev'
 Provides-Extra: docs
-Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
-Requires-Dist: mkdocs>=1.5.0; extra == 'docs'
+Requires-Dist: mkdocs-material<10.0.0,>=9.5.0; extra == 'docs'
+Requires-Dist: mkdocs<2.0.0,>=1.5.0; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == 'docs'
+Requires-Dist: pymdown-extensions>=10.0; extra == 'docs'
 Description-Content-Type: text/markdown
 
 # ecos-reader
@@ -117,7 +119,7 @@ df = ecos.get_treasury_yield(maturity="10Y")
 print(df)
 
 # GDP 조회
-df = ecos.get_gdp(frequency="Q", basis="real")
+df = ecos.get_gdp(frequency="quarterly", basis="real")
 print(df)
 ```
 
@@ -167,7 +169,7 @@ print(df)
 | 함수 | 설명 | 주기 |
 |-----|------|-----|
 | `get_household_credit(category)` | 가계신용 (업권별/용도별) | 분기 |
-| `get_household_lending_detail()` | 예금취급기관 가계대출 (용도별) | 월 |
+| `get_household_lending_detail(sub_category)` | 예금취급기관 가계대출 (용도별) | 월 |
 | `get_borrower_loan(loan_type, category)` | 차주별 가계대출 (신규/잔액) | 분기 |
 
 ### 재정·금융시장 지표
@@ -175,23 +177,17 @@ print(df)
 | 함수 | 설명 | 주기 |
 |-----|------|-----|
 | `get_fiscal_balance()` | 통합재정수지 | 월 |
-| `get_stock_index(frequency)` | 주가지수 KOSPI (일별/월별) | 일/월 |
-| `get_investor_trading()` | 투자자별 주식거래 | 월 |
-| `get_bond_yield(bond_type)` | 채권 수익률 (종류별/시장별) | 월 |
-
-> ⚠️ 다음 함수들은 v0.1.6 기준 단일 ECOS item만 반환하며 호출 시
-> `ecos.EcosPartialCoverageWarning`(`UserWarning` 서브클래스, 기본 필터로도 표시)이
-> 발생합니다. v0.3.0에서 시그니처가 변경됩니다: `get_gdp_by_industry`,
-> `get_gdp_by_expenditure`, `get_gdp_deflator_by_industry`,
-> `get_stock_index(monthly)`, `get_investor_trading`, `get_bond_yield`,
-> `get_household_lending_detail`, `get_borrower_loan`, `get_cpi_monthly`.
-> 자세한 내용은 이슈 #8.
->
-> 경고를 끄려면:
-> ```python
-> import warnings, ecos
-> warnings.simplefilter("ignore", ecos.EcosPartialCoverageWarning)
-> ```
+| `get_stock_index(frequency, sub_category)` | 주가지수 KOSPI (일별/월별) | 일/월 |
+| `get_investor_trading(action, metric, sub_category)` | 투자자별 주식거래 | 월 |
+| `get_bond_yield(bond_type, measure, sub_category)` | 채권 거래 (종류별/시장별) | 월 |
+
+> ℹ️ v0.3.0(#59~#63)에서 과거 단일 ECOS item만 반환하던 함수들이 모두 전체 시리즈
+> long-format + `sub_category` 선택으로 재설계되었습니다:
+> `get_gdp_by_industry`, `get_gdp_by_expenditure`, `get_gdp_deflator_by_industry`,
+> `get_stock_index(monthly)`, `get_investor_trading`, `get_cpi_monthly`,
+> `get_household_lending_detail`, `get_bond_yield`, `get_borrower_loan`(v0.2.0 #29).
+> 과거의 `EcosPartialCoverageWarning`은 제거되었습니다(#64). 자세한 변경·마이그레이션은
+> [v0.3.0 마이그레이션 가이드](docs/user-guide/migration-v0.3.0.md)를 참고하세요.
 
 ## 상세 사용법
 
@@ -205,10 +201,10 @@ df = ecos.get_base_rate(start_date="202001", end_date="202312")
 df = ecos.get_treasury_yield(maturity="3Y", start_date="20240101", end_date="20241231")
 
 # 분기 데이터 (YYYYQN 형식)
-df = ecos.get_gdp(frequency="Q", start_date="2020Q1", end_date="2024Q4")
+df = ecos.get_gdp(frequency="quarterly", start_date="2020Q1", end_date="2024Q4")
 
 # 연간 데이터 (YYYY 형식)
-df = ecos.get_gdp(frequency="A", start_date="2015", end_date="2024")
+df = ecos.get_gdp(frequency="annual", start_date="2015", end_date="2024")
 ```
 
 ### 고급 사용 예제
@@ -238,14 +234,14 @@ plt.show()
 import ecos
 
 # 실질 GDP 및 성장률 조회
-gdp = ecos.get_gdp(frequency="Q", basis="real", start_date="2020Q1", end_date="2024Q4")
-growth = ecos.get_gdp_growth_rate(frequency="Q", start_date="2020Q1", end_date="2024Q4")
+gdp = ecos.get_gdp(frequency="quarterly", basis="real", start_date="2020Q1", end_date="2024Q4")
+growth = ecos.get_gdp_growth_rate(frequency="quarterly", start_date="2020Q1", end_date="2024Q4")
 
 # 산업별 기여도 분석
 industry_gdp = ecos.get_gdp_by_industry(
     basis="real",
     seasonal_adj=True,
-    frequency="Q",
+    frequency="quarterly",
     start_date="2023Q1",
     end_date="2023Q4"
 )

{ecos_reader-0.2.1 → ecos_reader-0.3.0}/README.md

@@ -75,7 +75,7 @@ df = ecos.get_treasury_yield(maturity="10Y")
 print(df)
 
 # GDP 조회
-df = ecos.get_gdp(frequency="Q", basis="real")
+df = ecos.get_gdp(frequency="quarterly", basis="real")
 print(df)
 ```
 
@@ -125,7 +125,7 @@ print(df)
 | 함수 | 설명 | 주기 |
 |-----|------|-----|
 | `get_household_credit(category)` | 가계신용 (업권별/용도별) | 분기 |
-| `get_household_lending_detail()` | 예금취급기관 가계대출 (용도별) | 월 |
+| `get_household_lending_detail(sub_category)` | 예금취급기관 가계대출 (용도별) | 월 |
 | `get_borrower_loan(loan_type, category)` | 차주별 가계대출 (신규/잔액) | 분기 |
 
 ### 재정·금융시장 지표
@@ -133,23 +133,17 @@ print(df)
 | 함수 | 설명 | 주기 |
 |-----|------|-----|
 | `get_fiscal_balance()` | 통합재정수지 | 월 |
-| `get_stock_index(frequency)` | 주가지수 KOSPI (일별/월별) | 일/월 |
-| `get_investor_trading()` | 투자자별 주식거래 | 월 |
-| `get_bond_yield(bond_type)` | 채권 수익률 (종류별/시장별) | 월 |
-
-> ⚠️ 다음 함수들은 v0.1.6 기준 단일 ECOS item만 반환하며 호출 시
-> `ecos.EcosPartialCoverageWarning`(`UserWarning` 서브클래스, 기본 필터로도 표시)이
-> 발생합니다. v0.3.0에서 시그니처가 변경됩니다: `get_gdp_by_industry`,
-> `get_gdp_by_expenditure`, `get_gdp_deflator_by_industry`,
-> `get_stock_index(monthly)`, `get_investor_trading`, `get_bond_yield`,
-> `get_household_lending_detail`, `get_borrower_loan`, `get_cpi_monthly`.
-> 자세한 내용은 이슈 #8.
->
-> 경고를 끄려면:
-> ```python
-> import warnings, ecos
-> warnings.simplefilter("ignore", ecos.EcosPartialCoverageWarning)
-> ```
+| `get_stock_index(frequency, sub_category)` | 주가지수 KOSPI (일별/월별) | 일/월 |
+| `get_investor_trading(action, metric, sub_category)` | 투자자별 주식거래 | 월 |
+| `get_bond_yield(bond_type, measure, sub_category)` | 채권 거래 (종류별/시장별) | 월 |
+
+> ℹ️ v0.3.0(#59~#63)에서 과거 단일 ECOS item만 반환하던 함수들이 모두 전체 시리즈
+> long-format + `sub_category` 선택으로 재설계되었습니다:
+> `get_gdp_by_industry`, `get_gdp_by_expenditure`, `get_gdp_deflator_by_industry`,
+> `get_stock_index(monthly)`, `get_investor_trading`, `get_cpi_monthly`,
+> `get_household_lending_detail`, `get_bond_yield`, `get_borrower_loan`(v0.2.0 #29).
+> 과거의 `EcosPartialCoverageWarning`은 제거되었습니다(#64). 자세한 변경·마이그레이션은
+> [v0.3.0 마이그레이션 가이드](docs/user-guide/migration-v0.3.0.md)를 참고하세요.
 
 ## 상세 사용법
 
@@ -163,10 +157,10 @@ df = ecos.get_base_rate(start_date="202001", end_date="202312")
 df = ecos.get_treasury_yield(maturity="3Y", start_date="20240101", end_date="20241231")
 
 # 분기 데이터 (YYYYQN 형식)
-df = ecos.get_gdp(frequency="Q", start_date="2020Q1", end_date="2024Q4")
+df = ecos.get_gdp(frequency="quarterly", start_date="2020Q1", end_date="2024Q4")
 
 # 연간 데이터 (YYYY 형식)
-df = ecos.get_gdp(frequency="A", start_date="2015", end_date="2024")
+df = ecos.get_gdp(frequency="annual", start_date="2015", end_date="2024")
 ```
 
 ### 고급 사용 예제
@@ -196,14 +190,14 @@ plt.show()
 import ecos
 
 # 실질 GDP 및 성장률 조회
-gdp = ecos.get_gdp(frequency="Q", basis="real", start_date="2020Q1", end_date="2024Q4")
-growth = ecos.get_gdp_growth_rate(frequency="Q", start_date="2020Q1", end_date="2024Q4")
+gdp = ecos.get_gdp(frequency="quarterly", basis="real", start_date="2020Q1", end_date="2024Q4")
+growth = ecos.get_gdp_growth_rate(frequency="quarterly", start_date="2020Q1", end_date="2024Q4")
 
 # 산업별 기여도 분석
 industry_gdp = ecos.get_gdp_by_industry(
     basis="real",
     seasonal_adj=True,
-    frequency="Q",
+    frequency="quarterly",
     start_date="2023Q1",
     end_date="2023Q4"
 )

ecos_reader-0.3.0/docs/api-reference/client.md

@@ -0,0 +1,9 @@
+# EcosClient
+
+한국은행 ECOS Open API와 직접 통신하는 저수준 클라이언트 클래스입니다.
+
+::: ecos.EcosClient
+    options:
+      heading_level: 2
+      show_root_heading: true
+      members_order: source

ecos_reader-0.3.0/docs/api-reference/exceptions.md

@@ -0,0 +1,31 @@
+# 예외 처리
+
+ecos-reader가 발생시키는 예외 및 경고 클래스의 자동 생성 API 레퍼런스입니다.
+
+::: ecos.EcosError
+    options:
+      heading_level: 2
+
+::: ecos.EcosAPIError
+    options:
+      heading_level: 2
+
+::: ecos.EcosConfigError
+    options:
+      heading_level: 2
+
+::: ecos.EcosNetworkError
+    options:
+      heading_level: 2
+
+::: ecos.EcosRateLimitError
+    options:
+      heading_level: 2
+
+::: ecos.EcosServerError
+    options:
+      heading_level: 2
+
+::: ecos.EcosValidationError
+    options:
+      heading_level: 2

ecos_reader-0.3.0/docs/api-reference/indicators.md

@@ -0,0 +1,139 @@
+# 지표 함수
+
+모든 지표 조회 함수의 자동 생성 API 레퍼런스입니다.
+
+## 금리 지표
+
+::: ecos.get_base_rate
+    options:
+      heading_level: 3
+
+::: ecos.get_treasury_yield
+    options:
+      heading_level: 3
+
+::: ecos.get_yield_spread
+    options:
+      heading_level: 3
+
+::: ecos.get_bank_deposit_rate
+    options:
+      heading_level: 3
+
+::: ecos.get_bank_lending_rate
+    options:
+      heading_level: 3
+
+## 물가 지표
+
+::: ecos.get_cpi
+    options:
+      heading_level: 3
+
+::: ecos.get_core_cpi
+    options:
+      heading_level: 3
+
+::: ecos.get_cpi_monthly
+    options:
+      heading_level: 3
+
+::: ecos.get_cpi_by_category
+    options:
+      heading_level: 3
+
+::: ecos.get_ppi
+    options:
+      heading_level: 3
+
+## 성장 지표
+
+::: ecos.get_gdp
+    options:
+      heading_level: 3
+
+::: ecos.get_gdp_deflator
+    options:
+      heading_level: 3
+
+::: ecos.get_gdp_growth_rate
+    options:
+      heading_level: 3
+
+::: ecos.get_gdp_by_industry
+    options:
+      heading_level: 3
+
+::: ecos.get_gdp_by_expenditure
+    options:
+      heading_level: 3
+
+::: ecos.get_gdp_deflator_by_industry
+    options:
+      heading_level: 3
+
+## 통화 지표
+
+::: ecos.get_money_supply
+    options:
+      heading_level: 3
+
+::: ecos.get_m1_variants
+    options:
+      heading_level: 3
+
+::: ecos.get_m2_variants
+    options:
+      heading_level: 3
+
+::: ecos.get_m2_by_holder
+    options:
+      heading_level: 3
+
+::: ecos.get_bank_lending
+    options:
+      heading_level: 3
+
+::: ecos.get_household_credit
+    options:
+      heading_level: 3
+
+::: ecos.get_household_lending_detail
+    options:
+      heading_level: 3
+
+::: ecos.get_borrower_loan
+    options:
+      heading_level: 3
+
+## 채권 지표
+
+::: ecos.get_bond_yield
+    options:
+      heading_level: 3
+
+## 재정 지표
+
+::: ecos.get_fiscal_balance
+    options:
+      heading_level: 3
+
+## 주식시장 지표
+
+::: ecos.get_stock_index
+    options:
+      heading_level: 3
+
+::: ecos.get_investor_trading
+    options:
+      heading_level: 3
+
+## 지표 레지스트리
+
+::: ecos.list_indicators
+    options:
+      heading_level: 3
+
+::: ecos.indicators.get_indicator
+    options:
+      heading_level: 3

ecos_reader-0.3.0/docs/development/indicator-registry.md

@@ -0,0 +1,28 @@
+# 선언적 지표 레지스트리 (Indicator Registry)
+
+> 이 파일은 `scripts/gen_indicator_registry_doc.py` 가 `ecos.indicators.INDICATORS` 레지스트리에서 자동 생성합니다. 직접 편집하지 마세요.
+>
+> 전체 ECOS 통계 구현 현황은 `IMPLEMENTATION_STATUS.md` 를 참고하세요. 이 문서는 레지스트리에 등록된 단순 지표만 다룹니다.
+
+등록된 선언적 지표: **6건**
+
+## 금리
+
+| name | 통계표코드 | 항목코드 | 주기 | 단위 | 설명 |
+| --- | --- | --- | --- | --- | --- |
+| `base_rate` | 722Y001 | 0101000 | 월별 | % | 한국은행 기준금리 |
+
+## 물가
+
+| name | 통계표코드 | 항목코드 | 주기 | 단위 | 설명 |
+| --- | --- | --- | --- | --- | --- |
+| `core_cpi` | 901Y010 | 00 | 월별 | % | 근원 소비자물가지수(Core CPI) |
+| `cpi` | 901Y009 | 0 | 월별 | % | 소비자물가지수(CPI) 전년동월비 |
+| `cpi_monthly` | 901Y009 | 0 | 월별 | - | 소비자물가지수 월별 원지수(총지수) |
+| `ppi` | 404Y014 | *AA | 월별 | % | 생산자물가지수(PPI) |
+
+## 재정
+
+| name | 통계표코드 | 항목코드 | 주기 | 단위 | 설명 |
+| --- | --- | --- | --- | --- | --- |
+| `fiscal_balance` | 901Y013 | A | 월별 | 조원 | 통합재정수지 |