رفتن به مطلب

پروژه های من

پروژه های انجام شده یا مشارکت داشته توسط من

Parsidate - کتابخانه Rust برای تبدیل تاریخ میلادی به شمسی و بلعکس

تقویم شمسی به‌عنوان یک استاندارد رسمی در ایران و برخی کشورهای دیگر، جایگاه ویژه‌ای در کاربردهای روزمره و حرفه‌ای دارد. با این حال، در اکوسیستم Rust، ابزارهای محدودی برای پشتیبانی از این تقویم وجود داشت. کتابخانه‌های موجود یا به زبان‌های دیگری توسعه یافته بودند که با نیازهای بهینه‌سازی Rust همخوانی نداشتند، یا فاقد به‌روزرسانی و پشتیبانی کافی بودند به همین دلیل تصمیم گرفتم برای رفع نیاز خودم و سایر برنامه نویسان این پکیج رو بنویسم و منتشر کنم
قابلیت‌ها
تبدیل دوطرفه تاریخ: امکان تبدیل تاریخ میلادی به شمسی و از شمسی به میلادی.
تشخیص سال کبیسه: تابع is_persian_leap_year برای شناسایی سال‌های کبیسه شمسی.
محاسبه روز هفته: تابع weekday که نام روز هفته را به زبان فارسی بازمی‌گرداند.
سبکی و کارایی: طراحی شده با حداقل وابستگی‌ها و بهره‌مندی از کتابخانه chrono.
منبع‌باز بودن: کد منبع در دسترس عموم قرار دارد و امکان مشارکت در توسعه آن فراهم است.
نحوه عملکرد
Parsidate از کتابخانه استاندارد chrono برای مدیریت تاریخ‌های میلادی استفاده می‌کند و با پیاده‌سازی الگوریتم‌های معتبر تبدیل تقویم، تاریخ‌ها را به‌صورت دقیق به شمسی تبدیل می‌نماید. نمونه‌ای از استفاده از این کتابخانه به شرح زیر است:
use chrono::NaiveDate; use parsidate::ParsiDate; fn main() { // تبدیل تاریخ میلادی به شمسی let gregorian_date = NaiveDate::from_ymd_opt(2025, 3, 28).unwrap(); let persian_date = ParsiDate::from_gregorian(gregorian_date).unwrap(); println!("تاریخ شمسی: {}", persian_date.to_string()); // خروجی: 1404/01/08 println!("روز هفته: {}", persian_date.weekday()); // خروجی: جمعه // تبدیل تاریخ شمسی به میلادی let persian_date = ParsiDate { year: 1404, month: 1, day: 8 }; let gregorian_date = persian_date.to_gregorian().unwrap(); println!("تاریخ میلادی: {}", gregorian_date); // خروجی: 2025-03-28 }مشخصات فنی
وابستگی‌ها: تنها وابستگی این کتابخانه، chrono است که برای مدیریت تاریخ‌های میلادی به کار می‌رود.
الگوریتم تبدیل: مبتنی بر فرمول‌های استاندارد تبدیل تقویم میلادی به شمسی، با پشتیبانی از محاسبات سال‌های کبیسه.
رابط برنامه‌نویسی (API): توابعی نظیر from_gregorian و to_gregorian با استفاده از نوع بازگشتی Result، مدیریت خطاها را به‌صورت ایمن تضمین می‌کنند.
نحوه نصب و استفاده
برای افزودن Parsidate به پروژه خود، کافی است خط زیر را به فایل Cargo.toml اضافه کنید:
[dependencies] parsidate = "0.1.1" # نسخه جاری یا آخرین نسخه chrono = "0.4"مثال و جزییات بیشتر را در crates.io قرار داده ام.
sina
sina

GuardX: ابزار مدیریت فایل خط فرمان با قابلیت رمزنگاری

به عنوان یک توسعه‌دهنده که همیشه علاقمند به برنامه های خط فرمان و تحت ترمینال هستم،یه ابزار خط فرمان (CLI) که با استفاده از زبان Rust و کتابخونه ratatui ساختم. GuardXبرای مدیریت پوشه‌ها و فایل‌ها با قابلیت رمزنگاری طراحی شده و رابط کاربری غنی ترمینالی شیک و تعاملی داره.
ویژگی‌های کلیدی
اینجا یه نگاه کلی به قابلیت‌های GuardX می‌ندازیم:
مدیریت فایل و پوشه: مرور آسون با کلیدهای جهت‌نما و چیدمان دوپنلی برای پوشه‌ها و فایل‌ها.
رمزنگاری و رمزگشایی: محافظت از پوشه‌ها با یه کلید دلخواه و نمایش پیشرفت عملیات با نوار پیشرفت.
پیش‌نمایش فایل: مشاهده محتوای فایل‌ها بدون نیاز به خروج از برنامه.
رابط کاربری قابل تنظیم: انتخاب بین تم تیره و روشن و تنظیم طول کلید رمزنگاری از طریق پنجره تنظیمات.
داشبورد و تاریخچه: بررسی آمار پوشه‌ها/فایل‌ها و مرور عملیات قبلی توی یه نوار کناری شیک.
طراحی فنی
رابط کاربری از یه سیستم رویدادمحور بهره می‌بره که با crossterm پیاده‌سازی شده و به کاربر اجازه می‌ده با کلیدها و حتی ماوس (برای کلیک روی آیتم‌ها) تعامل داشته باشه. برای جذابیت بصری، از رنگ‌های سفارشی (مثل Rgb(20, 20, 30) برای تم تیره) و آیکون‌های یونیکد (مثل 🔐 برای فایل‌های رمزنگاری‌شده) استفاده کردم.
بررسی این پروژه رو به افرادی که به زبان Rust علاقمندن و قصد دارن پروژه های رمزگذاری و مشابه انجام بدن پیشنهاد میکنم.

sina
sina

CLAP: پخش موسیقی در ترمینال

CLAP (مخفف Command Line Audio Player) یکی از پروژه های تفریحی من هست که با زبان برنامه نویسی RUST و با هدف ایجاد یک پخش کننده موسیقی ساده و سریع طراحی شده است.
ویژگی های فنی
زبان برنامه نویسی Rust
رابط کاربری TUI یا Terminal User Interface
استفاده از کتابخانه tui-rs
موتور پخش صدا rodio
پشتیبانی از فرمت های رایج MP3,WAV,OGG,FLAC
استفاده از کتابخانه crossterm برای مدیریت ترمینال
کراس پلتفرم
ویژگی های فنی پیشرفته
استفاده از Arc و Mutex برای اشتراک گذاری امن داده ها بین thread ها
پیاده سازی الگوی طراحی Observer برای بروزرسانی وضعیت پخش
بهینه سازی مصرف حافظه با استفاده از streaming برای پخش فایل های صوتی
سایر توضیحات در فایل README قابل مشاهده میباشد.

sina
sina

الگوریتم و توابع اعتبار سنجی کد ملی به زبانهای برنامه نویسی مختلف

گاهی اوقات در برنامه‌ها و وب‌سایت‌ها نیاز داریم که کد ملی کاربران را دریافت کنیم. شاید تا به حال تنها کاری که برای اعتبارسنجی انجام می‌دادیم، بررسی این بود که کد ملی دقیقاً ده رقم داشته باشد و فقط شامل اعداد باشد. در این حالت، کاربر می‌توانست با وارد کردن یک عدد ده‌رقمی غیرمعتبر به راحتی از این مرحله عبور کند.
اخیراً به دلیل نیاز شخصی‌ام، کدی برای بررسی صحت کد ملی نوشتم. از آنجا که مطمئنم افراد زیادی هم به این موضوع نیاز دارند، در این مقاله توابع و مراحل انجام کار را توضیح می‌دهم.
کد ملی یک شماره ده‌رقمی است که سه رقم اول از سمت چپ نشان‌دهنده کد شهرستان محل صدور شناسنامه، شش رقم بعدی یک کد منحصربه‌فرد برای فرد در آن شهرستان و رقم آخر یک رقم کنترلی است که بر اساس نه رقم قبلی محاسبه می‌شود. برای تأیید صحت کد، کافی است رقم کنترلی را دوباره از روی نه رقم اول محاسبه کنیم.
با توجه به اینکه در سیستم کد ملی معمولاً صفرهایی قبل از کد وجود دارد (رقم اول یا دوم از سمت چپ ممکن است صفر باشد)، گاهی کاربران این صفرها را وارد نمی‌کنند یا نرم‌افزار آن‌ها را ذخیره نمی‌کند. بنابراین، بهتر است ابتدا بررسی کنیم که اگر طول کد بین ۸ تا ۹ رقم است، به تعداد لازم (یک یا دو صفر) به سمت چپ عدد اضافه کنیم.
الگوریتم محاسبه
برای محاسبه رقم کنترلی، هر رقم را در موقعیتش (از رقم یک تا رقم نه از چپ به راست) ضرب کرده و همه نتایج را با هم جمع می‌کنیم.
مجموع به‌دست‌آمده را بر ۱۱ تقسیم می‌کنیم.
اگر باقیمانده کمتر از ۲ باشد، رقم کنترلی باید برابر باقیمانده باشد؛ در غیر این صورت، رقم کنترلی برابر است با ۱۱ منهای باقیمانده.
مثال: آیا کد 7731689951 معتبر است؟
محاسبه:
7×10 + 7×9 + 3×8 + 1×7 + 6×6 + 8×5 + 9×4 + 9×3 + 5×2 = 313 313 ÷ 11 = 28 (باقیمانده = 5)چون باقیمانده (۵) بزرگ‌تر یا برابر ۲ است، رقم کنترلی باید ۱۱ - ۵ = ۶ باشد. اما در کد واردشده، رقم آخر ۱ است. پس این کد ملی معتبر نیست.
نمونه کد جاوااسکریپت:
/** * Validates an Iranian National Code based on the official algorithm. * * @param {string} nationalCode - The national code to validate * @returns {boolean} - True if valid, false otherwise */ function validateIranianNationalCode(nationalCode = '') { // Remove non-numeric characters const cleanedCode = (nationalCode || '').replace(/[^0-9]/g, ''); // Check length (must be 8 to 10 digits) const codeLength = cleanedCode.length; if (codeLength < 8 || codeLength > 10) { return false; } // Standardize to 10 digits by padding with leading zeros const standardizedCode = cleanedCode.padStart(10, '0'); // Check if all digits are the same if (standardizedCode.split('').every(digit => digit === standardizedCode[0])) { return false; } // Extract check digit (last digit) const checkDigit = parseInt(standardizedCode.slice(-1)); const digits = standardizedCode.slice(0, -1).split('').map(Number); // Calculate weighted sum (weights: 10 down to 2) const sum = digits.reduce((acc, digit, i) => acc + digit * (10 - i), 0); // Compute remainder and check digit const remainder = sum % 11; const calculatedCheckDigit = remainder < 2 ? remainder : 11 - remainder; // Return true if check digits match return calculatedCheckDigit === checkDigit; } // Test console.log(validateIranianNationalCode('6587452158')); // falseبرای راحتی کار، این الگوریتم را به زبان‌های برنامه‌نویسی مختلف پیاده‌سازی کرده‌ام و در گیت‌هاب قرار داده‌ام. کد در Repository در دسترس است و توضیحات تکمیلی در فایل README نوشته شده است.
مثال زنده
برای استفاده از این پروژه میتوانید از صفحه زیر استفاده کنید.
jalalvandi.github.io/IR-NationalCode
توجه فرمایید اعدادی که وارد میکنید در هیچ جایی ذخیره نخواهند شد.
sina
sina

افزونه Live RTL Fixer

Live RTL Fixer یک افزونه قدرتمند و متن‌باز برای مرورگر کروم اج و فایرفاکس است که با هدف بهبود تجربه کاربری زبان‌های راست‌به‌چپ (RTL) مانند فارسی و عربی طراحی شده است. این افزونه به‌طور خاص برای رفع مشکلات جهت‌گیری و ترازبندی متن در صفحات وب که در میان متن آنها لغات و کلمات انگلیسی و لاتین وجود دارد و موجب به هم ریختگی میشود طراحی شده است—به‌ویژه در شرایطی که از ابزارهای ترجمه مرورگر (مانند Google Translate) استفاده می‌شود. این افزونه با ارائه قابلیت‌های پیشرفته و رابط کاربری ساده، به کاربران اجازه می‌دهد متن‌ها را به‌صورت زنده و بدون نیاز به رفرش صفحه اصلاح کنند.
ویژگی‌های کلیدی
اصلاح زنده متن: با استفاده از MutationObserver، تغییرات DOM را در لحظه رصد می‌کند و جهت‌گیری متن (RTL یا LTR) را به‌طور خودکار یا دستی تنظیم می‌کند.
تشخیص هوشمند زبان: الگوریتم تشخیص زبان مبتنی بر regex، با آستانه قابل تنظیم (پیش‌فرض 0.2)، به‌صورت دقیق متن‌های RTL (مثل فارسی و عربی) و LTR (مثل انگلیسی) را شناسایی می‌کند.
حالت‌های خودکار و دستی: در حالت خودکار، استایل‌ها به‌طور مستقیم اعمال می‌شوند؛ در حالت دستی، کاربران می‌توانند با برچسب‌گذاری اولیه و اعمال تغییرات دلخواه کنترل بیشتری داشته باشند.
مدیریت استثناها: بخش‌های کد (مثل تگ‌های <code> و <pre>) از فیکس مستثنی شده‌اند تا ساختار اصلی کدها حفظ شود.
رابط کاربری تعاملی: پنجره popup با امکاناتی مثل فعال/غیرفعال کردن افزونه، انتخاب حالت، افزودن سایت‌ها به لیست سیاه، و ریست تغییرات.
بهینه‌سازی عملکرد: با محدود کردن رصد تغییرات به المنت‌های متنی و استفاده از انتخابگرهای هدفمند، بار پردازشی به حداقل رسیده است.
پشتیبانی از لیست سیاه: کاربران می‌توانند سایت‌هایی که نمی‌خواهند افزونه در آن‌ها اجرا شود را مشخص کنند.
جزئیات فنی
این افزونه با جاوااسکریپت خالص و APIهای کروم و فایرفاکس توسعه داده شده و از ساختار زیر بهره می‌برد:
فایل manifest.json: تنظیمات اصلی افزونه شامل مجوزها (activeTab, storage) و اتصال اسکریپت‌ها.
content.js: هسته منطقی پروژه که با MutationObserver تغییرات DOM را رصد کرده و استایل‌های direction, text-align, و unicode-bidi را اعمال می‌کند.
popup.js و popup.html: رابط کاربری و مدیریت تنظیمات کاربر با استفاده از chrome.storage.sync برای ذخیره‌سازی پایدار.
styles.css: استایل‌های کمکی برای اطمینان از سازگاری بصری.
یکی از نقاط قوت این افزونه، ماژولاریتی کد و مدیریت خطاهاست. با استفاده از توابع جداگانه (مثل detectLanguage و applyTextDirection) و try-catch، پایداری و خوانایی کد تضمین شده است. همچنین، بهینه‌سازی‌هایی مثل محدود کردن دامنه رصد به المنت‌های متنی و حذف بررسی‌های غیرضروری DOM، عملکرد را در صفحات شلوغ بهبود داده است.
موارد استفاده
این افزونه برای کاربرانی که مرتباً با محتوای چندزبانه کار می‌کنند—مثل مترجمان، توسعه‌دهندگان وب، یا خوانندگان محتوای بین‌المللی—بسیار مناسب است. به‌عنوان مثال، کافیست یک صفحه انگلیسی را با ابزار ترجمه کروم به فارسی ترجمه کنید؛ Live RTL Fixer فوراً جهت‌گیری متن را اصلاح می‌کند، بدون اینکه ساختار کد یا بخش‌های LTR را مختل کند.
نصب و استفاده
برای نصب، کافیست مخزن پروژه را از گیت‌هاب کلون کنید یا فایل ZIP را دانلود کرده و در حالت توسعه‌دهنده کروم بارگذاری کنید (chrome://extensions/). پس از نصب، آیکن افزونه در نوار ابزار ظاهر می‌شود و با یک کلیک می‌توانید تنظیمات را مدیریت کنید.توضیحات بیشتر در فایل README آورده شده است

بروزرسانی 8/1/1404 :
نسخه فایرفاکس افزوده شد
لینگ Repository فایرفاکس
sina
sina

SubAI Desktop ابزاری برای ترجمه زیرنویس ها با Python و Gemini API

SubAI، یک اپلیکیشن نوشته شده با پایتون برای ترجمه خودکار فایل‌های زیرنویس (SRT) با استفاده از API Gemini است. هدف این پروژه، ارائه ابزاری ساده و کاربردی برای ترجمه زیرنویس‌ها به زبان‌های مختلف است

ویژگی‌های کلیدی
این برنامه امکانات متعددی را در اختیار کاربران قرار می‌دهد که آن را به ابزاری متمایز تبدیل می‌کند:
رابط کاربری زیبا و کاربرپسند: طراحی شده با PyQT5،شامل جدول نمایش زیرنویس‌ها، دکمه‌های کنترلی و منوهای تنظیمات است.
پشتیبانی از زبان‌های متنوع: امکان انتخاب زبان‌های هدف مانند انگلیسی، فرانسه، آلمانی، اسپانیایی، فارسی، چینی و ژاپنی.
ترجمه مبتنی بر هوش مصنوعی: استفاده از API مدل‌های زبانی پیشرفته (مانند Gemini) برای ترجمه دقیق و سریع.
مدیریت کش ترجمه: قابلیت ذخیره ترجمه‌ها در حافظه RAM یا فایل SQLite برای جلوگیری از ترجمه‌های تکراری.
کنترل فرآیند ترجمه: امکان شروع، توقف و ادامه ترجمه‌ها همراه با نوار پیشرفت.
تنظیمات پیشرفته: گزینه‌هایی برای تنظیم نرخ درخواست‌ها (RPM)، مدل زبانی، اندازه دسته (Batch Size) و نوع کش.
معماری و پیاده‌سازی
این پروژه با استفاده از پایتون و فریم‌ورک Qt توسعه یافته است که به دلیل عملکرد بالا و قابلیت‌های گسترده در ساخت رابط‌های کاربری، انتخاب شده است. معماری پروژه به صورت زیر است:
کلاس اصلی (SubtitleTranslatorApp):
هسته برنامه که رابط کاربری را مدیریت می‌کند.
شامل ویجت‌هایی مانند QTableWidget برای نمایش زیرنویس‌ها، QPushButton برای اقدامات کاربر و QProgressBar برای نشان دادن پیشرفت ترجمه.
از QSqlDatabase برای مدیریت دیتابیس تنظیمات و کش استفاده می‌کند.
پنجره‌های تنظیمات (SettingsDialog و AdvancedSettingsDialog):
پنجره تنظیمات عمومی برای ورود کلید API و تنظیمات پروکسی.
پنجره تنظیمات پیشرفته برای مدیریت پارامترهای ترجمه مانند RPM و مدل زبانی.
همزمانی (TranslationWorker):
یک کلاس مبتنی بر QThread که ترجمه‌ها را به صورت ناهمزمان انجام می‌دهد.
از QNetworkAccessManager برای ارسال درخواست‌های HTTP به API ترجمه استفاده می‌کند.
پشتیبانی از پردازش دسته‌ای (Batch Processing) برای بهینه‌سازی درخواست‌ها.
منابع و دیتابیس:
فایل‌های منبع مانند لوگوی برنامه (logo.png) با استفاده از سیستم منابع Qt (main.qrc) مدیریت می‌شوند.
دیتابیس SQLite برای ذخیره تنظیمات و کش ترجمه‌ها.
برنامه‌های آینده
این پروژه هنوز جای توسعه دارد. برخی از ایده‌ها برای آینده شامل موارد زیر است:
پشتیبانی کامل از فرمت‌های زیرنویس: اضافه کردن Parser پیشرفته‌تر برای SRT و فرمت‌های دیگر مانند ASS.
ترجمه آفلاین: ادغام مدل‌های محلی هوش مصنوعی برای استفاده بدون اینترنت.
مدل های متنوع:افزوده شدن مدل های متنوع هوش مصنوعی در کنار Gemini
بهینه‌سازی بیشتر: کاهش حجم و بهبود زمان پاسخ‌دهی API.
نحوه استفاده
برای استفاده از این نرم‌افزار:
با توجه به توضیحات فایل README پایتون و نیازمندی های برنامه را نصب نمایید و اجرا کنید.
از منوی "Public Settings" کلید API و پروکسی (در صورت نیاز) را تنظیم کنید.
از منوی "Advanced Settings" پارامترهای ترجمه را مشخص کنید.
فایل SRT را با دکمه "Choose File" انتخاب کنید.
زبان مقصد را انتخاب کرده و "Start Translate" را بزنید.
پس از اتمام ترجمه، فایل نهایی را با "Save" ذخیره کنید.
این نرم‌افزار نه تنها ابزاری کاربردی برای کاربران عادی است، بلکه برای توسعه‌دهندگان نیز یک مطالعه موردی جذاب از مهندسی نرم‌افزار بهینه ارائه می‌دهد. اگر علاقه‌مند به مشارکت در توسعه یا استفاده از این پروژه هستید، خوشحال می‌شوم بازخورد شما را دریافت کنم.
sina
sina

SubAI Web: ابزاری برای ترجمه زیرنویس‌ها با PHP و Gemini API

SubAI، یک وب‌اپلیکیشن برای ترجمه خودکار فایل‌های زیرنویس (SRT) با استفاده از API Gemini است. هدف این پروژه، ارائه ابزاری ساده و کاربردی برای ترجمه زیرنویس‌ها به زبان‌های مختلف و مدیریت فایل‌های ترجمه‌شده است
ویژگی‌های اصلی
ترجمه خودکار زیرنویس‌ها با انتخاب زبان مقصد.
امکان مشاهده، جستجو و دانلود فایل‌های ترجمه‌شده.
تنظیمات پیشرفته شامل کلید API، مدل ترجمه و کش.
امنیت تضمین‌شده با CSRF و فیلتر ورودی‌ها.
تکنولوژی‌های مورد استفاده
PHP: برای بک‌اند و منطق اصلی.
MySQL: برای ذخیره‌سازی داده‌ها.
Gemini API: برای پردازش ترجمه.
Bootstrap: برای رابط کاربری.
JavaScript: برای تعاملات کاربر.
نحوه کار
دریافت Gemini API و وارد کردن آن در تنظیمات.
فایل SRT را آپلود و زبان مقصد را انتخاب کنید.
ترجمه با نمایش پیشرفت انجام می‌شود.
فایل ترجمه‌شده را دانلود یا در بخش "Translated Files" مدیریت کنید.
کاربرد
مناسب علاقه‌مندان به فیلم و سریال برای ترجمه زیرنویس.
ابزار کمکی برای مترجمان حرفه‌ای.
برنامه‌های آینده
پشتیبانی از فرمت‌های دیگر (مثل VTT).
افزودن سایر مدل ها برای استفاده در ترجمه
دسترسی و اجرا
برنامه از طریق (این لینک) قابل دسترسی میباشد. کلید API Gemini نیز مورد نیاز است.
sina
sina