مواد پر جائیں
بلاگ

ٹریول API کی سینڈ باکس ٹیسٹنگ: جو سینڈ باکس نہیں دکھاتا

Tekravel اداریہ
AI کی مدد سے لکھا گیا

انٹیگریشن نے ہر وہ امتحان پاس کر لیا جو ٹریول API کی سینڈ باکس ٹیسٹنگ اس کے سامنے رکھ سکتی تھی۔ سرچ پروازیں لوٹاتی تھی، ہوٹل کی دستیابی کی کال خالی کمروں کے ساتھ واپس آتی تھی، بکنگ کال ہر بار کنفرمیشن نمبر دیتی تھی، اور QA نے جمعرات کو منظوری دے دی۔ اگلے منگل ایک گاہک نے ہوٹل کی ایک قیمت ادا کی اور سپلائر نے اسے دوسری قیمت پر کنفرم کیا، ایک فلائٹ بکنگ timeout ہو گئی اور کوئی نہیں بتا سکا کہ سیٹ ہولڈ ہوئی یا نہیں، اور سپورٹ کے ایک ایجنٹ نے پوری دوپہر ایک ہی سفر کو بیان کرنے والے دو ریکارڈز ملانے میں گزار دی۔ ان میں سے کوئی بھی ایسا بگ نہیں تھا جو ٹیسٹ سوٹ سے چھوٹ گیا ہو۔ یہ وہ منظرنامے تھے جنہیں ٹیسٹ سوٹ دیکھ ہی نہیں سکتا تھا۔ سینڈ باکس ضروری ہے، مگر کافی ہونے سے بہت دور ہے، اور ان دونوں کے درمیان کے خلا میں ٹریول انٹیگریشن کے زیادہ تر مہنگے حادثات رہتے ہیں۔

یہ اس ڈیولپر کے لیے ٹیسٹ پلان ہے جو اس انٹیگریشن کا ذمہ دار ہے: سینڈ باکس کیا ثابت کر سکتا ہے، اپنی ساخت کی وجہ سے کیا نہیں کر سکتا، اور کمپنی کے کارڈ پر اصلی سیٹیں بک کیے بغیر اس فرق کو کیسے پورا کیا جائے۔

سینڈ باکس میں پاس ہونے والا کوڈ پروڈکشن میں کیوں ٹوٹتا ہے

سینڈ باکس جوابات کی شکل کا وعدہ ہے، ان کے رویے کا نہیں۔ اسکیما پروڈکشن سے ملتا ہے۔ رویہ تقریباً کبھی نہیں ملتا، اور اس میں کسی کا قصور نہیں: ٹیسٹ ماحول لائیو انوینٹری چلانے کا متحمل نہیں ہو سکتا، اس لیے وہ کرایوں اور کمروں کا ایک مقررہ سیٹ دیتا ہے جو کبھی ختم نہیں ہوتے، کبھی قیمت نہیں بدلتے اور کبھی شیڈول نہیں بدلتے۔ وہ تیزی سے جواب دیتا ہے کیونکہ اسے کوئی اور استعمال نہیں کر رہا۔ وہ شاذ و نادر ہی آدھے راستے میں ناکام ہوتا ہے۔

پروڈکشن یہ سب روزانہ کرتی ہے۔ انوینٹری باقی تمام بیچنے والوں کے ساتھ مشترک ہے؛ کرائے کوئی اوپر کی سطح پر کیش کرتا ہے اور وہ پرانے ہو جاتے ہیں؛ لوڈ کے نیچے سپلائر کا سسٹم آہستہ جواب دیتا ہے یا بالکل نہیں دیتا۔ جس کوڈ نے صرف سینڈ باکس دیکھا ہے، اسے عملاً صرف ایک ایسے سپلائر کے خلاف ٹیسٹ کیا گیا ہے جس کا دن بالکل مثالی گزر رہا ہو۔

