Metadata-Version: 2.4
Name: melek-shell
Version: 0.1.0
Summary: Melek AI Asistan Projesi - Gelişmiş Gölge Terminal Modülü
Author: Melek AI Team
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: psutil>=5.0.0

# melek-shell

Melek AI Asistan Projesi'nin gelişmiş, korumalı ve asenkron terminal (CMD/PowerShell) köprüsü.

Bu kütüphane, Windows işletim sistemi üzerinde çalışan asistanların sistem komutlarını güvenli, asenkron ve oturum durumunu (dizin hafızası) koruyacak şekilde çalıştırmasını sağlar.

## Özellikler

- **Oturum/Dizin Hafızası:** `cd` komutunu özel olarak algılar ve sonraki komutların bu dizinde çalışmasını sağlar.
- **Canlı Akış (Streaming):** Komut çıktılarını ve hatalarını anlık olarak okur ve callback fonksiyonları yardımıyla gerçek zamanlı yayınlar.
- **Yetim Süreç Temizleyici (Orphan Killer):** Zaman aşımına uğrayan komutların alt süreçlerini (process tree) tamamen kapatır.
- **Komut Güvenlik Duvarı:** Kritik ve tehlikeli sistem komutlarını (örn. `format`, `rmdir /s` vb.) engeller.
- **Takma Adlar (Alias):** Sık kullanılan uzun komutlar için kısayollar tanımlar.

## Kurulum

Projeyi klonladıktan veya indirdikten sonra, proje dizininde aşağıdaki komutla kurabilirsiniz:

```bash
pip install .
```

Geliştirici modu (editable mode) için:

```bash
pip install -e .
```

## Kullanım

```python
from melek_shell import MelekShellController

# Varsayılan 20 saniye zaman aşımı ile başlat
shell = MelekShellController(default_timeout=20)

# Canlı akış callback fonksiyonu
def stream_output(line, stream_type):
    prefix = "[STDOUT]" if stream_type == "stdout" else "[STDERR]"
    print(f"{prefix} {line}")

# Komut çalıştır
result = shell.execute_command("ping 127.0.0.1 -n 3", stream_callback=stream_output)

print("Başarı durumu:", result["success"])
print("Dönen kod:", result["return_code"])
```
