melek-shell 0.1.0

Melek AI Asistan Projesi - Gelişmiş Gölge Terminal Modülü

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:

pip install .

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

pip install -e .

Kullanım

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"])