dhruv 1.0.0

A Python package

dhruv 🐍

A foundational Python package for AI-assisted development, designed for simplicity and extensibility.

About

Dhruv is more than just a template; it's a "batteries-included" foundation for building robust Python tools. It comes pre-packaged with an AI Developer Handbook—a set of system prompts used to standardize documentation, roadmapping, testing, and refactoring—along with ready-to-use configuration templates.

---

🚀 Quick Start

Prerequisites

• Python 3.8 or higher

Installation

For a straightforward installation, run the following command in the root directory:

pip install .

For developers who wish to modify the source code, install it in editable mode:

pip install -e .

Usage Example

Verify the installation with the built-in CLI:

dhruv hello
# Expected Output: "Hello from Dhruv!"

---

✨ Key Features

• AI Developer Handbook: Includes a comprehensive set of system prompts (src/dhruv/prompts/) to guide AI agents through Documentation, Roadmapping, Testing, and Refactoring.
• Batteries-Included Templates: Pre-configured templates for pytest and project settings (src/dhruv/templates/).
• Modern CLI Foundation: Built with Typer and Rich for a robust and beautiful command-line interface.
• Clean Architecture: Standardized src layout ready for expansion.

---

⚙️ Configuration & Advanced Usage

CLI Reference

Command	Description
dhruv hello	Prints a hello message to verify the installation.

Accessing Resources

The package includes valuable resources for development:

• Prompts: Located in src/dhruv/prompts/. Use these to guide your AI coding assistant.
• Templates: Located in src/dhruv/templates/. Copy these to your project root for instant configuration.

---

🏗️ Architecture

The project follows a modular src layout:

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

---

🗺️ Roadmap

• Initial Release
• Add more utility functions
• Implement a command-line interface
• Expose prompts and templates via CLI (e.g., dhruv init)

---

🤝 Contributing & License

Contributions are welcome! Please feel free to submit a pull request.

This project is licensed under the MIT License. See the pyproject.toml file for details.