caap 0.0.1

CPU AS A SERVICE

⚙️ CAAP (CPU As A Program)

🧠 A simple virtual CPU that executes custom assembly-like instructions inside Python.

CAAP is a lightweight interpreter that simulates a basic CPU.
It lets you run simple text-based instructions like SET and MOV to manipulate variables, just like a minimal processor.

---

🚀 Features

• 🧠 Simple CPU-like instruction system
• ⚡ Fast and lightweight (pure Python)
• 📦 No external dependencies
• 🧪 Easy to extend with new commands
• 🎮 Great for learning interpreters and CPU concepts

---

📥 Installation

pip install caap

---

🧑‍💻 Basic Usage

from caap import CPU

cpu = CPU()

code = """
SET A, 10
SET B, 20
MOV C, A
"""

result = cpu.run(code)

print(result)

---

📊 Output

{'A': 10, 'B': 20, 'C': 10}

---

⚙️ Supported Instructions

Instruction	Description
SET A, value	Assign a value to a variable
MOV A, B	Copy value from variable B into A

---

🧠 How It Works

CAAP reads each line of text, splits it into commands, and executes it using an internal memory system (like CPU registers).

Each variable acts like a register inside a virtual CPU.

---

🔥 More Examples

📌 Example 1: Simple Math Storage

SET X, 5
SET Y, 15
MOV Z, X

Output:

{'X': 5, 'Y': 15, 'Z': 5}

---

📌 Example 2: Overwriting Values

SET A, 100
SET B, 50
MOV A, B

Output:

{'A': 50, 'B': 50}

---

🎮 Projects You Can Build With CAAP

🧮 1. Mini Calculator Engine

Use CAAP to simulate calculations step by step.

🧠 2. Simple AI Decision System

Use variables like memory states for decisions.

🎮 3. Text-Based Game Engine

Build HP systems, inventory, and battle logic.

⚙️ 4. CPU Simulation Learning Tool

Teach how CPUs work (registers, memory, execution).

🧪 5. Custom Language Experiments

Use CAAP as base for your own scripting language.

---

🧩 Roadmap

• [✔️] ADD support (A + B)
• [✔️] PRINT instruction
• [✔️] IF conditions
• [✔️] LOOP / JMP support
• [✔️] Error handling improvements
• [✔️] Debug mode (step-by-step execution)

---

🤝 Contributing

Feel free to:

• Add new instructions
• Improve execution engine
• Suggest optimizations

---

📄 License

This project is licensed under Apache License 2.0

---

🧠 Author

Built with ⚙️ and creativity by tamimdevlopment

---

🔥 Final Note

CAAP is not just a tool —
it’s a virtual CPU inside Python 🧠⚡