pydsa-engine 0.1.1

A semantic DSA execution engine.

🚀 PyDSA Engine

A Semantic AI-Powered Data Structures & Algorithms Execution Engine

---

🌟 Overview

PyDSA Engine is a next-generation Data Structures and Algorithms execution environment designed for developers, students, educators, and AI applications.

Instead of remembering exact problem names, simply describe what you're looking for and let the AI-powered routing engine find the correct algorithm instantly.

PyDSA Engine includes:

• 🧠 AI Semantic Search
• ⚡ Dynamic Algorithm Execution
• 🔍 Visual X-Ray Tracer
• 📋 Clipboard Integration
• 🌐 Built-in FastAPI Server
• 📚 3900+ Algorithm Database
• 📈 Complexity Analysis
• 🎯 Natural Language Problem Routing

---

✨ Features

🧠 AI Vector Routing

Find algorithms using natural language.

Example:

"water container"

Automatically routes to:

Container With Most Water

---

⚡ Dynamic Execution

Execute algorithms directly from the terminal with real inputs.

Supports:

• Arrays
• Strings
• Integers
• Matrices
• Graph Inputs
• Trees

---

🔍 X-Ray Visual Tracer

Watch your algorithm execute step-by-step.

Features:

• Local variable tracking
• Execution flow visualization
• Debugging support
• Educational learning mode

---

🌐 Built-in REST API

Turn PyDSA into a backend microservice instantly.

Powered by:

• FastAPI
• Swagger UI
• OpenAPI

---

📋 Clipboard Integration

Copy optimal solutions directly into your IDE.

---

📦 Installation

Install globally from PyPI:

pip install pydsa-engine

Verify installation:

pydsa --help

---

💻 CLI Usage

1️⃣ Search For A Problem

Use natural language to find algorithms.

pydsa search "water container"

Example Output:

Found:
Container With Most Water
Difficulty: Medium
Category: Two Pointers

---

2️⃣ View Source Code

Display the optimal implementation.

pydsa solve "max water" --show-code

---

3️⃣ Copy Source Code

Copy the implementation directly to your clipboard.

pydsa solve "two sum" --copy

Requirements:

pip install pyperclip

---

4️⃣ Execute An Algorithm

Pass actual inputs directly.

Example:

pydsa solve "two sum" "[2,7,11,15]" "9"

Output:

Result:
[0,1]

Time Complexity:
O(n)

Space Complexity:
O(n)

---

5️⃣ Visual X-Ray Tracing

Watch execution step-by-step.

pydsa solve "two sum" "[2,7,11,15]" "9" --trace

Example Output:

Line 12:
num = 2
target = 9

Line 13:
lookup = {2:0}

Perfect for:

• Learning DSA
• Debugging
• Interview Preparation

---

🌐 REST API Server

PyDSA includes a production-ready FastAPI backend.

Start server:

pydsa serve --port 8000

Server:

http://127.0.0.1:8000

Swagger Docs:

http://127.0.0.1:8000/docs

Redoc:

http://127.0.0.1:8000/redoc

---

Example API Request

Endpoint

POST /solve

Request Body

{
  "query": "two sum",
  "inputs": [
    [2,7,11,15],
    9
  ],
  "trace": true
}

Response

{
  "result": [0,1],
  "time_complexity": "O(n)",
  "space_complexity": "O(n)"
}

---

📚 Supported Categories

PyDSA Engine currently supports:

• Arrays
• Strings
• Linked Lists
• Trees
• Binary Trees
• Binary Search Trees
• Graphs
• Dynamic Programming
• Greedy Algorithms
• Backtracking
• Recursion
• Sliding Window
• Two Pointers
• Hash Tables
• Heaps
• Queues
• Stacks
• Tries
• Design Problems
• Math
• Bit Manipulation

And many more.

---

🏗 Project Architecture

PyDSA Engine
│
├── CLI
├── AI Semantic Search
├── Vector Database
├── Execution Engine
├── Visual Tracer
├── FastAPI Server
├── Complexity Analyzer
└── Algorithm Database (3900+)

---

🛠 Development Setup

Clone repository:

git clone https://github.com/YOUR_USERNAME/pydsa.git

Move into project:

cd pydsa

Install editable mode:

pip install -e .

Install testing dependencies:

pip install pytest

---

✅ Run Tests

Execute the full test suite:

pytest

Run with coverage:

pytest --cov=pydsa

---

🤝 Contributing

Contributions are welcome.

You can contribute:

• New algorithms
• Bug fixes
• Documentation
• New CLI features
• Performance improvements
• AI routing enhancements

Workflow:

fork → feature branch → commit → pull request

---

📈 Roadmap

v1

• AI Semantic Search
• Execution Engine
• FastAPI Server
• X-Ray Tracer

v2

• Visual Graph Explorer
• Interactive Tree Renderer
• Algorithm Benchmarking
• Web Playground

v3

• AI Tutor Mode
• LeetCode Importer
• Competitive Programming Assistant
• Algorithm Recommendation Engine

---

📄 License

Licensed under the MIT License.

See:

LICENSE

for details.

---

Built with ❤️ for the Python & DSA Community

PyDSA Engine — Search. Execute. Learn.