Files
Aislo/resources/master_data/scripts/master_doc_digits.py
T
eomsangdonandClaude Opus 5.5 aa36c4fb6b feat(859-3): 보이는 수 자릿수 규칙 한 쌍 — 줄 쌓기 화면 · 서버 계산서 글(셈 · 금액 그대로)
- 규칙 한 벌 = common_util_show_digits.ts ↔ master_doc_digits.py(짝 · 거울 시험 test_859_3)
  표 값 = 고른 줄의 원문 글자 자리(끝 0 살림 · 서버 표 캐시에 줄마다 `자리` 실음) ·
  식 값 = Q 3 · n 2 · cm 3(8-1 주①) › 원 단위 · 비목 이름 = 소수 한 자리 › 그 밖 유효숫자 3(소수 2~6) ·
  입력 · 요소 = 자료 그대로 · 만약으로 고른 기호 하나인 식은 그 값의 갈래를 따름
- 줄 쌓기 오른쪽(공식 줄 · 값 묶음 · 금액 줄 수량 · 단가 식 · 결과) · 왼쪽 값 · 작업량 줄 · M02 계산서 글
- test_845_2 기대 글 고침(노무비 계수 0.208333 → 0.208 — 뜻한 바뀜 · 금액 59,020.2 그대로)
- 관련 시험 + 관문 256 통과 · typecheck 0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 21:55:48 +09:00

186 lines
7.9 KiB
Python

