printsection 0.1.0__tar.gz

printsection-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 printtitle contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

printsection-0.1.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.5
+Name: printsection
+Version: 0.1.0
+Summary: 출력 구간을 나누는 위아래 빈 줄 + 가운데 정렬 구분선 (한글 폭 자동 보정)
+License-Expression: MIT
+License-File: LICENSE
+Keywords: center,console,divider,korean,print,section
+Classifier: Natural Language :: Korean
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# printsection
+
+`print("\n", "실습 결과".center(50, "-"), end="\n\n")` 를 한 줄로.
+출력 결과를 구간별로 나눠 보기 좋게 구분해 줍니다.
+
+```bash
+pip install printsection
+```
+
+```python
+from printsection import section
+
+section("실습 1")
+print("...")
+section("실습 2")
+```
+
+```
+
+----------------------실습 1----------------------
+
+...
+
+----------------------실습 2----------------------
+
+```
+
+위아래 빈 줄과 가운데 정렬이 기본입니다. 한글처럼 화면에서 2칸을 차지하는 글자도 폭을 계산해서 실제 화면 기준으로 가운데에 맞춥니다.
+
+## 옵션
+
+호출할 때 원하는 값만 바꾸면 됩니다.
+
+```python
+section("실습 결과", width=60, fillchar="=")
+section("왼쪽 정렬", align="left")          # "center" / "left" / "right"
+section("빈 줄 조절", top=2, bottom=0)
+section("str.center처럼", wide=False)       # 글자 수 기준으로 계산
+section()                                   # 글자 없이 구분선만
+```
+
+| 옵션 | 기본값 | 설명 |
+|---|---|---|
+| `width` | `50` | 전체 너비 |
+| `fillchar` | `"-"` | 채움 문자 (한 글자) |
+| `align` | `"center"` | `"center"`, `"left"`, `"right"` |
+| `top` | `1` | 위쪽 빈 줄 수 |
+| `bottom` | `1` | 아래쪽 빈 줄 수 |
+| `wide` | `True` | 한글 등 전각 문자를 2칸으로 계산 |
+| `file` | `sys.stdout` | 출력 대상 |
+
+## 기본값 한 번에 바꾸기
+
+```python
+from printsection import section, set_defaults, reset_defaults
+
+set_defaults(width=70, fillchar="*")
+section("1번 문제")
+section("2번 문제")
+reset_defaults()
+```
+
+## 문자열만 받기
+
+```python
+from printsection import format_section
+
+s = format_section("실습 결과")   # 출력하지 않고 문자열 반환
+```

printsection-0.1.0/README.md

@@ -0,0 +1,69 @@
+# printsection
+
+`print("\n", "실습 결과".center(50, "-"), end="\n\n")` 를 한 줄로.
+출력 결과를 구간별로 나눠 보기 좋게 구분해 줍니다.
+
+```bash
+pip install printsection
+```
+
+```python
+from printsection import section
+
+section("실습 1")
+print("...")
+section("실습 2")
+```
+
+```
+
+----------------------실습 1----------------------
+
+...
+
+----------------------실습 2----------------------
+
+```
+
+위아래 빈 줄과 가운데 정렬이 기본입니다. 한글처럼 화면에서 2칸을 차지하는 글자도 폭을 계산해서 실제 화면 기준으로 가운데에 맞춥니다.
+
+## 옵션
+
+호출할 때 원하는 값만 바꾸면 됩니다.
+
+```python
+section("실습 결과", width=60, fillchar="=")
+section("왼쪽 정렬", align="left")          # "center" / "left" / "right"
+section("빈 줄 조절", top=2, bottom=0)
+section("str.center처럼", wide=False)       # 글자 수 기준으로 계산
+section()                                   # 글자 없이 구분선만
+```
+
+| 옵션 | 기본값 | 설명 |
+|---|---|---|
+| `width` | `50` | 전체 너비 |
+| `fillchar` | `"-"` | 채움 문자 (한 글자) |
+| `align` | `"center"` | `"center"`, `"left"`, `"right"` |
+| `top` | `1` | 위쪽 빈 줄 수 |
+| `bottom` | `1` | 아래쪽 빈 줄 수 |
+| `wide` | `True` | 한글 등 전각 문자를 2칸으로 계산 |
+| `file` | `sys.stdout` | 출력 대상 |
+
+## 기본값 한 번에 바꾸기
+
+```python
+from printsection import section, set_defaults, reset_defaults
+
+set_defaults(width=70, fillchar="*")
+section("1번 문제")
+section("2번 문제")
+reset_defaults()
+```
+
+## 문자열만 받기
+
+```python
+from printsection import format_section
+
+s = format_section("실습 결과")   # 출력하지 않고 문자열 반환
+```

printsection-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "printsection"
+version = "0.1.0"
+description = "출력 구간을 나누는 위아래 빈 줄 + 가운데 정렬 구분선 (한글 폭 자동 보정)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+keywords = ["print", "section", "divider", "center", "korean", "console"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Natural Language :: Korean",
+]

printsection-0.1.0/src/printsection/__init__.py

