كتابة كود بايثون يُشغَّل ويُختبَر قبل أن يصلك
إعادة تسمية 400 ملف، أو دمج ملفات CSV الشهرية، أو استخراج أرقام من ملفات PDF: مهام تأخذ عشر دقائق لمن يعرف بايثون، وظهيرة كاملة لمن لا يعرفها. صف المهمة وأرفق ملفات نموذجية، فيكتب وكيلك في todo.is سكربتًا نظيفًا، ويشغّله في مساحة عمله على نماذجك، ويعطيك النتيجة والكود لتعيد استخدامه.
الأمر
- اكتب لي سكربت بايثون [ما يجب أن يفعله السكربت]. المدخلات: [الملفات أو البيانات] (أرفقت نماذج). المخرجات: [النتيجة المطلوبة]. سيعمل على [مكان التشغيل]. استخدم المكتبة القياسية فقط، ومكتبات معروفة عند الحاجة، واذكرها في ملف requirements.txt. أضف تعليقات ورسائل خطأ واضحة، وخيار --dry-run إن كان السكربت يعدّل الملفات. انتبه للنصوص العربية: اقرأ الملفات بترميز UTF-8 واحفظها بحيث تظهر الحروف العربية صحيحة في Excel. شغّله على نماذجي في مساحة عملك، وأرني الناتج، وأرسل لي ملف .py مع ملف README قصير بالعربية يشرح طريقة التشغيل.
ما الذي تغيّره
- [ما يجب أن يفعله السكربت]: مثل «يدمج كل ملفات المبيعات الشهرية CSV في ملف واحد ويضيف عمود الشهر من اسم الملف».
- [الملفات أو البيانات]: مثل «12 ملف CSV بأسماء من sales_2026_01.csv إلى sales_2026_12.csv». أرفق نموذجين أو ثلاثة.
- [النتيجة المطلوبة]: مثل «ملف Excel واحد مع ورقة ملخص» أو «الملفات نفسها بأسماء جديدة في المجلد نفسه».
- [مكان التشغيل]: مثل «حاسوبي بنظام Windows مع Python 3.12» أو «Mac» أو «خادم Linux». أو «شغّله أنت وأرسل لي النتيجة».
مثال على النتيجة
- merge_sales.py: ماذا يفعل
- يقرأ كل ملف sales_YYYY_MM.csv في المجلد، ويضيف عمود month من اسم الملف، ويجمعها في جدول واحد، ثم يكتب ملف Excel فيه ورقة ملخص.
- طريقة التشغيل
- • التثبيت مرة واحدة: pip install -r requirements.txt (pandas وopenpyxl)
- • معاينة دون كتابة: python merge_sales.py ./sales --dry-run
- • التشغيل: python merge_sales.py ./sales --out sales_2026_all.xlsx
- قلب السكربت
- for path in sorted(folder.glob("sales_*_*.csv")):
- m = re.match(r"sales_(\d{4})_(\d{2})\.csvquot;, path.name)
- if not m:
- print(f"تخطّي {path.name}: الاسم لا يطابق sales_YYYY_MM.csv")
- continue
- df = pd.read_csv(path, encoding="utf-8-sig")
- df["month"] = f"{m[1]}-{m[2]}"
- frames.append(df)
- التشغيل التجريبي على ملفاتك الـ 12
- • دُمج 18,402 صفًا، والأعمدة: date وsku وqty وprice وmonth
- • الملف sales_2026_04.csv يستخدم «;» فاصلًا: يكتشفه السكربت ويقرؤه بشكل صحيح
- • الملف sales_2026_07.csv محفوظ بترميز Windows-1256 القديم، فظهرت أسماء المنتجات العربية رموزًا غريبة. يجرّب السكربت هذا الترميز تلقائيًا إذا فشل UTF-8، والآن تظهر «تمر سكري» و«قهوة عربية» بشكل صحيح
- • 6 صفوف بلا سعر: بقيت في الملف، وأُدرجت في ورقة Check these
- • ورقة الملخص: إجمالي الكميات والإيرادات بالدرهم لكل شهر، وأعلى 10 منتجات
- الأمان
- • لا يغيّر السكربت ملفات CSV الأصلية ولا يحذفها
- • يتوقف برسالة واضحة إن كان ملف الناتج مفتوحًا في Excel
- • خيار --dry-run يعرض الملفات التي سيقرؤها وعدد صفوفها دون كتابة أي شيء
- الملفات التي تستلمها
- • merge_sales.py وrequirements.txt وREADME.md (بالعربية)
- • sales_2026_all.xlsx، الناتج من نماذجك
كيف تنفّذه مع todo.is
- انسخ البرومبت وصف المهمة والمدخلات والمخرجات التي تريدها.
- أرفق ملفين أو ثلاثة نموذجية في todo.is (أو أرسلها إلى وكيلك) وأرسل المهمة.
- يكتب وكيلك السكربت، ويشغّله على نماذجك، ويريك ما خرج منه.
- حمّل ملف .py وrequirements.txt وREADME، أو احتفظ بالنتيجة فقط.
- اطلب تعديلات («تجاهل أيام الجمعة أيضًا») فيعيد التشغيل كله، واجعلها مهمة متكررة للأعمال الشهرية.
نصائح لنتيجة أفضل
- أرفق نماذج حقيقية بقيم وهمية إن لزم. الترميزات والفواصل والعناوين الغريبة هي ما يكسر السكربتات.
- ملفات CSV العربية المصدّرة من أنظمة قديمة تأتي أحيانًا بترميز Windows-1256. اذكر ذلك إن ظهرت الحروف رموزًا، واطلب حفظ الناتج بترميز utf-8-sig ليفتحه Excel بالعربية مباشرة.
- اذكر مكان التشغيل. مسارات الملفات ونهايات الأسطر وتثبيت المكتبات تختلف بين Windows وMac وLinux.
- اطلب خيار --dry-run لأي سكربت يعيد تسمية الملفات أو ينقلها أو يحذفها.
- إن كنت تحتاج النتيجة مرة واحدة فقط، فتجاوز الإعداد: دع وكيلك يشغّل السكربت ويرسل لك ملف الناتج.
كتابة كود بايثون: أسئلة شائعة
- هل يشغّل الوكيل كود بايثون فعلًا؟ نعم. يشغّل بايثون في مساحة عمله الخاصة على الملفات التي ترفقها ويريك الناتج. لا يشغّل أي شيء على حاسوبك أو خوادمك.
- هل أحتاج إلى تثبيت بايثون لاستخدام السكربت؟ فقط إن أردت تشغيله بنفسك. غير ذلك أرفق الملفات، ويشغّله وكيلك ويرسل لك النتيجة.
- هل يمكن أن يكتب الشرح والتعليقات بالعربية؟ نعم. اطلب تعليقات وملف README بالعربية، ويبقى الكود نفسه وأسماء المتغيرات بالإنجليزية كما هو المعتاد في بايثون.
- هل يتعامل مع المواقع أو واجهات API؟ يمكنه كتابة سكربتات تستدعي واجهات API عامة أو تقرأ صفحات عامة وفق شروط كل موقع. للمواقع التي تحتاج تسجيل دخول، الأفضل غالبًا أن يستخدم وكيلك متصفحه.
- ما إصدار بايثون الذي يستهدفه؟ Python 3.10 أو أحدث افتراضيًا. اذكر إصدارًا أقدم أو مكتبات محددة أنت مقيد بها، فيكتب لها.
JavaScript is required to use the todo.is app.