عین مطابق یونٹ ٹیسٹنگ منظرناموں کے لیے لانچ ڈارکلی جھنڈوں کو ترتیب دینا

یونٹ ٹیسٹنگ میں سیاق و سباق پر مبنی پرچم کی تشخیص میں مہارت حاصل کرنا

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

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

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

ایک حقیقی دنیا کی مثال سے گزر کر، ہم یونٹ ٹیسٹوں میں OpenFeature کے ساتھ LaunchDarkly's SDK استعمال کرنے کے لیے چیلنجوں اور حلوں کو کھولیں گے۔ عملی اقدامات اور مثالوں کے ساتھ، آپ سیاق و سباق سے چلنے والے پرچم کی تشخیص کے فن میں مہارت حاصل کر لیں گے اور اپنی جانچ کی مہارت کو اگلے درجے تک لے جائیں گے۔ 🚀

سیاق و سباق کے مخصوص فلیگ ٹیسٹنگ کے میکانکس کی نقاب کشائی

اوپر کی مثال میں، پہلا اسکرپٹ گو میں بیک اینڈ پر عمل درآمد ہے جسے لانچ ڈارکلی فلیگ کی تشخیص کو سنبھالنے کے لیے ڈیزائن کیا گیا ہے۔ یونٹ ٹیسٹنگ. مقصد یہ ہے کہ متحرک صارف کے سیاق و سباق کی بنیاد پر مختلف فلیگ رویوں کی تقلید کی جائے، جس سے الگ تھلگ مختلف منظرناموں کی جانچ ممکن ہو سکے۔ اسکرپٹ کا آغاز `ldtestdata.DataSource()` کمانڈ کا استعمال کرتے ہوئے ایک ٹیسٹ ڈیٹا سورس بنانے سے ہوتا ہے، جو ہمیں پروگرام کے مطابق فیچر فلیگ سیٹنگز کی وضاحت اور ترمیم کرنے کی اجازت دیتا ہے۔ یہ اس بات کو یقینی بناتا ہے کہ ٹیسٹ کے ماحول کو حقیقی دنیا کی ترتیب کو نقل کرنے کے لیے موزوں بنایا جا سکتا ہے۔ 📊

اسٹینڈ آؤٹ کمانڈز میں سے ایک 'VariationForKey()' ہے، جو صارف کی خصوصیات کے لیے مخصوص پرچم کی مختلف حالتوں کا نقشہ بناتا ہے۔ ہمارے معاملے میں، ہم اس بات کو یقینی بنانے کے لیے استعمال کرتے ہیں کہ "غیر فعال-پرچم" کی خصوصیت والے صارفین کے لیے 'جھوٹے' کا اندازہ 'سچ' پر سیٹ کیا جاتا ہے، جب کہ 'فال تھرو ویری ایشن()' کا استعمال کرنے والے دوسروں کے لیے 'سچ' پر ڈیفالٹ کرتے ہیں۔ یہ سیٹ اپ ایک عملی منظر نامے کی عکاسی کرتا ہے جہاں بیٹا خصوصیات بعض صارفین کے لیے غیر فعال ہیں لیکن باقی آبادی کے لیے فعال ہیں۔ ان کمانڈز کو یکجا کر کے، ہم ٹیسٹوں میں حقیقت پسندانہ خصوصیت کے جھنڈے کے رویے کی تقلید کے لیے ایک مضبوط طریقہ کار بناتے ہیں۔

Node.js میں لکھا گیا دوسرا اسکرپٹ LaunchDarkly SDK کا استعمال کرتے ہوئے فرنٹ اینڈ یا مڈل ویئر ایپلی کیشنز پر فوکس کرتا ہے۔ یہ مختلف حالتوں اور ہدف کے اصولوں کے ساتھ جھنڈوں کو متحرک طور پر ترتیب دینے کے لیے `testData.updateFlag()` کمانڈ استعمال کرتا ہے۔ مثال کے طور پر، ہم مخصوص حسب ضرورت اوصاف کے ساتھ صارفین کو نشانہ بناتے ہیں، جیسے "غیر فعال-پرچم،" جھنڈے کی تشخیص کے رویے کو تبدیل کرنے کے لیے۔ یہ متحرک کنفیگریشن خاص طور پر ایسے ماحول میں مفید ہے جہاں فیچر ٹوگلز کو اکثر اپ ڈیٹ کیا جاتا ہے یا مختلف منظرناموں کے تحت جانچنے کی ضرورت ہوتی ہے۔ فیچر رول آؤٹ کے دوران ہموار صارف کے تجربات کو یقینی بنانے کے لیے یہ انتہائی موثر ہے۔ 🚀

