# 저장소 복제
git clone https://github.com/krishnakanthb13/password_generator.git
cd password_generator

# 의존성 설치 (colorama, cryptography, pyperclip 등)
pip install -r requirements.txt

# 20자 랜덤 비밀번호 생성
python main.py random -l 20

# 4단어 패스프레이즈 생성
python main.py phrase -w 4 --capitalize

# 리트스피크 패스프레이즈 생성
python main.py leet -w 3 -s _

# 엔트로피 분석과 함께 생성
python main.py --show-entropy random -l 16

# 대화형 모드 실행
python main.py --interactive

# 사전 설정 프로필 사용 (Strong)
python main.py --preset strong --show-entropy

# 기본 16자 비밀번호
python main.py random

# 24자, 문자만
python main.py random -l 24 --no-symbols --no-digits

# 읽기 쉬운 (0/O, 1/l/I 제외)
python main.py --easy-read random -l 20

# 최소 요구 사항 포함
python main.py random -l 16 --min-upper 2 --min-digits 2 --min-symbols 1

# 균형 모드 (대부분 문자, 적은 기호)
python main.py random -l 24 --balanced

# 표준 4단어 패스프레이즈
python main.py phrase -w 4

# 대문자화 및 밑줄 구분자
python main.py phrase -w 5 -s _ --capitalize

# 교차 대소문자 (높은 엔트로피)
python main.py phrase -w 4 -s . --alternate
# 출력: aPpLe.bAnAnA.cHeRrY.dAtE

# 모두 대문자 및 하이픈 구분자 (높은 엔트로피)
python main.py phrase -w 4 -s . --uppercase
# 출력: APPLE-BANANA-CHERRY-DATE

# 리트스피크 버전 (스마트 50% 치환)
python main.py leet -w 4 -s -
# 출력: 4PPl3.8@N@[email protected]

# 테마 패스프레이즈 ('animals.txt' 사용)
python main.py phrase -w 4 --capitalize --wordlist data/wordlists/animals.txt
# 출력: Tiger-Falcon-Shark-Wolf

# 5개 세그먼트, 각 5자
python main.py license --segments 5 --segment-length 5

# 4개 세그먼트, 각 8자
python main.py license --segments 4 --segment-length 8

# HS256용 JWT 시크릿
python main.py jwt --bits 256

# Base64 API 키
python main.py base64 -b 32 --url-safe

# UUID 토큰 (v4 랜덤)
python main.py uuid --upper

# UUID v7 (시간 기반, 정렬 가능)
python main.py uuid --ver 7
# 또는 단축 명령어
python main.py uuid --v7

# 짧은 UUID (Base58 인코딩, ~22자)
python main.py uuid --short

# 단축 명령어로 v7 UUID 생성
python main.py u --v7

# 10개의 짧은 v4 UUID 생성
python main.py uuid --v4 --short -n 10

# NATO 음성 변환
python main.py phonetic --text "PassForge"
# 출력: Papa-Alpha-Sierra-Sierra-Foxtrot-Oscar-Romeo-Golf-Echo

# 기존 비밀번호 분석
python main.py analyze "p@ssword123"

# 기록에 로그
python main.py --log random -l 16

# 마지막 10개 기록 항목 보기 (기본)
python main.py history

# 모든 기록 항목 보기 (실시간 복호화)
python main.py history --all

# 편집된 비밀번호로 기록 보기
python main.py history --redact

# 기록 내보내기 (기본 편집됨)
python main.py history --export backup.json

# 기록 내보내기 (평문 - 주의 필요)
python main.py history --export secrets.csv --no-redact

# 스크립트용 JSON 출력
python main.py --json jwt --bits 256

password_generator/
├── main.py                 # 진입점
├── requirements.txt        # 의존성
├── src/
│   ├── __init__.py
│   ├── cli.py                # 인수 파서 및 배너
│   ├── command_handler.py    # 명령어 라우팅
│   ├── interactive.py        # 대화형 메뉴
│   ├── generators/           # 모든 비밀번호 생성기
│   │   ├── base.py           # 추상 기본 클래스
│   │   ├── random_password.py # 랜덤 비밀번호 생성기
│   │   ├── passphrase.py     # 패스프레이즈 생성기
│   │   ├── leetspeak.py      # 리트스피크 생성기
│   │   ├── pin.py            # PIN 생성기
│   │   ├── pronounceable.py  # 발음 가능 비밀번호 생성기
│   │   ├── uuid_token.py     # UUID 토큰 생성기
│   │   ├── base64_secret.py  # Base64 시크릿 생성기
│   │   ├── jwt_secret.py     # JWT 시크릿 생성기
│   │   ├── wifi_key.py       # WiFi 키 생성기
│   │   ├── license_key.py    # 라이선스 키 생성기
│   │   ├── recovery_codes.py # 복구 코드 생성기
│   │   ├── otp.py            # OTP 생성기
│   │   ├── pattern.py        # 패턴 생성기
│   │   └── phonetic.py       # NATO 음성 생성기
│   ├── security/
│   │   ├── entropy.py        # 엔트로피 계산기
│   │   ├── strength_checker.py # zxcvbn 통합
│   │   └── vault.py          # 안전한 기록 암호화
│   ├── output/
│   │   ├── formatter.py      # 색상 코드 출력
│   │   ├── logger.py         # 기록 로깅
│   │   ├── clipboard.py      # 안전한 클립보드 처리
│   │   └── qrcode_gen.py     # OTP용 QR 코드 생성
│   ├── config/
│   │   ├── loader.py         # YAML/JSON 설정 로더
│   │   └── presets.py        # 사전 정의된 보안 프로필
├── data/
│   └── wordlists/            # 테마 단어 목록 (animals.txt, biology.txt 등)
└── tests/

# 모든 테스트 실행
python -m pytest tests/ -v

# 특정 테스트 클래스 실행
python -m pytest tests/test_generators.py::TestRandomPasswordGenerator -v

# 커버리지와 함께 실행
python -m pytest tests/ --cov=src --cov-report=html

{
  "random": {
    "length": 20,
    "easy_read": true
  },
  "passphrase": {
    "words": 5,
    "capitalize": true
  },
  "output": {
    "show_entropy": true
  }
}

# 빌드 스크립트 사용
passforge_build.bat

# 또는 수동
pip install pyinstaller
pyinstaller --onefile --name passforge --console main.py

# 빌드 스크립트 사용
chmod +x passforge_build.sh
./passforge_build.sh

# 또는 수동
pip install pyinstaller
pyinstaller --onefile --name passforge --console main.py