टेस्टर्स के लिए Git बेसिक्स

यह क्यों ज़रूरी है

"आपने कौन-सा build टेस्ट किया?" — Git इस सवाल का सटीक जवाब देता है। Commit id के बिना failure को reproduce करना मुश्किल है, और कोई साबित नहीं कर सकता कि retest fix वाले version पर चला। "main पर 3f9c2ab में fail होता है" को team का कोई भी reproduce कर सकता है।

Git यह भी दिखाता है कि क्या बदला: पिछले tested version के बाद का diff regression tests चुनने का सीधा input है। और automated tests, test data और pipeline files उसी repository में रहती हैं जिसमें product code है, इसलिए उन्हें maintain करने का मतलब है developer की तरह commit, branch और merge करना।

Repository, commit और वे तीन जगहें जहाँ से change गुज़रता है

Repository एक project folder और उसकी पूरी history है, जिसे Git एक hidden .git directory में रखता है। Team की shared copy, यानी remote, जिसे आम तौर पर origin कहते हैं, एक server पर रहती है; git clone उसे पूरी history के साथ आपकी machine पर copy करता है। बाद में git fetch नए commits download करता है और remote की branches अब कहाँ point करती हैं, यह origin/main जैसे नामों में दर्ज करता है, आपकी files को छुए बिना; git pull आपकी current branch को भी update कर देता है, और git push आपके अपने commits origin पर भेजता है।

एक change तीन जगहों से गुज़रता है: working tree (वे files जिन्हें आप edit करते हैं), staging area या index (git add से चुने गए changes) और history (git commit staged चीज़ों का snapshot record करता है)। Git हर commit को एक hash से नाम देता है, यानी commit के content और history से निकाला गया fixed-length fingerprint: 40 hexadecimal characters (ज़्यादातर repositories में SHA-1), जो आम तौर पर पहले सात या ज़्यादा characters तक छोटा करके दिखाया जाता है, जैसे 3f9c2ab। एक character बदलते ही id बदल जाती है, इसलिए commit id ठीक एक version की पहचान है। SHA-1 जनरेटर यह असर किसी भी text पर दिखाता है; Git commit का hash अपने internal format में बनाता है, इसलिए इससे आपको commit id नहीं मिलेगी।

$ git clone https://git.example.com/shop/web.git  # the repository and its history
$ cd web
$ git fetch                     # later: get new commits from origin; files untouched
$ git pull                      # fetch, then bring your current branch up to date
$ git status                    # what is modified, staged or untracked
$ git add tests/checkout/vat.spec.ts
$ git commit -m "Add VAT test for a total ending in .005"
$ git push                      # send your new commits to origin

आज़माएँ: SHA-1 जनरेटर

Branches, HEAD और merge

Branch एक movable नाम है जो एक commit की ओर point करता है; branch पर हर नया commit उस नाम को आगे बढ़ा देता है। main (पुरानी repositories में अक्सर master) में आम तौर पर integrated product रहता है, और developers हर change के लिए एक short-lived branch बनाते हैं, जैसे fix/vat-rounding, ताकि अधूरा काम किसी को परेशान न करे। HEAD वह है जिसे आपने अभी check out किया है, आम तौर पर कोई branch।

Merge एक branch के commits को दूसरी branch में लाता है। अगर branch शुरू होने के बाद target आगे नहीं बढ़ा, तो Git बस उसका नाम आगे बढ़ा देता है (fast-forward); अगर दोनों तरफ़ नए commits हैं, तो Git दो parents वाला merge commit बनाता है। अगर दोनों तरफ़ एक ही lines बदली गईं, तो Git merge conflict पर रुक जाता है और कोई इंसान result लिखता है। बिना conflict वाला merge भी ऐसे changes जोड़ता है जो पहले कभी साथ में नहीं चले, इसलिए merged build को अपना अलग test चाहिए। Branching strategies और pull requests अगले lesson में हैं।

git log --graph में हर * एक commit है और lines उसके parents तक जाती हैं; brackets में लिखे नाम बताते हैं कि branches, tags और HEAD कहाँ point कर रहे हैं।

$ git switch -c fix/vat-rounding   # new branch at the current commit, switch to it
$ git commit -am "Fix VAT rounding for totals ending in .005"  # -a stages edited files
$ git switch main
$ git pull                         # fast-forward: two new commits from colleagues
$ git merge fix/vat-rounding       # both sides moved on: Git makes a merge commit
$ git log --oneline --graph -5
*   9e41d07 (HEAD -> main) Merge branch 'fix/vat-rounding' into main
|\
| * 3f9c2ab (fix/vat-rounding) Fix VAT rounding for totals ending in .005
* | c7d2e18 (origin/main) Add Arabic labels to the invoice PDF
* | 5b0a9f4 Update minimum order total to 50.00 SAR
|/
* 1d2e3f4 (tag: v2.3.0) Release 2.3.0

log, show और diff से history पढ़ना

