pkgmgr-kunrunic 0.1.1.dev4__py3-none-any.whl

pkgmgr_kunrunic-0.1.1.dev4.dist-info/METADATA

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: pkgmgr-kunrunic
+Version: 0.1.1.dev4
+Summary: Package management workflow scaffold.
+Author: pkgmgr maintainers
+License: MIT License
+        
+        Copyright (c) 2025 Jho Sung Jun
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/kunrunic/pkgmgnt
+Project-URL: Repository, https://github.com/kunrunic/pkgmgnt
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Dynamic: license-file
+
+# pkgmgr
+
+패키지 관리/배포 워크플로를 위한 Python 패키지입니다. 현재는 패키지 단위 관리와 릴리스 번들링에 초점을 둔 초기 버전입니다.
+
+## 디자인/Use case
+- 흐름 요약과 Mermaid 시퀀스 다이어그램은 [`design/mermaid/use-cases.md`](design/mermaid/use-cases.md)에 있습니다.
+- 주 명령별 설정/동작 요약과 make-config/install/create-pkg/update-pkg/close-pkg 시퀀스를 포함합니다.
+
+## 구성
+- `pkgmgr/cli.py` : CLI 엔트리 (아래 명령어 참조)
+- `pkgmgr/config.py` : `pkgmgr.yaml` / `pkg.yaml` 템플릿 생성 및 로더 (PyYAML 필요)
+- `pkgmgr/snapshot.py`, `pkgmgr/release.py`, `pkgmgr/watch.py` : 스냅샷/패키지 수명주기/감시/릴리스 번들
+- `pkgmgr/collectors/` : 컬렉터 인터페이스 및 체크섬 컬렉터 스텁
+- 템플릿: `pkgmgr/templates/pkgmgr.yaml.sample`, `pkgmgr/templates/pkg.yaml.sample`
+
+## 필요 사항
+- Python 3.6 이상
+- 의존성(PyYAML 등)은 `pip install pkgmgr-kunrunic` 시 자동 설치됩니다.
+
+## 설치 (PyPI/로컬)
+- PyPI(권장): `python -m pip install pkgmgr-kunrunic` (또는 `pipx install pkgmgr-kunrunic`으로 전역 CLI 설치).
+- 로컬/개발: 리포지토리 클론 후 `python -m pip install .` 또는 빌드 산출물(`dist/pkgmgr_kunrunic-<버전>-py3-none-any.whl`)을 `python -m pip install dist/<파일>`로 설치.
+- 확인: `pkgmgr --version` 혹은 `python -m pkgmgr.cli --version`.
+
+## 기본 사용 흐름
+아래 명령은 `pkgmgr ...` 또는 `python -m pkgmgr.cli ...` 형태로 실행합니다.  
+설정 파일 기본 위치는 `~/pkgmgr/pkgmgr.yaml`이며, `~/pkgmgr/pkgmgr*.yaml`과 `~/pkgmgr/config/pkgmgr*.yaml`을 자동 탐색합니다(여러 개면 선택 필요, `--config`로 강제 지정 가능). 상태/릴리스 데이터는 `~/pkgmgr/local/state` 아래에 기록됩니다.
+
+### 1) make-config — 메인 설정 템플릿 생성
+```
+pkgmgr make-config
+pkgmgr make-config -o ~/pkgmgr/config/pkgmgr-alt.yaml  # 위치 지정 가능
+```
+편집할 주요 필드: `pkg_release_root`, `sources`, `source.exclude`, `artifacts.targets/exclude`, `git.keywords/repo_root`, `collectors.enabled`, `actions`.
+
+### 2) install — PATH/alias 등록 + 초기 baseline(한 번만)
+```
+pkgmgr install [--config <path>]
+```
+- 사용 쉘을 감지해 rc 파일에 PATH/alias 추가.
+- `~/pkgmgr/local/state/baseline.json`이 없을 때만 초기 스냅샷 생성(있으면 건너뜀).
+
+### 3) create-pkg — 패키지 디렉터리/설정 생성
+```
+pkgmgr create-pkg <pkg-id> [--config <path>]
+```
+- `<pkg_release_root>/<pkg-id>/pkg.yaml`을 실제 값으로 채워 생성(기존 파일이 있으면 덮어쓰기 여부 확인).
+- 메인 설정의 `git.keywords/repo_root`, `collectors.enabled`를 기본값으로 반영.
+- baseline이 없는 경우에만 baseline 생성.
+
+### 4) update-pkg — Git/체크섬 수집 + 릴리스 번들 생성
+```
+pkgmgr update-pkg <pkg-id> [--config <path>]
+```
+- 최신 릴리스 종료/아카이브: `pkgmgr update-pkg <pkg-id> --release` (tar 생성 후 `HISTORY/`로 이동).
+- Git: `git.repo_root`(상대/절대)에서 `git.keywords` 매칭 커밋을 모아 `message/author/subject/files/keywords` 저장.
+- 체크섬: 키워드에 걸린 파일 + `include.releases` 경로의 파일 해시 수집.
+- 릴리스 번들: `include.releases` 최상위 디렉터리별로 `release/<root>/release.vX.Y.Z/`를 생성. `--release` 전까지는 최신 버전을 유지하며 변경분만 추가/덮어쓰기/삭제 반영(버전 증가 없음), 이전 버전과 해시가 동일한 파일은 스킵. 각 릴리스 폴더에 `PKG_NOTE`(1회 생성, 사용자 내용 유지)와 `PKG_LIST`(매번 갱신) 작성.
+- 실행 결과는 `~/pkgmgr/local/state/pkg/<id>/updates/update-<ts>.json`에 기록(`git`, `checksums`, `release` 메타 포함).
+
+### 5) actions — 외부 작업 실행
+```
+pkgmgr actions
+pkgmgr --config <path> actions <name> [args...]
+```
+- 설정의 `actions`에 등록된 작업 목록을 출력하거나, 지정한 작업을 실행합니다.
+- `<name>` 뒤의 모든 인자는 액션 커맨드에 그대로 전달됩니다.
+- 예: `pkgmgr --config ~/pkgmgr/pkgmgr.yaml actions export_cksum --root R --time 4`
+- 예: `pkgmgr --config ~/pkgmgr/pkgmgr.yaml actions export_cksum --pkg-dir /path/to/pkg --excel /path/to/template.xlsx`
+
+## PATH/alias 자동 추가
+- PyPI/로컬 설치 후 `python -m pkgmgr.cli install`을 실행하면 현재 파이썬의 `bin` 경로(예: venv/bin, ~/.local/bin 등)를 감지해 사용 중인 쉘의 rc 파일에 PATH/alias를 추가합니다.
+- 지원 쉘: bash(`~/.bashrc`), zsh(`~/.zshrc`), csh/tcsh(`~/.cshrc`/`~/.tcshrc`), fish(`~/.config/fish/config.fish`).
+- 추가 내용:
+  - PATH: `export PATH="<script_dir>:$PATH"` 또는 쉘별 동등 구문
+  - alias: `alias pkg="pkgmgr"` (csh/fish 문법 사용)
+- 이미 추가된 경우(marker로 확인) 중복 삽입하지 않습니다. rc 파일이 없으면 새로 만듭니다.
+
+## 템플릿 개요
+- `pkgmgr/templates/pkgmgr.yaml.sample` : 메인 설정 샘플  
+  - `pkg_release_root`: 패키지 릴리스 루트  
+  - `sources`: 관리할 소스 경로 목록  
+  - `source.exclude`: 소스 스캔 제외 패턴 (glob 지원)  
+  - `artifacts.targets` / `artifacts.exclude`: 배포 대상 포함/제외 규칙 (glob 지원: `tmp/**`, `*.bak`, `**/*.tmp` 등)  
+  - `watch.interval_sec`: 감시 폴링 주기(향후 노출 예정)  
+  - `watch.on_change`: 변경 시 실행할 action 이름 리스트(향후 노출 예정)  
+  - `collectors.enabled`: 기본 활성 컬렉터(향후 확장 예정)
+  - `actions`: action 이름 → 실행할 커맨드 목록 (각 항목에 `cmd` 필수, `cwd`/`env` 선택)
+
+- `pkgmgr/templates/pkg.yaml.sample` : 패키지별 설정 샘플  
+  - `pkg.id` / `pkg.root` / `pkg.status(open|closed)`  
+  - `include.releases`: 릴리스에 포함할 경로(최상위 디렉터리별로 묶여 `release/<root>/release.vX.Y.Z` 생성)  
+  - `git.repo_root/keywords/since/until`: 커밋 수집 범위  
+  - `collectors.enabled`: 패키지별 컬렉터 설정
+
+## 주의
+- 시스템 전체 관리(감시/수집/포인트) 기능은 아직 확장 단계입니다. 추후 단계적으로 구현/교체 예정입니다.
+
+## 확장성 가이드
+- `actions`를 기본 확장 포인트로 사용합니다. 배포/내보내기/알림 등은 액션으로 위임하는 것을 권장합니다.
+- 릴리스 번들 포맷(`release/<root>/release.vX.Y.Z/`, `PKG_LIST`, `PKG_NOTE`)은 외부 도구와의 연동 기준점으로 사용합니다.
+- `~/pkgmgr/local/state/pkg/<id>/updates/update-<ts>.json`은 자동화 파이프라인에서 읽을 수 있는 결과물로 취급합니다.
+- 전역 수집/집계는 `collectors` 확장으로 흡수할 계획이며, CLI로 노출하기 전까지는 내부 확장용으로 유지합니다.
+
+## TODO (우선순위)
+- 감시/포인트 고도화: watchdog/inotify 연동, diff 결과를 포인트 메타에 기록, 에러/로그 처리.
+- baseline/릴리스 알림: baseline 대비 변경 감지 시 알림/확인 흐름 추가(README/README.txt TODO 반영).
+- 컬렉터 파이프라인: 체크섬 외 collector 등록/선택/실행 로직, include 기준 실행, 정적/동적/EDR/AV 훅 자리 마련.
+- 테스트/CI: watch diff/포인트/라이프사이클 단위 테스트 추가, pytest/CI 스크립트 보강.