# -*- coding: utf-8 -*-
"""보이는 수의 자릿수 규칙 한 벌(PLAN 859-3 · 856-5 · 요구 898 · 902) —
셈 값 · 저장 값 · 금액은 그대로 · 그리는 글자만.
⚠ 짝 = `common_util/common_util_show_digits.ts`(같은 규칙 · 한쪽을 고치면 다른 쪽도) ·
거울 시험 `resources/tester/test_859_3_show_digits.py`.
갈래(`kind_of`) = 문서 식 줄 → 「식」 · 변수 연결 표 → 「표」 · 입력 · 선택 → 「입력」 ·
그 밖(요소 · 단가산출) → 「요소」.
규칙(자리 값은 `RULE` 한 곳):
표 = 고른 표 줄의 원문 글자 자리(끝 0 살림 —
건설 · 산림 1-2-2 1 [주]② 「항목에서 제시한 소수자리 우선」) ·
글자 자리를 모르면(끝 0 빠진 자료 · 사용자가 바꾼 값) 자료 수 그대로
식 = 기호 Q 3 · n 2 · cm 3 자리(건설 8-1 [주]① 계산값의 맺음) ›
단위가 원(원/…) · 비목 이름(노무비 · 재료비 · 경비)이면 소수 한 자리
(1-2-2 2 「일위대가표의 금액란 0.1 원」 준용) ›
그 밖 = 유효숫자 3 · 소수 최소 2 · 최대 6(1-2-2 3 시공단위 품 표 근사 · 정수는 정수)
입력 · 요소 = 자료 수 그대로(소수 여섯 자리까지 · 끝 0 뗌 — `eqText`)
수 꼴 = 천 단위 쉼표 · 반올림(0.5 올림 · 짧은 10 진 글 기준 — 화면 `Intl` 과 같음).
"""
from __future__ import annotations
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
#: 자리 값 표 — 사용자 확정 값이 바뀌면 여기만 고침(짝 TS `RULE`)
RULE = {
"plain": 6, # 입력 · 요소 · 자리 모르는 표 값 = 최대 자리(끝 0 뗌)
"symbol": {"Q": 3, "n": 2, "cm": 3}, # 건설 8-1 [주]① — 식이 낸 값 · 기호 그대로
"money": 1, # 원 단위 중간 값(율 줄 단가 · 원/… 식 값)
"money_names": ("노무비", "재료비", "경비"), # 단위 없는 비목 값(기계 시간당 식) = 원
"sig": 3, # 그 밖 식 값 — 유효숫자
"min": 2, # 〃 소수 최소(정수는 정수)
"max": 6, # 〃 소수 최대
}
def dec(v) -> Decimal | None:
"""수 → Decimal(화면 double 의 짧은 10 진 글 · 글 · 참거짓 · 빈 값 = None)."""
if isinstance(v, bool) or v is None or isinstance(v, str):
return None
try:
d = Decimal(repr(float(v))) # 화면 수(double)와 같은 짧은 10 진 글
except (InvalidOperation, ValueError, TypeError, OverflowError):
return None
return d if d.is_finite() else None
def fmt(d: Decimal, lo: int, hi: int) -> str:
"""소수 `hi` 자리 반올림 · 끝 0 은 `lo` 자리까지 뗌 · 천 단위 쉼표
(Intl 과 같음 — 0 으로 반올림된 음수 = 「-0」)."""
q = d.quantize(Decimal(1).scaleb(-hi), ROUND_HALF_UP)
sign = "-" if q.is_signed() else ""
whole, _, frac = f"{abs(q):f}".partition(".")
frac = frac.rstrip("0")
frac += "0" * (lo - len(frac))
head = f"{int(whole):,}"
return f"{sign}{head}.{frac}" if frac else f"{sign}{head}"
def places_of(d: Decimal) -> int:
"""짧은 10 진 글의 소수 자리(0.10 → 1 · 3.0 → 0)."""
exp = d.normalize().as_tuple().exponent
return -exp if isinstance(exp, int) and exp < 0 else 0
def text_places(d: Decimal) -> int:
"""글자 그대로의 소수 자리(Decimal('0.10') → 2 · 표 파일 원문 글자)."""
exp = d.as_tuple().exponent
return -exp if isinstance(exp, int) and exp < 0 else 0
def row_places(row: dict) -> dict:
"""표 줄의 칸마다 원문 글자 자리 — 짧은 글보다 길 때만(끝 0 · 화면 캐시 `자리`)."""
out = {}
for col, v in row.items():
if isinstance(v, Decimal) and v.is_finite() and text_places(v) > places_of(v):
out[col] = text_places(v)
return out
def table_places(table: dict) -> list | None:
"""표 줄마다 `row_places`(끝 0 없는 줄 = None) · 표 통째 끝 0 없음 = None."""
got = [row_places(r) if isinstance(r, dict) else {} for r in table.get("줄") or []]
return [x or None for x in got] if any(got) else None
def table_value_places(link: dict, value, evaluate, get_table) -> int | None:
"""표 값의 원문 글자 자리 — 지금 조건으로 고른 줄(`find`)의 그 칸 글자 ·
값이 그 줄 값과 같을 때만(사용자가 바꾼 값 = None) ·
`evaluate(식 나무)` = 조건 값 · `get_table(키)` = 표(못 읽으면 None)."""
import master_doc as md
import master_doc_link as ml
ref, col = str(link.get("표") or ""), link.get("칸")
if not ref or not col or "{" in ref:
return None
conds = {}
for c, t in (link.get("조건") or {}).items():
try:
n = md.parse(t)
except md.DocError:
continue
conds[c] = evaluate(n)
try:
table = get_table(ref)
row = ml.find(table, conds, col) if table else None
except Exception: # noqa: BLE001 — 그림용 · 못 찾으면 자료 수 그대로
return None
if not row or dec(row.get(col)) is None or dec(row.get(col)) != dec(value):
return None
return row_places(row).get(col)
def kind_of(doc: dict, name: str, var: dict | None = None) -> str:
"""값 갈래 — 식 · 표 · 입력 · 요소."""
if any(str(x.get("기호") or "") == name for x in doc.get("식") or []):
return "식"
kind = ((var or {}).get("연결") or {}).get("갈래")
if kind == "표":
return "표"
if kind in ("입력", "선택"):
return "입력"
return "요소" if var is not None else "식"
def show(v, kind: str = "요소", name: str = "", unit: str = "", places: int | None = None) -> str:
"""보이는 수 글 — `places` = 표 원문 글자 자리(모르면 None) · 수가 아니면 글 그대로."""
if v is None or v == "":
return ""
if isinstance(v, bool):
return "true" if v else "false"
d = dec(v)
if d is None:
return str(v)
if kind == "표":
p = max(places or 0, places_of(d))
return fmt(d, p, p) if p <= RULE["plain"] else fmt(d, 0, RULE["plain"])
if kind != "식":
return fmt(d, 0, RULE["plain"])
if name in RULE["symbol"]:
return fmt(d, 0, RULE["symbol"][name])
if str(unit or "").strip().startswith("원") or name in RULE["money_names"]:
return fmt(d, 0, RULE["money"])
if d == d.to_integral_value():
return fmt(d, 0, 0)
hi = max(RULE["min"], min(RULE["max"], RULE["sig"] - 1 - d.adjusted()))
return fmt(d, RULE["min"], hi)
def source(doc: dict, name: str, evaluate) -> str:
"""값이 온 기호 — 식 줄이 기호 하나(만약 = 지금 탄 갈래)면 그 기호로 따라감 ·
`evaluate(식 나무)` = 그림용 값(모르면 None)."""
import master_doc as md
lines = {str(x.get("기호") or ""): x.get("식") for x in doc.get("식") or []}
at = name
for _ in range(8):
if at not in lines:
break
try:
n = md.parse(lines[at])
except md.DocError:
return at
while n and n[0] == "call" and n[1] == "만약" and len(n[2]) == 3:
t = evaluate(n[2][0])
if t is None:
return at
n = n[2][1 if t else 2]
if not n or n[0] != "var" or n[1] == at:
return at
at = n[1]
return at
def show_value(doc: dict, name: str, v, evaluate, get_table, unit: str | None = None) -> str:
"""문서 기호 값 글 한 벌(짝 TS `showValue`) — 값이 온 기호의 갈래 · 표 원문 글자 자리 · 단위."""
import master_doc as md
src = source(doc, name, evaluate)
var = next((x for x in doc.get("변수") or [] if md.var_id(x) == src), None)
kind = kind_of(doc, src, var)
places = None
if kind == "표" and var is not None:
places = table_value_places(var.get("연결") or {}, v, evaluate, get_table)
return show(v, kind, src, str((var or {}).get("단위") or "") if unit is None else unit, places)