اس لیے سینڈ باکس کو تین تہوں میں سے ایک سمجھیں۔ یہ ثابت کرتا ہے کہ ریکویسٹس درست بنی ہیں اور پارسر اسکیما سمجھتا ہے۔ ریکارڈ شدہ فکسچرز ثابت کرتے ہیں کہ کوڈ ان جوابات کو جھیل لیتا ہے جو پروڈکشن واقعی بھیجتی ہے۔ لائیو چیکس کا ایک چھوٹا، سوچا سمجھا سیٹ ثابت کرتا ہے کہ کچھ بدلنے کے بعد بھی کنکشن ٹھیک ہیں۔ ہر تہہ وہ پکڑتی ہے جو باقی دو نہیں پکڑ سکتیں۔

وہ منظرنامے جو سینڈ باکس عموماً نہیں دیتا

پہلا ٹیسٹ لکھنے سے پہلے انہیں لکھ لیں۔ سینڈ باکس کسی خاص ٹیسٹ ویلیو سے ان میں سے ایک دو کی نقل کر سکتا ہے؛ زیادہ تر اس کے پاس سرے سے ہوتے ہی نہیں۔

منظرنامہپروڈکشن کیا کرتی ہےاسے کیسے کور کریں
سرچ اور بکنگ کے درمیان قیمت بدل جاتی ہےبکنگ کسی اور ٹوٹل پر کامیاب ہو جاتی ہے، یا قیمت کی تبدیلی کی ایسی ایرر کے ساتھ ناکام ہوتی ہے جو آپ کو دکھانی ہےفکسچر جوڑا: ایک سرچ جواب اور ایک مختلف ٹوٹل والا بکنگ جواب؛ یقینی بنائیں کہ مسافر سے دوبارہ پوچھا جائے، خاموشی سے رقم نہ کاٹی جائے
دستیابی اور بکنگ کے درمیان سب بک جاتا ہےپیش کیا گیا کمرہ یا کرایہ کلاس ہولڈ کرنے کی کوشش پر ختم ہو چکا ہوتا ہےسپلائر کی اصلی "سولڈ آؤٹ" ایرر کا فکسچر؛ یقینی بنائیں کہ مسافر ایرر پیج پر نہیں بلکہ نتائج پر واپس جائے
بکنگ کال پر timeoutسپلائر نے بکنگ بنائی بھی ہو سکتی ہے اور نہیں بھیریکویسٹ بھیجنے کے بعد timeout ڈالیں؛ یقینی بنائیں کہ کسی بھی دوبارہ کوشش سے پہلے بکنگ کا اسٹیٹس پوچھا جائے
دوہری سبمیشنڈبل کلک یا کلائنٹ کی دوبارہ کوشش دو بکنگز بنا دیتی ہےایک ہی بکنگ ایک ہی idempotency key کے ساتھ دو بار بھیجیں؛ یقینی بنائیں کہ بالکل ایک بکنگ موجود ہو
ٹکٹ جاری ہونے کے بعد شیڈول کی تبدیلیبیچی گئی فلائٹ اب کسی اور وقت پر یا کسی اور فلائٹ نمبر سے روانہ ہوتی ہےبدلے ہوئے سفرنامے کا فکسچر؛ یقینی بنائیں کہ تبدیلی گاہک کو سنبھالنے والے تک پہنچے
کئی سروسز والی بکنگ میں جزوی کامیابیفلائٹ کنفرم ہو جاتی ہے، ہوٹل نہیںملا جلا فکسچر؛ یقینی بنائیں کہ سسٹم بالکل وہی ریکارڈ کرے جو کنفرم ہوا اور کسی انسان کو الرٹ کرے
لوڈ کے نیچے throttlingRate limit کے جوابات، پھر سست جواباتریکارڈ شدہ throttling جواب دوبارہ چلائیں؛ backoff یقینی بنائیں، اور یہ کہ سرچ ایرر دینے کے بجائے سست ہو جائے

