Metadata-Version: 2.4
Name: ducvannguyen
Version: 8.0.0
Summary: Professional Python toolkit & CLI system with DucVanNguyen class and terminal tools
Author-email: Duc Van Nguyen <ducvannguyenhtml@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/vanducdev/ducvannguyen
Project-URL: Repository, https://github.com/vanducdev/ducvannguyen
Project-URL: Issues, https://github.com/vanducdev/ducvannguyen/issues
Keywords: ducvannguyen,dvn,python,package,cli,toolkit,utilities
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# ducvannguyen v8.0.0

🚀 **Professional Python Toolkit & CLI System** by **Duc Van Nguyen**.

---

## 🌟 What's New in v8.0.0

- 💻 **7 Integrated CLI Commands**: Run `ducvannguyen`, `dvn`, `ducvannguyen-info`, `ducvannguyen-banner`, `ducvannguyen-sysinfo`, `ducvannguyen-server` directly in CMD / PowerShell!
- 🎨 **ANSI Visual Banners**: Colorful ASCII Art branding right in your terminal.
- ⚡ **Interactive Terminal Shell**: Interactive CLI dashboard with password generators, hashing, and diagnostic tools.
- 🌐 **Built-in Web Server**: Run a live status HTTP server with `ducvannguyen server`.
- 🛡️ **Security & Crypto Module**: Cryptographic hash summary, Base64 encoding/decoding, secure password generator.
- 🖥️ **System Diagnostics**: Real-time OS, CPU, RAM, and network diagnostic reports.

---

## 📦 Installation

```bash
pip install --upgrade ducvannguyen
```

---

## ⚡ Command Line Utilities (CLI)

Once installed, you can use these commands anywhere in your terminal:

| Command | Description |
| :--- | :--- |
| `ducvannguyen` or `dvn` | Launch interactive terminal shell dashboard |
| `ducvannguyen info` | Show package version & system information |
| `ducvannguyen banner` | Display full-color ASCII Art banner |
| `ducvannguyen sysinfo` | Run full hardware & OS diagnostic report |
| `ducvannguyen hash "text"` | Generate MD5, SHA256, Base64 hash for any string |
| `ducvannguyen gen-pass` | Generate cryptographically secure passwords |
| `ducvannguyen server` | Launch local HTTP demo server on port 8080 |

---

## 🐍 Python Usage

### Multiple Import Options

```python
# 1. Main Class
from ducvannguyen import DucVanNguyen
dvn_app = DucVanNguyen()

# 2. Pre-instantiated Shortcuts
import ducvannguyen as dvn
from ducvannguyen import ducvannguyen, dvn, DVN

# 3. Submodules
from ducvannguyen import crypto, system, network, banner
```

### Examples

```python
import ducvannguyen as dvn

# Visual Banner
dvn.print_banner()

# Cryptography & Security
token = dvn.generate_token(32)
password = dvn.generate_secure_password(16)
hashes = dvn.hash_summary("Hello Duc Van Nguyen")

print("Generated Password:", password)
print("SHA256 Hash:", hashes["sha256"])

# System Info
sys_info = dvn.get_system_info()
print("OS:", sys_info["os_name"], sys_info["architecture"])

# Toolkit Core (52+ utilities)
is_valid = dvn.ducvannguyen.is_email("ducvannguyenhtml@gmail.com")
print("Email Valid:", is_valid)
```

---

## 🔗 Links

- **PyPI**: https://pypi.org/project/ducvannguyen/
- **GitHub**: https://github.com/vanducdev/ducvannguyen
- **Issues**: https://github.com/vanducdev/ducvannguyen/issues

---

**Made with ❤️ by Duc Van Nguyen**
