توهان جي ڪوڊ کي صاف ۽ خوبصورت بڻائڻ هڪ بهترين طريقو آهي ڊيڊ لائنن کي پورو ڪرڻ لاءِ. رابرٽ مارٽن پنهنجي هڪ بيچيني بيان سان سر تي نيل کي مارايو: ”ڪوڊ جي معيار جو واحد صحيح ماپ What-The-F**ks/Minute يونٽ آهي. "" اصل ۾).
![صاف ڪوڊ ڪيئن لکجي - 1]()
مون کي وضاحت ڪرڻ ڏيو ته هن جو مطلب ڇا آهي. هر دفعي جڏهن آئون ڪوڊ جو جائزو وٺندو آهيان، منهنجو دماغ ٽن جذبن مان گذري ٿو:
- ”WTF؟! هي ڇا؟!" (ناراضيءَ سان) - ائين نه آهي... سڀ ڪجهه ڏاڍو خراب آهي....
- ”WTF؟! هي ڇا؟!" (تعظيم سان) - ها، هڪ هوشيار ماڻهو اهو ڪيو!
- ”WTF؟! هي ڇا؟!" (جلن سان) - هڪ قسم جو مونجهارو، اسان ڇا جي باري ۾ ڳالهائي رهيا آهيون؟!
تنهن ڪري سڀ کان اهم ڇا آهي ۽ ڇا اسان اندازو لڳايو ٿا جڏهن اسان ڪجهه ڪوڊ ڏسون ٿا؟
اهو آهي: ان جي پاڪائي ۽ حسن. صاف ۽ خوبصورت ڪوڊ لکڻ جي صلاحيت هڪ انتهائي پيشه ور ڊولپر جو اشارو آهي. هن مهارت ۾ تربيت ٻن حصن تي ٻڌل آهي - علم ۽ ڪم. علم توهان کي سيکاري ٿو نمونن، اصولن، عملن، هوريسٽ. توھان کي انھن جي ضرورت آھي پروفيشنل طور تي. صرف توهان کي هن علم کي اسپنج وانگر جذب ڪرڻ گهرجي مسلسل مشق ۽ محنت ذريعي. مختصر ۾، صاف ڪوڊ لکڻ آسان ناهي. اهو ڏکيو، محنتي ڪم آهي، ۽ توهان کي ان تي سخت محنت ڪرڻي پوندي. آزمائش ۽ غلطي جي ذريعي، توهان ساڳئي قدمن کي بار بار ورجائيندي بهتر ڪنداسين جيستائين توهان اهو حل ڳوليندا آهيو جيڪو توهان چاهيو ٿا. اتي ڪو به آسان طريقو ناهي. صاف ڪوڊ لکڻ ڪيئن سکڻ ۾ توهان جي مدد ڪرڻ لاءِ هيٺيان ڪجهه طريقا آهن.
نالي ۾ ڇا آهي
ڪينڊرڪ لامر (آمريڪي هپ هاپ فنڪار - ايڊيٽر جو نوٽ) هڪ ڀيرو صحيح طور تي نوٽ ڪيو:
"جيڪڏهن مان حقيقي ڪهاڻي ٻڌائڻ وارو آهيان، مون کي پنهنجي نالي سان شروع ڪرڻو پوندو." سافٽ ويئر ڊولپمينٽ ۾ نالا هر جڳهه آهن. اسان نالو ڏيون ٿا افعال، طبقن، دليلن، پيڪيجز، پروگرامن - سڀ ڪجھ. اسان ماخذ فائلن ۽ حوالن جي ڪتابن ۽ ان سان ڳنڍيل هر شيء جو نالو ڏيون ٿا. اسان شين کي لامحدود نالو ڏيون ٿا، ۽ اهو صاف ڪوڊ ٺاهڻ جي طرف ڪم ڪرڻ جو هڪ نازڪ حصو بڻجي ٿو. نالو جيڪو توهان ڪجهه ڏيو ٿا اهو ارادي کي ظاهر ڪرڻ گهرجي. سٺو نالو ڳولڻ آسان ناهي، اهو وقت وٺندو آهي، پر اهو پڻ گهڻو وقت بچائيندو آهي جڏهن توهان کي ڪوڊ سان معاملو ڪرڻو پوندو آهي ۽ صورتحال پيچيده ٿي ويندي آهي. تنهن ڪري هن عمل جي باري ۾ محتاط رهو ۽ بعد ۾ نالا تبديل ڪرڻ کان نه ڊڄو جيڪڏهن توهان ڪجهه وڌيڪ مناسب ڳوليندا آهيو. هرڪو جيڪو توهان جي ڪوڊ سان ڊيل ڪندو توهان جو تمام گهڻو شڪرگذار ٿيندو.
|
ياد رهي ته ڪنهن به متغير، طبقي، فنڪشن جو نالو لازمي طور تي ٽن مکيه سوالن جو جواب ڏيڻ گهرجي: اهو ڇو (متغير، فنڪشن، وغيره) موجود آهي، اهو ڇا ڪندو آهي ۽ اهو ڇا لاء استعمال ٿيندو آهي.
ان لاءِ نه رڳو سٺي وضاحتي صلاحيتن جي ضرورت آهي، پر عام فهم ۽ وسيع نظريو پڻ. ۽ ڪو به توهان کي اهو توهان کان بهتر نه سيکاري سگهي. |
"هڪ فنڪشن" - هڪ شيء
لوئس هينري سليوان (آمريڪي عقليت پسند ۽ ماڊرنسٽ آرڪيٽيڪٽ) هڪ ڀيرو مشهور طور تي چيو هو ته:
”فنڪشن فارم جو تعين ڪندو آهي . هن چيو ته گهرن جي فن تعمير جي باري ۾، پر هن جوهر تبديل نه ٿو. هر سسٽم ڪجهه ڊومين-مخصوص ٻولي تي ٺهيل آهي جيڪي پروگرامر ٺاهيندا آهن ان کي درست بيان ڪرڻ لاءِ. فعل ٻوليءَ جي فعلن طور ڪم ڪن ٿا، ۽ طبقا اسم آھن. گهڻو ڪري، فنڪشن هڪ پروگرامنگ ٻولي جي تنظيم ۾ اهم آهن، ۽ انهن کي صحيح طور تي لکڻ سٺو ڪوڊ ٺاهڻ جو جوهر آهي. معيار جي ڪمن کي لکڻ لاء صرف ٻه سونهري اصول آهن:
- انهن کي ننڍو هجڻ گهرجي
- انهن کي هڪ ڪم ڪرڻ گهرجي، هڪ ڪم، ۽ اهو سٺو ڪرڻ گهرجي
اھو آھي، توھان جو فنڪشن ننڍڙو ھئڻ گھرجي ۽ نسٽڊ ڍانچي تي مشتمل نه ھئڻ گھرجي. اهڙيء طرح، فنڪشنل انڊينٽيشن جي سطح هڪ يا ٻن کان وڌيڪ نه هجڻ گهرجي. اهو طريقو ڪوڊ کي پڙهڻ، سمجهڻ ۽ سمجهڻ ۾ تمام گهڻو آسان بڻائي ٿو. ان کان علاوه، اسان کي پڪ ڪرڻ گهرجي ته فنڪشن اندر اظهار جي ساڳي سطح تي تجريد آهي. هڪ فنڪشن اندر تجريد جي سطحن کي ملائڻ هميشه تمام گهڻو مونجهارو پيدا ڪري ٿو ۽ آخرڪار غير منظم ڪوڊ ڏانهن وٺي ٿو. بهترين پروگرامر ڪمن کي ٻڌائڻ لاءِ ڪهاڻيون سمجهندا آهن، نه رڳو لکڻ لاءِ ڪوڊ. اهي پنهنجي چونڊيل پروگرامنگ ٻولي جا اوزار استعمال ڪن ٿا هڪ امير، اظهار ڪندڙ، ۽ صاف سٿرو بلاڪ ٺاهڻ لاءِ جيڪو بنيادي طور تي هڪ عظيم ڪهاڻيڪار طور ڪم ڪري سگهي ٿو.
"تبصرا خراب ڪوڊ لاء نه ٺاهيندا آهن"
وينس وليمز، آمريڪي ٽينس پليئر ۽ پنج ڀيرا ومبلڊن چيمپيئن، سر تي نيل کي ماريو جڏهن هن چيو:
"هرڪو پنهنجا تبصرا ڇڏي ٿو. اهڙي طرح افواهون ظاهر ٿين ٿيون . تبصرا ٻه دھاري تلوار وانگر آھن، سٺو رکيل تبصرو تمام مفيد شيء آھي. ٻئي طرف، فضول، بيڪار تبصرن کان سواءِ ٻيو ڪجهه به خلا ۾ نه ٿو اچي. پر سڀ کان وڌيڪ نقصانڪار تبصرا اهي آهن جيڪي غلط معلومات ۽ ڪوڙ پکيڙين ٿا. مختصر ۾، تبصرا هڪ قسم جي ضروري برائي آهن. هميشه نه، پر اڪثر حصو لاء. ڇو؟ اهو سادو آهي، تبصرو جيترو پراڻو آهي، اوترو وڌيڪ ڏکيو آهي ان کي برقرار رکڻ، ۽ اڪثر پروگرامر، جيئن توهان ڄاڻو ٿا، هميشه ڪوڊ ۾ تبديلين سان گڏ تبصرا تبديل نه ڪندا آهن. ڪوڊ منتقل ۽ ترقي ڪري ٿو. ڪوڊ جا حصا اڳتي ۽ پوئتي ھليا ويا آھن، پر ڪو به تبصرو نه آھي. ۽ اهو هڪ مسئلو بڻجي ٿو!
|
ياد رکو: صاف، صاف ڪوڊ چند تبصرن سان، پيچيده، بي ترتيب ڪوڊ کان گهڻو بهتر آهي. تبصرن ۾ پيدا ڪيل افراتفري جي وضاحت ڪندي پنهنجي توانائي ضايع نه ڪريو. بهتر آهي ته اهو وقت ان گندگي کي صاف ڪرڻ ۾ گذاريو. |
"ڪوڊ فارميٽنگ هميشه هڪ ترجيح آهي"
اها ڳالهه رابرٽ سي مارٽن (رابرٽ سيسل مارٽن) عرف چاچا باب، ڊولپر، سافٽ ويئر ڊولپمينٽ تي ڪيترن ئي ڪتابن جو ليکڪ، صلاحڪار، ايجائل منشور جو ڪو-ليکڪ، ۽ ٻين کان سواءِ ڪنهن نه چيو هو. ۽ هن وڌيڪ شامل ڪيو:
"فارميٽنگ ڪوڊ هڪ قسم جو مواصلات آهي. ۽ مواصلات ڪنهن به پيشه ور ڊولپر لاءِ اولين ترجيح آهي. مٿين بيان کي گهٽ نه سمجهيو وڃي، ڇاڪاڻ ته اهو هڪ بهترين ڊولپر جي سڀ کان اهم خاصيتن مان هڪ آهي. فارميٽ ٿيل ڪوڊ توهان کي اجازت ڏئي ٿو توهان جي دماغ ۾ گهيرو ڏسڻ. اسان ماڻهن کي متاثر ڪرڻ چاهيون ٿا اسان جي صاف سٿري، تفصيل تي ڌيان ڏيڻ، منظم ڪرڻ جي صلاحيت ۽ واضح طور تي پنهنجن خيالن جو اظهار. پر جيڪڏهن، جڏهن ماڻهو ڪوڊ تي نظر اچن ٿا، اهي ڪجهه قسم جي مونجهاري کي ڏسن ٿا، هڪ وينگريٽ جي ياد ڏياريندڙ، نه ته شروعات ۽ نه ئي آخر سان، اهو توهان جي ڪوششن کي رد ڪري ٿو ۽ ڊولپر جي شهرت کي گهٽائي ٿو. ان ۾ شڪ نه ڪريو! توهان سچ کان تمام پري آهيو جيڪڏهن توهان سوچيو ته هن ڪاروبار ۾ بنيادي شيء اها آهي ته "ڪوڊ صرف ڪم ڪري ٿو." ڪارڪردگي جيڪا توهان اڄ ٺاهيندا آهيو گهڻو ڪري ايندڙ رليز ۾ تبديل ٿي ويندي، پر ڪوڊ جي پڙهڻ جي صلاحيت تبديل نه ٿيندي. ڪوڊ جو انداز ۽ ان جي سٺي پڙهڻ جي صلاحيت ان کي گهڻي وقت تائين ڪوڊ کي برقرار رکڻ آسان بڻائي ٿي، جيتوڻيڪ اصل ڪوڊ جي سڃاڻپ کان ٻاهر تبديل ٿي وئي آهي.
| اهو ڪڏهن به نه وساريو ته مستقبل ۾، جيڪو گهڻو ڪري ياد رکيو ويندو اهو توهان جو ڪوڊ نه آهي، پر توهان جو انداز ۽ تسلسل آهي. تنهن ڪري، پڪ ڪريو ته ڪوڊ چڱي طرح فارميٽ ڪيو ويو آهي ۽ سادي قاعدن جي پيروي ڪري ٿو جيڪي سڀني ٽيم جي ميمبرن لاء سمجھڻ وارا آهن. |
پهريون ٺاهيو "ڪوشش-پڪڙ-آخر ۾" بلاڪ
جارجس ڪينگوئليم (سائنس جو تاريخدان، فلسفي) صحيح لکيو آهي ته:
”غلطي ڪرڻ انسان لاءِ فطري ڳالهه آهي، پر غلطين تي اصرار ڪرڻ شيطان جي طرفان آهي “ . مسئلو حل ڪرڻ اهو آهي جيڪو سڀ پروگرامر ڪندا آهن. غلط ڊيٽا داخل ٿي سگھي ٿي ان پٽ ۽ ڊوائيس ناڪام ٿي سگھي ٿي. ۽ ڊولپر جي طور تي، اسان کي پڪ ڪرڻ جي ضرورت آهي ته ڪوڊ اهو ڪري ٿو جيڪو اهو ڪرڻ گهرجي. مسئلو صرف غلطي کي سنڀالڻ جو ناهي، پر "صاف ۽ پڙهڻ ۾ آسان" غلطي سنڀالڻ. گھڻن پروگرامن کي ترتيب ڏيڻ جي غلطي کي سنڀالڻ لاء. جيڪڏهن توهان ائين ڪريو ٿا، هر شيء اهڙي افراتفري ۾ اچي ٿو ته بنيادي ڪوڊ جو مقصد ۽ منطق تباهه ٿي ويندو. اهو غلط آهي، اهو هن طريقي سان نه هجڻ گهرجي. ڪوڊ صاف ۽ قابل اعتماد هجڻ گهرجي، ۽ غلطي کي هٿي ڏيڻ گهرجي بيحد ۽ قدرتي طور تي ڪوڊ ۾ ٺهيل. هي هڪ اعلي درجي پروگرامر جو هڪ اشارو آهي. ۽ ھن کي حاصل ڪرڻ جو ھڪڙو طريقو آھي مناسب nesting ۽ ڪوريج جي ذريعي سڀني غلطين جي ڪوشش-ڪيچ بلاڪ ۾. اهي بلاڪ توهان جي ڪوڊ جي دائري کي بيان ڪن ٿا. جڏهن توهان ڪوڊ تي عمل ڪريو ٿا ڪوشش واري حصي ۾ ڪوشش-ڪيچ-آخر ۾ بلاڪ، توهان بيان ڪري رهيا آهيو ته عملدرآمد ڪنهن به وقت ختم ٿي سگهي ٿو ۽ پوءِ ڪيچ ۾ ٻيهر شروع ٿي سگهي ٿو. تنهن ڪري، اسان صلاح ڏيو ڪوشش سان شروع ڪريو-پڪڙ-آخر ۾ جڏهن توهان ڪوڊ لکندا آهيو. اهو طئي ڪرڻ ۾ مدد ڪندو ته صارف ڪوڊ مان ڪهڙي توقع ڪري سگهي ٿو، قطع نظر ته ڪوشش دوران ڪوڊ سان ڇا غلط ٿئي.
| هميشه ياد رکو ته هر استثنا جيڪو توهان اڇلايو ان ۾ ڪافي حوالن تي مشتمل هجڻ گهرجي غلطي جي جڳهه ۽ ماخذ کي طئي ڪرڻ لاءِ. تخليقي ۽ معلوماتي غلطي پيغامن کي ياد ڪيو ويندو آهي ڪوڊ جي لکڻ کان پوء ڊگهي، جيتوڻيڪ جڏهن پروگرامر اڳ ۾ ئي مڪمل طور تي مختلف ڪمن سان مصروف آهي. |
اچو ته ان جو خلاصو
ھڪڙو غير معمولي جملو اسان کي مٿين سڀني کي اختصار ڪرڻ ۾ مدد ڏيندو. هي آهي ڪوڊ-سينس يا "عام ڪوڊ جو احساس،" هڪ قسم جو پروگرامر عام احساس جي برابر آهي. رابرٽ مارٽن جي لفظن ۾:
”صاف ڪوڊ لکڻ لاءِ ڪيترن ئي ننڍڙن طريقن جي منظم استعمال جي ضرورت آهي، جيڪا ”صفائي“ جي محتاط ۽ ڪجهه دردناڪ احساس جي نتيجي ۾ لاڳو ٿئي ٿي. اهي ننڍيون ٽيڪنڪون مجموعي طور تي ڪوڊ-سينس سڏجن ٿيون . اسان مان ڪجهه کي شروع کان ئي ”سائونڊ ڪوڊ سينس“ آهي، جڏهن ته ٻين کي مسلسل مشق ذريعي ان کي ترقي ڪرڻي آهي. هي جبلت نه رڳو خراب ۽ سٺي ڪوڊ جي وچ ۾ فرق کي سڃاڻڻ ۾ مدد ڪري ٿي، پر حڪمت عملين جي ٺهڻ ۾ پڻ مدد ڪري ٿي جنهن جو مقصد خراب ڪوڊ کي سٺي ۾ تبديل ڪرڻ آهي. خراب ڪوڊ سڀ ڪجهه برباد ڪري ٿو. علامتي طور تي ڳالهائڻ، جيڪڏهن توهان ڪتي جي ٻج سان تمام لذيذ ڪيڪ کي ٿڌو ڪيو، ته پوء ... اڙي ... شايد ئي ڪنهن کي پسند نه ڪندو. ڪوڊ احساس هڪ پروگرامر کي صاف ڪوڊ ٺاهڻ جو مقصد حاصل ڪرڻ لاءِ صحيح اوزار استعمال ڪرڻ ۾ مدد ڪري ٿو. هڪ پروگرامر جيڪو سمجهي ٿو ته ڪوڊ-سنس ڇا آهي هڪ فنڪار جيڪو هڪ خالي اسڪرين تي آرٽ جو ڪم ٺاهي سگهي ٿو جيڪو ڪيترن سالن تائين ياد رکيو ويندو. جيئن ته هيرالڊ “هال” ابيلسن، ڪمپيوٽر سائنس جو پروفيسر ايم آءِ ٽي ۾ ۽ Creative Commons ۽ Free Software Foundation جو باني ڊائريڪٽر، ان جو خلاصو بيان ڪيو:
”پروگرامن کي پهريان لکڻ جي ضرورت آهي ته جيئن ماڻهو انهن کي پڙهي سگهن، ۽ پوءِ انهن کي پڙهي سگهجي. عمل ڪيو ويو." ڪار" . توهان هن موضوع تي ڇا پڙهي سگهو ٿا: "A دستي ڪتاب Agile Software Craftsmanship" - رابرٽ مارٽن. “A handbook of Agile estimation” - Mike Cohn
ليکڪ بابت: روي شنڪر راجن ممبئي (ڀارت) مان گلوبل آئي ٽي پروگرام مئنيجر آهي. مشهور بلاگر، هائيڪو شاعر، آرڪيالاجي ۽ تاريخ جو شوقين. توهان هن سان رابطو ڪري سگهو ٿا
Twitter ,
Medium ,
LinkedIn
GO TO FULL VERSION