git log commits को सबसे नए से पुराने क्रम में दिखाता है; git show एक commit और उसके changes दिखाता है; git diff किन्हीं दो versions की तुलना करता है। Tag किसी एक commit का fixed नाम है, आम तौर पर v2.3.0 जैसी कोई release।

नीचे के diff में --- और +++ पुरानी और नई file के नाम बताते हैं, - से शुरू होने वाली lines हटाई गईं, + से शुरू होने वाली जोड़ी गईं, और @@ -9,5 +9,5 @@ का मतलब है कि excerpt line 9 से शुरू होता है और दोनों versions में पाँच lines तक फैला है; दूसरे @@ के बाद का text बस file की एक पिछली line है, जो orientation के लिए दिखाई जाती है।

• git log --oneline v2.3.0..main: main में वह सब जो release v2.3.0 में नहीं है।
• git log --oneline -- src/checkout/: सिर्फ़ वे commits जिन्होंने checkout folder को छुआ।
• git diff --stat v2.3.0 main: दो versions के बीच बदली files और lines की गिनती।
• git tag --contains 3f9c2ab: वे releases जिनमें कोई fix पहले से शामिल है।

$ git diff v2.3.0 main -- src/checkout/vat.ts
diff --git a/src/checkout/vat.ts b/src/checkout/vat.ts
index 4b1e2c0..9d7a3f1 100644
--- a/src/checkout/vat.ts
+++ b/src/checkout/vat.ts
@@ -9,5 +9,5 @@ import { roundHalfUp } from './money';
 // VAT rate in this example: 15 %
 export function vatFor(net: number): number {
   const rate = 0.15;
-  return Math.round(net * rate * 100) / 100;
+  return roundHalfUp(net * rate, 2);
 }

आज़माएँ: टेक्स्ट डिफ़

Worked example: पिछली release के बाद क्या बदला

आपने पिछले हफ़्ते release v2.3.0 टेस्ट की थी; आज आपसे latest main पर regression pass माँगा गया है। Application खोलने से पहले आप Git से पूछते हैं कि क्या बदला; commands और उनका output इस section के आख़िर में हैं। उन्हें file दर file पढ़ें:

• vat.ts: VAT rounding की एक line बदली। ऐसी amounts टेस्ट करें जिनका VAT आधे हलला पर ख़त्म होता है, जैसे 1.10 SAR की net price (VAT 0.165)। git grep दिखाता है कि totals और refunds भी vatFor call करते हैं, इसलिए refunds भी scope में आते हैं।
• min-order.ts: minimum order अब 50.00 SAR है। Boundary value analysis की तरह 49.99 और 50.00 टेस्ट करें; अगर किसी ticket या release note में इस change का ज़िक्र नहीं है, तो टेस्ट करने से पहले पूछें।
• labels.ar.json: invoice के नए Arabic labels। Arabic PDF invoice और उसका right-to-left layout जाँचें।
• vat.spec.ts: नए unit tests। जिन values को ये cover करते हैं उन पर कम manual मेहनत चाहिए; जो छूट गईं वे आपकी list में जाती हैं।
• Test report और हर bug report में लिखें: "main पर 9e41d07 में regression, v2.3.0 के बाद के changes"।

$ git fetch origin
$ git log --oneline v2.3.0..origin/main
9e41d07 (origin/main) Merge branch 'fix/vat-rounding' into main
3f9c2ab Fix VAT rounding for totals ending in .005
c7d2e18 Add Arabic labels to the invoice PDF
5b0a9f4 Update minimum order total to 50.00 SAR
$ git diff --stat v2.3.0 origin/main
 src/checkout/min-order.ts  |  4 ++--
 src/checkout/vat.ts        |  2 +-
 src/invoice/labels.ar.json | 18 ++++++++++++++++++
 tests/checkout/vat.spec.ts | 21 +++++++++++++++++++++
 4 files changed, 42 insertions(+), 3 deletions(-)
$ git grep -n "vatFor(" origin/main -- src
origin/main:src/checkout/total.ts:27:  const vat = vatFor(net);
origin/main:src/checkout/vat.ts:10:export function vatFor(net: number): number {
origin/main:src/refunds/refund.ts:41:  return amount + vatFor(amount);

आज़माएँ: रिग्रेशन सिनेरियो जनरेटर

अक्सर पूछे जाने वाले सवाल

संदर्भ

• Reference — GitGit projectहर Git command और उसके options का आधिकारिक reference, काम के अनुसार समूहित — setup, branching, sharing, patching, inspection और debugging।
• Pro Git, 2nd Edition (Scott Chacon and Ben Straub)Apress · 2014Pro Git किताब, ऑनलाइन मुफ़्त पढ़ने के लिए: Git की बुनियादी बातें, branching और merging, distributed workflows, और Git अपना डेटा कैसे स्टोर करता है।
• ISTQB Certified Tester Foundation Level (CTFL) v4.0ISTQB · 2023सॉफ़्टवेयर टेस्टिंग का फ़ाउंडेशन पाठ्यक्रम: टेस्ट स्तर और प्रकार, टेस्ट डिज़ाइन तकनीकें, टेस्ट प्रबंधन और टूल।