dhruv13x 4.0.0

Dhruv's complete meta tooling suite — installs all utilities in one package.

✨ dhruv13x: The Unified Developer Toolchain

Elevator Pitch: The "Swiss Army Knife" for modern Python engineering—a meta-package that installs and unifies a suite of essential developer utilities under a single, consistent CLI.

📖 About

Why juggle a dozen different tools when you can have a unified workflow? dhruv13x is a "batteries-included" toolkit that bundles high-quality utilities for code hygiene, backups, documentation, and automation. It streamlines your development process by providing a central interface to manage these tasks, while still allowing access to each underlying tool independently.

---

🚀 Quick Start

Prerequisites

• Python 3.11 or higher

Installation

Install the meta-suite with a single command:

pip install dhruv13x

Usage Example

Verify the installation and see the suite of installed tools:

# Check version
dhruv13x version

# List all installed meta tools
dhruv13x tools

Run a cleanup of your project:

dhruv13x purge

---

✨ Key Features

• Unified Ecosystem: Installs 10+ developer utilities (like duplifinder, pypurge, projectclone) in one go.
• God Level: Smart Cleanup: The purge command intelligently removes clutter (__pycache__, .pyc, build artifacts) to keep your workspace pristine.
• Atomic Snapshots: Use clone to create instant, timestamped backups of your entire project state.
• Disaster Recovery: Mistake made? Use restore to revert your project to a previous snapshot immediately.
• Duplicate Detection: Identify copy-pasted code blocks using dedupe (powered by duplifinder).
• Flexible Execution: Acts as a smart wrapper—isolating tool execution in subprocesses for stability while allowing direct argument pass-through.

---

⚙️ Configuration & Advanced Usage

CLI Commands

The dhruv13x CLI maps common tasks to specific underlying tools.

Command	Description	underlying Tool
tools	List all installed meta tools in the suite.	Internal
version	Show the unified suite version.	Internal
purge	Clean project clutter (aggressive mode).	pypurge
clone	Create a timestamped project snapshot.	projectclone
restore	Restore project from a snapshot.	projectrestore
dedupe	Find duplicate code blocks.	duplifinder

Note: The dedupe command supports argument pass-through.

# Pass arguments directly to duplifinder
dhruv13x dedupe --min-lines 5 --exclude tests/

Environment Variables

dhruv13x does not require specific environment variables. However, individual tools (like enterprise-docs or create-dump) may respect their own configuration files or env vars.

---

🏗️ Architecture

Directory Structure

src/
└── dhruv13x/
    ├── __init__.py
    ├── banner.py   # ASCII art and branding
    └── cli.py      # Main Typer application & command routing

Core Logic

The application is built on Typer.

1. Entry Point: cli.py defines the main application and commands.
2. Command Routing: Each dhruv13x command acts as a proxy.
   • Direct Import: Some tools (like projectclone) are imported and run directly.
   • Subprocess: Others (like pypurge, duplifinder) are executed in a shell subprocess to ensure environment isolation and capture output streams.

---

🗺️ Roadmap

• Core: Unified CLI structure & tool installation.
• Maintenance: purge (cleanup) and dedupe (code quality).
• Backup: clone (snapshot) and restore (recovery).
• Refactoring: import_fix wrapper for import-surgeon.
• Scaffolding: init wrapper for pyinitgen.
• Workflow: routine wrapper for routine-workflow.
• Docs: docs wrapper for enterprise-docs.

---

🤝 Contributing

We welcome contributions! Whether it's adding a wrapper for a new tool or improving the existing CLI.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes.
4. Push to the branch.
5. Open a Pull Request.

---

📜 License

This project is licensed under the MIT License.