📦

python-cli-patterns

Name: python-cli-patterns
Author: 0xDarkMatter

مراجعة المحتوى r1 مخاطر عالية 📁 الوصول إلى نظام الملفات🔑 متغيرات البيئة⚡ يحتوي على سكربتات🌐 الوصول إلى الشبكة⚙️ الأوامر الخارجية

بناء تطبيقات CLI بلغة Python

تحتاج الفرق إلى واجهات سطر أوامر Python متسقة للخيارات والمخرجات والإعدادات والاختبارات. توفر هذه المهارة أنماط Typer وRich لتصميم CLI عملي وجاهز للإنتاج.

يدعم: Claude Codex Code(CC)

⚠️ 38 ضعيف

توقف واطلب التأكيد قبل التثبيت.

راجع الخطة واحصل على موافقة صريحة من المستخدم قبل تغيير الملفات.

التثبيت باستخدام Agent لدي

انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.

طلب الوكيل

Review the Skillstore skill "python-cli-patterns" from https://skillstore.io/skills/0xdarkmatter-python-cli-patterns.md and its manifest at https://skillstore.io/api/skills/0xdarkmatter-python-cli-patterns/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.

موارد مهيّأة لـ Agents

استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.

تفاصيل Markdown GET /skills/0xdarkmatter-python-cli-patterns.md manifest موقَّع GET /api/skills/0xdarkmatter-python-cli-patterns/manifest lockfile موقَّع GET /api/skills/0xdarkmatter-python-cli-patterns/lockfile

اختبرها

جارٍ استخدام "python-cli-patterns". ابن CLI يستورد الملفات ويعرض التقدم.

النتيجة المتوقعة:

بنية أوامر تتضمن التحقق من المسارات والإبلاغ عن التقدم ورسائل النجاح ومعالجة الأخطاء وسيناريوهات الاختبار.

جارٍ استخدام "python-cli-patterns". أضف دعم الإعدادات إلى سكربت Python موجود.

النتيجة المتوقعة:

خطة إعدادات تتضمن القيم الافتراضية من الملفات وتجاوزات البيئة وأسبقية سطر الأوامر ومسارات الإعدادات المرئية.

جارٍ استخدام "python-cli-patterns". اجعل مخرجات الطرفية أسهل للفحص السريع.

النتيجة المتوقعة:

خطة مخرجات Rich تستخدم الجداول للسجلات واللوحات للملخصات وأخطاء stderr واضحة.

التدقيق الأمني

مخاطر عالية

v6 • ٤‏/٧‏/٢٠٢٦ فتح التقرير المرتبط بالإصدار

Most static findings are false positives caused by Markdown examples that mention environment variables, hidden XDG paths, database URLs, and code fences. No prompt injection or credential exfiltration intent was found in the reviewed source files. One semantic issue remains: a Typer query example executes raw SQL supplied as a CLI argument.

الملفات التي تم فحصها

1,322

الأسطر التي تم تحليلها

عناصر المراجعة

تم تجاهل الإيجابيات الكاذبة

مخاوف أمنية مؤكدة (1)

مرتفع

references/typer-patterns.md:177-184

Raw SQL Execution Example

The Typer query example accepts a sql argument from the command line and passes it directly to the database execution method. Generated tools could expose arbitrary database reads or writes if copied into untrusted CLIs.

The source shows a command argument named sql passed directly to ctx.obj.db.execute. This is a clear unsafe pattern, even though the file is documentation.

عوامل الخطر

📁 الوصول إلى نظام الملفات (6)

references/configuration.md:292 references/configuration.md:293 references/configuration.md:294 references/configuration.md:292 references/configuration.md:293 references/configuration.md:294

🔑 متغيرات البيئة (13)

references/configuration.md:138 references/configuration.md:140 references/configuration.md:150 references/configuration.md:152 references/configuration.md:162 references/configuration.md:164 references/configuration.md:249 references/configuration.md:29 references/configuration.md:113 references/configuration.md:115 references/configuration.md:117 references/typer-patterns.md:169 references/typer-patterns.md:281

⚡ يحتوي على سكربتات (1)

references/rich-output.md:79-87

🌐 الوصول إلى الشبكة (1)

references/typer-patterns.md:238

⚙️ الأوامر الخارجية (24)

دقّقه: codex عرض سجل التدقيق →

شارك واستشهد بهذا التقرير

شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.

فتح التقرير المرتبط بالإصدار

نسخ رابط التقرير

https://skillstore.io/skills/0xdarkmatter-python-cli-patterns/audits/6?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/0xdarkmatter-python-cli-patterns/security.svg)](https://skillstore.io/skills/0xdarkmatter-python-cli-patterns?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/0xdarkmatter-python-cli-patterns?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/0xdarkmatter-python-cli-patterns/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

بطاقة قابلة للتضمين

<iframe src="https://skillstore.io/embed/skills/0xdarkmatter-python-cli-patterns.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

الاستشهادات الأكاديمية (APA · BibTeX · CFF)

اقتباس APA

0xDarkMatter. (2026). python-cli-patterns security audit report (audit version 6) [Author version unspecified]. Skillstore. https://skillstore.io/skills/0xdarkmatter-python-cli-patterns/audits/6

اقتباس BibTeX

@techreport{0xdarkmatter-0xdarkmatter-python-cli-patterns-2026,
  author = {0xDarkMatter},
  title = {python-cli-patterns security audit report (audit version 6)},
  institution = {Skillstore},
  year = {2026},
  number = {6},
  url = {https://skillstore.io/skills/0xdarkmatter-python-cli-patterns/audits/6},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "python-cli-patterns security audit report (audit version 6)"
version: "unspecified"
type: report
authors:
  - name: "0xDarkMatter"
date-released: "2026-07-04"
url: "https://skillstore.io/skills/0xdarkmatter-python-cli-patterns/audits/6"
identifiers:
  - type: other
    value: "skillstore:0xdarkmatter-python-cli-patterns:audit:6"
    description: "Skillstore immutable audit report identifier"

تقييم Skillstore

سبب هذا التقييم موثوقية الأدلة: متوسط

الهندسة المعمارية

قابلية الصيانة

المحتوى

المجتمع

الامتثال للمواصفات

ما الذي يمكنك بناؤه

إنشاء CLI داخلي للإدارة

استخدم مجموعات الأوامر والخيارات ذات الأنواع المحددة وجداول Rich والإعدادات المحلية لبناء أدوات إدارية بسلوك متوقع.

تحسين السكربتات التشغيلية

استبدل السكربتات المرتجلة بأوامر Typer مختبرة ومؤشرات تقدم ومسارات إعدادات صريحة.

إضافة CLI موجه للمطورين في المشروع

اعرض مهام المشروع الشائعة عبر CLI مصقول يتضمن التحقق ونصوص المساعدة واختبارات CliRunner.

جرّب هذه الموجّهات

إنشاء CLI أساسي

أنشئ CLI أساسي باستخدام Typer لمشروع اسمه <name> مع أمر واحد وخيارات ذات أنواع محددة ونص مساعدة واضح وأخطاء بسيطة.

إضافة مخرجات Rich

حدّث خطة CLI هذه لاستخدام جداول Rich وملاحظات التقدم واللوحات ورسائل الخطأ المقروءة دون تغيير سلوك الأمر.

تصميم الإعدادات

صمم معالجة الإعدادات لهذا CLI باستخدام TOML ومتغيرات البيئة والمسارات الصريحة واختبارات أسبقية الإعدادات.

إعادة هيكلة CLI كامل

راجع تصميم CLI هذا واقترح بنية Typer مع أوامر فرعية وإعدادات متعددة الطبقات ومخرجات Rich ومعالجة async واختبارات CliRunner.

أفضل الممارسات

تحقق من المسارات والخيارات قبل تنفيذ أعمال على نظام الملفات.
احتفظ بالأسرار في متغيرات البيئة أو ملفات الإعدادات المحلية وتجنب طباعتها.
أضف اختبارات CliRunner للأوامر الصالحة والإدخال غير الصالح والإعدادات المعتمدة على البيئة.

تجنب

لا تنفذ SQL خامًا من إدخال سطر الأوامر إلا إذا كانت الأداة موثوقة بصرامة.
لا تكتب الإعدادات في مسارات منزلية مخفية دون عرض المسار الذي تم حله.
لا تخلط منطق الأعمال مباشرة داخل callbacks الأوامر عندما ينبغي اختباره بشكل منفصل.