بتل کد Battle Codeدارد باز می‌شود…

کار تیمی با گیت

وقتی چند نفر روی یک کد کار می‌کنند، باید راهی باشد که کار همدیگر را ببینند، نظر بدهند و بی‌دردسر یکی‌اش کنند. این کلمه‌ها را هر روز در صفحه‌ی پول ریکوئست‌های GitHub می‌بینی.

پسوند ‎-ed: کاری که انجام شده

GitHub وضعیت‌ها را با شکل ‎-ed فعل می‌گوید: approved (تأییدشده)، rejected (ردشده)، merged (ادغام‌شده)، reverted (برگردانده‌شده)، closed (بسته‌شده). همین شکل برای زمان گذشته هم هست: «Sara approved the changes». اگر فعل به e ختم شود فقط d می‌گیرد: approve می‌شود approved و merge می‌شود merged.

هشت کلمه‌ی این درس

merge conflict (مِرج کانفلیکت): تداخل؛ وقتی دو نفر یک خط را دو جور عوض کرده‌اند

conflict یعنی «درگیری» یا «ناسازگاری». merge conflict وقتی پیش می‌آید که دو شاخه یک خط از یک فایل را دو جور متفاوت عوض کرده باشند و Git نتواند خودش تصمیم بگیرد کدام درست است. آن‌وقت کار را نگه می‌دارد، هر دو نسخه را در فایل علامت می‌زند و از تو می‌خواهد یکی را انتخاب کنی. ترسناک نیست؛ برای همه هر هفته پیش می‌آید.

There is a merge conflict in main.py that you need to resolve.

در main.py یک تداخل هست که باید حلش کنی.

fork (فورک): نسخه‌ی شخصی تو از مخزن یک نفر دیگر

fork در انگلیسی یعنی «چنگال»، و به دوراهی جاده هم fork می‌گویند: جایی که یک راه دو تا می‌شود. در GitHub وقتی یک مخزن را fork می‌کنی، یک نسخه از آن در حساب خودت ساخته می‌شود که می‌توانی آزادانه عوضش کنی، بدون این‌که به مخزن اصلی دست بزنی. بیشتر کمک‌ها به پروژه‌های متن‌باز از همین راه شروع می‌شود.

Fork the repository, make your changes, and open a pull request.

مخزن را فورک کن، تغییرهایت را بده و یک پول ریکوئست باز کن.

pull request (پول ریکوئِست): درخواست این‌که تغییرهای تو وارد کد اصلی شود

request یعنی «درخواست». pull request یعنی از صاحبان پروژه درخواست می‌کنی تغییرهای شاخه‌ی تو را به سمت کد اصلی «بکشند» (pull). در صفحه‌ی آن، بقیه تغییرها را خط به خط می‌بینند، نظر می‌دهند و اگر خوب بود merge می‌کنند. کار تیمی روی GitHub تقریبا همیشه از همین راه می‌گذرد.

I opened a pull request for the new login page.

برای صفحه‌ی ورود تازه یک پول ریکوئست باز کردم.

review (ریویو): بازبینی کردن؛ خواندن و نظر دادن درباره‌ی کد یک نفر

re- یعنی «دوباره» و view یعنی «دیدن»: دوباره و با دقت نگاه کردن. نقد فیلم و نظر خریدارها هم review است. در برنامه‌نویسی code review یعنی یک نفر دیگر کد تو را قبل از merge می‌خواند تا باگ‌ها را پیدا کند و پیشنهاد بدهد. هدف مچ‌گیری نیست؛ چهار چشم بهتر از دو چشم می‌بیند.

Can you review my pull request when you have time?

می‌شود هر وقت فرصت داشتی پول ریکوئست من را بازبینی کنی؟

approve (اَپروو): تأیید کردن

approve یعنی «تأیید کردن»: رسما بگویی «این خوب است، قبول دارم». در بازبینی کد، وقتی بازبین تغییرها را خواند و مشکلی ندید، دکمه‌ی Approve را می‌زند و پول ریکوئست آماده‌ی merge می‌شود. اسمش approval است.

Two reviewers must approve the changes before we merge.

قبل از مرج، دو بازبین باید تغییرها را تأیید کنند.

reject (ریجِکت): رد کردن؛ نپذیرفتن

reject یعنی «رد کردن»، برعکس accept و approve. در Git این کلمه را بیشتر وقتی می‌بینی که سرور push تو را قبول نمی‌کند، چون روی سرور commitهایی هست که تو هنوز نگرفته‌ای. راهش ساده است: اول pull کن، بعد دوباره push. یک پول ریکوئست هم ممکن است رد شود، اگر صاحبان پروژه آن تغییر را نخواهند.

The server rejected my push because my branch was out of date.

سرور پوش من را رد کرد چون شاخه‌ام قدیمی بود.

diff (دیف): تفاوت دو نسخه، خط به خط

diff کوتاه‌شده‌ی difference است، یعنی «تفاوت». یک diff نشان می‌دهد بین دو نسخه‌ی یک فایل دقیقا کدام خط‌ها عوض شده‌اند: خط‌های اضافه‌شده با + (معمولا سبز) و خط‌های پاک‌شده با - (معمولا قرمز). بازبینی کد یعنی همین diff را خواندن.

Check the diff before you commit to see what changed.

قبل از کامیت، دیف را نگاه کن تا ببینی چه چیزی عوض شده است.

revert (ریوِرت): برگرداندن یک تغییر به حالت قبل

revert یعنی «به حالت قبل برگشتن». در Git با git revert یک commit را بی‌اثر می‌کنی، ولی نه با پاک کردنش: Git یک commit تازه می‌سازد که دقیقا برعکس آن را انجام می‌دهد. این‌طوری تاریخچه دست‌نخورده می‌ماند و همه می‌بینند چه شد. وقتی تغییری سایت را خراب کرده، سریع‌ترین راه همین است.

The update broke the login page, so we reverted it.

به‌روزرسانی صفحه‌ی ورود را خراب کرد، برای همین آن را برگرداندیم.

گفت‌وگو زیر یک پول ریکوئست

Ali opened a pull request: "Add high score table" #57

Sara: Thanks, Ali! I started to review it. The diff looks clean, but there is a merge conflict in game.py. Can you fix it?

Ali: Done. I pulled main and fixed the conflict.

Sara: Great. One more thing: line 40 changes the player speed. Was that on purpose?

Ali: No, that was a mistake. I will revert that line.

Sara: Perfect. I approve the changes. Merging now!

علی یک پول ریکوئست باز کرد: «اضافه کردن جدول بیشترین امتیاز» ‎#57

سارا: ممنون علی! بازبینی‌اش را شروع کردم. دیف تمیز است، ولی در game.py یک تداخل هست. می‌توانی درستش کنی؟

علی: انجام شد. main را پول کردم و تداخل را حل کردم.

سارا: عالی. یک چیز دیگر: خط ۴۰ سرعت بازیکن را عوض می‌کند. عمدی بود؟

علی: نه، اشتباه بود. آن خط را برمی‌گردانم.

سارا: عالی. تغییرها را تأیید می‌کنم. الان مرج می‌کنم!