RepoManager

수업·실습 후 남는 GitHub 저장소를 GUI에서 골라 백업·아카이브·이름 변경·삭제하는 데스크톱 앱입니다.
Windows, macOS, Linux에서 동작합니다 (PySide6).

프로젝트: https://github.com/progh2/repomanager

기능

목록·필터

• 활성 / 아카이브 이중 목록과 → ← 이동
• 검색, Owner, 공개범위, Pages, Fork, 정렬(이름 / 업데이트 / 생성)
• 생성일·업데이트일, Public/Private, 설명, Pages·Fork 아이콘
• 더블클릭 또는 버튼으로 GitHub / Pages 열기
• 로딩 스피너 오버레이, 시작 시 캐시 목록 즉시 표시 후 백그라운드 새로고침
• 창 크기·필터·정렬 상태 기억

편집·정리

• 설명 편집, AI 추천 설명(GitHub Models / Copilot 권한 시, UI 언어로 생성)
• 공개/비공개 토글
• 이름 변경 — URL·remote·Pages 등이 깨질 수 있다는 경고 + RENAME 입력 확인
• 선택 저장소 일괄 아카이브 / 활성 복원 / 삭제
• 삭제·이름 변경 전 확인 창 (DELETE / RENAME 입력)
• 삭제 전 CSV 내보내기, ZIP 백업

ZIP 백업 (삭제 전 권장)

• git clone --mirror로 모든 브랜치·태그 포함
• Issues / Pull requests / Milestones를 JSON으로 함께 저장
• 상세 패널, 상단 ZIP 백업, 삭제 확인 창에서 실행
• 로컬에 Git이 없으면 메타데이터만 저장하고 안내

인증·설정·UX

• PAT / GitHub CLI / 웹 로그인(OAuth Device Flow)
• 토큰은 OS 자격 증명 저장소(keyring)에 저장
• 다국어 UI: 한국어 / English / 日本語 (시스템 기본)
• 라이트 / 다크 테마
• 단축키: F5·Ctrl+R 새로고침, Delete 삭제 확인
• API rate limit 표시, 백그라운드 워커로 UI 멈춤 방지

요구 사항

• Python 3.11+
• GitHub 토큰 (PAT 또는 gh / OAuth)
• ZIP 전체 브랜치 백업 시: Git이 PATH에 있어야 함

빠른 실행 (권장)

# Windows — 더블클릭 또는 터미널
run.bat

# macOS / Linux
./run.sh

첫 실행 시 .venv 생성과 의존성 설치를 자동으로 합니다.
의존성만 다시 설치: run.bat --update / ./run.sh --update

수동 설치·실행

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

pip install -r requirements.txt
# 또는: pip install -e ".[dev]"

python -m repomanager

선택적으로 .env에 토큰을 둘 수 있습니다 (copy / cp .env.example .env).

GITHUB_TOKEN=ghp_your_token_here
GITHUB_OAUTH_CLIENT_ID=Iv1...   # 웹 로그인용(선택)

GitHub 인증

우선순위: 환경변수(.env) → 설정에 저장한 토큰 → GitHub CLI(gh).

1) 설정 메뉴 (권장)

파일 → 설정 (Ctrl+,)

• Personal Access Token 붙여넣기 후 저장
• 또는 GitHub CLI에서 가져오기
• 또는 GitHub 웹으로 로그인 (OAuth Device Flow)

토큰은 Windows Credential Manager / macOS Keychain / Linux Secret Service에 keyring으로 저장됩니다.
keyring을 쓸 수 없으면 Qt QSettings로 대체됩니다.

2) Classic PAT 권한

Fine-grained PAT는 대상 저장소에 Administration: Read and write(삭제·이름 변경 등)가 필요할 수 있습니다.

3) GitHub CLI로 삭제 권한

gh auth refresh -h github.com -s delete_repo
``