ممکن ہے اپنے اسٹیک کے لیے آپ آخری کالم سے متفق نہ ہوں۔ کوئی بات نہیں۔ اہم یہ ہے کہ ہر قطار کا ایک مالک اور ایک assertion ہو، کیونکہ ہر ایک کبھی نہ کبھی آپ کے ساتھ ہو کر رہے گی۔

فکسچرز اصلی جوابات سے بنائیں، گھڑے ہوئے نہیں

ٹریول انٹیگریشن میں سب سے کارآمد عادت ان جوابات کو سنبھال کر رکھنا ہے جنہوں نے آپ کو حیران کیا۔ ہاتھ سے لکھا mock ڈیٹا وہ دکھاتا ہے جو آپ سمجھتے ہیں کہ سپلائر بھیجتا ہے؛ ریکارڈ شدہ جواب وہ دکھاتا ہے جو اس نے واقعی بھیجا، بشمول وہ فیلڈز جو خالی ہیں حالانکہ دستاویزات کہتی ہیں کبھی خالی نہیں ہوتیں، ایسی کرنسی میں قیمت جو آپ نے مانگی ہی نہیں، اور وہ ایرر جو کامیابی کے اسٹیٹس کے ساتھ آتی ہے۔

ایک معمول جو کام کرتا ہے:

  • سرحد پر ریکارڈ کریں۔ سپلائر کالز کی خام ریکویسٹ اور ریسپانس باڈیز نان پروڈکشن ماحول میں لاگ کریں، اور اگر آپ کے پرائیویسی قواعد اجازت دیں تو پروڈکشن میں ٹریفک کے ایک نمونے کے لیے۔
  • رکھنے سے پہلے صاف کریں۔ مسافروں کے نام، پاسپورٹ نمبر، ای میلز، فون نمبر اور ادائیگی کے حوالہ جات فکسچر کے ریپوزٹری میں جانے سے پہلے نکال دیے جاتے ہیں۔ ان کی جگہ صاف طور پر جعلی ویلیوز رکھیں تاکہ کوئی فکسچر کو اصلی بکنگ نہ سمجھ بیٹھے۔
  • فکسچرز کا نام رویے پر رکھیں۔ hotel-book-price-increased.json اگلے ڈیولپر کو بتاتا ہے کہ یہ کیوں موجود ہے؛ response-17.json نہیں بتاتا۔
  • بدصورت والے ہمیشہ کے لیے رکھیں۔ وہ بگڑا ہوا جواب جس نے ایک اتوار سرچ گرا دی تھی، آپ کی سب سے قیمتی فائل ہے۔ اس کی جگہ ایسے ٹیسٹ میں ہے جو ہر commit پر چلے۔

پھر ان فکسچرز پر کنٹریکٹ ٹیسٹ لکھیں: پارسر، اندرونی ماڈلز میں میپنگ، ایررز کی درجہ بندی۔ اگر سپلائر کسی فیلڈ کا نام بدل دے اور کنٹریکٹ ٹیسٹ فیل ہو جائے، تو آپ کو یہ CI میں پتا چلتا ہے، گاہک سے نہیں۔ درجہ بندی والا حصہ بکنگ انجن API کی ایررز کے انتظام پر ہماری تحریر میں تفصیل سے بیان ہوا ہے۔

پیسے کے راستوں کو پیسہ خرچ کیے بغیر ٹیسٹ کرنا

یہاں سینڈ باکس سب سے کم مدد کرتا ہے، کیونکہ پیسے کے راستے ہی وہ جگہ ہیں جہاں ٹیسٹ ماحول اصلی ماحول سے مختلف ہوتا ہے۔ اصلی ٹکٹنگ، کارڈ سے اصلی کٹوتی اور سپلائر کی اصلی انوائسنگ وہ چیزیں ہیں جنہیں سب سے زیادہ درست ہونا چاہیے اور جن کی لائیو مشق سب سے کم ممکن ہے۔

