farsiscript-lang 0.2.0

A simple programming language with Farsi syntax that compiles to C

زبان برنامه‌نویسی فارسی – FarsiScript

یک زبان برنامه‌نویسی کاملاً فارسی با مفسر (interpreter) و کامپایلر به زبان C.

🚀 شروع سریع

./fs run برنامه.fs        # اجرای مستقیم
./fs compile برنامه.fs    # کامپایل به C و اجرا

✨ قابلیت‌ها

قابلیت	مثال
متغیرها و عملگرها	x = 5 + 2 * 3
رشته‌ها و الحاق	"سلام " + "حسام"
شرط چندگانه	اگر (نمره > 90) { ... } درغیراینصورت اگر ...
حلقه‌ها	تاوقتی, برای عددی, برای روی آرایه/رشته/فرهنگ
توابع	تابع جمع(a, b) { برگردان a + b; }
آرایه‌ها	[1, 2, 3] و arr[0] = 10
فرهنگ‌ها (دیکشنری)	{"اسم": "حسام", "سن": 30}
ورودی/خروجی	خواندن, چاپ
کار با فایل	خواندن_فایل, نوشتن_فایل
مدیریت خطا	سعی کن { ... } بگیر (خطا) { ... }
کلاس‌ها و اشیاء	کلاس شخص { ... }
کتابخانه استاندارد	زمان_اکنون(), عدد_تصادفی(), اجرا(), تاریخ_امروز()
اعداد فارسی	۳.۱۴ و ورودی فارسی
نظرات	// توضیح
کامپایل به C	./fs compile file.fs

📦 نصب

pip install -e .
# یا
python setup.py install

پس از نصب، دستور farsiscript در دسترس خواهد بود.

📖 مثال‌های بیشتر

کلاس‌ها و اشیاء

کلاس شخص {
    تابع جدید(نام, سن) {
        این.نام = نام;
        این.سن = سن;
    }
    تابع معرفی() {
        چاپ "اسم: " + این.نام + " سن: " + این.سن;
    }
}
حسام = شخص("حسام", 30);
حسام.معرفی();

مدیریت خطا

سعی کن {
    خطا_بده("مشکل در برنامه");
} بگیر (خطا) {
    چاپ "خطا رخ داد: " + خطا;
}

وارد کردن ماژول

استفاده از "کتابخانه.fs";
سلام("حسام");

📁 ساختار پروژه

• tokenizer.py – تحلیل واژگان
• parser.py – تحلیل نحوی
• evaluator.py – اجرا (مفسر)
• compiler.py – تولید کد C و کامپایل
• main.py – نقطهٔ شروع مفسر
• fs – ابزار خط فرمان یکپارچه

🤝 مشارکت

ایده‌ها و پیشنهادها خوش‌آمدند!
برای توسعه، فایل‌های .py را ویرایش کنید و با ./fs run تست بگیرید.

📝 مجوز

پروژه به صورت آزاد و رایگان ارائه می‌شود.
هرگونه استفاده، تغییر و انتشار با ذکر منبع مجاز است.

---

ساخته‌شده با عشق به فارسی 💚