dooma 0.1.0__tar.gz

dooma-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dooma Contributors
+
+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.

dooma-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: dooma
+Version: 0.1.0
+Summary: A blazing-fast, interactive terminal explorer for 17,000+ company-wise DSA interview questions.
+Author: dooma-dev
+License: MIT
+Project-URL: Homepage, https://github.com/im-anishraj/dooma
+Project-URL: Repository, https://github.com/im-anishraj/dooma.git
+Project-URL: Bug Tracker, https://github.com/im-anishraj/dooma/issues
+Keywords: dsa,interview,leetcode,terminal,cli,algorithms
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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: Topic :: Education
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# Dooma
+
+![Dooma Logo](https://img.shields.io/badge/Dooma-DSA_Forge-blue?style=for-the-badge)
+[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI Build](https://img.shields.io/github/actions/workflow/status/im-anishraj/dooma/ci.yml?branch=main)](https://github.com/im-anishraj/dooma/actions)
+
+**Dooma** is your ultimate, blazing-fast Data Structures and Algorithms (DSA) preparation companion. Built entirely for the terminal, it serves as a lightweight, interactive explorer for over **17,900+ real interview questions** from **660+ top tech companies**.
+
+No more scrolling through clunky websites or losing track of which questions Amazon or Google actually ask. Dooma brings the entire dataset straight into your console with a beautiful, responsive UI.
+
+## 🚀 Features
+
+- **Massive Database**: Access a curated, offline-first dataset of 17,931 question mappings across 662 companies.
+- **Interactive Terminal UI**: Built with `Rich` and `Typer`, Dooma offers a stunning, paginated, and easy-to-navigate interface.
+- **Alphabetical Explorer**: Quickly jump to your target company (e.g., press `G` for Google) and view all associated questions.
+- **Data Rich**: Instantly see Question Titles, Difficulty Ratings (color-coded), Frequency/Acceptance percentages, and direct LeetCode URLs.
+- **Zero Overhead**: No accounts, no internet required to browse the database, no tracking. Just pure preparation.
+
+## 📦 Quickstart
+
+Dooma is incredibly easy to set up and use. 
+
+### Installation
+Clone the repository and install it locally using `pip`:
+```bash
+git clone https://github.com/im-anishraj/dooma.git
+cd dooma
+pip install -e .
+```
+
+### Usage
+Once installed, simply run the tool from anywhere in your terminal:
+```bash
+dooma
+```
+1. You will be greeted by an alphabet menu. Type the first letter of your target company (e.g., `A` for Amazon).
+2. Select your company from the beautifully paginated list.
+3. Browse the questions, take note of the difficulties and frequencies, and click the URLs to practice!
+4. Type `0` at any time to safely step back through the menus.
+
+## 🤝 Contributing
+
+We welcome contributions to make Dooma even better! Whether you want to update the dataset, add new features, or improve the UI, we'd love your help.
+Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started and the pull request process.
+
+Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

dooma-0.1.0/README.md

@@ -0,0 +1,51 @@
+# Dooma
+
+![Dooma Logo](https://img.shields.io/badge/Dooma-DSA_Forge-blue?style=for-the-badge)
+[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI Build](https://img.shields.io/github/actions/workflow/status/im-anishraj/dooma/ci.yml?branch=main)](https://github.com/im-anishraj/dooma/actions)
+
+**Dooma** is your ultimate, blazing-fast Data Structures and Algorithms (DSA) preparation companion. Built entirely for the terminal, it serves as a lightweight, interactive explorer for over **17,900+ real interview questions** from **660+ top tech companies**.
+
+No more scrolling through clunky websites or losing track of which questions Amazon or Google actually ask. Dooma brings the entire dataset straight into your console with a beautiful, responsive UI.
+
+## 🚀 Features
+
+- **Massive Database**: Access a curated, offline-first dataset of 17,931 question mappings across 662 companies.
+- **Interactive Terminal UI**: Built with `Rich` and `Typer`, Dooma offers a stunning, paginated, and easy-to-navigate interface.
+- **Alphabetical Explorer**: Quickly jump to your target company (e.g., press `G` for Google) and view all associated questions.
+- **Data Rich**: Instantly see Question Titles, Difficulty Ratings (color-coded), Frequency/Acceptance percentages, and direct LeetCode URLs.
+- **Zero Overhead**: No accounts, no internet required to browse the database, no tracking. Just pure preparation.
+
+## 📦 Quickstart
+
+Dooma is incredibly easy to set up and use. 
+
+### Installation
+Clone the repository and install it locally using `pip`:
+```bash
+git clone https://github.com/im-anishraj/dooma.git
+cd dooma
+pip install -e .
+```
+
+### Usage
+Once installed, simply run the tool from anywhere in your terminal:
+```bash
+dooma
+```
+1. You will be greeted by an alphabet menu. Type the first letter of your target company (e.g., `A` for Amazon).
+2. Select your company from the beautifully paginated list.
+3. Browse the questions, take note of the difficulties and frequencies, and click the URLs to practice!
+4. Type `0` at any time to safely step back through the menus.
+
+## 🤝 Contributing
+
+We welcome contributions to make Dooma even better! Whether you want to update the dataset, add new features, or improve the UI, we'd love your help.
+Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started and the pull request process.
+
+Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

dooma-0.1.0/dooma/__init__.py

@@ -0,0 +1,5 @@
+"""
+Dooma: A professional, open-source Python library and CLI for DSA practice.
+"""
+
+__version__ = "0.1.0"

dooma-0.1.0/dooma/cli/__init__.py

@@ -0,0 +1,3 @@
+"""
+Typer CLI application for Dooma.
+"""

dooma-0.1.0/dooma/cli/main.py

@@ -0,0 +1,182 @@
+import json
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.table import Table
+from rich.prompt import Prompt
+from rich.panel import Panel
+from rich.columns import Columns
+
+app = typer.Typer(add_completion=False)
+console = Console()
+
+def load_data():
+    dataset_path = Path(__file__).parent.parent / "dataset" / "companies.json"
+    if not dataset_path.exists():
+        console.print(f"[red]Dataset not found at {dataset_path}![/red]")
+        raise typer.Exit(1)
+    with open(dataset_path, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+@app.callback(invoke_without_command=True)
+def interactive_loop(ctx: typer.Context):
+    if ctx.invoked_subcommand is not None:
+        return
+    
+    data = load_data()
+    companies = sorted(list(data.keys()))
+    
+    # Group companies by first letter
+    groups = {}
+    for company in companies:
+        first_char = company[0].upper()
+        if not first_char.isalpha():
+            first_char = '#'
+            
+        if first_char not in groups:
+            groups[first_char] = []
+        groups[first_char].append(company)
+        
+    sorted_letters = sorted(list(groups.keys()))
+    
+    while True:
+        console.clear()
+        console.print(Panel("[bold cyan]Welcome to Dooma - Your Ultimate DSA Preparation Companion[/bold cyan]"))
+        console.print("[bold magenta]--- Step 1: Select the First Letter of the Company You Want to Prepare For ---[/bold magenta]\n")
+        
+        # Display letters nicely
+        letter_display = []
+        for letter in sorted_letters:
+            count = len(groups[letter])
+            letter_display.append(f"[bold yellow]{letter}[/bold yellow] [dim]({count})[/dim]")
+            
+        console.print(Columns(letter_display, expand=True, equal=True))
+        
+        console.print("\n[dim]Options:[/dim]")
+        console.print("[dim]- Type a letter to explore companies (e.g., 'A', 'G', '#')[/dim]")
+        console.print("[dim]- Enter '0' to safely exit the application[/dim]")
+        
+        choice = Prompt.ask("\nYour choice", default="")
+        choice = choice.upper().strip()
+        
+        if choice == "0":
+            console.print("[green]Goodbye![/green]")
+            raise typer.Exit()
+        elif choice in groups:
+            show_company_list(choice, groups[choice], data)
+        else:
+            console.print("[red]Invalid letter. Please select a letter from the list above.[/red]")
+            Prompt.ask("[dim]Press Enter to continue...[/dim]")
+
+def show_company_list(letter, group_companies, data):
+    page = 0
+    items_per_page = 30
+    
+    while True:
+        console.clear()
+        console.print(Panel(f"[bold cyan]Step 2: Choose Your Target Company (Starting with '{letter}')[/bold cyan]"))
+        console.print(f"[bold magenta]--- Page {page + 1} ---[/bold magenta]\n")
+        
+        start_idx = page * items_per_page
+        end_idx = min(start_idx + items_per_page, len(group_companies))
+        
+        for i in range(start_idx, end_idx):
+            console.print(f"  [bold yellow]{i + 1}.[/bold yellow] {group_companies[i]}")
+            
+        console.print("\n[dim]Options:[/dim]")
+        console.print("[dim]- Type the number next to the company name to view its questions[/dim]")
+        if end_idx < len(group_companies):
+            console.print("[dim]- Enter 'n' for the next page[/dim]")
+        if page > 0:
+            console.print("[dim]- Enter 'p' for the previous page[/dim]")
+        console.print("[dim]- Enter '0' to go one step back to the alphabet menu[/dim]")
+        
+        choice = Prompt.ask("\nYour choice", default="")
+        choice = choice.strip()
+        
+        if choice == "0":
+            return
+        elif choice.lower() == 'n' and end_idx < len(group_companies):
+            page += 1
+        elif choice.lower() == 'p' and page > 0:
+            page -= 1
+        elif choice.isdigit():
+            idx = int(choice) - 1
+            if 0 <= idx < len(group_companies):
+                company_name = group_companies[idx]
+                show_company_questions(company_name, data[company_name])
+            else:
+                console.print("[red]Invalid selection.[/red]")
+                Prompt.ask("[dim]Press Enter to continue...[/dim]")
+        else:
+            console.print("[red]Invalid input.[/red]")
+            Prompt.ask("[dim]Press Enter to continue...[/dim]")
+
+def show_company_questions(company_name, questions):
+    page = 0
+    items_per_page = 15
+    
+    while True:
+        console.clear()
+        table = Table(
+            title=f"Step 3: Interview Questions for [bold cyan]{company_name}[/bold cyan] (Page {page + 1})", 
+            show_header=True, 
+            header_style="bold magenta",
+            expand=True
+        )
+        table.add_column("No.", justify="right", style="cyan", no_wrap=True)
+        table.add_column("Title", style="white")
+        table.add_column("Difficulty", style="white")
+        table.add_column("Frequency", style="yellow")
+        table.add_column("URL", style="blue")
+        
+        start_idx = page * items_per_page
+        end_idx = min(start_idx + items_per_page, len(questions))
+        
+        for i in range(start_idx, end_idx):
+            q = questions[i]
+            diff = q.get("difficulty", "N/A")
+            if diff == "Easy":
+                diff_color = "green"
+            elif diff == "Medium":
+                diff_color = "yellow"
+            elif diff == "Hard":
+                diff_color = "red"
+            else:
+                diff_color = "white"
+            
+            diff_formatted = f"[{diff_color}]{diff}[/{diff_color}]"
+            
+            table.add_row(
+                str(i + 1),
+                q.get("title", "N/A"),
+                diff_formatted,
+                q.get("frequency", "N/A"),
+                q.get("url", "N/A")
+            )
+            
+        console.print(table)
+        
+        console.print("\n[dim]Options:[/dim]")
+        if end_idx < len(questions):
+            console.print("[dim]- Enter 'n' for the next page of questions[/dim]")
+        if page > 0:
+            console.print("[dim]- Enter 'p' for the previous page of questions[/dim]")
+        console.print("[dim]- Enter '0' to go one step back to the company list[/dim]")
+        
+        choice = Prompt.ask("\nYour choice", default="")
+        choice = choice.strip()
+        
+        if choice == "0":
+            return # Go back to company list
+        elif choice.lower() == 'n' and end_idx < len(questions):
+            page += 1
+        elif choice.lower() == 'p' and page > 0:
+            page -= 1
+        else:
+            console.print("[red]Invalid input.[/red]")
+            Prompt.ask("[dim]Press Enter to continue...[/dim]")
+
+if __name__ == "__main__":
+    app()