دونوں اسکرپٹ استعمال کرنے کی اہم اہمیت کو ظاہر کرتے ہیں۔ سیاق و سباق سے چلنے والے پرچم کی تشخیص. گو عمل درآمد طاقتور ڈیٹا سورس ہیرا پھیری کے ساتھ سرور سائیڈ کنٹرول کو ظاہر کرتا ہے، جبکہ Node.js مثال کلائنٹ سائیڈ پر متحرک فلیگ اپ ڈیٹس کو نمایاں کرتی ہے۔ ایک ساتھ، یہ نقطہ نظر لانچ ڈارکلی جھنڈوں کے ذریعے ٹوگل کردہ خصوصیات کی جانچ کے لیے ایک جامع حل فراہم کرتے ہیں۔ چاہے آپ تجرباتی خصوصیات کو تیار کرنے والے ڈویلپر ہوں یا پیچیدہ منظرناموں کو ڈیبگ کر رہے ہوں، یہ اسکرپٹس قابل اعتماد اور سیاق و سباق سے آگاہ ٹیسٹنگ ورک فلو کی بنیاد کے طور پر کام کرتی ہیں۔ 💡

package main

import (
    "context"
    "fmt"
    "time"
    ld "github.com/launchdarkly/go-server-sdk/v7"
    "github.com/launchdarkly/go-server-sdk/v7/ldcomponents"
    "github.com/launchdarkly/go-server-sdk/v7/testhelpers/ldtestdata"
)

// Create a test data source and client
func NewTestClient() (*ldtestdata.TestDataSource, *ld.LDClient, error) {
    td := ldtestdata.DataSource()
    config := ld.Config{
        DataSource: td,
        Events:     ldcomponents.NoEvents(),
    }
    client, err := ld.MakeCustomClient("test-sdk-key", config, 5*time.Second)
    if err != nil {
        return nil, nil, err
    }
    return td, client, nil
}

// Configure the test flag with variations
func ConfigureFlag(td *ldtestdata.TestDataSource) {
    td.Update(td.Flag("feature-flag")
        .BooleanFlag()
        .VariationForKey("user", "disable-flag", false)
        .FallthroughVariation(true))
}

// Simulate evaluation based on context
func EvaluateFlag(client *ld.LDClient, context map[string]interface{}) bool {
    evalContext := ld.ContextBuild(context["kind"].(string)).SetAnonymous(true).Build()
    value, err := client.BoolVariation("feature-flag", evalContext, false)
    if err != nil {
        fmt.Println("Error evaluating flag:", err)
        return false
    }
    return value
}

func main() {
    td, client, err := NewTestClient()
    if err != nil {
        fmt.Println("Error creating client:", err)
        return
    }
    defer client.Close()
    ConfigureFlag(td)
    testContext := map[string]interface{}{
        "kind":         "user",
        "disable-flag": true,
    }
    result := EvaluateFlag(client, testContext)
    fmt.Println("Feature flag evaluation result:", result)
}

const LaunchDarkly = require('launchdarkly-node-server-sdk');

async function setupClient() {
    const client = LaunchDarkly.init('test-sdk-key');
    await client.waitForInitialization();
    return client;
}

async function configureFlag(client) {
    const data = client.testData();
    data.updateFlag('feature-flag', {
        variations: [true, false],
        fallthrough: { variation: 0 },
        targets: [
            { variation: 1, values: ['disable-flag'] }
        ]
    });
}

async function evaluateFlag(client, context) {
    const value = await client.variation('feature-flag', context, false);
    console.log('Flag evaluation result:', value);
    return value;
}

async function main() {
    const client = await setupClient();
    await configureFlag(client);
    const testContext = {
        key: 'user-123',
        custom: { 'disable-flag': true }
    };
    await evaluateFlag(client, testContext);
    client.close();
}

main().catch(console.error);

اعلی درجے کی سیاق و سباق کی ترتیب کے ساتھ لانچ ڈارکلی ٹیسٹنگ کو بڑھانا

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

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

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