Metadata-Version: 2.4
Name: cipher-shield
Version: 2.1.0
Summary: Advanced file encryptor/decryptor with AES-256-GCM and CUTC text envelopes
Author: TLVM
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: cryptography>=42.0.0

# Cipher Shield

`cipher-shield` là bộ mã hóa/giải mã file dùng:

- AES-256-GCM
- PBKDF2-HMAC-SHA256
- ZLIB
- CUTC text envelope (Base64)

## Cài như một gói pip

```bash
pip install .
```

Cài ở chế độ dev:

```bash
pip install -e .
```

Build wheel:

```bash
python -m pip install build
python -m build
```

## Dùng CLI

Mã hóa:

```bash
cipher-shield input.bin
cipher-shield input.bin output.cutc --cutc
cipher-shield input.bin output.enc --password "matkhau"
```

Giải mã:

```bash
cipher-shield -dc input.cutc
cipher-shield -dc input.enc output.bin
```

## Tuỳ chọn chính

- `-h`, `--help`, `-help`: trợ giúp
- `-dc`: giải mã
- `-en`: mã hóa
- `--cutc`: xuất ra CUTC text
- `--cutc-style`: chọn kiểu banner
- `--cre TLVM`: hiển thị credit trong banner / metadata
- `--deep`: bật chế độ kiểm tra bảo mật chặt hơn
- `-p`, `--password`: truyền mật khẩu
- `-k`, `--key-file`: đọc mật khẩu từ file text
- `-f`: ghi đè file đầu ra
- `-rm`: xoá file gốc sau khi xử lý
- `--dry-run`: chạy thử, không ghi file

## Ghi chú

- Mặc định chỉ tạo file đầu ra nếu thao tác hợp lệ.
- Header được ràng buộc bằng AAD của AES-GCM để phát hiện sửa đổi.
- Dữ liệu CUTC được bóc tách theo khung Base64 an toàn.
