لديك ستة صفوف من ملف Cartwheel الفوضوي في قائمة من القواميس. تريد قيمتها الإجمالية، وكم جاء من كل قناة بيع، وأيّ الطلبات كانت كبيرة. كتابة سطر لكل صف تنجح مع ستة صفوف وتنهار مع ستة آلاف. حلقة التكرار (loop) تكتب المنطق مرة واحدة، وتكرّره Python لكل صف.
\norders = [\n {\"order_id\": 2574, \"total\": 65.0, \"channel\": \"mobile app\"},\n {\"order_id\": 2069, \"total\": 18.0, \"channel\": \"mobile app\"},\n {\"order_id\": 1200, \"total\": 33.0, \"channel\": \"mobile app\"},\n {\"order_id\": 1809, \"total\": 35.0, \"channel\": \"web\"},\n {\"order_id\": 1434, \"total\": 72.0, \"channel\": None},\n {\"order_id\": 2089, \"total\": 58.0, \"channel\": \"marketplace\"},\n]\n\ngrand_total = 0\nfor order in orders:\n grand_total += order[\"total\"]\nprint(grand_total)اقرأها هكذا: “لكل طلب في orders، شغّل الأسطر المُزاحة”. في كل دورة يشير الاسم order إلى القاموس التالي. والسطر grand_total += order["total"] اختصار لـ grand_total = grand_total + order["total"].
الإزاحة (indentation) في Python ليست زينة: الأسطر المُزاحة (أربع مسافات بحسب العُرف) هي جسم الحلقة، وأول سطر يعود إلى الهامش الأيسر يعمل بعد انتهاء الحلقة. لهذا تقع print خارجها: أنت تريد نتيجة واحدة، لا ستًا.
الشروط تتيح لكل صف أن يسلك مسارًا مختلفًا. فريق العمليات في Cartwheel يصنّف الطلبات بحسب حجمها:
\ntotals = [65.0, 18.0, 33.0, 35.0, 72.0, 58.0, 329.0]\n\nfor t in totals:\n if t < 50:\n size = \"small\"\n elif t < 150:\n size = \"medium\"\n else:\n size = \"large\"\n print(t, size)تختبر Python الشروط من الأعلى إلى الأسفل ولا تشغّل إلا أول فرع صحيح. الترتيب مهم: لو جاء اختبار الـ 150 أولًا، لصُنّف كل طلب صغير على أنه متوسط أيضًا، لأن 18 أقل من 150 كذلك. ضع الشرط الأضيق أولًا، أو اجعل الشروط غير متداخلة.
\nتستطيع دمج الشروط بـ and وor وnot. وتتيح لك Python أيضًا تسلسل المقارنات كما تكتبها في الرياضيات، وهذا مفيد مع النطاقات:
t = 89.0\nchannel = \"web\"\nprint(t >= 50 and channel == \"web\") # both must be true\nprint(50 <= t < 150) # chained: at least 50 and below 150\nprint(not channel == \"marketplace\") # flips True and Falseوحين تحتاج أيضًا موقع كل عنصر، لقائمة مرتّبة أو لرسالة مثل “الصف 3 معطوب”، غلّف القائمة بـ enumerate()، التي تعطيك الموقع والعنصر معًا: for position, t in enumerate(totals, start=1):. فضّلها على عدّ المواقع بيدك في متغيّر منفصل.
أكثر أنماط الحلقات فائدة في التحليل هو “لكل فئة، اجمع شيئًا”. يحتفظ القاموس بمجموع متراكم لكل مفتاح:
\norders = [\n {\"order_id\": 2574, \"total\": 65.0, \"channel\": \"mobile app\"},\n {\"order_id\": 2069, \"total\": 18.0, \"channel\": \"mobile app\"},\n {\"order_id\": 1200, \"total\": 33.0, \"channel\": \"mobile app\"},\n {\"order_id\": 1809, \"total\": 35.0, \"channel\": \"web\"},\n {\"order_id\": 1434, \"total\": 72.0, \"channel\": None},\n {\"order_id\": 2089, \"total\": 58.0, \"channel\": \"marketplace\"},\n]\n\nrevenue_by_channel = {}\nfor order in orders:\n channel = order[\"channel\"] or \"unknown\"\n revenue_by_channel[channel] = revenue_by_channel.get(channel, 0) + order[\"total\"]\n\nfor channel, revenue in revenue_by_channel.items():\n print(channel, revenue)تفصيلان يحملان هذا الكود. revenue_by_channel.get(channel, 0) تعيد المجموع المتراكم حتى الآن، أو 0 في أول مرة تظهر فيها القناة. وorder["channel"] or "unknown" تستبدل None بتسمية مقروءة، لأن None تُعامَل كقيمة خاطئة، وor تعيد الطرف الأيمن حين يكون الأيسر خاطئًا.
هذا groupby مكتوب باليد. في الدرس 4.1 تنجزه pandas في سطر واحد، وأنت الآن تعرف ما يفعله ذلك السطر في الخلفية: المرور على الصفوف، ومعرفة مجموعة كل صف، وتحديث مجموع تلك المجموعة.
كثيرًا ما توجد الحلقة فقط لتبني قائمة جديدة. والـ list comprehension تقول ذلك مباشرة:
\ntotals = [65.0, 18.0, 33.0, 35.0, 72.0, 58.0, 329.0]\n\nwith_rise = [round(t * 1.05, 2) for t in totals]\nlarge = [t for t in totals if t >= 60]\nprint(with_rise)\nprint(large, len(large))اقرأ [t for t in totals if t >= 60] هكذا: “t، لكل t في totals، إذا كانت t 60 على الأقل”. الجزء الذي قبل for هو ما يدخل القائمة، والـ if في النهاية تصفّي. والـ dictionary comprehension تعمل بالطريقة نفسها مع زوج key: value:
countries = [\"Canada\", \"united kingdom\", \"UNITED KINGDOM\", \"Saudi Arabia\"]\nclean = [c.strip().title() for c in countries]\nprint(clean)\nprint(sorted(set(clean))) # unique values, sorted\nprint({c: len(c) for c in set(clean)})الـ set لا يحتفظ إلا بالقيم الفريدة، فيدمج set(clean) الكتابتين المختلفتين للمملكة المتحدة في واحدة بعد تنظيفهما. ستطبّق الإصلاح نفسه على عمود كامل باستخدام pandas في الدرس 3.2.
في pandas لن تكتب حلقة على الصفوف تقريبًا أبدًا. orders["total"].sum() تقوم بحلقة الجمع، وorders.groupby("channel")["total"].sum() تقوم بنمط القاموس السابق، وكلاهما بكود مُترجَم سريع. فلماذا تتعلّم الحلقات؟ لأنها طريقتك للتحقّق من فهمك لما تفعله عملية pandas، ولأن كثيرًا من العمل الحقيقي (المرور على ملفات، أو على أشهر، أو على قائمة دول لبناء تقرير) يبقى حلقة تحيط بكود pandas.
في التمرين تلخّص اثني عشر صفًا بحسب الدولة. ثم تغلّف منطقًا كهذا في دوال قابلة لإعادة الاستخدام، وتتعلّم قراءة رسائل الخطأ التي تعرضها Python.
\n","toc":[{"id":"sec-1","text":"حلقة for","level":2},{"id":"sec-2","text":"اتخاذ القرارات بـ if و elif و else","level":2},{"id":"sec-3","text":"العدّ والجمع بحسب المجموعة","level":2},{"id":"sec-4","text":"الـ comprehensions: بناء القوائم في سطر واحد","level":2},{"id":"sec-5","text":"الحلقات مقابل pandas","level":2}],"takeaways":["حلقةfor تشغّل جسمها المُزاح (indented) مرة لكل عنصر؛ أنشئ المتغيّرات التراكمية مثل total = 0 قبل الحلقة، لا داخلها.","سلسلة if / elif / else تفحص الشروط من الأعلى إلى الأسفل، ولا تشغّل إلا أول فرع يكون شرطه صحيحًا.","النمط counts[key] = counts.get(key, 0) + 1 هو الطريقة المعتادة للعدّ أو الجمع بحسب المجموعة باستخدام قاموس.","الـ list comprehension بالشكل [expr for x in items if condition] تبني قائمة جديدة في سطر واحد مقروء.","في pandas نادرًا ما تكتب حلقات، لأن العمليات على الأعمدة تقوم بالتكرار نيابةً عنك؛ لكن الحلقات تبقى طريقتك لفهم ما تفعله تلك العمليات."],"further":[{"title":"More Control Flow Tools (if, for, range)","url":"https://docs.python.org/3/tutorial/controlflow.html"},{"title":"List Comprehensions","url":"https://docs.python.org/3/tutorial/datastructures.html#list-comprehensions"}],"quiz":[{"q":"ماذا يطبع هذا الكود؟
\ntotals = [65, 18, 33]\nfor t in totals:\n running = 0\n running += t\nprint(running)116","why":"هذا يتطلّب أن يكون running = 0 قبل الحلقة. أما هنا فيُعاد تصفيره في كل دورة."},{"text":"33","why":"صحيح. يُعاد المتغيّر التراكمي إلى 0 في بداية كل دورة، فلا تبقى إلا القيمة الأخيرة."},{"text":"0","why":"التصفير يحدث قبل الجمع في كل دورة، فتضيف الدورة الأخيرة 33 رغم ذلك."},{"text":"خطأ NameError","why":"يُنشأ running داخل الحلقة في الدورة الأولى، فيكون موجودًا حين تعمل print."}],"answer":1},{"q":"طلب مجموعه 150 يمرّ عبر if t < 50: "small" ثم elif t < 150: "medium" ثم else: "large". أيّ تصنيف يحصل عليه؟
"medium"","why":"المقارنة 150 < 150 تساوي False، فلا يعمل فرع الـ elif."},{"text":""large"","why":"صحيح. الشرطان كلاهما خاطئان مع 150، فيعمل فرع الـ else."},{"text":"التصنيفان "medium" و "large" معًا","why":"سلسلة if/elif/else تشغّل فرعًا واحدًا على الأكثر، وهو أول فرع يكون شرطه صحيحًا."}],"answer":1},{"q":"أيّ comprehension تحتفظ بمجاميع طلبات الويب فقط من قائمة قواميس الطلبات؟
","options":[{"text":"[o["total"] for o in orders if o["channel"] == "web"]","why":"صحيح. التعبير الذي قبل for هو ما يدخل القائمة الجديدة، والـ if في النهاية تصفّي العناصر التي تصل إليها."},{"text":"[o for o in orders if o["channel"] == "web"]["total"]","why":"هذا يبني قائمة من القواميس ثم يحاول الوصول إلى عنصر في القائمة بنص، وهذا يسبّب TypeError."},{"text":"[o["total"] if o["channel"] == "web" for o in orders]","why":"شرط التصفية يأتي بعد الـ for. والـ if التي تأتي قبل الـ for لا بد لها من else، لذا هذا خطأ في الصياغة."}],"answer":0}],"exercise":{"kind":"python","files":[],"starter":"orders = [\n {\"order_id\": 2574, \"total\": 65.0, \"channel\": \"mobile app\", \"country\": \"Canada\"},\n {\"order_id\": 2069, \"total\": 18.0, \"channel\": \"mobile app\", \"country\": \"United States\"},\n {\"order_id\": 1200, \"total\": 33.0, \"channel\": \"mobile app\", \"country\": \"united kingdom\"},\n {\"order_id\": 1809, \"total\": 35.0, \"channel\": \"web\", \"country\": \"United States\"},\n {\"order_id\": 1434, \"total\": 72.0, \"channel\": None, \"country\": \"Saudi Arabia\"},\n {\"order_id\": 2089, \"total\": 58.0, \"channel\": \"marketplace\", \"country\": \"UNITED KINGDOM\"},\n {\"order_id\": 2490, \"total\": 89.0, \"channel\": \"web\", \"country\": \"United Arab Emirates\"},\n {\"order_id\": 2985, \"total\": 24.0, \"channel\": \"web\", \"country\": \"United Kingdom\"},\n {\"order_id\": 2544, \"total\": 58.0, \"channel\": \"mobile app\", \"country\": \"Jordan\"},\n {\"order_id\": 2375, \"total\": 329.0, \"channel\": \"mobile app\", \"country\": \"United Kingdom\"},\n {\"order_id\": 1129, \"total\": 29.0, \"channel\": \"web\", \"country\": \"United States\"},\n {\"order_id\": 1176, \"total\": 44.0, \"channel\": \"web\", \"country\": \"United States\"},\n]\n# 1. Revenue per country, with country names cleaned by .strip().title()\nrevenue_by_country = {}\n\n# 2. order_id of every order with a total of 60 or more, in the original order\nlarge_ids = []\n\n# 3. How many orders came through the \"web\" channel\nweb_count = 0\n","solution":"orders = [\n {\"order_id\": 2574, \"total\": 65.0, \"channel\": \"mobile app\", \"country\": \"Canada\"},\n {\"order_id\": 2069, \"total\": 18.0, \"channel\": \"mobile app\", \"country\": \"United States\"},\n {\"order_id\": 1200, \"total\": 33.0, \"channel\": \"mobile app\", \"country\": \"united kingdom\"},\n {\"order_id\": 1809, \"total\": 35.0, \"channel\": \"web\", \"country\": \"United States\"},\n {\"order_id\": 1434, \"total\": 72.0, \"channel\": None, \"country\": \"Saudi Arabia\"},\n {\"order_id\": 2089, \"total\": 58.0, \"channel\": \"marketplace\", \"country\": \"UNITED KINGDOM\"},\n {\"order_id\": 2490, \"total\": 89.0, \"channel\": \"web\", \"country\": \"United Arab Emirates\"},\n {\"order_id\": 2985, \"total\": 24.0, \"channel\": \"web\", \"country\": \"United Kingdom\"},\n {\"order_id\": 2544, \"total\": 58.0, \"channel\": \"mobile app\", \"country\": \"Jordan\"},\n {\"order_id\": 2375, \"total\": 329.0, \"channel\": \"mobile app\", \"country\": \"United Kingdom\"},\n {\"order_id\": 1129, \"total\": 29.0, \"channel\": \"web\", \"country\": \"United States\"},\n {\"order_id\": 1176, \"total\": 44.0, \"channel\": \"web\", \"country\": \"United States\"},\n]\nrevenue_by_country = {}\nfor order in orders:\n country = order[\"country\"].strip().title()\n revenue_by_country[country] = revenue_by_country.get(country, 0) + order[\"total\"]\nlarge_ids = [o[\"order_id\"] for o in orders if o[\"total\"] >= 60]\nweb_count = 0\nfor o in orders:\n if o[\"channel\"] == \"web\":\n web_count += 1\n","checks":[{"id":"countries-clean","test":"sorted(revenue_by_country) == ['Canada', 'Jordan', 'Saudi Arabia', 'United Arab Emirates', 'United Kingdom', 'United States']"},{"id":"uk-total","test":"round(revenue_by_country.get('United Kingdom', 0), 2) == 444.0"},{"id":"all-revenue","test":"round(sum(revenue_by_country.values()), 2) == 854.0"},{"id":"large-ids","test":"list(large_ids) == [2574, 1434, 2490, 2375]"},{"id":"web-count","test":"web_count == 5"}],"title":"لخّص اثني عشر طلبًا بحسب الدولة","prompt":"تحتوي orders على اثني عشر صفًا من الملف الفوضوي، وأسماء الدول مكتوبة بأحرف كبيرة وصغيرة غير متّسقة. ابنِ revenue_by_country، قاموسًا من اسم الدولة بعد تنظيفه (استخدم .strip().title()) إلى مجموع total. وابنِ large_ids، قائمة بأرقام order_id للطلبات التي مجموعها 60 أو أكثر، بترتيبها الأصلي. واجعل web_count عدد الطلبات التي قناتها "web" بالضبط.
orders مرة واحدة لبناء القاموس: نظّف الدولة في متغيّر أولًا، ثم حدّث المجموع لذلك المفتاح.","revenue_by_country[country] = revenue_by_country.get(country, 0) + order["total"] تضيف إلى مجموع موجود أو تبدأ مجموعًا جديدًا.","large_ids = [o["order_id"] for o in orders if o["total"] >= 60]. ولـ web_count، يعمل sum(1 for o in orders if o["channel"] == "web") أو حلقة فيها += 1."],"explanation":"تنظيف المفتاح قبل استخدامه هو ما يجعل "united kingdom" و"UNITED KINGDOM" و"United Kingdom" تقع في الخانة نفسها؛ بدونه ستحصل على ثلاثة مدخلات للمملكة المتحدة ومجموع موزّع على ثلاثة. النمط .get(key, 0) يتعامل مع أول ظهور لكل دولة. والـ comprehension تحافظ على الترتيب الأصلي لأنها تمرّ على orders من البداية إلى النهاية. المجموع الكلي عبر الدول يبقى 854.0، وهذه طريقة سريعة للتأكّد من أن التجميع لم يُضِع صفًا ولم يحسبه مرتين: تحقّق دائمًا من أن الأجزاء مجموعها يساوي الكل.
large_ids تساوي [2574, 1434, 2490, 2375]","web-count":"web_count يساوي 5"}},"words":621,"readMinutes":4}