kpubdata 0.1.0__tar.gz → 0.2.1__tar.gz

kpubdata-0.2.1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,175 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: "Version bump type"
+        required: true
+        type: choice
+        options:
+          - patch
+          - minor
+          - pre
+        default: patch
+      dry_run:
+        description: "Dry run (skip PyPI publish)"
+        required: false
+        type: boolean
+        default: false
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  bump-version:
+    name: Bump Version
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch'
+    timeout-minutes: 5
+    outputs:
+      new_version: ${{ steps.bump.outputs.new_version }}
+      tag: ${{ steps.bump.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version
+        id: bump
+        shell: bash
+        run: |
+          current=$(python3 -c "
+          import re, pathlib
+          m = re.search(r'version = \"([^\"]+)\"', pathlib.Path('pyproject.toml').read_text())
+          print(m.group(1))
+          ")
+          echo "Current version: ${current}"
+
+          bump="${{ inputs.bump }}"
+          new_version=$(python3 -c "
+          import re
+          v = '${current}'
+          parts = v.split('.')
+          major, minor = int(parts[0]), int(parts[1])
+          patch_raw = parts[2]
+
+          if '${bump}' == 'patch':
+              patch = int(re.match(r'\d+', patch_raw).group())
+              print(f'{major}.{minor}.{patch + 1}')
+          elif '${bump}' == 'minor':
+              print(f'{major}.{minor + 1}.0')
+          elif '${bump}' == 'pre':
+              if 'a' in patch_raw:
+                  patch, pre = patch_raw.split('a')
+                  print(f'{major}.{minor}.{patch}a{int(pre) + 1}')
+              else:
+                  patch = int(patch_raw)
+                  print(f'{major}.{minor}.{patch + 1}a0')
+          ")
+
+          python3 -c "
+          import pathlib
+          p = pathlib.Path('pyproject.toml')
+          p.write_text(p.read_text().replace('version = \"${current}\"', 'version = \"${new_version}\"'))
+          "
+
+          echo "new_version=${new_version}" >> "$GITHUB_OUTPUT"
+          echo "tag=v${new_version}" >> "$GITHUB_OUTPUT"
+          echo "Bumped: ${current} → ${new_version}"
+
+      - name: Commit and tag
+        run: |
+          git add pyproject.toml
+          git commit -m "chore: bump version to ${{ steps.bump.outputs.new_version }}"
+          git tag "${{ steps.bump.outputs.tag }}"
+          git push origin main --tags
+
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    needs: [bump-version]
+    if: always() && (needs.bump-version.result == 'success' || needs.bump-version.result == 'skipped')
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && 'main' || github.ref }}
+
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync --frozen --extra dev
+
+      - name: Run quality gates
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+          uv run mypy src
+          uv run pytest -ra
+
+      - name: Build sdist and wheel
+        run: uv run python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  create-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: [bump-version, build]
+    if: github.event_name == 'workflow_dispatch' && !inputs.dry_run
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${{ needs.bump-version.outputs.tag }}" \
+            --title "${{ needs.bump-version.outputs.tag }}" \
+            --generate-notes \
+            --target main
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [bump-version, build]
+    if: |
+      always() &&
+      needs.build.result == 'success' &&
+      (github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && !inputs.dry_run))
+    environment: pypi
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

kpubdata-0.2.1/.sisyphus/remove-get-record-plan.md

@@ -0,0 +1,18 @@
+## Scope
+- Remove `get_record` from the provider protocol, registry validation, dataset binding, tests, and docs.
+
+## Touched modules
+- `src/kpubdata/core/protocol.py`
+- `src/kpubdata/core/dataset.py`
+- `src/kpubdata/registry.py`
+- affected unit/integration/contract tests
+- API and architecture docs describing removed single-record access
+
+## Risks
+- Public `Dataset.get()` removal can leave stale docs/tests behind.
+- Registry validation and protocol changes can break fake adapters in tests.
+
+## Validation steps
+- Run LSP diagnostics on changed source and test files.
+- Run `uv run pytest`.
+- Run `uv run mypy src`.

{kpubdata-0.1.0 → kpubdata-0.2.1}/API_SPEC.md

@@ -43,12 +43,21 @@ dataset = client.dataset("molit.apartment_trades")
 result = dataset.list(lawd_code="11680", deal_ym="202503")
 ```
 
-### Single record
+`list()` returns exactly one page of results. When another page is available,
+the returned `RecordBatch.next_page` is set.
+
+### List all pages
 
 ```python
-record = dataset.get(id="...")
+dataset = client.dataset("molit.apartment_trades")
+for batch in dataset.list_all(lawd_code="11680", deal_ym="202503"):
+    for item in batch.items:
+        print(item)
 ```
 
+`list_all()` yields one `RecordBatch` per page and follows `next_page`
+automatically until pagination is exhausted.
+
 ### Schema
 
 ```python
@@ -82,9 +91,9 @@ Rules:
 
 Returns `RecordBatch`.
 
-### `get()`
+### `list_all()`
 
-Returns one normalized record or `None`.
+Returns a generator of `RecordBatch` values, one per page.
 
 ### `schema()`
 
@@ -101,7 +110,7 @@ KPubData promises stability for:
 - `Client`
 - `Client.from_env()`
 - dataset discovery methods
-- `Dataset.list/get/schema/call_raw`
+- `Dataset.list/list_all/schema/call_raw`
 - canonical model classes
 - canonical error types
 
@@ -157,4 +166,3 @@ client.call_provider_endpoint("seoul", "SearchSTNTimeTableByIDService", ...)
 | :--- | :--- | :--- |
 | [kpubdata-builder](https://github.com/yeongseon/kpubdata-builder) | [API_CONTRACT.md](https://github.com/yeongseon/kpubdata-builder/blob/main/API_CONTRACT.md) | Builder API 규약 |
 | [kpubdata-studio](https://github.com/yeongseon/kpubdata-studio) | [API_CONTRACT.md](https://github.com/yeongseon/kpubdata-studio/blob/main/API_CONTRACT.md) | Studio API 규약 |
-

{kpubdata-0.1.0 → kpubdata-0.2.1}/ARCHITECTURE.md

@@ -144,7 +144,112 @@ KPubData는 이 모든 은행을 대신 처리해주는 **"통합 키오스크"*
 5.  **5단계: 결과 반환 (Return)**
     - 최종적으로 예쁘게 포장된 `RecordBatch` 객체가 사용자에게 전달됩니다.
 
-## 6. 자주 묻는 질문 (FAQ)
+## 6. 인증 흐름 (Authentication Flow)
+
+### 6.1 개요
+
+공공데이터 API를 사용하려면 각 기관에서 발급한 **인증키(API Key)**가 필요합니다. KPubData는 이 키를 사용자로부터 받아 각 기관이 요구하는 방식으로 HTTP 요청에 주입합니다.
+
+핵심 설계 원칙:
+- **키 저장은 `KPubDataConfig`에 집중**: 모든 기관의 키를 한 곳에서 관리합니다.
+- **키 주입은 각 어댑터에 위임**: 기관마다 키를 넣는 위치와 파라미터 이름이 다르므로, 이 로직은 어댑터가 담당합니다.
+- **환경변수 우선 해석**: 명시적으로 전달된 키 → `KPUBDATA_*` 환경변수 → fallback 환경변수 순으로 탐색합니다.
+
+### 6.2 키 해석 우선순위
+
+```mermaid
+flowchart TD
+    Start[키 요청: require_provider_key] --> E1{명시적으로 전달된 키?}
+    E1 -- 있음 --> Use[키 반환]
+    E1 -- 없음 --> E2{KPUBDATA_{PROVIDER}_API_KEY 환경변수?}
+    E2 -- 있음 --> Use
+    E2 -- 없음 --> E3{"{PROVIDER}_API_KEY" 환경변수?}
+    E3 -- 있음 --> Use
+    E3 -- 없음 --> Err[ConfigError 발생]
+```
+
+```python
+# 1순위: 명시적 전달
+client = Client(provider_keys={"datago": "MY_KEY"})
+
+# 2순위: KPUBDATA_ 접두사 환경변수
+# export KPUBDATA_DATAGO_API_KEY="MY_KEY"
+client = Client.from_env()
+
+# 3순위: 접두사 없는 환경변수 (fallback)
+# export DATAGO_API_KEY="MY_KEY"
+client = Client.from_env()
+```
+
+**관련 코드**: `src/kpubdata/config.py` → `KPubDataConfig.get_provider_key()`, `require_provider_key()`
+
+### 6.3 키의 내부 전달 경로
+
+```mermaid
+sequenceDiagram
+    participant U as 사용자
+    participant C as Client
+    participant Cfg as KPubDataConfig
+    participant A as ProviderAdapter
+    participant T as HttpTransport
+    participant P as 공공 API
+
+    U->>C: Client(provider_keys={"datago": "KEY"})
+    C->>Cfg: KPubDataConfig(provider_keys={...})
+    Note over Cfg: 키를 dict에 보관
+
+    U->>C: dataset("datago.village_fcst").list(...)
+    C->>A: query_records(dataset_ref, query)
+    A->>Cfg: require_provider_key("datago")
+    Cfg-->>A: "KEY" 반환
+    A->>A: _build_params()에서 키를 HTTP 파라미터에 주입
+    A->>T: HTTP 요청 (키 포함)
+    T->>P: GET https://apis.data.go.kr/...?serviceKey=KEY
+    P-->>T: 응답
+```
+
+**핵심 메서드**: 모든 어댑터는 `_require_api_key()` → `self._config.require_provider_key("slug")` 패턴을 사용합니다.
+
+### 6.4 기관별 키 주입 방식
+
+기관마다 키를 HTTP 요청에 넣는 위치와 파라미터 이름이 다릅니다.
+
+| Provider | 파라미터 이름 | 주입 위치 | 예시 | 특이사항 |
+|---|---|---|---|---|
+| `datago` | `serviceKey` | Query parameter | `?serviceKey=KEY` | dataset별 `service_key_param` 메타데이터로 파라미터명 오버라이드 가능 |
+| `bok` | _(URL 경로)_ | URL path segment | `/{KEY}/json/{operation}/...` | 쿼리 파라미터가 아닌 **URL 경로**에 직접 삽입 |
+| `kosis` | `apiKey` | Query parameter | `?apiKey=KEY` | 표준적인 쿼리 파라미터 방식 |
+| `lofin` | `Key` | Query parameter | `?Key=KEY` | 대문자 `K` 필수. `Type=json`도 대문자 `T` 필수 |
+
+```text
+datago:  GET https://apis.data.go.kr/.../getVilageFcst?serviceKey=KEY&...
+bok:     GET https://ecos.bok.or.kr/api/KEY/json/StatisticSearch/...
+kosis:   GET https://kosis.kr/openapi/Idx/indikatorList.do?apiKey=KEY&...
+lofin:   GET https://www.lofin365.go.kr/lf/hub/AJGCF?Key=KEY&Type=json&...
+```
+
+### 6.5 새 어댑터 추가 시 인증 구현 가이드
+
+새로운 데이터 기관을 추가할 때, 인증 관련 구현은 다음 3단계를 따릅니다.
+
+**1단계**: `_require_api_key()` 메서드를 정의합니다.
+```python
+def _require_api_key(self) -> str:
+    return self._config.require_provider_key("your_provider_slug")
+```
+
+**2단계**: 요청 생성 시 키를 해당 기관의 방식에 맞게 주입합니다.
+```python
+# Query parameter 방식 (가장 일반적)
+params = {"apiKey": self._require_api_key(), ...}
+
+# URL path 방식 (bok처럼 경로에 넣는 경우)
+url = f"{base_url}/{self._require_api_key()}/json/{operation}"
+```
+
+**3단계**: `Client`의 `_BUILTIN_PROVIDERS` 튜플에 등록하면, `from_env()`가 자동으로 `KPUBDATA_{SLUG}_API_KEY` 환경변수를 스캔합니다.
+
+## 7. 자주 묻는 질문 (FAQ)
 
 **Q: 새 데이터셋을 추가하려면 어디를 수정하나요?**
 A: 해당 기관의 어댑터(`providers/<provider>/adapter.py`)와 데이터 목록 파일(`catalogue.json`)을 수정하면 됩니다.

{kpubdata-0.1.0 → kpubdata-0.2.1}/CANONICAL_MODEL.md

@@ -312,7 +312,6 @@ class Dataset:
     ref: DatasetRef
 
     def list(self, **filters) -> RecordBatch: ...
-    def get(self, **key) -> dict[str, object] | None: ...
     def schema(self) -> SchemaDescriptor | None: ...
     def call_raw(self, operation: str, **params) -> object: ...
 ```
@@ -352,4 +351,3 @@ Do not erase provider-native detail.
 | [PROVIDER_ADAPTER_CONTRACT.md](./PROVIDER_ADAPTER_CONTRACT.md) | 어댑터 구현 규약 |
 | [API_SPEC.md](./API_SPEC.md) | 파이썬 API 명세 |
 | [VALIDATION.md](./VALIDATION.md) | 아키텍처 타당성 검증 |
-

{kpubdata-0.1.0 → kpubdata-0.2.1}/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2025-04-17
+
+### Added
+- Single-page pagination contract for all adapters (datago, bok, lofin, kosis)
+- `Dataset.list_all()` generator for automatic multi-page iteration
+- `RecordBatch.to_pandas()` for pandas DataFrame conversion (optional `pandas` dependency)
+- Unit tests for BOK and LOFIN adapters
+
+### Changed
+- Default `page_size` increased from 10 to 100
+- **Breaking**: `query_records()` now returns a single page instead of auto-draining all pages
+
+### Removed
+- Unreachable single-record adapter stubs
+- Single-record access from the provider and dataset public APIs
+
+## [0.1.0] - 2025-04-10
+
 ### Added
 
 - Core framework: `Client`, `Dataset`, `Catalog`, `Query`, `RecordBatch` public API

{kpubdata-0.1.0 → kpubdata-0.2.1}/PACKAGING.md

@@ -82,11 +82,55 @@ uv run python -m build
 
 ### Release
 
-1. bump version
-2. update changelog
-3. run full quality gates
-4. build sdist + wheel
-5. publish to TestPyPI/PyPI
+GitHub Actions `Publish to PyPI` workflow를 통해 배포합니다.
+
+#### 방법 1: 수동 트리거 (권장)
+
+1. GitHub → Actions → **Publish to PyPI** → **Run workflow**
+2. 옵션 선택:
+   - **bump**: `patch` (0.1.0 → 0.1.1), `minor` (0.1.0 → 0.2.0), `pre` (0.1.0 → 0.1.1a0)
+   - **dry_run**: 체크하면 PyPI 배포 없이 빌드만 확인
+3. workflow가 자동으로 수행하는 작업:
+   - `pyproject.toml` 버전 bump + commit + tag
+   - quality gates 실행 (ruff, mypy, pytest)
+   - sdist + wheel 빌드
+   - GitHub Release 생성 (자동 release notes)
+   - PyPI 배포 (trusted publisher / OIDC)
+
+#### 방법 2: GitHub Release 수동 생성
+
+1. 직접 `pyproject.toml` 버전 수정 + commit + push
+2. GitHub → Releases → **Create a new release**
+3. 태그: `v{version}` (예: `v0.2.0`)
+4. Release 생성 시 workflow가 자동으로 빌드 + PyPI 배포
+
+#### 배포 전 체크리스트
+
+- [ ] main 브랜치에 모든 변경사항 merge 완료
+- [ ] CI 통과 확인 (ruff, mypy, pytest)
+- [ ] `SUPPORTED_DATA.md` 최신 상태
+
+#### 배포 흐름도
+
+```mermaid
+flowchart TD
+    A[변경사항 main에 merge] --> B{배포 방식}
+    B -->|수동 트리거| C[Actions > Run workflow]
+    C --> D[bump type 선택]
+    D --> E[자동: 버전 bump + commit + tag]
+    B -->|Release 생성| F[수동: 버전 수정 + Release 생성]
+    E --> G[Quality gates]
+    F --> G
+    G --> H[Build sdist + wheel]
+    H --> I[GitHub Release 생성]
+    I --> J[PyPI 배포]
+```
+
+#### 환경 설정
+
+- **PyPI trusted publisher**: GitHub Actions OIDC — 별도 API 토큰 불필요
+- **GitHub environment**: `pypi` (Settings → Environments)
+- **Workflow 파일**: `.github/workflows/publish-pypi.yml`
 
 ## 7. Versioning policy
 

{kpubdata-0.1.0 → kpubdata-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kpubdata
-Version: 0.1.0
+Version: 0.2.1
 Summary: Dialect-inspired Python access framework for Korean public data
 Author: Yeongseon Choe
 License: MIT
@@ -297,6 +297,37 @@ for item in result.items[:5]:
 # ...
 ```
 
+### 9. 전체 페이지 자동 조회 (list_all)
+
+대량의 데이터를 페이지 단위로 자동 순회하려면 `list_all()`을 사용합니다.
+
+```python
+ds = client.dataset("lofin.expenditure_budget")
+
+# 모든 페이지를 자동으로 순회하며 RecordBatch를 반환
+for batch in ds.list_all(fyr="2024"):
+    print(f"이번 페이지: {len(batch.items)}건")
+    for item in batch.items:
+        print(item)
+```
+
+### 10. pandas DataFrame 변환
+
+조회 결과를 pandas DataFrame으로 변환하여 분석할 수 있습니다.
+
+```bash
+pip install kpubdata[pandas]
+```
+
+```python
+ds = client.dataset("bok.base_rate")
+result = ds.list(start_date="202401", end_date="202412")
+
+# pandas DataFrame으로 변환
+df = result.to_pandas()
+print(df.head())
+```
+
 ## 지원 중인 공공데이터
 
 현재 지원 현황의 상세 정보와 진행 예정 항목은 [SUPPORTED_DATA.md](./SUPPORTED_DATA.md)에서 확인할 수 있습니다.
@@ -316,6 +347,9 @@ for item in result.items[:5]:
 | 지방재정365 (`lofin`) | 기능별세출 (`expenditure_function`) | 지원 |
 | 지방재정365 (`lofin`) | 채무비율현황 (`debt_ratio`) | 지원 |
 | 지방재정365 (`lofin`) | 재정자립도현황 (`fiscal_independence`) | 지원 |
+| 지방재정365 (`lofin`) | 재원별 세입결산 (`revenue_by_source`) | 지원 |
+
+> 검증 수준 및 실API 최종 검증일 등 상세 정보는 [SUPPORTED_DATA.md](./SUPPORTED_DATA.md)를 참고하세요.
 
 ## 문서 가이드 (Document Guide)
 
@@ -378,3 +412,4 @@ KPubData의 설계 철학과 사용 방법을 안내하는 문서 목록입니
 
 ### v0.3
 - 표준 코어를 기반으로 한 경량 [MCP](https://modelcontextprotocol.io/)(Model Context Protocol — AI 모델이 외부 도구를 사용하는 표준 규약) 어댑터 지원
+

{kpubdata-0.1.0 → kpubdata-0.2.1}/PRD.md

@@ -157,16 +157,7 @@ Acceptance:
 - includes `raw`
 - includes metadata about pagination and provider
 
-### FR-6. Single-record access
-
-Supported datasets may expose a single-record get operation.
-
-Acceptance:
-
-- `dataset.get(...)`
-- unsupported datasets raise `UnsupportedCapabilityError`
-
-### FR-7. Schema/metadata access
+### FR-6. Schema/metadata access
 
 Datasets may expose schema or field metadata.
 
@@ -175,7 +166,7 @@ Acceptance:
 - `dataset.schema()`
 - returns `SchemaDescriptor | None`
 
-### FR-8. Raw access
+### FR-7. Raw access
 
 Every provider adapter must expose a raw-call path.
 
@@ -303,4 +294,3 @@ client.getRTMSDataSvcAptTradeDev(...)
 | :--- | :--- | :--- |
 | [kpubdata-builder](https://github.com/yeongseon/kpubdata-builder) | [PRD.md](https://github.com/yeongseon/kpubdata-builder/blob/main/PRD.md) | Builder 제품 요구사항 |
 | [kpubdata-studio](https://github.com/yeongseon/kpubdata-studio) | [PRD.md](https://github.com/yeongseon/kpubdata-studio/blob/main/PRD.md) | Studio 제품 요구사항 |
-

{kpubdata-0.1.0 → kpubdata-0.2.1}/PROVIDER_ADAPTER_CONTRACT.md

@@ -149,7 +149,6 @@ class ProviderAdapter(Protocol):
     def search_datasets(self, text: str) -> list[DatasetRef]: ...
     def get_dataset(self, dataset_id: str) -> DatasetRef: ...
     def query_records(self, dataset: DatasetRef, query: Query) -> RecordBatch: ...
-    def get_record(self, dataset: DatasetRef, key: dict[str, object]) -> dict[str, object] | None: ...
     def get_schema(self, dataset: DatasetRef) -> SchemaDescriptor | None: ...
     def call_raw(self, dataset: DatasetRef, operation: str, params: dict[str, object]) -> object: ...
 ```
@@ -163,7 +162,6 @@ classDiagram
         +search_datasets(text: str) list~DatasetRef~
         +get_dataset(dataset_id: str) DatasetRef
         +query_records(dataset: DatasetRef, query: Query) RecordBatch
-        +get_record(dataset: DatasetRef, key: dict) dict
         +get_schema(dataset: DatasetRef) SchemaDescriptor
         +call_raw(dataset: DatasetRef, op: str, params: dict) object
     }
@@ -248,4 +246,3 @@ Otherwise, keep the complexity local to the adapter.
 | [API_SPEC.md](./API_SPEC.md) | 파이썬 API 명세 |
 | [VALIDATION.md](./VALIDATION.md) | 아키텍처 타당성 검증 |
 | [AGENTS.md](./AGENTS.md) | 어댑터 개발 가이드 및 에이전트 규칙 |
-

{kpubdata-0.1.0 → kpubdata-0.2.1}/README.md

@@ -260,6 +260,37 @@ for item in result.items[:5]:
 # ...
 ```
 
+### 9. 전체 페이지 자동 조회 (list_all)
+
+대량의 데이터를 페이지 단위로 자동 순회하려면 `list_all()`을 사용합니다.
+
+```python
+ds = client.dataset("lofin.expenditure_budget")
+
+# 모든 페이지를 자동으로 순회하며 RecordBatch를 반환
+for batch in ds.list_all(fyr="2024"):
+    print(f"이번 페이지: {len(batch.items)}건")
+    for item in batch.items:
+        print(item)
+```
+
+### 10. pandas DataFrame 변환
+
+조회 결과를 pandas DataFrame으로 변환하여 분석할 수 있습니다.
+
+```bash
+pip install kpubdata[pandas]
+```
+
+```python
+ds = client.dataset("bok.base_rate")
+result = ds.list(start_date="202401", end_date="202412")
+
+# pandas DataFrame으로 변환
+df = result.to_pandas()
+print(df.head())
+```
+
 ## 지원 중인 공공데이터
 
 현재 지원 현황의 상세 정보와 진행 예정 항목은 [SUPPORTED_DATA.md](./SUPPORTED_DATA.md)에서 확인할 수 있습니다.
@@ -279,6 +310,9 @@ for item in result.items[:5]:
 | 지방재정365 (`lofin`) | 기능별세출 (`expenditure_function`) | 지원 |
 | 지방재정365 (`lofin`) | 채무비율현황 (`debt_ratio`) | 지원 |
 | 지방재정365 (`lofin`) | 재정자립도현황 (`fiscal_independence`) | 지원 |
+| 지방재정365 (`lofin`) | 재원별 세입결산 (`revenue_by_source`) | 지원 |
+
+> 검증 수준 및 실API 최종 검증일 등 상세 정보는 [SUPPORTED_DATA.md](./SUPPORTED_DATA.md)를 참고하세요.
 
 ## 문서 가이드 (Document Guide)
 
@@ -341,3 +375,4 @@ KPubData의 설계 철학과 사용 방법을 안내하는 문서 목록입니
 
 ### v0.3
 - 표준 코어를 기반으로 한 경량 [MCP](https://modelcontextprotocol.io/)(Model Context Protocol — AI 모델이 외부 도구를 사용하는 표준 규약) 어댑터 지원
+