Metadata-Version: 2.4
Name: cppy-obf
Version: 0.1.0
Summary: Source code encryption, obfuscation, and hardware USB dongle key tool
Home-page: https://github.com/lunarcompany/cp_py
Author: Lunar Company
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: cryptography>=41.0.0
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# cppy-obf

> **차세대 엔터프라이즈 소스코드 암호화, 실행 가능한 자체 난독화 & 실물 USB 하드웨어 동글 보안 솔루션**

`cppy-obf`는 Python 소스코드를 군사급 AES-256 대칭키 암호화로 보호하며, 코드가 암호화된 채로도 별도 키 없이 즉시 실행 가능한 **자기 실행 난독화(Self-executing Obfuscation)** 기술 및 **실물 USB 하드웨어 보안 동글(Dongle)** 연동을 제공하는 최첨단 보안 패키지입니다.

---

## 🌐 공식 웹사이트 및 라이브 데모

- **공식 소개 & 실시간 소스코드 검증 사이트**: [https://cppy-obf.lunarcompany.xyz](https://cppy-obf.lunarcompany.xyz)
  - 실제로 백엔드 소스코드가 난독화/암호화된 채로 구동되는 라이브 검증 데모 및 인터랙티브 Before & After 비교 확인 가능!

---

## 🚀 빠른 시작 및 설치

```bash
pip install cppy-obf
```

설치 후 `cppy` 명령어를 전역에서 바로 사용할 수 있습니다:

```bash
cppy --help
```

---

## ✨ 핵심 기능

1. **실행 가능한 난독화 (`cppy --obf <파일>`)**:
   - Python, JS, HTML 소스코드를 압축/암호화하여 원본 비즈니스 로직을 완벽 은닉.
   - 키 입력 없이 **프로그램 자체는 완벽하게 독립 실행(Self-Executing)**.
   - 원본 복구를 위한 고유 `.obfde` 키가 안전하게 분리 생성됩니다.
2. **실물 USB 하드웨어 동글 결합 (`cppy --obf --usb <파일>`)**:
   - 연결된 USB를 `CPDE_KEY` 보안 볼륨으로 전환.
   - 실물 드라이브의 **물리적 하드웨어 고유 시리얼(Device Serial)**과 암호키를 강제 결합.
   - 복사된 가짜 키로는 복호화 불가능하며 실물 USB가 꽂혀 있어야만 복호화 허용!
3. **AES-256 군사급 양방향 암호화 (`cppy en <파일>`, `cppy de <파일>`)**:
   - 실행을 차단하고 코드를 완전히 봉인하는 엔터프라이즈 대칭키 보호.
4. **안티 템퍼링 (SHA-256 Anti-Tampering)**:
   - 본문 무결성 해시 검증으로 1바이트라도 위변조 시 실행 차단.
5. **비밀번호 마스킹 & 3회 시도 제한 (Brute-Force 방어)**:
   - 터미널 키 입력 시 화면 노출을 차단하며 3회 연속 실패 시 프로세스 강제 종료.
6. **디렉터리 일괄 처리 (`cppy en-all`, `cppy de-all`)**:
   - 대규모 프로젝트 전체를 하위 디렉터리까지 재귀적으로 일괄 암호화/복호화.
7. **글로벌 8개국 다국어 지원**:
   - `cppy 한국`, `cppy usa`, `cppy japan`, `cppy china` 등 국가명 입력으로 CLI 언어 즉시 전환.

---

## 📖 CLI 사용 가이드

### 1. 실행 가능한 자체 난독화 (추천)
```bash
# 파일 자체는 정상 실행되지만 코드는 암호화/난독화로 봉인
cppy --obf main.py

# 실물 USB 하드웨어 보안키와 결합하여 난독화
cppy --obf --usb main.py

# 원본 복원
cppy --de-obf main.py
```

### 2. 표준 암호화 및 복호화
```bash
# 단일 파일 암호화 (.cpde 키 생성)
cppy en app.py

# 단일 파일 복호화
cppy de app.py

# 폴더 전체 재귀 일괄 암호화
cppy en-all ./src

# 폴더 전체 재귀 일괄 복호화
cppy de-all ./src
```

### 3. 상태 진단 및 설정
```bash
# 파일/폴더 암호화 보안 상태 진단
cppy status ./src

# 키 파일 내용(Hex/Base64) 확인
cppy key app.py.cpde

# 언어 전환 (예: 영어, 일본어)
cppy usa
cppy japan
```

---

## 🔗 연계 에코시스템

- **🌐 공식 소개 사이트**: [https://cppy-obf.lunarcompany.xyz](https://cppy-obf.lunarcompany.xyz)
- **🐍 Python PyPI**: [https://pypi.org/project/cppy-obf/](https://pypi.org/project/cppy-obf/)
- **📦 Node.js NPM**: [https://www.npmjs.com/package/cppy-obf-js](https://www.npmjs.com/package/cppy-obf-js)

---

## 📄 라이선스 (License)

MIT License. Free for Commercial and Open-Source usage.
