Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
0514199
Excel Paster: 엑셀 복사 내용을 텍스트 양식으로 바꿔 주는 앱 추가
claude Nov 4, 2026
ca61fcf
Excel Paster: 출력 양식을 템플릿 글상자 하나로 단순화
claude Nov 4, 2026
a7dcf7b
Excel Paster: 머리말·꼬리말이 있는 템플릿 지원
claude Nov 4, 2026
1f5afcb
main 병합: CI 매트릭스 변경 반영, README 재구성
claude Nov 5, 2026
59b1c3b
빌드: 쓰지 않는 Qt 구성 요소 제거로 크기 축소, pip-audit·SHA-256 체크섬 추가
claude Nov 5, 2026
bb50bd5
CI: 취약점 점검 전에 러너 기본 패키지(certifi, setuptools) 최신화
claude Nov 5, 2026
3e52b3f
CI: 파일 크기·체크섬 요약을 로그에도 출력
claude Nov 5, 2026
0814134
Excel Paster: 실제 시트 헤더 형식 지원 (빈 칸·공백·셀 안 줄바꿈)
claude Nov 5, 2026
448bdfc
CI: 앱별로 아티팩트 분리 (PDF-Masker-*, Excel-Paster-*)
claude Nov 5, 2026
129dfa3
Excel Paster: 첫 행이 열 이름인지 자동 판단, 열 이름 저장 기능
claude Nov 5, 2026
55b4862
Excel Paster: 복사한 내용을 엑셀처럼 격자 표로 표시
claude Nov 5, 2026
3b17f5c
Excel Paster: 두 줄 헤더 지원, [ ] 묶음 생략, 빈 값 옆 구분 기호 생략
claude Nov 5, 2026
0cb270a
Excel Paster: 업데이트 모듈 초안 (버전 확인·다운로드·체크섬 검증·교체 스크립트)
claude Nov 5, 2026
da1a549
Excel Paster: 앱 내 업데이트 (시작 시 확인 + 버튼 설치), PDF Masker 저장 오류 상세 표시
claude Nov 5, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 74 additions & 12 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -35,36 +35,86 @@ jobs:
with:
python-version: "3.12"
- run: pip install -r requirements.txt pyinstaller pillow
# 러너 파이썬에 기본으로 깔린 certifi 등이 구버전일 수 있어 점검 전에 최신으로
- run: pip install --upgrade certifi setuptools

- name: Audit dependencies for known vulnerabilities (pip-audit)
shell: bash
run: |
# 번들에 들어가거나 빌드에 쓰이는 패키지 전체를 그대로 점검. 알려진 취약점이 있으면 빌드 실패
python -m pip freeze > audit-requirements.txt
pipx run pip-audit --no-deps --desc -r audit-requirements.txt

- name: Make .icns (macOS)
if: runner.os == 'macOS'
run: python scripts/make_icns.py
run: |
python scripts/make_icns.py masker
python scripts/make_icns.py excelpaster

- name: Build
run: pyinstaller --noconfirm --clean pdfmasker.spec
run: |
pyinstaller --noconfirm --clean pdfmasker.spec
pyinstaller --noconfirm --clean excelpaster.spec

# 앱마다 폴더를 나눠 아티팩트를 따로 올린다 (각각 받을 수 있게)
- name: Package (Windows)
if: runner.os == 'Windows'
shell: pwsh
run: |
New-Item -ItemType Directory -Force out | Out-Null
Copy-Item "dist/PDF Masker.exe" "out/PDF-Masker-windows.exe"
New-Item -ItemType Directory -Force out/pdfmasker, out/excelpaster | Out-Null
Copy-Item "dist/PDF Masker.exe" "out/pdfmasker/PDF-Masker-windows.exe"
Copy-Item "dist/Excel Paster.exe" "out/excelpaster/Excel-Paster-windows.exe"
# SHA-256 체크섬: 받은 파일이 CI 가 만든 그 파일인지 확인용
foreach ($dir in "out/pdfmasker", "out/excelpaster") {
Get-ChildItem "$dir/*.exe" | ForEach-Object {
"$((Get-FileHash $_ -Algorithm SHA256).Hash.ToLower()) $($_.Name)"
} | Set-Content -Encoding ascii "$dir/SHA256SUMS.txt"
}

