🎓 دوره آموزشی جامع

📚 اطلاعات دوره

عنوان دوره: ساخت ابزارهای CLI با Argparse و Click در پایتون

موضوع کلی: برنامه نویسی

موضوع میانی: پایتون (Python)

📋 سرفصل‌های دوره (100 موضوع)

• 1. مقدمه‌ای بر رابط خط فرمان (CLI)
• 2. چرا ابزارهای CLI بسازیم؟
• 3. آناتومی یک دستور در خط فرمان
• 4. راه‌اندازی محیط توسعه پایتون (Virtual Environment)
• 5. آشنایی با ماژول sys و sys.argv
• 6. محدودیت‌های استفاده مستقیم از sys.argv
• 7. معرفی کتابخانه Argparse: استاندارد داخلی پایتون
• 8. ایجاد اولین پارسر با ArgumentParser
• 9. افزودن آرگومان‌های موقعیتی (Positional Arguments)
• 10. افزودن مستندات و پیام راهنما (Help Message)
• 11. افزودن آرگومان‌های اختیاری (Optional Arguments)
• 12. استفاده از نام‌های کوتاه و بلند برای آرگومان‌ها (-v, --verbose)
• 13. تعیین نوع داده برای آرگومان‌ها (type)
• 14. تعریف مقادیر پیش‌فرض (default)
• 15. الزامی کردن آرگومان‌های اختیاری (required)
• 16. کار با فلگ‌های بولین (action='store_true')
• 17. شمارش تکرار یک فلگ (action='count')
• 18. محدود کردن مقادیر ورودی با choices
• 19. سفارشی‌سازی متن راهنما با description و epilog
• 20. استفاده از متغیرهای متا (metavar) برای نمایش بهتر راهنما
• 21. گروه‌بندی آرگومان‌ها با add_argument_group
• 22. ایجاد آرگومان‌های انحصاری متقابل (Mutually Exclusive)
• 23. مقدمه‌ای بر دستورات فرعی (Sub-commands)
• 24. پیاده‌سازی دستورات فرعی با add_subparsers
• 25. افزودن آرگومان به دستورات فرعی
• 26. مدیریت و اجرای توابع مربوط به هر دستور فرعی
• 27. کنترل پیشرفته خطا در Argparse
• 28. پروژه اول (بخش ۱): ساخت یک ماشین حساب ساده با Argparse
• 29. پروژه اول (بخش ۲): افزودن دستورات فرعی برای چهار عمل اصلی
• 30. جمع‌بندی Argparse: نقاط قوت و ضعف
• 31. معرفی کتابخانه Click: رویکردی مدرن و دکوراتوری
• 32. نصب و راه‌اندازی کتابخانه Click
• 33. مقایسه Argparse و Click: چرا از Click استفاده کنیم؟
• 34. ساخت اولین دستور با دکوراتور click.command@
• 35. تعریف آرگومان‌ها با دکوراتور click.argument@
• 36. تعریف گزینه‌ها (Options) با دکوراتور click.option@
• 37. تفاوت Argument و Option در Click
• 38. تشخیص خودکار نوع داده در Click
• 39. تعیین صریح نوع داده (Integer, Float, String)
• 40. دریافت ورودی از کاربر با Prompt
• 41. دریافت پسورد و ورودی‌های حساس
• 42. ایجاد فلگ‌های بولین (is_flag=True)
• 43. گزینه‌های شمارشی (count=True)
• 44. دریافت چندین مقدار برای یک گزینه (multiple=True)
• 45. محدود کردن مقادیر با click.Choice
• 46. کار با انواع داده پیشرفته: فایل‌ها (click.File)
• 47. کار با انواع داده پیشرفته: مسیرها (click.Path)
• 48. اعتبارسنجی ورودی‌ها با استفاده از Callback
• 49. ایجاد گزینه‌های مشتاق (Eager Options) مانند version--
• 50. مقدمه‌ای بر گروه‌بندی دستورات
• 51. ایجاد گروه دستورات با click.group@
• 52. افزودن دستورات به یک گروه
• 53. ساخت CLIهای تودرتو (Nested Commands)
• 54. آشنایی با آبجکت Context و کاربردهای آن
• 55. انتقال داده بین دستورات با استفاده از Context
• 56. سفارشی‌سازی انواع پارامترها (Custom Parameter Types)
• 57. خروجی رنگی و استایل‌دهی با click.echo و click.secho
• 58. نمایش نوار پیشرفت (Progress Bar)
• 59. پاک کردن صفحه ترمینال
• 60. باز کردن ویرایشگر یا مرورگر از طریق CLI
• 61. دریافت تأییدیه از کاربر (click.confirm)
• 62. مدیریت خطا و خروج از برنامه در Click
• 63. پروژه دوم (بخش ۱): ساخت ابزار مدیریت وظایف (Todo List) با Click
• 64. پروژه دوم (بخش ۲): پیاده‌سازی دستورات add, list, done
• 65. پروژه دوم (بخش ۳): افزودن رنگ و قالب‌بندی بهتر به خروجی
• 66. ساختاربندی یک پروژه CLI بزرگ و ماژولار
• 67. آشنایی با فایل pyproject.toml برای مدیریت پروژه
• 68. تعریف نقطه ورود (Entry Point) برای ابزار CLI
• 69. نصب ابزار در حالت قابل ویرایش (Editable Mode)
• 70. مقدمه‌ای بر تست ابزارهای CLI
• 71. استفاده از click.testing.CliRunner برای تست دستورات Click
• 72. نوشتن تست‌های واحد (Unit Tests) برای منطق برنامه
• 73. نوشتن تست‌های یکپارچه‌سازی (Integration Tests) برای جریان‌های کاری
• 74. کار با فایل‌های پیکربندی (Configuration Files)
• 75. خواندن تنظیمات از فایل‌های JSON, YAML, یا INI
• 76. تعیین اولویت: آرگومان خط فرمان > فایل کانفیگ > مقدار پیش‌فرض
• 77. مدیریت وضعیت (State) بین اجراهای مختلف برنامه
• 78. کار با استریم‌های استاندارد: stdin, stdout, stderr
• 79. ارسال خروجی یک دستور به ورودی دستور دیگر (Piping)
• 80. افزودن لاگینگ (Logging) به ابزار CLI
• 81. کنترل سطح لاگ از طریق آرگومان خط فرمان
• 82. اجرای دستورات و فرآیندهای خارجی با ماژول subprocess
• 83. نکات امنیتی: جلوگیری از تزریق دستور (Shell Injection)
• 84. مستندسازی خودکار گزینه‌ها از روی Docstring
• 85. آماده‌سازی ابزار برای توزیع و انتشار
• 86. ساخت پکیج‌های sdist و wheel
• 87. انتشار پکیج در PyPI (Python Package Index)
• 88. استفاده از ابزار twine برای آپلود پکیج
• 89. پروژه نهایی (بخش ۱): طراحی ابزار CLI برای تعامل با یک API وب
• 90. پروژه نهایی (بخش ۲): ساختار دستورات (دریافت اطلاعات، جستجو، ...)
• 91. پروژه نهایی (بخش ۳): پیاده‌سازی منطق درخواست‌های API
• 92. پروژه نهایی (بخش ۴): مدیریت توکن API و اطلاعات حساس
• 93. پروژه نهایی (بخش ۵): افزودن خروجی با فرمت‌های مختلف (جدول، JSON)
• 94. پروژه نهایی (بخش ۶): نوشتن تست و مستندات
• 95. تکنیک‌های پیشرفته: تکمیل خودکار دستورات (Auto-completion)
• 96. ایجاد پلاگین برای ابزار CLI
• 97. بین‌المللی‌سازی (i18n) و محلی‌سازی (l10n) در CLI
• 98. بهترین شیوه‌ها در طراحی رابط کاربری CLI
• 99. جمع‌بندی دوره و مرور مفاهیم کلیدی
• 100. مسیرهای یادگیری بیشتر پس از این دوره