dhruv 🐍

A foundational Python package for AI-assisted development, featuring an AI Developer Handbook and batteries-included templates.

⚡ Quick Start

Prerequisites

• Python 3.8+
• pip

Installation

pip install .

Or for development:

pip install -e .

Run

Verify the installation immediately:

dhruv hello

Demo

Use the core logic in your own scripts:

from dhruv.main import hello

# Access the core functionality directly
print(hello())
# Output: "Hello from Dhruv!"

✨ Features

• 🧠 AI Developer Handbook: A comprehensive set of standardized system prompts (src/dhruv/prompts/) to guide AI agents through Documentation, Roadmapping, Testing, and Refactoring.
• 🚀 Modern CLI Foundation: Built with Typer and Rich for a robust, beautiful, and self-documenting command-line interface.
• 📦 Batteries-Included Templates: Pre-configured templates for pytest, project settings, and more, located in src/dhruv/templates/.
• 🏗️ Clean Architecture: Follows a strict src layout with modular design, ensuring scalability and maintainability.
• 🎨 Visual Utilities: Includes banner generation and syntax highlighting themes for a polished user experience.

🛠️ Configuration

CLI Arguments

The dhruv CLI is the primary interface.

Note: No environment variables are currently required for core operation.

🏗️ Architecture

Directory Tree

src/
└── dhruv/
    ├── prompts/    # 📘 AI Developer Handbook & System Prompts
    ├── templates/  # 🛠️ Configuration Templates (pytest, settings)
    ├── utils/      # 🔧 Utility modules (banners, themes)
    ├── cli.py      # 🚀 CLI entry point (Typer)
    └── main.py     # 🧠 Core logic

High-Level Flow

1. Entry Point: dhruv command triggers src/dhruv/cli.py.
2. Routing: typer routes commands (e.g., hello) to their respective functions.
3. Core Logic: Commands invoke logic in src/dhruv/main.py or access resources in prompts/ and templates/.
4. Utilities: src/dhruv/utils/ provides shared functionality like banner rendering and styling.

🐞 Troubleshooting

Debug Mode

If you encounter unexpected behavior, check your Python version and environment details:

python --version
pip show dhruv

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

Dev Setup

1. Clone the repository.
2. Install package in editable mode: pip install -e .
3. Install test dependencies: pip install pytest pytest-cov
4. Run tests: pytest

🗺️ Roadmap

• Initial Release & Core Structure
• CLI Implementation (typer)
• AI Developer Handbook (Prompts)
• Interactive Init: dhruv init to scaffold new projects.
• Prompt Management: CLI commands to list and display prompts.
• Template Injection: Automate copying templates to project root.