- name: Package (macOS .dmg)
if: runner.os == 'macOS'
run: |
mkdir -p out dmgroot
mkdir -p out/pdfmasker out/excelpaster
# 서명 인증서가 없으므로 ad-hoc 서명 (Gatekeeper 경고는 README 참고)
codesign --force --deep --sign - "dist/PDF Masker.app"
cp -R "dist/PDF Masker.app" dmgroot/
ln -s /Applications dmgroot/Applications
hdiutil create -volname "PDF Masker" -srcfolder dmgroot -ov -format UDZO \
"out/PDF-Masker-${{ matrix.name }}.dmg"
package() { # $1 앱 이름, $2 출력 폴더
codesign --force --deep --sign - "dist/$1.app"
rm -rf dmgroot && mkdir dmgroot
cp -R "dist/$1.app" dmgroot/
ln -s /Applications dmgroot/Applications
hdiutil create -volname "$1" -srcfolder dmgroot -ov -format UDZO \
"$2/${1// /-}-${{ matrix.name }}.dmg"
(cd "$2" && shasum -a 256 *.dmg > SHA256SUMS.txt)
}
package "PDF Masker" out/pdfmasker
package "Excel Paster" out/excelpaster

- name: Report sizes and checksums
shell: bash
run: |
{
echo "### ${{ matrix.name }} 빌드 결과"
echo
echo '| 파일 | 크기 |'
echo '| --- | --- |'
for f in out/*/*.exe out/*/*.dmg; do
[ -e "$f" ] || continue
echo "| $(basename "$f") | $(du -h "$f" | cut -f1) |"
done
echo
echo '```'
cat out/*/SHA256SUMS.txt
echo '```'
} | tee -a "$GITHUB_STEP_SUMMARY"

- uses: actions/upload-artifact@v4
with:
name: PDF-Masker-${{ matrix.name }}
path: out/*
path: out/pdfmasker/*

- uses: actions/upload-artifact@v4
with:
name: Excel-Paster-${{ matrix.name }}
path: out/excelpaster/*

release:
if: startsWith(github.ref, 'refs/tags/v')
Expand All @@ -73,9 +123,21 @@ jobs:
permissions:
contents: write
steps:
- uses: actions/checkout@v4
- name: Verify tag matches app version
run: |
v="v$(python3 -c 'from excelpaster._version import __version__; print(__version__)')"
if [ "$v" != "$GITHUB_REF_NAME" ]; then
echo "태그 $GITHUB_REF_NAME 가 excelpaster/_version.py 의 $v 와 다릅니다"; exit 1
fi
- uses: actions/download-artifact@v4
with:
path: artifacts
- name: Merge checksums
run: cat artifacts/*/SHA256SUMS.txt > SHA256SUMS.txt
- uses: softprops/action-gh-release@v2
with:
files: artifacts/**/*
files: |
artifacts/**/*.exe
artifacts/**/*.dmg
SHA256SUMS.txt
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,5 @@ dist/
out/
masker/assets/icon.icns
masker/assets/icon.iconset/
excelpaster/assets/icon.icns
excelpaster/assets/icon.iconset/
124 changes: 116 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,16 @@ PDF에서 가릴 부분을 드래그로 지정하거나 자동으로 찾아, **

## 다운로드 / 설치

GitHub Actions가 자동으로 빌드합니다. 저장소의 **Actions** 탭 → 최근 실행 → **Artifacts** 에서 받거나,
`v1.0.0` 같은 태그를 푸시하면 **Releases** 에 올라갑니다.
GitHub Actions가 자동으로 빌드합니다. 저장소의 **Actions** 탭 → 최근 실행 → **Artifacts** 에서 앱별로 따로 받거나
(`PDF-Masker-windows`, `Excel-Paster-windows`, macOS 는 `-macos-arm64`), `v1.0.0` 같은 태그를 푸시하면 **Releases** 에 올라갑니다.
각 zip 에는 실행 파일과 `SHA256SUMS.txt` 가 들어 있습니다.

| 파일 | 대상 |
| --- | --- |
| `PDF-Masker-windows.exe` | Windows 10/11 (64비트) — 설치 없이 바로 실행 |
| `PDF-Masker-macos-arm64.dmg` | Mac (Apple Silicon, M1 이후) |
| `Excel-Paster-windows.exe` | [Excel Paster](#excel-paster) Windows용 — 설치 없이 바로 실행 |
| `Excel-Paster-macos-arm64.dmg` | Excel Paster Mac용 |

> **처음 실행 시 경고가 뜨는 이유**
> 개발자 서명 인증서(Apple $99/년, Windows 코드사인)를 쓰지 않아 OS가 "확인되지 않은 앱"으로 경고합니다.
Expand All @@ -35,6 +38,11 @@ GitHub Actions가 자동으로 빌드합니다. 저장소의 **Actions** 탭 →
>
> 서명 인증서가 있다면 `.github/workflows/build.yml` 의 패키징 단계에 서명을 추가하면 됩니다.

**빌드 신뢰성**: 모든 실행 파일은 GitHub 가 제공하는 깨끗한 가상머신에서 이 저장소의 소스만으로 빌드됩니다.
빌드마다 포함되는 패키지 전체를 `pip-audit` 로 알려진 취약점 점검을 하고(발견 시 빌드 실패), 산출물의 SHA-256 체크섬을
`SHA256SUMS-*.txt` 로 함께 올립니다. Actions 실행 페이지의 Summary 에서 파일 크기와 체크섬을 바로 볼 수 있습니다.
받은 파일은 Windows 에서 `certutil -hashfile 파일.exe SHA256`, macOS 에서 `shasum -a 256 파일.dmg` 로 대조하면 됩니다.

## 사용법

1. PDF를 창에 끌어다 놓거나 `Ctrl+O`로 엽니다.
Expand Down Expand Up @@ -68,14 +76,15 @@ GitHub Actions가 자동으로 빌드합니다. 저장소의 **Actions** 탭 →
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python main.py # 실행
python main.py # PDF Masker 실행
python paster_main.py # Excel Paster 실행
pytest -q # 테스트
```

### 로컬 빌드

- macOS: `scripts/build.sh` → `dist/PDF Masker.app`
- Windows: `scripts\build.bat` → `dist\PDF Masker.exe`
- macOS: `scripts/build.sh` → `dist/PDF Masker.app`, `dist/Excel Paster.app`
- Windows: `scripts\build.bat` → `dist\PDF Masker.exe`, `dist\Excel Paster.exe`

### 구조

Expand All @@ -85,7 +94,106 @@ pytest -q # 테스트
| `masker/detect.py` | 개인정보 패턴 자동 탐지 (텍스트 / OCR 공통) |
| `masker/ocr.py` | OS 내장 OCR 백엔드 (macOS Vision, Windows.Media.Ocr) |
| `masker/gui.py` | PySide6 데스크톱 UI |
| `masker/theme.py` | 라이트/다크 테마 토큰, 스타일시트, 아이콘 |
| `tests/` | 핵심 로직 테스트 24개 (OCR 경로는 가짜 백엔드로 검증) |
| `pdfmasker.spec` | PyInstaller 빌드 스펙 |
| `masker/theme.py` | 라이트/다크 테마 토큰, 스타일시트, 아이콘 (두 앱이 공유) |
| `excelpaster/core.py` | 엑셀 클립보드 파싱, 템플릿·필터 변환, 프리셋 직렬화. GUI 없이 테스트 가능 |
| `excelpaster/gui.py` | Excel Paster PySide6 UI |
| `tests/` | 핵심 로직 테스트 (`test_core.py`·`test_detect.py` PDF Masker, `test_paster.py` Excel Paster) |
| `pdfmasker.spec`, `excelpaster.spec` | PyInstaller 빌드 스펙 |
| `scripts/pyi_trim.py` | 번들에서 쓰지 않는 Qt 모듈·플러그인·번역을 걸러내 실행 파일 크기 축소 |
| `.github/workflows/build.yml` | Windows/macOS 자동 빌드 및 릴리스 |

---

# Excel Paster

엑셀에서 셀 범위를 복사해 붙여넣으면, 내가 글로 적어 둔 **템플릿** 대로 바꿔 주는 Windows·macOS 데스크톱 앱입니다.
명단을 메신저에 올리거나, 표를 문장으로 풀어 쓸 때 씁니다. PDF Masker 와 마찬가지로 모든 처리는 내 컴퓨터 안에서만 이루어집니다.

| 라이트 | 다크 |
| --- | --- |
| ![light](docs/paster-light.png) | ![dark](docs/paster-dark.png) |

## 사용법

1. 엑셀에서 원하는 셀 범위를 복사합니다 (`Ctrl+C`).
2. Excel Paster 창으로 오면 자동으로 입력칸에 들어갑니다. (자동 가져오기를 끈 경우 입력칸에 `Ctrl+V` 또는 툴바의 **클립보드 가져오기**)
3. 가운데 템플릿 칸에 원하는 양식을 글로 적습니다. 결과는 오른쪽에 바로 나타납니다.
4. **결과 복사** (`Ctrl+Shift+C`) 를 누른 뒤 원하는 곳에 `Ctrl+V` 합니다.

## 템플릿

원하는 결과를 그대로 적되, 셀 값이 들어갈 자리에 `{열이름}` 또는 `{1}` `{2}` (열 번호) 를 씁니다.
**`{ }` 가 든 줄만 엑셀의 한 행마다 반복**되고, 그 앞뒤 줄은 한 번만 나옵니다. 열 이름 칩을 클릭해도 들어갑니다.

첫 행이 열 이름(품명, 규격 …)이면 자동으로 건너뛰고, 아니면 전부 데이터로 넣습니다.
**헤더 없이 데이터만 복사**해도 `{품명}` 같은 이름을 쓰려면, 왼쪽 **열 이름** 칸에 시트의 열 순서를 한 번 저장해 두세요.
헤더 행을 한 번 붙여넣고 **첫 행에서 가져오기** 를 누르면 됩니다. 이후엔 어느 행을 복사하든 바로 변환됩니다.

예) 엑셀에 품명 · 규격(두께·가로·세로·높이) · 재질 · 수량 열이 있을 때, 템플릿을

```
11/5일 입고요청
{품명} [{가로}*{세로}*{높이}] {재질} {수량}개
오전입고 바랍니다.
```

라고 적으면 결과는

```
11/5일 입고요청
Xx형태 700*350*1600 SUS304 1개
GAa STEEL 1개
AR38 20개
오전입고 바랍니다.
```

**빈 셀 처리**: 빈 셀은 옆의 공백 하나와 함께 사라져 `AR38 20개` 처럼 공백이 겹치지 않습니다.
`{가로}*{세로}` 처럼 자리표시자 사이의 구분 기호는 한쪽이 비면 같이 사라지고, `[ ]` 로 묶은 부분은
안의 자리표시자가 전부 비면 통째로 사라집니다 (예: `[{두께}t]`). 대괄호를 글자 그대로 쓰려면 `[[ ]]`.

**헤더가 두 줄**인 시트(규격 아래 두께·가로·세로·높이)는 두 줄을 합쳐 아래 줄 이름으로 참조합니다.
반복 줄이 여러 줄이어도 되고, 꼬리말 앞에 빈 줄을 두면 그 간격이 유지됩니다. 꼬리말 없이 끝에 빈 줄을 두면 행 사이가 띄어집니다.

| 쓰기 | 뜻 |
| --- | --- |
| `{품명}` `{수량}` | 열 이름으로 참조 (첫 행 또는 저장해 둔 열 이름) |
| `{1}` `{2}` … | 열 번호로 참조 (열 이름이 없어도 됨) |
| `{#}` | 행 번호 (1부터) |
| `{행수}` | 전체 행 수 (머리말·꼬리말에서도 사용 가능) |
| `{오늘}` | 오늘 날짜, `11/5` 형식 |
| `{{` `}}` `[[` `]]` | 중괄호·대괄호 글자 그대로 |

필요하면 `|` 뒤에 필터를 붙일 수 있습니다 (여러 개 연달아 가능).

| 필터 | 예 | 결과 |
| --- | --- | --- |
| `comma` | `{금액\|comma}` | `1234567` → `1,234,567` |
| `nocomma` | `{금액\|nocomma}` | `1,234` → `1234` |
| `trim` `upper` `lower` | `{코드\|trim\|upper}` | 공백 제거 / 대문자 / 소문자 |
| `default:값` | `{비고\|default:없음}` | 비어 있으면 `없음` |
| `ljust:N` `rjust:N` `center:N` `zfill:N` | `{금액\|rjust:10}` | 폭 맞추기 / 0 채우기 |
| `replace:a,b` | `{전화\|replace:-,}` | `a` 를 `b` 로 바꿈 |
| `oneline` | `{메모\|oneline}` | 셀 안 줄바꿈·연속 공백을 한 칸으로 |
| `quote` | `{값\|quote}` | 큰따옴표로 감싸기 (내부 따옴표는 `""`) |

## 업데이트

앱을 켤 때 GitHub Releases 에 새 버전이 있는지 확인하고, 있으면 오른쪽 아래에 **새 버전 vX — 업데이트** 버튼이 뜹니다.
누르면 새 실행 파일을 받아 `SHA256SUMS.txt` 로 검증한 뒤 교체하고 다시 실행합니다 (Windows). macOS 는 받은 dmg 를 열어 줍니다.
**도움말 → 업데이트 확인…** 으로 직접 확인할 수 있고, **시작할 때 업데이트 확인** 을 끄면 시작 시 인터넷에 접속하지 않습니다.
확인 과정에서 보내는 것은 버전 조회 요청뿐이며, 붙여넣은 내용은 어디에도 전송되지 않습니다.

새 버전을 내려면 `excelpaster/_version.py` 의 버전을 올리고 같은 번호의 태그(`v1.1.0`)를 푸시하면 CI 가 Releases 에 올립니다.

## 저장된 템플릿

자주 쓰는 템플릿은 **저장…** (`Ctrl+S`) 으로 이름을 붙여 두고 목록에서 고릅니다. 내 템플릿은 ★ 표시로 위쪽에 나옵니다.
**프리셋 메뉴 → 내보내기/가져오기** 로 JSON 파일로 옮길 수 있습니다. 마지막으로 쓰던 템플릿과 창 크기는 다음 실행 때 그대로 복원됩니다.

## 동작 세부

- 엑셀이 클립보드에 넣는 탭 구분 텍스트를 그대로 해석합니다. 줄바꿈·탭·따옴표가 든 셀(엑셀이 큰따옴표로 감싸는 셀)도 올바르게 읽습니다.
- 엑셀이 붙이는 마지막 빈 줄은 무시하고, 행마다 열 수가 다르면 빈 칸으로 채웁니다.
- 탭이 없는 일반 텍스트를 붙여넣으면 한 줄이 한 행(1열)이 됩니다.
- 모르는 자리표시자는 그대로 남겨 두고 경고로 알려 줍니다 (타이핑 중 결과가 깨지지 않도록).
- 자동 가져오기는 탭이나 줄바꿈이 든 텍스트만 가져오며, 방금 복사한 결과물은 다시 가져오지 않습니다.
Binary file added docs/paster-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/paster-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
50 changes: 50 additions & 0 deletions excelpaster.spec
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# -*- mode: python ; coding: utf-8 -*-
# PyInstaller 스펙 (Excel Paster). 사용: pyinstaller excelpaster.spec
import sys
from pathlib import Path

sys.path.insert(0, str(Path(SPECPATH) / "scripts"))
from pyi_trim import trim_qt # noqa: E402 — 쓰지 않는 Qt 구성 요소 제거

APP_NAME = "Excel Paster"
ROOT = Path(SPECPATH)
ASSETS = ROOT / "excelpaster" / "assets"
icon = None
if sys.platform == "win32":
icon = str(ASSETS / "icon.ico")
elif sys.platform == "darwin" and (ASSETS / "icon.icns").exists():
icon = str(ASSETS / "icon.icns")

a = Analysis(
["paster_main.py"],
pathex=[str(ROOT)],
datas=[(str(ASSETS / "icon.png"), "excelpaster/assets")],
hiddenimports=[],
excludes=["pymupdf", "fitz", "PySide6.QtWebEngineCore", "PySide6.QtWebEngineWidgets",
"PySide6.QtPdf", "PySide6.QtQml", "PySide6.QtQuick", "PySide6.Qt3DCore",
"PySide6.QtMultimedia", "pymupdf4llm", "pymupdf_layout", "tkinter"],
noarchive=False,
)
trim_qt(a)
pyz = PYZ(a.pure)

if sys.platform == "darwin":
exe = EXE(pyz, a.scripts, exclude_binaries=True, name=APP_NAME, console=False, icon=icon)
coll = COLLECT(exe, a.binaries, a.datas, name=APP_NAME)
app = BUNDLE(
coll,
name=f"{APP_NAME}.app",
icon=icon,
bundle_identifier="dev.local.excelpaster",
info_plist={
"CFBundleDisplayName": APP_NAME,
"CFBundleShortVersionString": "1.0.0",
"NSHighResolutionCapable": True,
"NSRequiresAquaSystemAppearance": False,
},
)
else:
exe = EXE(
pyz, a.scripts, a.binaries, a.datas, [],
name=APP_NAME, console=False, icon=icon, upx=False,
)
1 change: 1 addition & 0 deletions excelpaster/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
"""엑셀에서 복사한 표를 원하는 텍스트 양식으로 바꿔 주는 데스크톱 앱."""
3 changes: 3 additions & 0 deletions excelpaster/_version.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
"""앱 버전. 릴리스 태그(vX.Y.Z)와 같아야 하며 CI 가 검사한다."""

__version__ = "1.0.0"
Binary file added excelpaster/assets/icon.ico
Binary file not shown.
Binary file added excelpaster/assets/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading