استخدم Hermes كمكتبة Python

فكّر في Hermes كمساعدٍ آليٍّ ودود يمكنك توجيهه بأوامر بسيطة بلغة بايثون — دون الحاجة لتعلّم لغة جديدة أو التنقل في لوحات تحكم معقّدة.

ماذا يعني “الاستخدام كمكتبة”؟

عادةً، تتواصل مع Hermes عبر نافذة محادثة. لكن عند استخدامه كمكتبة بايثون، تكتب نصوصًا برمجية (Scripts) تخبر Hermes بما يجب فعله. هذا مثالي لأتمتة المهام المتكررة مثل إصلاح الأكواد، أو تشغيل الاختبارات، أو تنظيف الملفات.

أول أوامرك: البحث والتصحيح

لنفترض أن لديك مشروعًا كبيرًا يحتوي على استدعاءات API قديمة تحتاج إلى تحديث. بدلًا من فتح كل ملف يدويًا، يمكنك كتابة نص برمجي يجدها ويصلحها جميعًا:

# Find all Python files using deprecated API and fix them
matches = search_files("old_api_call", path="src/", file_glob="*.py")
fixed = 0
for match in matches.get("matches", []):
    result = patch(
        path=match["path"],
        old_string="old_api_call(",
        new_string="new_api_call(",
        replace_all=True
    )
    if "error" not in str(result):
        fixed += 1

print(f"Fixed {fixed} files out of {len(matches.get('matches', []))} matches")

إليك ما يحدث: يبحث Hermes في كل ملف .py داخل src/، ويعثر على old_api_call(، ويستبدلها بـ new_api_call(. هكذا تكون قد وفّرت على نفسك ساعات من العمل اليدوي.

تشغيل الاختبارات والحصول على تقرير

هل تريد معرفة ما إذا كان الكود يعمل فعلاً؟ يمكنك تشغيل مجموعة الاختبارات والحصول على ملخص واضح:

from hermes_tools import terminal, read_file
import json

# Run tests, parse results, and report
result = terminal("cd /project && python -m pytest --tb=short -q 2>&1", timeout=120)
output = result.get("output", "")

# Parse test output
passed = output.count(" passed")
failed = output.count(" failed")
errors = output.count(" error")

report = {
    "passed": passed,
    "failed": failed,
    "errors": errors,
    "exit_code": result.get("exit_code", -1),
    "summary": output[-500:] if len(output) > 500 else output
}

print(json.dumps(report, indent=2))

هذا النص البرمجي يشغّل اختباراتك، ويحسب عدد الناجحة والفاشلة، ثم يطبع تقرير JSON منسّقًا. يمكنك حتى إرسال هذا التقرير إلى فريقك عبر البريد الإلكتروني تلقائيًا.

طريقتان لتشغيل الكود

يمنحك Hermes “وضعين” لتشغيل النصوص البرمجية:

• وضع المشروع (الافتراضي): يعمل النص البرمجي داخل مجلد مشروعك، مستخدمًا بيئة بايثون الموجودة لديك بالفعل. هذا هو الأفضل للعمل اليومي — يمكنك استخدام import pandas أو قراءة الملفات بمسارات نسبية كما تفعل عادةً.

• الوضع الصارم (Strict): يعمل النص البرمجي في مجلد منفصل ومعزول باستخدام بايثون الخاص بـ Hermes. استخدم هذا الوضع عندما تريد أقصى درجات إعادة الإنتاجية — مثلًا عند مشاركة نص برمجي مع شخص آخر وتريد التأكد من أنه يعمل بنفس الطريقة في كل مكان.

يمكنك التبديل بين الوضعين في ملف الإعدادات:

# ~/.hermes/config.yaml
code_execution:
  mode: project   # or "strict"

الأمان أولًا (حتى أثناء البرمجة)

لا تقلق بشأن الأمان — Hermes حريص. في كلا الوضعين، يقوم بـ:

• إزالة مفاتيح API وكلمات المرور من بيئة النص البرمجي
• منع النصوص البرمجية من استدعاء أدوات Hermes الأخرى بشكل متكرر
• تحديد المدة التي يمكن أن يعمل فيها النص البرمجي (5 دقائق كحد أقصى) وكمية المخرجات التي يمكن طباعتها

الخلاصة ونصيحة احترافية

استخدام Hermes كمكتبة بايثون يحوّل المهام المملّة إلى نصوص برمجية من سطر واحد. ابدأ صغيرًا: اختر مهمة متكررة واحدة (مثل إعادة تسمية المتغيرات أو تشغيل الاختبارات) وقم بأتمتتها.

نصيحة عملية: اختبر دائمًا النص البرمجي على نسخة من مشروعك أولاً، وليس على النسخة الأصلية. بهذه الطريقة، إذا حدث خطأ ما، لن تكون قد أفسدت شيئًا. بمجرد أن تصبح واثقًا، شغّله على النسخة الحقيقية. أتمتة سعيدة!

---