مسئلے کو تقسیم کریں۔ قیمتوں کا حساب خالص منطق ہے اور اسے آف لائن مکمل طور پر ٹیسٹ کیا جا سکتا ہے: ریکارڈ شدہ کرائے لیں، اپنے مارک اپ کے قواعد، کرنسی کی تبدیلی اور راؤنڈنگ لاگو کریں، اور وہ ٹوٹل جانچیں جو مسافر دیکھتا ہے۔ یہ مشکل کیسز کے لیے کریں — ایک کرنسی کا کرایہ دوسری کرنسی میں بیچا جائے، ایک پروڈکٹ پر فیصد اور دوسری پر مقررہ رقم والا مارک اپ، بچے کا کرایہ، ایسی راؤنڈنگ جو دکھانے اور کٹوتی میں مختلف ہو۔ چند روپوں سے غلط ٹوٹل بھی غلط ہے، اور وہ ہر بکنگ پر غلط ہے۔

ادائیگی کے گرد اسٹیٹ کی تبدیلیاں دوسرا نصف ہیں۔ انہیں واضح طور پر ماڈل کریں — کوٹ شدہ، ہولڈ، ادا شدہ، کنفرم، ٹکٹ جاری، منسوخ، رقم واپس — اور ٹیسٹ کریں کہ ہر تبدیلی کی بالکل ایک وجہ ہو۔ سب سے مہنگا بگ پکڑنے والا ٹیسٹ وہ ہے جو یقینی بنائے کہ جس بکنگ کو سپلائر نے کنفرم نہیں کیا اس کی ادائیگی کاٹی نہیں جا سکتی، اور کوئی کنفرم بکنگ ادائیگی کے ریکارڈ کے بغیر موجود نہیں ہو سکتی۔

آخر میں، ٹیسٹ رن کا اصلی ٹکٹنگ تک پہنچنا ناممکن بنا دیں۔ غیر متوقع نہیں؛ ناممکن۔ اسٹارٹ اپ پر ایک چیک جو پروڈکشن کریڈنشلز لوڈ ہونے کی صورت میں سوٹ چلانے سے انکار کر دے، ایک لائن کا خرچ ہے اور انٹیگریشن ٹیم کی بدترین صبح سے بچاتا ہے۔

غلطی کی قیمت کیا ہے

ٹریول انٹیگریشن میں چھوٹا ہوا منظرنامہ شاذ و نادر ہی ایرر کی صورت میں سامنے آتا ہے۔ وہ ایک ایسی بکنگ کی صورت میں آتا ہے جو بالکل ٹھیک لگتی ہے۔ ایک ڈپلیکیٹ ٹکٹ جو کسی نے نہیں مانگا اور جسے کسی کو ڈیڈ لائن سے پہلے void کرنا ہے۔ ایک ہوٹل جو ایسی قیمت پر کنفرم ہوا جو اب ایجنسی کو خود برداشت کرنی ہے۔ ایک timeout بکنگ جسے سسٹم نے دوبارہ آزمایا، تو سپلائر دو کمرے ہولڈ کرتا ہے اور دونوں کا بل بھیجتا ہے۔ ایجنسی کے ذریعے بیچے گئے ہوائی ٹکٹ میں، جو جاری ہوا اور جو بیچا گیا ان کا فرق بعد میں ADM کی صورت میں لوٹ سکتا ہے، اس فروخت کا مارجن خرچ ہو جانے کے کافی بعد۔

یہ اخراجات اس کاروبار پر پڑتے ہیں جس نے سفر بیچا، اس ڈیولپر پر نہیں جس نے retry لوپ لکھا۔ لانچ سے پہلے انہیں ٹیسٹ کرنے کی پوری دلیل یہی ہے، بجائے اس کے کہ انہیں ایک ایک سپورٹ ٹکٹ سے سیکھا جائے۔

