✨ 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.

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.
• 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.