{"id":27125037,"url":"https://github.com/hemmat1984/crun","last_synced_at":"2025-04-12T04:59:47.789Z","repository":{"id":286355160,"uuid":"961161342","full_name":"hemmat1984/CRUN","owner":"hemmat1984","description":"CRUN - Compile \u0026 Run C/C++ Code with Ease","archived":false,"fork":false,"pushed_at":"2025-04-05T22:20:53.000Z","size":194,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T01:54:47.409Z","etag":null,"topics":["batch-script","c","compiler-toolset","cpp","shell-script"],"latest_commit_sha":null,"homepage":"","language":"Batchfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hemmat1984.png","metadata":{"files":{"readme":"README.fa.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-05T22:13:44.000Z","updated_at":"2025-04-06T08:58:55.000Z","dependencies_parsed_at":"2025-04-05T23:31:47.176Z","dependency_job_id":null,"html_url":"https://github.com/hemmat1984/CRUN","commit_stats":null,"previous_names":["hemmat1984/crun"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemmat1984%2FCRUN","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemmat1984%2FCRUN/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemmat1984%2FCRUN/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemmat1984%2FCRUN/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hemmat1984","download_url":"https://codeload.github.com/hemmat1984/CRUN/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248328108,"owners_count":21085258,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["batch-script","c","compiler-toolset","cpp","shell-script"],"created_at":"2025-04-07T14:29:05.699Z","updated_at":"2025-04-11T01:54:51.277Z","avatar_url":"https://github.com/hemmat1984.png","language":"Batchfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **CRUN — کامپایل و اجرای آسان کدهای C/C++**\n![CRUN Logo](assets/logo.png)\n\n**CRUN** یک ابزار خط فرمان مینیمال و چندسکویی (cross-platform) است که فرایند کامپایل و اجرای برنامه‌های C و ++C را تنها با یک دستور ساده می‌کند — مناسب برای دانشجویان، توسعه‌دهندگان و علاقه‌مندان به برنامه‌نویسی.\n\n---\n\n## 🚀 قابلیت‌ها\n\n- ✅ کامپایل و اجرای سریع فایل‌های `.c` و `.cpp`\n- 🧠 انتخاب هوشمند کامپایلر: GCC/G++ یا Clang/Clang++\n- 🐞 پشتیبانی از اشکال‌زدایی (debug) با GDB و LLDB\n- 🧪 ادغام‌شده با AddressSanitizer برای تشخیص خطاهای حافظه\n- 🧾 امکان ارسال آرگومان به برنامه در زمان اجرا\n- 💻 قابل استفاده در هر دو سیستم‌عامل **ویندوز** و **لینوکس**\n\n---\n\n## 🛠️ پیش‌نیازها\n\nاطمینان حاصل کنید ابزارهای زیر روی سیستم شما نصب شده‌اند و در مسیر (PATH) سیستم قرار دارند:\n\n- **GCC/G++ یا Clang/Clang++** — الزامی برای کامپایل\n- **GDB یا LLDB** — اختیاری برای حالت اشکال‌زدایی\n- **ویندوز**: از `crun.bat` استفاده کنید.\n- **لینوکس**: از `crun.sh` استفاده کنید.\n\n---\n\n## 📦 نصب\n\n### در **ویندوز**:\n1. فایل `crun.bat` را دانلود کنید.\n2. آن را در پوشه‌ای قرار دهید که در مسیر PATH سیستم شما باشد (مثلاً `C:\\Windows\\System32`).\n3. Command Prompt را باز کرده و دستور زیر را اجرا کنید:\n   ```cmd\n   crun\n   ```\n\n### در **لینوکس**:\n1. فایل `crun.sh` را دانلود کنید.\n2. آن را اجرایی (executable) کنید:\n   ```bash\n   chmod +x crun.sh\n   ```\n3. فایل را به یکی از پوشه‌های PATH منتقل کنید:\n   ```bash\n   sudo mv crun.sh /usr/local/bin/crun\n   ```\n4. تست کنید:\n   ```bash\n   crun\n   ```\n\n---\n\n## 🧪 استفاده\n\n```bash\ncrun [mode] filename.c/.cpp [program_args]\n```\n\n### حالت‌ها (Modes)\n\n| حالت | توضیح |\n|------|-------|\n| g    | کامپایل با GCC/G++ (پیش‌فرض) |\n| d    | کامپایل با نمادهای اشکال‌زدایی و اجرا با GDB |\n| c    | کامپایل با Clang/Clang++ |\n| cd   | کامپایل و اشکال‌زدایی با LLDB |\n| s    | کامپایل با AddressSanitizer |\n| h    | نمایش پیام راهنما |\n\n---\n\n## 📘 مثال‌ها\n\n```bash\ncrun hello.c\ncrun d main.cpp\ncrun s app.c input.txt\ncrun c program.cpp arg1 arg2\n```\n\n---\n\n## 📂 پوشه Examples\n\nپوشه `examples/` شامل فایل‌های نمونه زیر است:\n\n- `test.c`: یک برنامه ساده C با پردازش آرگومان‌ها\n- `hello.cpp`: برنامه کلاسیک \"سلام دنیا\" به زبان ++C\n- `input.txt`: فایل ورودی نمونه برای تست\n\n---\n\n## 🔖 نکات\n\n- مطمئن شوید ابزارهایی مثل gcc، g++، gdb و clang نصب شده‌اند و در مسیر `PATH` قرار دارند.\n- مسیرهایی که شامل فاصله هستند باید داخل کوتیشن `\" \"` قرار گیرند.\n- برای حالت‌های اشکال‌زدایی، نصب بودن GDB (در ویندوز/لینوکس) یا LLDB (در macOS/لینوکس) ضروری است.\n\n---\n\n## 📝 مجوز (License)\n\nاین پروژه تحت مجوز MIT منتشر شده است. جزئیات بیشتر را در فایل LICENSE ببینید.\n\n---\n\n## 🤝 مشارکت\n\nمشارکت در این پروژه از طریق Pull Request و Issue کاملاً خوش‌آمد است!  \nاگر ایده‌ای دارید یا باگ‌هایی پیدا کردید، با هم پروژه را بهتر کنیم 💡\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhemmat1984%2Fcrun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhemmat1984%2Fcrun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhemmat1984%2Fcrun/lists"}