@@ -0,0 +1,87 @@
+"""위아래 빈 줄과 가운데 정렬이 기본으로 들어간 구간 구분 출력 함수.
+
+    >>> from printsection import section
+    >>> section("실습 결과")
+
+    --------------------실습 결과---------------------
+
+"""
+
+import sys
+import unicodedata
+
+__all__ = ["section", "format_section", "set_defaults", "reset_defaults"]
+__version__ = "0.1.0"
+
+_FACTORY_DEFAULTS = {
+    "width": 50,
+    "fillchar": "-",
+    "align": "center",
+    "top": 1,
+    "bottom": 1,
+    "wide": True,
+}
+_defaults = dict(_FACTORY_DEFAULTS)
+
+
+def _display_width(s):
+    """터미널에서 차지하는 칸 수. 한글/한자 등 전각 문자는 2칸으로 센다."""
+    return sum(2 if unicodedata.east_asian_width(ch) in ("W", "F") else 1 for ch in s)
+
+
+def format_section(text="", **options):
+    """출력하지 않고 구분 문자열만 만들어 반환한다 (위아래 빈 줄 포함)."""
+    unknown = set(options) - set(_FACTORY_DEFAULTS)
+    if unknown:
+        raise TypeError(f"알 수 없는 옵션: {', '.join(sorted(unknown))}")
+    opt = {**_defaults, **options}
+
+    text = str(text)
+    fillchar = opt["fillchar"]
+    if len(fillchar) != 1:
+        raise ValueError("fillchar는 한 글자여야 합니다.")
+
+    measure = _display_width if opt["wide"] else len
+    fill_w = measure(fillchar)
+    pad = max(opt["width"] - measure(text), 0) // fill_w
+
+    align = opt["align"]
+    if align == "center":
+        left = pad // 2
+    elif align == "left":
+        left = 0
+    elif align == "right":
+        left = pad
+    else:
+        raise ValueError("align은 'center', 'left', 'right' 중 하나여야 합니다.")
+    line = fillchar * left + text + fillchar * (pad - left)
+
+    return "\n" * opt["top"] + line + "\n" * opt["bottom"]
+
+
+def section(text="", *, file=None, flush=False, **options):
+    """구간 이름을 위아래 빈 줄과 함께 가운데 정렬해서 출력한다.
+
+    옵션 (생략하면 set_defaults로 정한 값, 처음엔 아래 기본값):
+        width=50      전체 너비
+        fillchar="-"  채움 문자 (한 글자)
+        align="center"  "center" / "left" / "right"
+        top=1         위쪽 빈 줄 수
+        bottom=1      아래쪽 빈 줄 수
+        wide=True     한글 등 전각 문자를 2칸으로 계산해 실제 화면에서 정확히 정렬
+    """
+    print(format_section(text, **options), file=file or sys.stdout, flush=flush)
+
+
+def set_defaults(**options):
+    """이후 모든 section() 호출의 기본값을 바꾼다. 예: set_defaults(width=60, fillchar="=")"""
+    unknown = set(options) - set(_FACTORY_DEFAULTS)
+    if unknown:
+        raise TypeError(f"알 수 없는 옵션: {', '.join(sorted(unknown))}")
+    _defaults.update(options)
+
+
+def reset_defaults():
+    """set_defaults로 바꾼 기본값을 처음 상태로 되돌린다."""
+    _defaults.clear()
+    _defaults.update(_FACTORY_DEFAULTS)

printsection-0.1.0/tests/test_printsection.py

@@ -0,0 +1,47 @@
+import pytest
+
+from printsection import format_section, reset_defaults, set_defaults
+
+
+@pytest.fixture(autouse=True)
+def _reset():
+    reset_defaults()
+    yield
+    reset_defaults()
+
+
+def test_default_matches_screen_width():
+    s = format_section("실습 결과")
+    line = s.strip("\n")
+    assert s.startswith("\n") and s.endswith("\n")
+    # 한글 4자(8칸) + 공백 1칸 = 9칸, 나머지 41칸을 '-'로 채움
+    assert line == "-" * 20 + "실습 결과" + "-" * 21
+
+
+def test_ascii_same_as_str_center_length():
+    line = format_section("abc", top=0, bottom=0)
+    assert len(line) == 50 and line.strip("-") == "abc"
+
+
+def test_options():
+    assert format_section("ab", width=6, fillchar="=", top=0, bottom=0) == "==ab=="
+    assert format_section("ab", width=6, align="left", top=0, bottom=0) == "ab----"
+    assert format_section("ab", width=6, align="right", top=0, bottom=0) == "----ab"
+    assert format_section("가", width=4, wide=False, top=0, bottom=0) == "-가--"
+    assert format_section("x", width=1, top=2, bottom=3) == "\n\nx\n\n\n"
+
+
+def test_set_defaults():
+    set_defaults(width=4, fillchar="*", top=0, bottom=0)
+    assert format_section("ab") == "*ab*"
+    reset_defaults()
+    assert len(format_section("ab", top=0, bottom=0)) == 50
+
+
+def test_bad_options():
+    with pytest.raises(TypeError):
+        format_section("a", colour="red")
+    with pytest.raises(ValueError):
+        format_section("a", fillchar="--")
+    with pytest.raises(ValueError):
+        format_section("a", align="middle")