Jev کے ساتھ JavaScript ویلیوز کو بائیں طرف پیڈ کرنے کے لیے jev-leftpad استعمال کریں

jev-leftpad کیا کرتا ہے

jev-leftpad Jev سے یہ منتخب کرنے کو کہہ کر کسی ویلیو کے بائیں جانب پیڈنگ لگاتا ہے کہ کتنی اسپیس شامل کی جائیں۔ یہ جان بوجھ کر غیر معمولی ہے: اگرچہ JavaScript کا built-in padStart() نیٹ ورک ریکویسٹ کے بغیر یہ مسئلہ حل کر سکتا ہے، یہ پیکیج TypeSafe کے native @typesafe-ai/sdk کے ذریعے jev-latest استعمال کرتا ہے۔

ہر کال ایک TypeSafe API ریکویسٹ کرتی ہے۔ Jev space_0 سے space_10 تک نام والے اختیارات میں سے انتخاب کرتا ہے، اور پھر JavaScript منتخب کردہ آپشن کو اسپیسز میں تبدیل کرکے اصل ویلیو کو ان کے بعد رکھتا ہے۔

ضروریات

آپ کو Node.js 20 یا اس کے بعد کا ورژن اور TypeSafe API key درکار ہے۔ پیکیج استعمال کرنے سے پہلے TYPESAFE_API_KEY environment variable ترتیب دیں۔

export TYPESAFE_API_KEY="your-api-key"

Windows PowerShell میں آپ موجودہ سیشن کے لیے یہ variable یوں ترتیب دے سکتے ہیں:

$env:TYPESAFE_API_KEY="your-api-key"

انسٹالیشن

Node.js پروجیکٹ بنائیں یا کھولیں، پھر npm کے ذریعے پیکیج انسٹال کریں:

npm install jev-leftpad

پیکیج اپنی دستاویزی مثال میں ECMAScript module syntax استعمال کرتا ہے، اس لیے یقینی بنائیں کہ آپ کا پروجیکٹ import statements کو سپورٹ کرنے کے لیے ترتیب دیا گیا ہے۔

بنیادی استعمال

default export درآمد کریں اور ویلیو اور target length کے ساتھ leftPad چلائیں۔ چونکہ پیکیج API ریکویسٹ کرتا ہے، اس لیے فنکشن غیر متزامن ہے اور اسے await کرنا ضروری ہے۔

import leftPad from 'jev-leftpad';

const result = await leftPad('jev', 8);

console.log(JSON.stringify(result));
// "     jev" (probably)

target length واپس کی جانے والی ویلیو کی مطلوبہ کل لمبائی ہے۔ اس مثال میں jev کے تین حروف ہیں اور target length آٹھ ہے، اس لیے Jev کو space_5 منتخب کرنا چاہیے۔ پھر JavaScript پانچ اسپیسز بناتا ہے اور ان کے بعد jev رکھتا ہے۔

API کو سمجھنا

leftPad(value, targetLength)

• value: وہ ویلیو جسے پیڈنگ کے بعد رکھنا ہے۔
• targetLength: مطلوبہ target length کی نمائندگی کرنے والا غیر منفی safe integer۔

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

عملی امور

ہر invocation ایک TypeSafe API ریکویسٹ کرتی ہے، اور retries غیر فعال ہیں۔ ریکویسٹ ناکام ہو سکتی ہے، یا Jev غلط آپشن منتخب کر سکتا ہے۔ اس آپریشن کی لاگت بھی JavaScript کے native padStart() سے زیادہ ہے۔

jev-leftpad کو production یا کسی اہم کام کے لیے استعمال نہ کریں۔

عام application code کے لیے اس کے بجائے String.prototype.padStart() استعمال کریں۔ jev-leftpad کو کسی سادہ آپریشن کے AI-backed implementation کے تجربے یا demonstration کے طور پر سمجھنا بہتر ہے۔

ٹیسٹنگ اور ڈیولپمنٹ

پروجیکٹ پر کام کرنے یا اس کے tests چلانے کے لیے development dependencies انسٹال کریں اور test command چلائیں:

npm install
npm test

tests Jev کو mock کرتے ہیں، اس لیے انہیں TypeSafe API key کی ضرورت نہیں ہوتی اور TypeSafe credits خرچ نہیں ہوتے۔ اس طرح live API requests کیے بغیر یہ test suite مقامی ڈیولپمنٹ کے لیے موزوں رہتا ہے۔

نتیجہ

jev-leftpad Jev اور TypeSafe سے چلنے والا غیر متزامن left-padding فنکشن فراہم کرتا ہے۔ اسے npm کے ذریعے انسٹال کریں، TYPESAFE_API_KEY ترتیب دیں، leftPad(value, targetLength) چلائیں، اور اس کی 0 سے 10 اسپیس کی سخت حد اور retries نہ ہونے کو یاد رکھیں۔ قابلِ اعتماد production padding کے لیے built-in padStart() کو ترجیح دیں۔