hwpx-kit-cli 0.4.0__tar.gz → 0.4.1__tar.gz

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hwpx-kit",
   "description": "한글(HWPX/HWP) 문서 자동화 스킬 모음 — 양식 분석·채우기·백지 생성·표기 변환·공문 규약·표 계산·오피스 출력. CLI는 첫 사용 시 스킬이 설치를 안내 (Python 3.10+ 필요).",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "author": {
     "name": "6aneffy",
     "email": "tkdgus990809@gmail.com"

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hwpx-kit-cli
-Version: 0.4.0
+Version: 0.4.1
 Summary: 한글(HWPX) 문서 자동화 CLI — Korean HWPX document automation for AI agents: analyze, fill, read, validate, table ops
 Project-URL: Homepage, https://github.com/6aneffy/hwpx-kit
 Project-URL: Repository, https://github.com/6aneffy/hwpx-kit
@@ -33,7 +33,7 @@ Description-Content-Type: text/markdown
 [![PyPI](https://img.shields.io/pypi/v/hwpx-kit-cli.svg)](https://pypi.org/project/hwpx-kit-cli/)
 [![Python](https://img.shields.io/badge/python-3.10%2B-3776AB.svg)](https://www.python.org/)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-d97757.svg)](https://claude.com/claude-code)
-[![Tests](https://img.shields.io/badge/tests-186%20passing-brightgreen.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-190%20passing-brightgreen.svg)](tests/)
 
 </div>
 
@@ -208,7 +208,7 @@ templates/ 기본 계획서 템플릿 (표지·장 헤더·표 골격, 마커
 
 ## 검증
 
-- 자동 테스트 186개 (pytest)
+- 자동 테스트 190개 (pytest)
 - 실서식 수렴 테스트: 보도자료·신청서·계획서·회의록·공고문 5계열,
   실제 공공기관 문서 30여 종으로 analyze→fill→validate 왕복
 - 실사용 시나리오 테스트 3회 (백지 생성 12분 완주, 장·표 동적 추가, 보도자료 변환)

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/README.md

@@ -10,7 +10,7 @@
 [![PyPI](https://img.shields.io/pypi/v/hwpx-kit-cli.svg)](https://pypi.org/project/hwpx-kit-cli/)
 [![Python](https://img.shields.io/badge/python-3.10%2B-3776AB.svg)](https://www.python.org/)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-d97757.svg)](https://claude.com/claude-code)
-[![Tests](https://img.shields.io/badge/tests-186%20passing-brightgreen.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-190%20passing-brightgreen.svg)](tests/)
 
 </div>
 
@@ -185,7 +185,7 @@ templates/ 기본 계획서 템플릿 (표지·장 헤더·표 골격, 마커
 
 ## 검증
 
-- 자동 테스트 186개 (pytest)
+- 자동 테스트 190개 (pytest)
 - 실서식 수렴 테스트: 보도자료·신청서·계획서·회의록·공고문 5계열,
   실제 공공기관 문서 30여 종으로 analyze→fill→validate 왕복
 - 실사용 시나리오 테스트 3회 (백지 생성 12분 완주, 장·표 동적 추가, 보도자료 변환)

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hwpx-kit-cli"
-version = "0.4.0"
+version = "0.4.1"
 description = "한글(HWPX) 문서 자동화 CLI — Korean HWPX document automation for AI agents: analyze, fill, read, validate, table ops"
 readme = "README.md"
 requires-python = ">=3.10"

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/skills/table-calc/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: table-calc
-description: 보고서 표 수치 작업 — 증감(△·▲▽·↑↓·%·%p), 비율, 순번, 세자리 콤마, 합계·역합계 계산과 공무원 관습 표기. hwpx 표에 "증감 채워줘", "비율 계산해서 넣어줘", "합계 맞춰줘", "표 계산해줘" 요청 시 사용. Triggers: calculate table totals in Korean report style.
+description: 보고서 표 수치 작업 — 증감(△·▲▽·↑↓·%·%p), 비율, 순번, 세자리 콤마, 합계·역합계 계산과 공무원 관습 표기. hwpx 표에 "증감 채워줘", "비율 계산해서 넣어줘", "합계 맞춰줘", "표 계산해줘", "천원/백만원 단위로 바꿔줘" 요청 시 사용. Triggers: calculate table totals in Korean report style.
 ---
 
 # table-calc: 표 수치 계산·표기
@@ -36,6 +36,16 @@ description: 보고서 표 수치 작업 — 증감(△·▲▽·↑↓·%·%p),
 - **검산**: 채우기 전에 합계 행이 항목 합과 일치하는지 확인, 불일치하면 채우지
   말고 사용자에게 보고
 
+## 표 단위 변환 — "이 표 천원/백만원 단위로 바꿔줘"
+
+1. `table-map`으로 대상 표의 수치 셀 수집 (원 단위 원본 값)
+2. 셀마다 `hwpx-kit fmt --scale <원값> --unit 천원` (또는 백만원) — 사사오입
+   반올림+콤마를 도구가 보장 (암산 금지). 여러 값이면 fmt를 && 체이닝
+3. `table-set --data`로 일괄 기입 + 표 위/아래에 `(단위: 천원)` 캡션이 없으면
+   text: 교체나 table-set으로 추가 (캡션 위치는 문서 관례 — 보통 표 우측 상단)
+4. **검산**: 변환 후 합계 행 = 항목 합 (반올림 누적 오차로 ±1 어긋나면
+   합계 셀은 원값 합의 변환값으로 맞추고 사용자에게 알림)
+
 ## 착지 (문서에 쓰기)
 
 계산 결과는 hwpx-form 스킬의 fill 계약으로 셀에 넣는다 — 새 방식을 만들지 말 것:

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/src/hwpx_kit/cli.py

@@ -196,6 +196,8 @@ def _build_parser() -> argparse.ArgumentParser:
     pt.add_argument("--date", help="날짜 YYYYMMDD → YYYY.M.D.(요일)")
     pt.add_argument("--age", help="생년월일 YYMMDD → YYMMDD(만나이)")
     pt.add_argument("--base", help="만나이 기준일 YYYYMMDD (기본 오늘)")
+    pt.add_argument("--scale", help="원 단위 금액 → --unit 단위로 환산 (반올림·콤마)")
+    pt.add_argument("--unit", default="천원", choices=["천원", "백만원"], help="--scale 대상 단위 (기본 천원)")
     pt.add_argument("--json", action="store_true")
 
     return p
@@ -240,6 +242,7 @@ def main(argv: list[str] | None = None) -> int:
             data = run_fmt(
                 amount=args.amount, date=args.date, age=args.age,
                 base=args.base, style=args.style,
+                scale=args.scale, unit=args.unit,
             )
         elif args.command == "row-height":
             data = run_row_height(

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/src/hwpx_kit/commands/fmt.py

@@ -4,7 +4,7 @@
 """
 from __future__ import annotations
 
-from hwpx_kit.format import format_amount, gongmun_date, korean_age
+from hwpx_kit.format import format_amount, gongmun_date, korean_age, scale_amount
 
 
 def run_fmt(
@@ -13,10 +13,20 @@ def run_fmt(
     age: str | None = None,
     base: str | None = None,
     style: str = "gongmun",
+    scale: str | None = None,
+    unit: str = "천원",
 ) -> dict:
-    targets = [k for k, v in (("amount", amount), ("date", date), ("age", age)) if v is not None]
+    targets = [k for k, v in (("amount", amount), ("date", date), ("age", age),
+                              ("scale", scale)) if v is not None]
     if len(targets) != 1:
-        raise ValueError("--amount / --date / --age 중 정확히 하나를 지정하세요.")
+        raise ValueError("--amount / --date / --age / --scale 중 정확히 하나를 지정하세요.")
+
+    if scale is not None:
+        cleaned = scale.replace(",", "").strip()
+        if not cleaned.isdigit():
+            raise ValueError(f"금액은 정수여야 합니다: {scale}")
+        return {"kind": "scale", "input": scale, "unit": unit,
+                "result": scale_amount(int(cleaned), unit)}
 
     if amount is not None:
         cleaned = amount.replace(",", "").strip()

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/src/hwpx_kit/format.py

@@ -92,3 +92,21 @@ def korean_age(yymmdd: str, base: str | None = None) -> str:
     if age < 0:
         raise ValueError("기준일이 생년월일보다 앞섭니다.")
     return f"{digits}({age})"
+
+
+_SCALE_UNITS = {"천원": 1_000, "백만원": 1_000_000}
+
+
+def scale_amount(won: int, unit: str) -> str:
+    """원 단위 금액 → 천원/백만원 단위 문자열 (반올림, 세 자리 콤마).
+
+    예산표 "단위: 천원" 관습용. 반내림이 필요한 특수 규정은 호출자가 처리.
+    """
+    from decimal import ROUND_HALF_UP, Decimal
+
+    divisor = _SCALE_UNITS.get(unit)
+    if divisor is None:
+        raise ValueError(f"지원 단위: {', '.join(_SCALE_UNITS)} (받은 값: {unit})")
+    # 파이썬 round()는 은행가 반올림(0.5→0) — 행정 관습은 사사오입(0.5→1)
+    scaled = int((Decimal(won) / Decimal(divisor)).quantize(Decimal(1), rounding=ROUND_HALF_UP))
+    return f"{scaled:,}"

{hwpx_kit_cli-0.4.0 → hwpx_kit_cli-0.4.1}/tests/test_format.py

@@ -144,3 +144,42 @@ def test_cli_fmt_requires_exactly_one(capsys):
     env = _last_json(capsys)
     assert code == 1
     assert env["ok"] is False
+
+
+# ── 표 단위 변환 (천원/백만원) ────────────────────────────────
+
+def test_scale_amount_to_cheonwon():
+    from hwpx_kit.format import scale_amount
+
+    # 관습: 반올림, 세 자리 콤마
+    assert scale_amount(1234567, "천원") == "1,235"
+    assert scale_amount(1000, "천원") == "1"
+    assert scale_amount(37000000, "천원") == "37,000"
+
+
+def test_scale_amount_to_baekmanwon():
+    from hwpx_kit.format import scale_amount
+
+    assert scale_amount(37000000, "백만원") == "37"
+    assert scale_amount(1234567890, "백만원") == "1,235"
+    assert scale_amount(500000, "백만원") == "1"   # 반올림 올라감
+
+
+def test_scale_amount_rejects_unknown_unit():
+    import pytest as _pytest
+
+    from hwpx_kit.format import scale_amount
+
+    with _pytest.raises(ValueError):
+        scale_amount(1000, "억원")
+
+
+def test_cli_fmt_scale(capsys):
+    import json as _json
+
+    from hwpx_kit.cli import main
+
+    code = main(["fmt", "--scale", "1,234,567", "--unit", "천원", "--json"])
+    env = _json.loads(capsys.readouterr().out.strip().splitlines()[-1])
+    assert code == 0
+    assert env["data"]["result"] == "1,235"