Skip to content

Zio.utils

This bundle does not look at the repository.
It finds numbers in a given text and returns them along with the words written next to each number.

A 10% can be a target value in one industry and something to discard in another. In construction management, “operating profit of about 10%” is not progress, but in accounting it is exactly that figure.

Therefore this function does not choose. It returns the number together with its label, and the caller decides what it represents. If the engine chooses for you, it will be correct for one industry and inevitably wrong for others.

Method Description
Zio.utils.numbers(text, near=None, kinds=None) Finds all numbers in the text and returns them as a list. If there are multiple lines, it looks line by line—because labels do not span lines.
Zio.utils.number(text, near=None, kinds=None) Returns the first of the same kind. Returns None if none is found.
Zio.utils.numbers("진척률 : 약 90%")
# [{"kind": "percent", "value": 90, "label": "진척률", "about": True,
# "raw": "90%", "line": "진척률 : 약 90%", "bracket": False}]
# 무엇을 진척으로 볼지는 **부르는 쪽이 말을 준다**
Zio.utils.numbers(worklog, near=["진척률", "진행률", "설치율"], kinds="percent")
# 90% ← "진척률" 16.4% ← "현장 설치율"
# (영업 이익 9% · 수신률 83.7% 는 걸러진다)
# 분량만
Zio.utils.numbers(worklog, kinds=["ratio", "count"])
# ratio 0 / 18 done=0 total=18
# count 18개점 value=18 unit="개점"
kind example accompanying fields
percent 90%, 5 % 이하, 1.5%(±0.5%) value, tolerance, bracket — if it is inside brackets, the evidence strength differs because a person deliberately marked it.
ratio 0 / 18, 522대중 244대, 3분의 1 done, total, unit
count 18개점, 2,823점포, 522대 value, unit — Do not list units. Return the attached word as is.
money 579,000,000원, 약 1억 2천만원 value, unit, maybe
range 5~10%, 15~20% low, high, unit — 15~20% is not just the single value 20%.
nth 2차, 3회차, 제1장 index, unit
date 2026-08-21, 8월 7일, 2026년 value or year / month / day

8/7 is read as three possibilities — August 7, the 8th of 7 items, or 7⁄8. Choosing one will silently make the other two wrong, and from then on this function becomes unreliable.

Zio.utils.numbers("장비 발주(8/7)")
# [{"kind": "ratio", "done": 8, "total": 7, "label": "장비 발주",
# "ambiguous": ["ratio", "nth", "date"],
# "date": {"month": 8, "day": 7},
# "nth": {"index": 8, "of": 7}}]
# 헷갈릴 수 없는 것에는 ambiguous 가 없다
Zio.utils.numbers("부착( 0 / 18, 0%)")
# [{"kind": "ratio", "done": 0, "total": 18, ...}] ← 0월은 없다

The entire reading is returned so that the caller can decide based on context. Amounts are also ambiguous — 2억 3천 could be 200 003 000 or, if “만” is omitted by habit, 230 000 000. Provide both value and maybe.

If you return only numbers, they can be used anywhere. The words written next to them allow the caller to infer meaning. Therefore, extracting labels is the most carefully handled part of this bundle.

Original label rule
진척률 : 약 90% 진척률 : marks the label before it. This is opposite to other delimiters.
( 매출 194,132,600원 / 영업 이익 약 10% ) 매출, 영업 이익 Parentheses and slashes separate fields. The thousands separator (194,132,600) does not split the field.
장비 발주(8/7) 장비 발주 If the parentheses contain only a number, look one more step back for the label.
영업 이익 약 9% 영업 이익, about Words like 약, 총, 최대 are removed from the label; only their meaning remains.

numbers() first finds everything. If nothing is found, the caller has no way to handle it, but if many are found you can reduce them with near and kinds. The words put into near are always supplied by the caller — putting a word like 진척률 inside the SDK makes it less of a common tool.

(주)지오유 · 경기 용인시 처인구 유림로154번길(유방동 673-2) 20-13

CEO 신달수·Business no. 142-81-36612·E-commerce no. 용인처인-0118호·Privacy officer 신달수·Email shindalsoo@gmail.com·Tel 1833-3623·Fax 02-6918-4006