ہر سپلائر تبدیلی کے بعد کیا smoke test کریں

سپلائرز چیزیں بدلتے ہیں: نیا API ورژن، نیا endpoint، بدلا ہوا کریڈنشل، مختلف کانٹینٹ میپنگ۔ ممکن ہے آپ کا اپنا کوڈ بالکل نہ بدلا ہو۔ پھر بھی یہ فہرست اس ماحول میں چلائیں جو بدلے ہوئے سپلائر سے بات کرتا ہے:

  1. اس سپلائر سے بیچی جانے والی ہر پروڈکٹ کے لیے ایک سرچ، ایسے روٹ یا شہر پر جس کے بارے میں آپ جانتے ہیں کہ نتائج آتے ہیں۔
  2. ہر نتیجہ پارس کریں اور کسی کو خاموشی سے نہ گرائیں؛ اپنی گنتی کا خام جواب کی گنتی سے موازنہ کریں۔
  3. ایک نتیجے کی قیمت شروع سے آخر تک لگائیں اور دکھائے گئے ٹوٹل کا خام کرائے سے اپنے حساب سے موازنہ کریں۔
  4. ٹیسٹ ماحول میں بکنگ کریں، اس کا اسٹیٹس واپس پڑھیں اور ہر وہ فیلڈ ملائیں جو آپ محفوظ کرتے ہیں۔
  5. اسے منسوخ کریں اور تصدیق کریں کہ منسوخی آپ کے ریکارڈز میں بھی نظر آتی ہے اور سپلائر کی طرف بھی۔
  6. اپنے محفوظ بدصورت فکسچرز نئے پارسر سے گزاریں۔
  7. جانچیں کہ timeout اور rate limit اب بھی اسی رویے تک لے جاتے ہیں جو آپ نے طے کیا تھا، کیونکہ نیا ورژن ان کا جواب مختلف دے سکتا ہے۔ اگر رسپانس ٹائم بدل گئے ہیں تو لیٹنسی والی تحریر بتاتی ہے کہ اس کا کون سا حصہ آپ کے ٹھیک کرنے کا ہے۔

اتنی مختصر کہ ہر بار چلائی جا سکے، اور یہی اصل بات ہے۔ جو smoke test کوئی نہیں چلاتا کیونکہ اس میں پورا دن لگتا ہے، وہ smoke test نہیں۔

سینڈ باکس کی اصل جگہ

ان میں سے کوئی بات سینڈ باکس کو کم مفید نہیں بناتی۔ یہ اسے ایماندار بناتی ہے: وہ جگہ جہاں آپ اسکیما سیکھتے ہیں اور تصدیق کرتے ہیں کہ ریکویسٹس درست ہیں، اس سے پہلے کہ فکسچرز اور لائیو چیکس وہ حصے سنبھال لیں جہاں تک وہ نہیں پہنچتا۔ اگر آپ پلیٹ فارم کے فلائٹ اور ہوٹل API کا جائزہ لے رہے ہیں تو رسائی self-service کی کے بجائے ایک گفتگو سے شروع ہوتی ہے — یہ ٹیسٹ پلان اس گفتگو میں ساتھ لائیں اور پوچھیں کہ اوپر کی ٹیبل کی ہر قطار کیسے کور ہوگی۔ جوابات آپ کو کسی API کے بارے میں اس کی دستاویزات سے زیادہ بتائیں گے۔

Tekravel اداریہ

ٹریول ٹیکنالوجی ڈیسک

Tekravel کا ٹریول ٹیکنالوجی ڈیسک پیشہ ور افراد کے لیے لکھتا ہے: ایجنسی مالکان، کنسولیڈیٹرز اور وہ ڈویلپرز جو انہیں مربوط کرتے ہیں۔ ہر مضمون شائع ہونے سے پہلے اُسی پلیٹ فارم پر جانچا جاتا ہے جس کا وہ ذکر کرتا ہے۔