pkgmgr_kunrunic-0.1.1.dev4.dist-info/RECORD

@@ -0,0 +1,24 @@
+pkgmgr/__init__.py,sha256=YXso8YOYaKROJdRdSjJzOEr2gv4esU4GZN6rNjNhbv8,270
+pkgmgr/__main__.py,sha256=5eNtvDmnY8k4F1RUzYaPcmF-6t-4kH8THzm8x8vFZGI,117
+pkgmgr/cli.py,sha256=ynyn_Mv8CNYuxJSefAAncFAz-qUUF2wwx8kRuVj0A3M,9590
+pkgmgr/config.py,sha256=EXaA9wLDJr3wiOj46vE9LJKZcURI1UPr_9U3BPjymbM,13722
+pkgmgr/points.py,sha256=6RxcqJYzMLSmLdvoRmmfsrT5O2uDMrJtGHPTYxJE9Xw,3177
+pkgmgr/release.py,sha256=1614yD7xQC0uN0TyJJdebsKit-qUNA0cEom5OK0EEDw,35729
+pkgmgr/shell_integration.py,sha256=79MT1Y1ZAN020JDMN3J0mcEgsmC3OlGT6W_f8ArLEUU,3856
+pkgmgr/snapshot.py,sha256=STHhqf_nW51JnOisVeT58gPEr2SawNbq-V3xlt9ZXEE,9030
+pkgmgr/watch.py,sha256=7FeKdSOVNZZnIb12KwSs90NLkUAAn4iM130rNE7Z8oc,2642
+pkgmgr/collectors/__init__.py,sha256=eDt5wa8jyDFn3HC2-0U5AjyXSdlJ9hcHOweMewfD4kM,90
+pkgmgr/collectors/base.py,sha256=Zfpe6yMMLmoSZQUkYR6TObDF4TW1YQNNlAZmcukTQIU,309
+pkgmgr/collectors/checksums.py,sha256=Lp7ySNx6ZEhk6hMWtMgJ5KJn0PcWa6jb9_FXosd6Dks,877
+pkgmgr/templates/pkg.yaml.sample,sha256=9nm9Jj-98y9AjrAirx1AF3XAvFjkuQFI0n5fIpJWUSk,261
+pkgmgr/templates/pkgmgr.yaml.sample,sha256=9l39yqJkZTG960Tx5pm4e7p9oS3vLFdy65wOg_v-slg,1417
+pkgmgr_kunrunic-0.1.1.dev4.dist-info/licenses/LICENSE,sha256=DQyjlSl_S-KOdFowc6Lqx-cP6cX9aNF9CLguAHfQI5c,1069
+plugin/export_cksum.py,sha256=laYDz215mmbKhZzRtTV7p0LBU3RoWtnN5ygsU3MSnws,13624
+plugin/export_pkgstore.py,sha256=zhzZuce_q7cwSul9tcIJlCaGZp3zlRFY2s4sQk3vglA,4431
+plugin/export_source_review.py,sha256=5KXn5w8Cc15tBfNqPI65YVAu-SMK4bmA05WO4dVE8KA,16257
+tools/echo_args.py,sha256=Uh_11LzHvI5xYbWR_xC_7cUphEeyOWEBXgnKYXqgwHM,219
+pkgmgr_kunrunic-0.1.1.dev4.dist-info/METADATA,sha256=NxROILwIpW8aSG9A4U_eF9G2As82XRAg-SHl2WJeVMM,9748
+pkgmgr_kunrunic-0.1.1.dev4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pkgmgr_kunrunic-0.1.1.dev4.dist-info/entry_points.txt,sha256=DsYKXAiVGhesLkCOM0jgsRoiSXo21S8qReKGTqxTBjs,43
+pkgmgr_kunrunic-0.1.1.dev4.dist-info/top_level.txt,sha256=emuhQN2YYcS6sgkErR4Xz-F1xvP8UaZ4FnBUH0LVM_k,20
+pkgmgr_kunrunic-0.1.1.dev4.dist-info/RECORD,,

