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

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/.github/workflows/ci.yml

@@ -27,10 +27,10 @@ jobs:
     name: Lint & type-check
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v8.1.0
         with:
           enable-cache: true
 
@@ -58,10 +58,10 @@ jobs:
       matrix:
         python-version: ["3.10", "3.11", "3.12"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v8.1.0
         with:
           enable-cache: true
 

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/.github/workflows/codeql.yml

@@ -24,15 +24,15 @@ jobs:
       security-events: write
       contents: read
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@v3
+        uses: github/codeql-action/init@v4
         with:
           languages: python
           queries: security-extended
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v3
+        uses: github/codeql-action/analyze@v4
         with:
           category: "/language:python"

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

@@ -15,10 +15,10 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v8.1.0
         with:
           enable-cache: true
 
@@ -32,7 +32,7 @@ jobs:
 
       - name: Deploy to GitHub Pages
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./site

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/.github/workflows/nightly-e2e.yml

@@ -24,10 +24,10 @@ jobs:
     # fork에는 secret이 없어 의미가 없으므로 upstream 레포에서만 실행
     if: github.repository == 'choo121600/ecos-reader'
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v8.1.0
         with:
           enable-cache: true
 

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/.github/workflows/publish.yml

@@ -27,10 +27,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.10'
 
@@ -43,7 +43,7 @@ jobs:
         run: python -m build
 
       - name: Store the distribution packages
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: python-package-distributions
           path: dist/
@@ -61,7 +61,7 @@ jobs:
 
     steps:
       - name: Download all the dists
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: python-package-distributions
           path: dist/
@@ -78,10 +78,10 @@ jobs:
       contents: write  # IMPORTANT: mandatory for creating releases
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Download all the dists
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: python-package-distributions
           path: dist/

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/.github/workflows/security.yml

@@ -20,10 +20,10 @@ jobs:
     name: pip-audit
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v8.1.0
         with:
           enable-cache: true
 

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

@@ -5,6 +5,22 @@ 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.4.0] - 2026-05-31
+
+> Epic #57(Deprecation 정리)의 **BREAKING** 릴리스. v0.2.2(#20)에서
+> `EcosDeprecationWarning` 과 함께 deprecated 처리됐던 레거시 frequency
+> 단일 문자 표기를 제거합니다. 마이그레이션: 사용자 가이드 > v0.4.0 마이그레이션.
+
+### Removed (BREAKING)
+- 레거시 `frequency` 단일 문자 표기(`"D"`/`"M"`/`"Q"`/`"A"`) 제거. 이제 정식
+  어휘(`"daily"`/`"monthly"`/`"quarterly"`/`"annual"`)만 허용하며, 정식이 아닌
+  값은 경고 없이 즉시 `ValueError` 를 발생시킵니다. (#65)
+- `EcosDeprecationWarning` 클래스 및 공개 export 제거. frequency 단일 문자
+  표기 전용 경고였으며, 해당 표기 제거와 함께 더 이상 노출되지 않습니다. (#65)
+
+### Added
+- v0.4.0 마이그레이션 가이드(사용자 가이드). (#66)
+
 ## [0.3.0] - 2026-05-31
 
 > Epic #56(Partial-coverage 재설계)의 **BREAKING** 릴리스. 함수명이 전체 시리즈를
@@ -320,6 +336,7 @@ v0.1.6 라이브 e2e 검증에서 드러난 follow-up(#2 Reliability epic)을
   - 기본 사용법 (`examples/basic_usage.py`)
   - 거시경제 대시보드 (`examples/macro_dashboard.py`)
 
+[0.4.0]: https://github.com/choo121600/ecos-reader/compare/v0.3.0...v0.4.0
 [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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ecos-reader
-Version: 0.3.0
+Version: 0.4.0
 Summary: 한국은행 ECOS Open API Python 클라이언트
 Project-URL: Homepage, https://github.com/choo121600/ecos-reader
 Project-URL: Documentation, https://choo121600.github.io/ecos-reader/

ecos_reader-0.4.0/docs/user-guide/migration-frequency.md

@@ -0,0 +1,31 @@
+# frequency 표기 마이그레이션 (#20, #57)
+
+이 문서는 `frequency` 인자 표기 변경(레거시 단일 문자 → 정식 풀네임)에 대한 안내입니다.
+v0.4.0(#57)부터 레거시 단일 문자 표기는 **제거**되어 더 이상 허용되지 않습니다.
+
+## 한눈에 보기
+
+| 카테고리 | 함수 | 레거시(제거됨) | 정식(필수) |
+|---|---|---|---|
+| 성장 | `get_gdp`, `get_gdp_deflator` 등 | `Q`, `A` | `quarterly`, `annual` |
+| 금리 | `get_base_rate` | `D`, `M` | `daily`, `monthly` |
+| 주식 | `get_stock_index` | (없음) | `daily`, `monthly` |
+
+## 권장 변경
+
+```python
+# Before (v0.3.x 이하, 이제 ValueError)
+df = ecos.get_gdp(frequency="Q")
+
+# After (정식)
+df = ecos.get_gdp(frequency="quarterly")
+```
+
+## 동작/타임라인
+
+- v0.2.2: 정식 어휘 도입. 레거시 단일 문자는 `EcosDeprecationWarning` 과 함께 계속 동작.
+- **v0.4.0: 레거시 단일 문자 제거.** 이제 정식 어휘만 허용하며, 정식이 아닌
+  값은 경고 없이 즉시 `ValueError` 입니다. frequency 전용 경고였던
+  `EcosDeprecationWarning` 도 함께 제거되었습니다.
+
+v0.4.0 변경 상세는 [v0.4.0 마이그레이션](migration-v0.4.0.md) 을 참고하세요.

ecos_reader-0.4.0/docs/user-guide/migration-v0.4.0.md

@@ -0,0 +1,62 @@
+# v0.4.0 마이그레이션 가이드
+
+v0.4.0은 deprecation cycle이 만료된 항목을 제거하는 **BREAKING** 릴리스입니다.
+v0.2.2(#20)에서 `EcosDeprecationWarning` 과 함께 deprecated 처리된 레거시
+frequency 단일 문자 표기가 제거되었습니다.
+
+## 무엇이 바뀌었나
+
+- 레거시 frequency 단일 문자 표기(`"D"` / `"M"` / `"Q"` / `"A"`)가 **제거**되었습니다.
+- 이제 정식(canonical) 어휘만 허용합니다.
+
+  | 레거시 (제거됨) | 정식 어휘 |
+  | :-------------- | :---------- |
+  | `"D"`           | `"daily"`     |
+  | `"M"`           | `"monthly"`   |
+  | `"Q"`           | `"quarterly"` |
+  | `"A"`           | `"annual"`    |
+
+- 정식이 아닌 값은 경고 없이 **즉시 `ValueError`** 를 발생시킵니다.
+  (이전에는 레거시 표기를 `EcosDeprecationWarning` 과 함께 통과시켰습니다.)
+- frequency 전용 경고였던 `EcosDeprecationWarning` 클래스가 제거되어
+  `ecos` 패키지에서 더 이상 export되지 않습니다.
+
+## 영향을 받는 함수
+
+frequency 인자를 받는 지표 함수들입니다.
+
+- `get_gdp` 등 성장 지표: `"quarterly"` / `"annual"`
+- `get_base_rate` 등 금리 지표: `"daily"` / `"monthly"`
+- `get_stock_index` 등 주식 지표: `"daily"` / `"monthly"`
+
+## 코드 변경 방법
+
+레거시 단일 문자를 정식 어휘로 교체하세요.
+
+```python
+import ecos
+
+# 이전 (v0.3.x 이하) — deprecated, v0.4.0에서 제거됨 (이제 ValueError)
+df = ecos.get_gdp(frequency="Q")
+df = ecos.get_base_rate(frequency="D")
+
+# 이후 (v0.4.0+)
+df = ecos.get_gdp(frequency="quarterly")
+df = ecos.get_base_rate(frequency="daily")
+```
+
+`EcosDeprecationWarning` 을 직접 참조하던 코드가 있다면 제거하세요.
+
+```python
+# 이전 — 더 이상 동작하지 않음 (ImportError)
+import warnings
+from ecos import EcosDeprecationWarning
+warnings.simplefilter("ignore", EcosDeprecationWarning)
+
+# 이후 — 해당 경고가 제거되었으므로 이 코드는 불필요합니다.
+```
+
+## 참고
+
+- `_registry.py` 의 `DateFormat = Literal["D", "M", "Q", "A"]` 는 ECOS API의
+  내부 period 코드로, frequency 어휘와 무관하며 변경되지 않았습니다.

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ecos-reader"
-version = "0.3.0"
+version = "0.4.0"
 description = "한국은행 ECOS Open API Python 클라이언트"
 readme = "README.md"
 license = "MIT"

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/src/ecos/__init__.py

@@ -20,7 +20,7 @@ Examples
 
 from __future__ import annotations
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 __author__ = "yeonguk"
 
 # Config API
@@ -86,9 +86,6 @@ from .indicators import (
     list_indicators,
 )
 
-# Warnings
-from .indicators._frequency import EcosDeprecationWarning
-
 # Logging API
 from .logging import setup_logging
 
@@ -120,8 +117,6 @@ __all__ = [
     "EcosRateLimitError",
     "EcosServerError",
     "EcosValidationError",
-    # Warnings
-    "EcosDeprecationWarning",
     # 재정 지표
     "get_fiscal_balance",
     # 주식시장 지표

ecos_reader-0.4.0/src/ecos/indicators/_frequency.py

@@ -0,0 +1,54 @@
+"""
+frequency 어휘 통일 (#20, #57).
+
+과거에는 카테고리마다 ``frequency`` 값 표기가 달랐고, 레거시 단일 문자
+표기(``D``/``M``/``Q``/``A``)를 :class:`EcosDeprecationWarning` 과 함께
+한시적으로 허용했다.
+
+v0.4.0(#57)부터 레거시 표기는 **제거**되었으며, 정식(canonical) 풀네임
+어휘만 허용한다::
+
+    daily | monthly | quarterly | annual
+
+정식이 아닌 값은 경고 없이 즉시 :class:`ValueError` 로 처리한다.
+"""
+
+from __future__ import annotations
+
+
+def normalize_frequency(
+    value: str,
+    *,
+    allowed: tuple[str, ...],
+    func_name: str,
+) -> str:
+    """frequency 값을 검증한다.
+
+    Parameters
+    ----------
+    value : str
+        호출자가 전달한 frequency 값
+        (정식 어휘 ``daily``/``monthly``/``quarterly``/``annual``).
+    allowed : tuple of str
+        해당 지표가 지원하는 정식 frequency 값의 튜플
+        (예: ``("quarterly", "annual")``).
+    func_name : str
+        에러 메시지에 쓰이는 공개 함수명(예: ``"get_gdp"``).
+
+    Returns
+    -------
+    str
+        검증된 frequency 값.
+
+    Raises
+    ------
+    ValueError
+        ``value`` 가 ``allowed`` 에 없을 때. 레거시 단일 문자 표기
+        (``D``/``M``/``Q``/``A``)는 v0.4.0에서 제거되었으므로 동일하게
+        ``ValueError`` 로 처리된다.
+    """
+    if value not in allowed:
+        allowed_str = " 또는 ".join(repr(a) for a in allowed)
+        raise ValueError(f"{func_name}(): frequency는 {allowed_str} 중 하나여야 합니다.")
+
+    return value

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/src/ecos/indicators/growth.py

@@ -34,7 +34,7 @@ if TYPE_CHECKING:
 
 
 def get_gdp(
-    frequency: Literal["quarterly", "annual", "Q", "A"] = "quarterly",
+    frequency: Literal["quarterly", "annual"] = "quarterly",
     basis: Literal["real", "nominal"] = "real",
     start_date: str | None = None,
     end_date: str | None = None,
@@ -48,9 +48,6 @@ def get_gdp(
         조회 주기
         - 'quarterly': 분기 (기본값)
         - 'annual': 연간
-
-        레거시 'Q'/'A'도 당분간 허용되나 EcosDeprecationWarning과 함께
-        deprecated이며 v0.4.0에서 제거됩니다.
     basis : str
         GDP 기준
         - 'real': 실질 GDP (기본값)
@@ -114,7 +111,7 @@ def get_gdp(
 
 
 def get_gdp_deflator(
-    frequency: Literal["quarterly", "annual", "Q", "A"] = "quarterly",
+    frequency: Literal["quarterly", "annual"] = "quarterly",
     start_date: str | None = None,
     end_date: str | None = None,
 ) -> pd.DataFrame:
@@ -130,9 +127,6 @@ def get_gdp_deflator(
         조회 주기
         - 'quarterly': 분기 (기본값)
         - 'annual': 연간
-
-        레거시 'Q'/'A'도 당분간 허용되나 EcosDeprecationWarning과 함께
-        deprecated이며 v0.4.0에서 제거됩니다.
     start_date : str, optional
         조회 시작일
     end_date : str, optional
@@ -188,7 +182,7 @@ def get_gdp_deflator(
 
 
 def get_gdp_growth_rate(
-    frequency: Literal["quarterly", "annual", "Q", "A"] = "quarterly",
+    frequency: Literal["quarterly", "annual"] = "quarterly",
     start_date: str | None = None,
     end_date: str | None = None,
 ) -> pd.DataFrame:
@@ -203,9 +197,6 @@ def get_gdp_growth_rate(
         조회 주기
         - 'quarterly': 분기 (기본값)
         - 'annual': 연간
-
-        레거시 'Q'/'A'도 당분간 허용되나 EcosDeprecationWarning과 함께
-        deprecated이며 v0.4.0에서 제거됩니다.
     start_date : str, optional
         조회 시작일
         - 분기: YYYYQN 형식 (예: 2020Q1)
@@ -271,7 +262,7 @@ def get_gdp_growth_rate(
 def get_gdp_by_industry(
     basis: Literal["real", "nominal"] = "real",
     seasonal_adj: bool = True,
-    frequency: Literal["quarterly", "annual", "Q", "A"] = "quarterly",
+    frequency: Literal["quarterly", "annual"] = "quarterly",
     sub_category: str | None = None,
     start_date: str | None = None,
     end_date: str | None = None,
@@ -295,9 +286,6 @@ def get_gdp_by_industry(
         조회 주기
         - 'quarterly': 분기 (기본값)
         - 'annual': 연간
-
-        레거시 'Q'/'A'도 당분간 허용되나 EcosDeprecationWarning과 함께
-        deprecated이며 v0.4.0에서 제거됩니다.
     sub_category : str, optional
         세부 산업(항목명 또는 item_code1). 지정 시 해당 산업 단일 시계열만
         반환합니다. 미지정 시 전체 산업을 long-format으로 반환합니다.
@@ -395,7 +383,7 @@ def get_gdp_by_industry(
 
 def get_gdp_by_expenditure(
     basis: Literal["real", "nominal"] = "real",
-    frequency: Literal["quarterly", "annual", "Q", "A"] = "quarterly",
+    frequency: Literal["quarterly", "annual"] = "quarterly",
     sub_category: str | None = None,
     start_date: str | None = None,
     end_date: str | None = None,
@@ -417,9 +405,6 @@ def get_gdp_by_expenditure(
         조회 주기
         - 'quarterly': 분기 (기본값)
         - 'annual': 연간
-
-        레거시 'Q'/'A'도 당분간 허용되나 EcosDeprecationWarning과 함께
-        deprecated이며 v0.4.0에서 제거됩니다.
     sub_category : str, optional
         세부 지출항목(항목명 또는 item_code1). 지정 시 해당 항목 단일 시계열만
         반환합니다. 미지정 시 전체 지출항목을 long-format으로 반환합니다.
@@ -512,7 +497,7 @@ def get_gdp_by_expenditure(
 
 
 def get_gdp_deflator_by_industry(
-    frequency: Literal["quarterly", "annual", "Q", "A"] = "quarterly",
+    frequency: Literal["quarterly", "annual"] = "quarterly",
     sub_category: str | None = None,
     start_date: str | None = None,
     end_date: str | None = None,
@@ -530,9 +515,6 @@ def get_gdp_deflator_by_industry(
         조회 주기
         - 'quarterly': 분기 (기본값)
         - 'annual': 연간
-
-        레거시 'Q'/'A'도 당분간 허용되나 EcosDeprecationWarning과 함께
-        deprecated이며 v0.4.0에서 제거됩니다.
     sub_category : str, optional
         세부 산업(항목명 또는 item_code1). 지정 시 해당 산업 단일 시계열만
         반환합니다. 미지정 시 전체 산업을 long-format으로 반환합니다.

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/src/ecos/indicators/interest_rate.py

@@ -32,7 +32,7 @@ from ._registry import get_indicator
 def get_base_rate(
     start_date: str | None = None,
     end_date: str | None = None,
-    frequency: Literal["daily", "monthly", "D", "M"] = "monthly",
+    frequency: Literal["daily", "monthly"] = "monthly",
 ) -> pd.DataFrame:
     """
     한국은행 기준금리를 조회합니다.
@@ -50,10 +50,6 @@ def get_base_rate(
         - 'daily': 일별 (날짜 YYYYMMDD). 기준금리는 변경일에만 갱신되어
           결과가 sparse 합니다 (변경이 없는 날은 행이 없음).
 
-        레거시 단일 문자(``'M'``/``'D'``)도 당분간 허용되나
-        :class:`~ecos.EcosDeprecationWarning` 과 함께 deprecated이며
-        v0.4.0에서 제거됩니다.
-
     Returns
     -------
     pd.DataFrame
@@ -74,7 +70,7 @@ def get_base_rate(
 
     >>> # 일별 (변경일 단위) 조회
     >>> df = ecos.get_base_rate(
-    ...     start_date="20200101", end_date="20231231", frequency="D"
+    ...     start_date="20200101", end_date="20231231", frequency="daily"
     ... )
     """
     frequency = normalize_frequency(  # type: ignore[assignment]

ecos_reader-0.4.0/tests/indicators/test_frequency.py

@@ -0,0 +1,92 @@
+"""frequency 정규화 동작 검증 (#20, #57).
+
+정식 어휘(daily/monthly/quarterly/annual)만 허용한다. 레거시 단일 문자
+(D/M/Q/A)는 v0.4.0(#57)에서 제거되어 즉시 ValueError로 처리된다.
+"""
+
+from __future__ import annotations
+
+import warnings
+
+import pytest
+
+from ecos.indicators._frequency import normalize_frequency
+
+
+class TestNormalizeFrequencyCanonical:
+    """정식 어휘는 그대로 통과한다."""
+
+    def test_canonical_passthrough(self):
+        for value in ("daily", "monthly", "quarterly", "annual"):
+            assert (
+                normalize_frequency(
+                    value,
+                    allowed=("daily", "monthly", "quarterly", "annual"),
+                    func_name="test",
+                )
+                == value
+            )
+
+    def test_canonical_no_warning(self):
+        with warnings.catch_warnings():
+            warnings.simplefilter("error")
+            result = normalize_frequency("monthly", allowed=("monthly",), func_name="test")
+        assert result == "monthly"
+
+
+class TestNormalizeFrequencyLegacyRemoved:
+    """레거시 단일 문자는 제거되어 즉시 ValueError로 처리된다."""
+
+    def test_legacy_aliases_raise(self):
+        for legacy in ("D", "M", "Q", "A"):
+            with pytest.raises(ValueError, match="frequency"):
+                normalize_frequency(
+                    legacy,
+                    allowed=("daily", "monthly", "quarterly", "annual"),
+                    func_name="test",
+                )
+
+    def test_legacy_raises_without_warning(self):
+        """레거시 표기는 경고 없이 곧바로 ValueError."""
+        with warnings.catch_warnings():
+            warnings.simplefilter("error")
+            with pytest.raises(ValueError, match="frequency"):
+                normalize_frequency("Q", allowed=("quarterly", "annual"), func_name="get_gdp")
+
+    def test_invalid_raises_valueerror(self):
+        with pytest.raises(ValueError, match="frequency"):
+            normalize_frequency("W", allowed=("daily", "monthly"), func_name="test")
+
+    def test_canonical_outside_allowed_raises(self):
+        """정식 어휘라도 allowed에 없으면 ValueError."""
+        with pytest.raises(ValueError, match="frequency"):
+            normalize_frequency("daily", allowed=("quarterly", "annual"), func_name="test")
+
+    def test_error_message_includes_func_name(self):
+        with pytest.raises(ValueError, match="get_gdp"):
+            normalize_frequency("Q", allowed=("quarterly", "annual"), func_name="get_gdp")
+
+
+class TestFrequencyWiringPerFunction:
+    """per-function wiring: 레거시 표기는 ValueError로 거부된다."""
+
+    def test_get_gdp_legacy_quarterly_raises(self):
+        """get_gdp(frequency='Q')는 ValueError."""
+        from ecos import get_gdp
+
+        with pytest.raises(ValueError, match="frequency"):
+            get_gdp(frequency="Q", start_date="2024Q1", end_date="2024Q1")
+
+    def test_get_base_rate_legacy_daily_raises(self):
+        """get_base_rate(frequency='D')는 ValueError."""
+        from ecos import get_base_rate
+
+        with pytest.raises(ValueError, match="frequency"):
+            get_base_rate(frequency="D", start_date="20240101", end_date="20241231")
+
+    def test_get_stock_index_legacy_daily_raises(self):
+        """get_stock_index(frequency='D')는 ValueError."""
+        from ecos import get_stock_index
+
+        with pytest.raises(ValueError, match="frequency"):
+            get_stock_index(frequency="D")

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/tests/indicators/test_interest_rate.py

@@ -57,7 +57,7 @@ class TestGetBaseRate:
 
     @responses.activate
     def test_get_base_rate_daily_frequency(self):
-        """일별(frequency='D') 조회 — 722Y001 은 일별 원천."""
+        """일별(frequency='daily') 조회 — 722Y001 은 일별 원천."""
         mock_response = {
             "StatisticSearch": {
                 "row": [

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/tests/test_e2e_indicators.py

@@ -772,7 +772,7 @@ class TestE2ERegressionV016:
     # ---- GDP 연간 fallback (#28) ----
 
     def test_gdp_growth_rate_annual_fallback(self):
-        """frequency='A'는 계절조정(분기 전용) 대신 원계열 200Y106으로 fallback해야 함."""
+        """frequency='annual'은 계절조정(분기 전용) 대신 원계열 200Y106으로 fallback해야 함."""
         df = ecos.get_gdp_growth_rate(frequency="annual", start_date="2020", end_date="2023")
 
         assert not df.empty

{ecos_reader-0.3.0 → ecos_reader-0.4.0}/uv.lock

@@ -272,7 +272,7 @@ wheels = [
 
 [[package]]
 name = "ecos-reader"
-version = "0.3.0"
+version = "0.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "pandas" },