pyvegh 0.4.0__tar.gz → 0.6.0__tar.gz

{pyvegh-0.4.0 → pyvegh-0.6.0}/.gitignore

@@ -1,6 +1,5 @@
 # Rust
 /target
-Cargo.lock
 **/*.rs.bk
 
 # Python
@@ -44,4 +43,5 @@ venv.bak/
 # Internal
 *.vegh
 .veghcache/
-.veghhooks.json
+.veghhooks.json
+*.xml

{pyvegh-0.4.0 → pyvegh-0.6.0}/Cargo.lock

@@ -83,9 +83,9 @@ checksum = "5dd9dc738b7a8311c7ade152424974d8115f2cdad61e8dab8dac9f2362298510"
 
 [[package]]
 name = "cc"
-version = "1.2.50"
+version = "1.2.51"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9f50d563227a1c37cc0a263f64eca3334388c01c5e4c4861a9def205c614383c"
+checksum = "7a0aeaff4ff1a90589618835a598e545176939b97874f7abc7851caa0618f203"
 dependencies = [
  "find-msvc-tools",
  "jobserver",
@@ -173,9 +173,9 @@ dependencies = [
 
 [[package]]
 name = "find-msvc-tools"
-version = "0.1.5"
+version = "0.1.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3a3076410a55c90011c298b04d0cfa770b00fa04e1e3c97d3f6c9de105a03844"
+checksum = "645cbb3a84e60b7531617d5ae4e57f7e27308f6445f5abf653209ea76dec8dff"
 
 [[package]]
 name = "getrandom"
@@ -265,9 +265,9 @@ dependencies = [
 
 [[package]]
 name = "itoa"
-version = "1.0.15"
+version = "1.0.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4a5f13b858c8d314ee3e8f639011f7ccefe71f97f96e50151fb991f267928e2c"
+checksum = "92ecc6618181def0457392ccd0ee51198e065e016d1d527a7ac1b6dc7c1f09d2"
 
 [[package]]
 name = "jobserver"
@@ -291,15 +291,15 @@ dependencies = [
 
 [[package]]
 name = "libc"
-version = "0.2.178"
+version = "0.2.179"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "37c93d8daa9d8a012fd8ab92f088405fb202ea0b6ab73ee2482ae66af4f42091"
+checksum = "c5a2d376baa530d1238d133232d15e239abad80d05838b4b59354e5268af431f"
 
 [[package]]
 name = "libredox"
-version = "0.1.11"
+version = "0.1.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "df15f6eac291ed1cf25865b1ee60399f57e7c227e7f51bdbd4c5270396a9ed50"
+checksum = "3d0b95e02c851351f877147b7deea7b1afb1df71b63aa5f8270716e0c5720616"
 dependencies = [
  "bitflags",
  "libc",
@@ -365,15 +365,15 @@ checksum = "7edddbd0b52d732b21ad9a5fab5c704c14cd949e5e9a1ec5929a24fded1b904c"
 
 [[package]]
 name = "portable-atomic"
-version = "1.12.0"
+version = "1.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f59e70c4aef1e55797c2e8fd94a4f2a973fc972cfde0e0b05f683667b0cd39dd"
+checksum = "f89776e4d69bb58bc6993e99ffa1d11f228b839984854c7daeb5d37f87cbe950"
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.103"
+version = "1.0.105"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5ee95bc4ef87b8d5ba32e8b7714ccc834865276eab0aed5c9958d00ec45f49e8"
+checksum = "535d180e0ecab6268a3e718bb9fd44db66bbbc256257165fc699dadf70d16fe7"
 dependencies = [
  "unicode-ident",
 ]
@@ -441,7 +441,7 @@ dependencies = [
 
 [[package]]
 name = "pyvegh"
-version = "0.4.0"
+version = "0.6.0"
 dependencies = [
  "anyhow",
  "blake3",
@@ -458,9 +458,9 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.42"
+version = "1.0.43"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a338cc41d27e6cc6dce6cefc13a0729dfbb81c262b1f519331575dd80ef3067f"
+checksum = "dc74d9a594b72ae6656596548f56f667211f8a97b3d4c3d467150794690dc40a"
 dependencies = [
  "proc-macro2",
 ]
@@ -483,9 +483,9 @@ dependencies = [
 
 [[package]]
 name = "redox_syscall"
-version = "0.6.0"
+version = "0.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ec96166dafa0886eb81fe1c0a388bece180fbef2135f97c1e2cf8302e74b43b5"
+checksum = "49f3fe0889e69e2ae9e41f4d6c4c0181701d00e4697b356fb1f74173a5e0ee27"
 dependencies = [
  "bitflags",
 ]
@@ -509,9 +509,9 @@ checksum = "7a2d987857b319362043e95f5353c0535c1f58eec5336fdfcf626430af7def58"
 
 [[package]]
 name = "rustix"
-version = "1.1.2"
+version = "1.1.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cd15f8a2c5551a84d56efdc1cd049089e409ac19a3072d5037a17fd70719ff3e"
+checksum = "146c9e247ccc180c1f61615433868c99f3de3ae256a30a43b49f67c2d9171f34"
 dependencies = [
  "bitflags",
  "errno",
@@ -526,12 +526,6 @@ version = "1.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
 
-[[package]]
-name = "ryu"
-version = "1.0.21"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "62049b2877bf12821e8f9ad256ee38fdc31db7387ec2d3b3f403024de2034aea"
-
 [[package]]
 name = "same-file"
 version = "1.0.6"
@@ -573,15 +567,15 @@ dependencies = [
 
 [[package]]
 name = "serde_json"
-version = "1.0.145"
+version = "1.0.149"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "402a6f66d8c709116cf22f558eab210f5a50187f702eb4d7e5ef38d9a7f1c79c"
+checksum = "83fc039473c5595ace860d8c4fafa220ff474b3fc6bfdb4293327f1a37e94d86"
 dependencies = [
  "itoa",
  "memchr",
- "ryu",
  "serde",
  "serde_core",
+ "zmij",
 ]
 
 [[package]]
@@ -592,9 +586,9 @@ checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
 
 [[package]]
 name = "syn"
-version = "2.0.111"
+version = "2.0.114"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "390cc9a294ab71bdb1aa2e99d13be9c753cd2d7bd6560c77118597410c4d2e87"
+checksum = "d4d107df263a3013ef9b1879b0df87d706ff80f65a86ea879bd9c31f9b307c2a"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -861,6 +855,12 @@ dependencies = [
  "rustix",
 ]
 
+[[package]]
+name = "zmij"
+version = "1.0.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2fc5a66a20078bf1251bde995aa2fdcc4b800c70b5d92dd2c62abc5c60f679f8"
+
 [[package]]
 name = "zstd"
 version = "0.13.3"

{pyvegh-0.4.0 → pyvegh-0.6.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "pyvegh"
-version = "0.4.0"
+version = "0.6.0"
 edition = "2024"
 authors = ["CodeTease"]
 readme = "README.md"
@@ -14,7 +14,6 @@ pyo3 = { version = "0.27.1", features = ["extension-module", "abi3-py38"] }
 
 # Core Logic Deps
 tar = "0.4"
-# Kích hoạt zstdmt (multithread) cho zstd
 zstd = { version = "0.13", features = ["zstdmt"] } 
 ignore = "0.4"
 

pyvegh-0.4.0/README.md → pyvegh-0.6.0/PKG-INFO

@@ -1,3 +1,31 @@
+Metadata-Version: 2.4
+Name: pyvegh
+Version: 0.6.0
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Rust
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Classifier: Intended Audience :: Developers
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Dist: typer>=0.20.0
+Requires-Dist: rich>=14.2.0
+Requires-Dist: shellingham>=1.5.4
+Requires-Dist: requests>=2.32.5
+License-File: LICENSE
+Summary: Python bindings for Vegh - The Snapshot Tool.
+Keywords: snapshot,backup,rust,binding,loc,analytics
+Author: CodeTease
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
 # 🥬 PyVegh
 
 **PyVegh** is the official Python binding for the Vegh snapshot engine, developed by **CodeTease**.
@@ -9,7 +37,8 @@ It delivers the raw performance of Rust (Zstd multithreaded compression, Tar arc
 ## Features
 
 * **Blazing Fast:** Core logic is implemented in Rust using PyO3, utilizing **Zstd Multithreading** and the next-gen **Blake3** hashing algorithm.
-* **Analytics Dashboard:** Instantly visualize your project's Lines of Code (LOC) with a beautiful terminal dashboard—no extraction required.
+* **AI-Ready Context:** Generate clean, token-optimized XML prompts for ChatGPT/Claude in milliseconds.
+* **Analytics Dashboard:** Instantly visualize your project's Lines of Code (LOC) with a beautiful terminal dashboard, no extraction required.
 * **Dry-Run Mode:** Simulate snapshot creation to check file sizes and detect sensitive data risks before packing.
 * **Integrity v2:** Verify data integrity at lightning speed with **Blake3** and inspect metadata (author, timestamp, tool version) without unpacking.
 * **Smart Upload:** Built-in `send` command supporting concurrent **Chunked Uploads** for large files.
@@ -22,7 +51,7 @@ It delivers the raw performance of Rust (Zstd multithreaded compression, Tar arc
 Install directly from PyPI:
 ```bash
 pip install pyvegh
-````
+```
 
 Or build from source (requires Rust):
 
@@ -41,7 +70,13 @@ Set up your default server URL and Auth Token so you don't have to type them eve
 ```bash
 vegh config
 # Or one-liner:
-vegh config --url https://api.teaserverse.online/test --auth YOUR_TOKEN
+vegh config send --url https://api.teaserverse.online/test --auth YOUR_TOKEN
+
+# List current configuration
+vegh config list
+
+# Reset configuration to defaults
+vegh config reset
 ```
 
 ### 2\. Create Snapshot
@@ -56,15 +91,49 @@ vegh snap ./my-project --output backup.vegh
 vegh snap ./my-project --dry-run
 ```
 
-### 3\. Analytics 
+### 3\. LOC
 
-View the CodeTease Analytics Dashboard to break down your project by language and lines of code.
+View the Analytics Dashboard to break down your project by language and lines of code.
 
 ```bash
 vegh loc backup.vegh
+
+# Show Source Lines of Code (SLOC) instead of total LOC
+# Excludes blank lines and comments
+vegh loc backup.vegh --sloc
 ```
 
-### 4\. Inspect & Verify
+### 4\. Prompt
+
+Generate a structured XML context of your codebase to feed directly into ChatGPT, Claude, or Gemini.
+```bash
+# Generate XML context to stdout
+vegh prompt .
+
+# Clean Mode (Recommended):
+# Removes lock files (package-lock.json, Cargo.lock), logs, secrets and other unnecessary files.
+vegh prompt . --clean
+
+# Copy to Clipboard (One-shot):
+vegh prompt . --clean --copy
+
+# Save to file
+vegh prompt . --clean --output context.xml
+```
+
+### 5\. Prune
+
+Clean up old snapshots to free disk space.
+
+```bash
+# Keep only the 5 most recent snapshots in the current directory
+vegh prune --keep 5
+
+# Force clean without confirmation (useful for CI/CD)
+vegh prune --keep 1 --force
+```
+
+### 6\. Check
 
 Check file integrity (Blake3) and view embedded metadata.
 
@@ -72,7 +141,7 @@ Check file integrity (Blake3) and view embedded metadata.
 vegh check backup.vegh
 ```
 
-### 5\. Restore
+### 7\. Restore
 
 Restore the snapshot to a target directory. Supports **Partial Restore**.
 
@@ -82,9 +151,12 @@ vegh restore backup.vegh ./restored-folder
 
 # Partial restore (Specific files or folders)
 vegh restore backup.vegh ./restored-folder --path src/main.rs --path config/
+
+# Flatten directory structure (Extract files directly to output dir)
+vegh restore backup.vegh ./restored-folder --flatten
 ```
 
-### 6\. Peek & Diff
+### 8\. Cat & Diff
 
 Inspect content without extracting.
 
@@ -92,20 +164,23 @@ Inspect content without extracting.
 # View a file's content inside the snapshot
 vegh cat backup.vegh src/main.rs
 
+# View raw content (Useful for piping binary files)
+vegh cat backup.vegh image.png --raw > extracted_image.png
+
 # Compare snapshot with a directory
 vegh diff backup.vegh ./current-project
 ```
 
-### 7\. Send
+### 9\. Send
 
-Send the snapshot to a remote server. PyVegh now supports **Chunked Uploads** for reliability.
+Send the snapshot to a remote server. Supports **Chunked Uploads** for reliability.
 
 ```bash
 # Auto-detects if chunking is needed, or force it:
 vegh send backup.vegh --force-chunk
 ```
 
-### 8\. Doctor
+### 10\. Doctor
 
 Check your environment and installation health.
 
@@ -113,7 +188,7 @@ Check your environment and installation health.
 vegh doctor
 ```
 
-### 9\. Hooks example
+### 11\. Hooks example
 
 Create a `.veghhooks.json` in your workspace.
 
@@ -163,3 +238,4 @@ restore_snap("backup.vegh", "dest_folder")
 ## License
 
 This project is under the **MIT License**.
+

pyvegh-0.4.0/PKG-INFO → pyvegh-0.6.0/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.4
-Name: pyvegh
-Version: 0.4.0
-Requires-Dist: typer>=0.20.0
-Requires-Dist: rich>=14.2.0
-Requires-Dist: shellingham>=1.5.4
-Requires-Dist: requests>=2.32.5
-License-File: LICENSE
-Summary: Python bindings for Vegh - The Snapshot Tool.
-Keywords: snapshot,backup,rust,binding,loc,analytics
-Author: CodeTease
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-
 # 🥬 PyVegh
 
 **PyVegh** is the official Python binding for the Vegh snapshot engine, developed by **CodeTease**.
@@ -23,7 +9,8 @@ It delivers the raw performance of Rust (Zstd multithreaded compression, Tar arc
 ## Features
 
 * **Blazing Fast:** Core logic is implemented in Rust using PyO3, utilizing **Zstd Multithreading** and the next-gen **Blake3** hashing algorithm.
-* **Analytics Dashboard:** Instantly visualize your project's Lines of Code (LOC) with a beautiful terminal dashboard—no extraction required.
+* **AI-Ready Context:** Generate clean, token-optimized XML prompts for ChatGPT/Claude in milliseconds.
+* **Analytics Dashboard:** Instantly visualize your project's Lines of Code (LOC) with a beautiful terminal dashboard, no extraction required.
 * **Dry-Run Mode:** Simulate snapshot creation to check file sizes and detect sensitive data risks before packing.
 * **Integrity v2:** Verify data integrity at lightning speed with **Blake3** and inspect metadata (author, timestamp, tool version) without unpacking.
 * **Smart Upload:** Built-in `send` command supporting concurrent **Chunked Uploads** for large files.
@@ -36,7 +23,7 @@ It delivers the raw performance of Rust (Zstd multithreaded compression, Tar arc
 Install directly from PyPI:
 ```bash
 pip install pyvegh
-````
+```
 
 Or build from source (requires Rust):
 
@@ -55,7 +42,13 @@ Set up your default server URL and Auth Token so you don't have to type them eve
 ```bash
 vegh config
 # Or one-liner:
-vegh config --url https://api.teaserverse.online/test --auth YOUR_TOKEN
+vegh config send --url https://api.teaserverse.online/test --auth YOUR_TOKEN
+
+# List current configuration
+vegh config list
+
+# Reset configuration to defaults
+vegh config reset
 ```
 
 ### 2\. Create Snapshot
@@ -70,15 +63,49 @@ vegh snap ./my-project --output backup.vegh
 vegh snap ./my-project --dry-run
 ```
 
-### 3\. Analytics 
+### 3\. LOC
 
-View the CodeTease Analytics Dashboard to break down your project by language and lines of code.
+View the Analytics Dashboard to break down your project by language and lines of code.
 
 ```bash
 vegh loc backup.vegh
+
+# Show Source Lines of Code (SLOC) instead of total LOC
+# Excludes blank lines and comments
+vegh loc backup.vegh --sloc
 ```
 
-### 4\. Inspect & Verify
+### 4\. Prompt
+
+Generate a structured XML context of your codebase to feed directly into ChatGPT, Claude, or Gemini.
+```bash
+# Generate XML context to stdout
+vegh prompt .
+
+# Clean Mode (Recommended):
+# Removes lock files (package-lock.json, Cargo.lock), logs, secrets and other unnecessary files.
+vegh prompt . --clean
+
+# Copy to Clipboard (One-shot):
+vegh prompt . --clean --copy
+
+# Save to file
+vegh prompt . --clean --output context.xml
+```
+
+### 5\. Prune
+
+Clean up old snapshots to free disk space.
+
+```bash
+# Keep only the 5 most recent snapshots in the current directory
+vegh prune --keep 5
+
+# Force clean without confirmation (useful for CI/CD)
+vegh prune --keep 1 --force
+```
+
+### 6\. Check
 
 Check file integrity (Blake3) and view embedded metadata.
 
@@ -86,7 +113,7 @@ Check file integrity (Blake3) and view embedded metadata.
 vegh check backup.vegh
 ```
 
-### 5\. Restore
+### 7\. Restore
 
 Restore the snapshot to a target directory. Supports **Partial Restore**.
 
@@ -96,9 +123,12 @@ vegh restore backup.vegh ./restored-folder
 
 # Partial restore (Specific files or folders)
 vegh restore backup.vegh ./restored-folder --path src/main.rs --path config/
+
+# Flatten directory structure (Extract files directly to output dir)
+vegh restore backup.vegh ./restored-folder --flatten
 ```
 
-### 6\. Peek & Diff
+### 8\. Cat & Diff
 
 Inspect content without extracting.
 
@@ -106,20 +136,23 @@ Inspect content without extracting.
 # View a file's content inside the snapshot
 vegh cat backup.vegh src/main.rs
 
+# View raw content (Useful for piping binary files)
+vegh cat backup.vegh image.png --raw > extracted_image.png
+
 # Compare snapshot with a directory
 vegh diff backup.vegh ./current-project
 ```
 
-### 7\. Send
+### 9\. Send
 
-Send the snapshot to a remote server. PyVegh now supports **Chunked Uploads** for reliability.
+Send the snapshot to a remote server. Supports **Chunked Uploads** for reliability.
 
 ```bash
 # Auto-detects if chunking is needed, or force it:
 vegh send backup.vegh --force-chunk
 ```
 
-### 8\. Doctor
+### 10\. Doctor
 
 Check your environment and installation health.
 
@@ -127,7 +160,7 @@ Check your environment and installation health.
 vegh doctor
 ```
 
-### 9\. Hooks example
+### 11\. Hooks example
 
 Create a `.veghhooks.json` in your workspace.
 
@@ -177,4 +210,3 @@ restore_snap("backup.vegh", "dest_folder")
 ## License
 
 This project is under the **MIT License**.
-

pyvegh-0.6.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "pyvegh"
+version = "0.6.0"
+description = "Python bindings for Vegh - The Snapshot Tool."
+authors = [{name = "CodeTease"}]
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["snapshot", "backup", "rust", "binding", "loc", "analytics"]
+classifiers = [
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15", 
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Rust",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Utilities",
+    "Intended Audience :: Developers",
+    "Development Status :: 5 - Production/Stable",
+]
+license = {file = "LICENSE"}
+dependencies = [
+    "typer>=0.20.0",      
+    "rich>=14.2.0",       
+    "shellingham>=1.5.4", 
+    "requests>=2.32.5",   
+]
+
+[project.scripts]
+vegh = "vegh.cli:app"  # CLI entry point
+pyvegh = "vegh.cli:app" # Alternate
+
+[tool.maturin]
+features = ["pyo3/extension-module"]
+python-source = "python"
+module-name = "vegh._core" # Maps Rust binary to vegh._core

pyvegh-0.6.0/python/vegh/__init__.py

@@ -0,0 +1,24 @@
+# PyVegh - The CodeTease Snapshot Tool (Python Binding)
+# Copyright (c) 2025 CodeTease
+
+from ._core import (
+    create_snap,
+    dry_run_snap,
+    restore_snap,
+    check_integrity,
+    get_metadata,
+    count_locs,
+    scan_locs_dir,
+)
+
+__version__ = "0.6.0"
+__all__ = [
+    "create_snap",
+    "dry_run_snap",
+    "restore_snap",
+    "check_integrity",
+    "get_metadata",
+    "count_locs",
+    "scan_locs_dir",
+    "__version__",
+]