pkgmgr_kunrunic-0.1.1.dev4.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pkgmgr_kunrunic-0.1.1.dev4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pkgmgr = pkgmgr.cli:main

pkgmgr_kunrunic-0.1.1.dev4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jho Sung Jun
+
+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.

pkgmgr_kunrunic-0.1.1.dev4.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+pkgmgr
+plugin
+tools

plugin/export_cksum.py

@@ -0,0 +1,354 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+import argparse
+import os
+import subprocess
+import sys
+from copy import copy
+
+try:
+    import openpyxl
+except Exception:
+    openpyxl = None
+
+from pkgmgr import config
+from openpyxl.styles import Alignment, Border, Font, PatternFill, Side
+
+
+def _load_pkg_yaml(pkg_dir):
+    if not pkg_dir:
+        return None
+    return os.path.join(pkg_dir, "pkg.yaml")
+
+
+def _resolve_pkg_dir(pkg_id, config_path=None):
+    try:
+        if config_path:
+            main_cfg = config.load_main(path=config_path, allow_interactive=False)
+        else:
+            main_cfg = config.load_main(allow_interactive=False)
+    except Exception:
+        return None
+    release_root = main_cfg.get("pkg_release_root")
+    if not release_root:
+        return None
+    return os.path.abspath(os.path.expanduser(os.path.join(release_root, str(pkg_id))))
+
+
+def _group_release_paths(pkg_dir, releases):
+    grouped = {}
+    for entry in releases:
+        if entry is None:
+            continue
+        rel = str(entry)
+        target = rel if os.path.isabs(rel) else os.path.join(pkg_dir, rel)
+        target = os.path.abspath(os.path.expanduser(target))
+        if not os.path.exists(target):
+            print("[export_cksum] skip missing: %s" % target)
+            continue
+        try:
+            relpath = os.path.relpath(target, pkg_dir)
+        except Exception:
+            relpath = os.path.basename(target)
+        if relpath.startswith(".."):
+            print("[export_cksum] skip outside pkg_dir: %s" % target)
+            continue
+        parts = relpath.split(os.sep, 1)
+        if len(parts) == 2:
+            root, subrel = parts[0], parts[1]
+        else:
+            root, subrel = parts[0], ""
+        grouped.setdefault(root, []).append((target, subrel))
+    return grouped
+
+
+def _collect_files(root_dir, entries):
+    files = set()
+    for target, subrel in entries:
+        if subrel:
+            base_dir = os.path.join(root_dir, subrel)
+        else:
+            base_dir = target
+        if os.path.isfile(base_dir):
+            files.add(base_dir)
+            continue
+        if not os.path.isdir(base_dir):
+            continue
+        for base, _, names in os.walk(base_dir):
+            for name in names:
+                abspath = os.path.join(base, name)
+                if os.path.isfile(abspath):
+                    files.add(abspath)
+    return files
+
+
+def _cksum(path):
+    try:
+        out = subprocess.check_output(["cksum", path], stderr=subprocess.STDOUT)
+    except Exception as e:
+        print("[export_cksum] cksum failed: %s (%s)" % (path, str(e)))
+        return None
+    line = out.decode("utf-8", errors="replace").strip()
+    parts = line.split()
+    if len(parts) < 3:
+        print("[export_cksum] invalid cksum output: %s" % line)
+        return None
+    return parts[0], parts[1], " ".join(parts[2:])
+
+
+def _default_styles():
+    base_font = Font(name="맑은 고딕", size=11)
+    bold_font = Font(name="맑은 고딕", size=11, bold=True)
+    header_fill = PatternFill("solid", fgColor="92D050")
+    sub_fill = PatternFill("solid", fgColor="FCE4D6")
+    medium = Side(style="medium")
+    hair = Side(style="hair")
+    return {
+        "base_font": base_font,
+        "bold_font": bold_font,
+        "header_fill": header_fill,
+        "sub_fill": sub_fill,
+        "medium": medium,
+        "hair": hair,
+    }
+
+
+def _border(left=None, right=None, top=None, bottom=None):
+    return Border(left=left, right=right, top=top, bottom=bottom)
+
+
+def _init_sheet(ws, sheet_name, release_path, ensure_format):
+    if ensure_format:
+        styles = _default_styles()
+        ws.merge_cells("B2:E2")
+        ws.merge_cells("B3:E3")
+        if "B4:C4" not in ws.merged_cells:
+            ws.merge_cells("B4:C4")
+        for col in range(2, 6):
+            cell = ws.cell(row=2, column=col)
+            cell.fill = styles["header_fill"]
+            cell.font = styles["bold_font"]
+            cell.alignment = Alignment(horizontal="center", vertical="center")
+            cell.border = _border(styles["medium"], styles["medium"], styles["medium"], styles["medium"])
+        for col in range(2, 6):
+            cell = ws.cell(row=3, column=col)
+            cell.fill = styles["sub_fill"]
+            cell.font = styles["base_font"]
+            cell.alignment = Alignment(horizontal="center", vertical="center")
+            left = styles["medium"] if col == 2 else styles["hair"]
+            right = styles["medium"] if col == 5 else styles["hair"]
+            cell.border = _border(left, right, styles["medium"], styles["hair"])
+        for col in range(2, 6):
+            cell = ws.cell(row=4, column=col)
+            cell.fill = styles["sub_fill"]
+            cell.font = styles["base_font"]
+            cell.alignment = Alignment(horizontal="center", vertical="center")
+            left = styles["medium"] if col == 2 else styles["hair"]
+            right = styles["medium"] if col == 5 else styles["hair"]
+            cell.border = _border(left, right, styles["hair"], styles["hair"])
+        ws.row_dimensions[2].height = 17.25
+        ws.column_dimensions["B"].width = 16.75
+        ws.column_dimensions["C"].width = 12.75
+        ws.column_dimensions["D"].width = 45.875
+        ws.column_dimensions["E"].width = 12.75
+        ws.column_dimensions["F"].width = 13.0
+    ws.cell(row=2, column=2, value=sheet_name)
+    ws.cell(row=3, column=2, value=release_path)
+    ws.cell(row=4, column=2, value="Check Sum")
+    ws.cell(row=4, column=4, value="File Name")
+    ws.cell(row=4, column=5, value="비고")
+
+
+def _apply_table_border(ws, start_row, end_row, ensure_format):
+    if not ensure_format:
+        return
+    styles = _default_styles()
+    for row in range(start_row, end_row + 1):
+        for col in range(2, 6):
+            cell = ws.cell(row=row, column=col)
+            left = styles["medium"] if col == 2 else styles["hair"]
+            right = styles["medium"] if col == 5 else styles["hair"]
+            top = styles["hair"] if row >= 4 else None
+            if row == end_row:
+                bottom = styles["medium"]
+            elif row == 4:
+                bottom = styles["hair"]
+            else:
+                bottom = None
+            cell.border = _border(left, right, top, bottom)
+
+
+def _configure_page(ws, end_row, template_ws=None):
+    if template_ws is not None:
+        ws.print_area = template_ws.print_area
+        ws.page_setup.orientation = template_ws.page_setup.orientation
+        ws.page_setup.paperSize = template_ws.page_setup.paperSize
+        ws.page_setup.fitToWidth = template_ws.page_setup.fitToWidth
+        ws.page_setup.fitToHeight = template_ws.page_setup.fitToHeight
+        ws.sheet_view.view = template_ws.sheet_view.view
+        ws.sheet_view.zoomScale = template_ws.sheet_view.zoomScale
+        ws.sheet_view.zoomScaleNormal = template_ws.sheet_view.zoomScaleNormal
+        ws.sheet_view.showGridLines = template_ws.sheet_view.showGridLines
+        return
+    ws.print_area = "A1:F%d" % max(end_row, 5)
+    ws.page_setup.orientation = "portrait"
+    ws.page_setup.paperSize = 9
+    ws.page_setup.fitToWidth = 1
+    ws.page_setup.fitToHeight = 0
+    ws.sheet_properties.pageSetUpPr.fitToPage = True
+    ws.sheet_view.view = "pageBreakPreview"
+    ws.sheet_view.zoomScale = 100
+    ws.sheet_view.zoomScaleNormal = 100
+    ws.sheet_view.showGridLines = False
+
+
+def _copy_style(src, dest):
+    dest.font = copy(src.font)
+    dest.border = copy(src.border)
+    dest.fill = copy(src.fill)
+    dest.number_format = copy(src.number_format)
+    dest.protection = copy(src.protection)
+    dest.alignment = copy(src.alignment)
+
+
+def _write_sheet(ws, rows, ensure_format, template_ws=None):
+    if ws.max_row >= 5:
+        for row in ws.iter_rows(min_row=5, max_row=ws.max_row, min_col=2, max_col=5):
+            for cell in row:
+                cell.value = None
+    style_row = 5 if ws.max_row >= 5 else None
+    style_cells = {}
+    if style_row:
+        for col in range(2, 6):
+            style_cells[col] = ws.cell(row=style_row, column=col)
+    template_height = None
+    if template_ws is not None:
+        template_height = template_ws.row_dimensions[5].height
+    styles = _default_styles() if ensure_format else None
+    for idx, (cksum, size, path) in enumerate(rows, 5):
+        b = ws.cell(row=idx, column=2, value=cksum)
+        c = ws.cell(row=idx, column=3, value=size)
+        d = ws.cell(row=idx, column=4, value=path)
+        e = ws.cell(row=idx, column=5, value="")
+        if style_cells:
+            _copy_style(style_cells[2], b)
+            _copy_style(style_cells[3], c)
+            _copy_style(style_cells[4], d)
+            _copy_style(style_cells[5], e)
+        if ensure_format and styles:
+            b.border = _border(styles["medium"], styles["hair"], styles["hair"], None)
+            c.border = _border(styles["hair"], styles["hair"], styles["hair"], None)
+            d.border = _border(styles["hair"], styles["hair"], styles["hair"], None)
+            e.border = _border(styles["hair"], styles["medium"], styles["hair"], None)
+            for cell in (b, c, d, e):
+                cell.font = styles["base_font"]
+                cell.alignment = Alignment(vertical="center")
+        if template_height is not None:
+            ws.row_dimensions[idx].height = template_height
+    end_row = max(5, 4 + len(rows))
+    _apply_table_border(ws, 4, end_row, ensure_format)
+    if ensure_format:
+        blank_row = end_row + 1
+        for col in range(2, 6):
+            cell = ws.cell(row=blank_row, column=col)
+            cell.value = None
+            cell.border = Border()
+            cell.fill = PatternFill(fill_type=None)
+    _configure_page(ws, end_row + 1, template_ws=template_ws)
+
+
+def main(argv=None):
+    argv = argv if argv is not None else sys.argv[1:]
+    parser = argparse.ArgumentParser(description="Export cksum results into an Excel template.")
+    parser.add_argument("--config", help="pkgmgr main config path")
+    parser.add_argument("--pkg-id", required=True, help="pkg id (resolved via pkg_release_root)")
+    parser.add_argument("--excel", required=True, help="output xlsx path")
+    parser.add_argument("--template", help="xlsx template path (optional)")
+    args = parser.parse_args(argv)
+
+    if openpyxl is None:
+        print("[export_cksum] openpyxl is required (pip install openpyxl)")
+        return 1
+
+    pkg_dir = None
+    config_path = args.config or os.environ.get("PKGMGR_CONFIG")
+    if args.pkg_id:
+        pkg_dir = _resolve_pkg_dir(args.pkg_id, config_path=config_path)
+    pkg_yaml = _load_pkg_yaml(pkg_dir)
+    if not pkg_yaml:
+        print("[export_cksum] pkg.yaml not specified; use --pkg-id")
+        return 1
+    pkg_yaml = os.path.abspath(os.path.expanduser(pkg_yaml))
+    pkg_dir = os.path.dirname(pkg_yaml)
+
+    pkg_cfg = config.load_pkg_config(pkg_yaml)
+    releases = (pkg_cfg.get("include") or {}).get("releases") or []
+    grouped = _group_release_paths(pkg_dir, releases)
+    if not grouped:
+        print("[export_cksum] no release entries found in %s" % pkg_yaml)
+        return 1
+
+    excel_path = args.excel
+    if not excel_path.lower().endswith(".xlsx"):
+        excel_path = excel_path + ".xlsx"
+    if os.sep not in excel_path:
+        export_dir = os.path.join(pkg_dir, "export")
+        excel_path = os.path.join(export_dir, excel_path)
+    template_path = args.template or excel_path
+    template_available = template_path and os.path.exists(template_path)
+    if template_available:
+        wb = openpyxl.load_workbook(template_path)
+        print("[export_cksum] template loaded: %s" % template_path)
+    else:
+        wb = openpyxl.Workbook()
+        for name in list(wb.sheetnames):
+            wb.remove(wb[name])
+        print("[export_cksum] template not found; creating new workbook: %s" % excel_path)
+    template_ws = wb[wb.sheetnames[0]] if wb.sheetnames else None
+    template_title = template_ws.title if template_ws is not None else None
+    roots = []
+    for root, entries in sorted(grouped.items()):
+        roots.append(root)
+        root_dir = os.path.join(pkg_dir, root)
+        files = _collect_files(root_dir, entries)
+        rows = []
+        for path in files:
+            if not os.path.isfile(path):
+                continue
+            try:
+                relpath = os.path.relpath(path, root_dir)
+            except Exception:
+                relpath = os.path.basename(path)
+            cksum_row = _cksum(path)
+            if not cksum_row:
+                continue
+            rows.append((cksum_row[0], cksum_row[1], relpath))
+        rows.sort(key=lambda r: r[2])
+
+        ensure_format = not template_available
+        if root in wb.sheetnames:
+            ws = wb[root]
+        elif template_ws is not None:
+            ws = wb.copy_worksheet(template_ws)
+            ws.title = root
+        else:
+            ws = wb.create_sheet(title=root)
+        _init_sheet(ws, root, "PKG Release 경로 작성 필요", ensure_format)
+        _write_sheet(ws, rows, ensure_format, template_ws=template_ws)
+        print("[export_cksum] sheet=%s rows=%d" % (root, len(rows)))
+    if template_title and template_title not in roots and template_title in wb.sheetnames:
+        wb.remove(wb[template_title])
+
+    out_path = excel_path
+    if not out_path.lower().endswith(".xlsx"):
+        out_path = out_path + ".xlsx"
+    out_dir = os.path.dirname(os.path.abspath(out_path))
+    if out_dir and not os.path.exists(out_dir):
+        os.makedirs(out_dir)
+    wb.save(out_path)
+    print("[export_cksum] wrote %s" % out_path)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())