Skip to content

[K-006] krx: O(N) API 호출 동작 문서화 (#288)#296

Merged
yeongseon merged 1 commit into
mainfrom
docs/issue-288-krx-on-api-doc
Jul 3, 2026
Merged

[K-006] krx: O(N) API 호출 동작 문서화 (#288)#296
yeongseon merged 1 commit into
mainfrom
docs/issue-288-krx-on-api-doc

Conversation

@yeongseon

Copy link
Copy Markdown
Owner

요약

_fetch_market_valuation_by_day 메서드가 날짜 범위의 모든 달력 날짜마다 별도의 pykrx API를 호출하는 O(N) 동작을 문서화합니다.

변경 내용

adapter.py — _fetch_market_valuation_by_day

  1. docstring에 .. warning:: 블록 추가: 호출 횟수가 O(N_days)임을 명시하고, 주말/공휴일에도 API 호출이 발생함을 안내
  2. 런타임 logger.warning 추가: 날짜 범위가 90일 초과 시 "KRX market_valuation: N일 → API N회 호출 예정" 경고 출력 (로거를 켠 사용자에게 비용 가시화)

검증

  • ruff check 통과
  • mypy 통과
  • pytest tests/unit/providers/krx/ → 37/37 통과

Closes #288

…_by_day

Add a reStructuredText warning block to the docstring explaining that this
method makes one pykrx API call per calendar day (O(N_days)). Also add a
runtime logger.warning when the date range exceeds 90 days so callers see
the cost at debug-level logging.

Closes #288
@yeongseon yeongseon merged commit 786b70f into main Jul 3, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[K-006][P2] krx/adapter.py: pykrx 의존 + O(N) 일별 API 호출 문서화 필요

1 participant