pyvegh 0.7.0__cp310-abi3-win_amd64.whl

pyvegh-0.7.0.dist-info/METADATA

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: pyvegh
+Version: 0.7.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**.
+
+It delivers the raw performance of Rust (Zstd multithreaded compression, Tar archiving, Blake3 hashing) wrapped in a modern, flexible Python interface.
+
+> "Tight packing, swift unpacking, no nonsense."
+
+## Features
+
+* **Blazing Fast:** Core logic is implemented in Rust using PyO3, utilizing **Zstd Multithreading** and the next-gen **Blake3** hashing algorithm.
+* **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.
+* **Smart Filtering:** Automatically respects `.veghignore` and `.gitignore` rules.
+* **Vegh Hooks:** Allow you to custom automation shell command while snapping.
+* **Deep Inspection:** Peek into files (`cat`) and compare snapshots (`diff`) without unpacking.
+
+## Installation
+
+Install directly from PyPI:
+```bash
+pip install pyvegh
+```
+
+Or build from source (requires Rust):
+
+```bash
+maturin develop --release
+```
+
+## CLI Usage
+
+PyVegh provides a powerful command-line interface via the `vegh` (or `pyvegh`) command.
+
+### 1\. Configuration 
+
+Set up your default server URL and Auth Token so you don't have to type them every time.
+
+```bash
+vegh config
+# Or one-liner:
+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
+
+Pack a directory into a highly compressed snapshot.
+
+```bash
+# Basic snapshot
+vegh snap ./my-project --output backup.vegh
+
+# Dry-Run (Simulation) - Check for large/sensitive files
+vegh snap ./my-project --dry-run
+```
+
+### 3\. LOC
+
+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\. 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.
+
+```bash
+vegh check backup.vegh
+```
+
+### 7\. Restore
+
+Restore the snapshot to a target directory. Supports **Partial Restore**.
+
+```bash
+# Full restore
+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
+```
+
+### 8\. Cat & Diff
+
+Inspect content without extracting.
+
+```bash
+# 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
+```
+
+### 9\. Send
+
+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
+```
+
+### 10\. Doctor
+
+Check your environment and installation health.
+
+```bash
+vegh doctor
+```
+
+### 11\. Hooks example
+
+Create a `.veghhooks.json` in your workspace.
+
+```json
+{
+  "hooks": {
+    "pre": [
+      "echo '🚀 Pre-snap hook started...'",
+      "echo 'Preparing to backup...'",
+      "echo 'Backing up database...'",
+      "echo 'Backup completed.'"
+    ],
+    "post": [
+      "echo '🎉 Snapshot completed!'",
+      "echo 'Cleaning up...'"
+    ]
+  }
+}
+```
+
+## Library Usage
+
+You can also use PyVegh as a library in your own Python scripts:
+
+```python
+import json
+from vegh import create_snap, restore_snap, check_integrity, get_metadata
+
+# 1. Create a snapshot
+# Returns the number of files compressed
+count = create_snap("src_folder", "backup.vegh", comment="Automated backup")
+print(f"Compressed {count} files.")
+
+# 2. Check integrity (Now uses Blake3)
+checksum = check_integrity("backup.vegh")
+print(f"Blake3 Hash: {checksum}")
+
+# 3. Read Metadata (Fast, no unpacking)
+raw_meta = get_metadata("backup.vegh")
+meta = json.loads(raw_meta)
+print(f"Snapshot created by: {meta.get('author')}")
+
+# 4. Restore
+restore_snap("backup.vegh", "dest_folder")
+```
+
+## License
+
+This project is under the **MIT License**.
+

pyvegh-0.7.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+pyvegh-0.7.0.dist-info\METADATA,sha256=_UmEloaYqGaUXQbLqeFlUbUsfKX5l5GspR1oz2wj4vE,6715
+pyvegh-0.7.0.dist-info\WHEEL,sha256=ZMDDxh9OPoaLQ4P2dJmgI1XsENYSzjzq8fErKKVw5iE,96
+pyvegh-0.7.0.dist-info\entry_points.txt,sha256=WNhHyba1tppGRLA2R4dOILWdifp2vTP6dtvyOzPjtzk,56
+pyvegh-0.7.0.dist-info\licenses\LICENSE,sha256=5d9Msgs0I6oS2jCQpP8Y4eioop_lWZpqiDmsEINaA70,1087
+vegh\__init__.py,sha256=3aVDu-X8vk9GGe0JyRViYHU0tBDKkki2WLAmCtQacds,459
+vegh\_core.pyd,sha256=Tkk7-qg-apd6qFlESzevl8_8N6bkfo7ADHV13o3U_KA,4230656
+vegh\analytics.py,sha256=Po4rGncIqiKPe7SODW8Uodd5jLpsHS_4T3PlwAKi_Us,19587
+vegh\cli.py,sha256=_ZyEhLY_7f8VgkMDxu1sKSQtadH4zW7giO2-7uHEZCo,55907
+pyvegh-0.7.0.dist-info\RECORD,,

pyvegh-0.7.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.11.5)
+Root-Is-Purelib: false
+Tag: cp310-abi3-win_amd64

pyvegh-0.7.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pyvegh=vegh.cli:app
+vegh=vegh.cli:app

pyvegh-0.7.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CodeTease
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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.7.0"
+__all__ = [
+    "create_snap",
+    "dry_run_snap",
+    "restore_snap",
+    "check_integrity",
+    "get_metadata",
+    "count_locs",
+    "scan_locs_dir",
+    "__version__",
+]