Awesome Jev کیا ہے؟
Awesome Jev اوپن سورس منصوبوں کی ایک منتخب ڈائریکٹری ہے، جو TypeSafe Jev کے ساتھ بنائے گئے ہیں۔ اس کیٹلاگ میں 59 منصوبے شامل ہیں، جن میں کلائنٹ SDKs، ایپلیکیشن انٹیگریشنز، ڈویلپر ٹولز، سرچ سسٹمز، صارفین کے لیے ایپلیکیشنز اور تحقیق شامل ہیں۔
یہ منصوبے عام آزاد متن کی تخلیق کے بجائے ٹائپ شدہ فیصلوں کے لیے Jev استعمال کرتے ہیں۔ منصوبے کے لحاظ سے یہ فیصلے درجہ بندی، اسکورنگ، رینکنگ، روٹنگ، تصدیق، فلٹرنگ اور کارروائی کے انتخاب جیسے کاموں میں مدد دیتے ہیں۔
Awesome Jev ایک آزاد منصوبہ ہے اور TypeSafe سے وابستہ نہیں ہے۔ ڈائریکٹری میں شمولیت کسی سرٹیفیکیشن کی ضمانت نہیں ہے۔
ڈائریکٹری کی اہم خصوصیات
- منظم کیٹلاگ: منصوبوں کو SDKs، انٹیگریشنز، ڈویلپر ٹولز، سرچ، ایپلیکیشنز اور تحقیق میں تقسیم کیا گیا ہے۔
- جائزہ شدہ گذارشات: ہر جمع کرائے گئے منصوبے کا الگ سے جائزہ لیا جاتا ہے، پھر منتظمین فیصلہ کرتے ہیں کہ اسے ضم کیا جائے یا نہیں۔
- ماخذ پر مبنی توثیق: Jev Review Action ماخذ کے شواہد، منصوبے کی تفصیلات اور سیٹ اپ کی ہدایات کی جانچ کرتا ہے۔
- ٹائپ شدہ جائزہ فیصلے: Jev منظم فیصلے فراہم کرتا ہے، جبکہ ریپوزٹری کا کوڈ جائزے کا تبصرہ تیار کرتا ہے۔
- وسیع زبانوں کی معاونت: SDK سیکشن میں Python، JavaScript اور TypeScript، Go، Rust، Ruby، PHP، Swift، Elixir، .NET، Scala اور دیگر ایکوسسٹمز شامل ہیں۔
- اوپن تعاون کا عمل: معاونین ایک پل ریکویسٹ میں زیادہ سے زیادہ دس منصوبوں کے اندراجات تجویز کر سکتے ہیں۔
سیٹ اپ اور رسائی
کیٹلاگ کا استعمال
Awesome Jev ایک ڈائریکٹری ہے، اس لیے صرف اسے دیکھنے کے لیے کچھ انسٹال کرنے کی ضرورت نہیں۔ ریپوزٹری کھولیں، کوئی زمرہ منتخب کریں اور کسی منصوبے کے لنک کی پیروی کرتے ہوئے اس کی ماخذ ریپوزٹری تک پہنچیں۔
انسٹالیشن کی ضروریات ہر فہرست شدہ منصوبے سے متعلق ہیں۔ کوئی منصوبہ منتخب کرنے کے بعد پیکیج کی انسٹالیشن، API کی تشکیل، معاون ماحول اور استعمال کی ہدایات کے لیے اس کی اپنی README دیکھیں۔ یہ فرض نہ کریں کہ تمام منصوبوں کا سیٹ اپ ایک جیسا یا لائسنس ایک ہی ہے۔
تعاون کے لیے تیاری
کسی منصوبے کو شامل کرنے کے لیے ریپوزٹری کی تعاون کی رہنما دستاویز سے آغاز کریں۔ آپ ایک پل ریکویسٹ میں زیادہ سے زیادہ دس اندراجات شامل کر سکتے ہیں۔ ماخذ کے راستے اختیاری ہیں کیونکہ جائزہ لینے والا انٹیگریشن کوڈ خودکار طور پر تلاش کر سکتا ہے۔
- تصدیق کریں کہ منصوبہ اوپن سورس ہے اور TypeSafe Jev کے ساتھ بنایا گیا ہے۔
- متوقع گذارشاتی فارمیٹ کے لیے تعاون کی رہنما دستاویز پڑھیں۔
- ایسی مختصر تفصیل لکھیں جو ماخذ کوڈ کے حقیقی کام کی عکاسی کرے۔
- پل ریکویسٹ میں دس سے زیادہ منصوبوں کے اندراجات شامل نہ کریں۔
- پل ریکویسٹ جمع کرائیں اور خودکار نتائج کا جائزہ لیں۔
- ماخذ کے شواہد، سیٹ اپ کی ہدایات، تفصیلات یا زمرہ بندی سے متعلق مسائل حل کریں۔
مدد درکار ہو تو ریپوزٹری کا گذارشاتی مدد کا مسئلہ ٹیمپلیٹ استعمال کریں۔
درست Jev منصوبہ کیسے تلاش کریں
مرحلہ 1: اپنے استعمال کے معاملے سے آغاز کریں
کیٹلاگ کو محدود کرنے کا تیز ترین طریقہ زمرے ہیں:
- SDKs: جب TypeSafe کے ٹائپ شدہ فیصلہ API کو براہ راست ایپلیکیشن کوڈ میں شامل کرنا ہو تو یہ منتخب کریں۔
- انٹیگریشن: کسی موجودہ فریم ورک، پروٹوکول، ڈیٹابیس، براؤزر ورک فلو یا ایجنٹ سسٹم سے Jev جوڑنے کے لیے یہاں سے آغاز کریں۔
- ڈویلپر ٹولز: کوڈ ریویو، ریپوزٹری سرچ، CI چیکس، ٹیسٹ کے انتخاب، ٹول آؤٹ پٹ فلٹرنگ اور کوڈنگ ایجنٹ ورک فلو کے لیے یہ سیکشن دیکھیں۔
- سرچ: دستاویزات کی دوبارہ رینکنگ، ویب سرچ کے فیصلوں یا گراف نیویگیشن کے لیے ان منصوبوں کو استعمال کریں۔
- ایپلیکیشنز: براؤزر ایجنٹس، ٹریڈنگ ایپلیکیشنز، پلے گراؤنڈز اور کمپیوٹر استعمال کرنے والے ٹولز جیسی مکمل مصنوعات اور مظاہروں کا جائزہ لیں۔
- تحقیق: نقلِ نو، بینچ مارکس، ریکویسٹ اسکیماؤں اور ماڈل کے موازنے کا مطالعہ کرنے کے لیے یہ سیکشن استعمال کریں۔
مرحلہ 2: درست نفاذی سطح منتخب کریں
اگر آپ کوئی حسبِ ضرورت ایپلیکیشن بنا رہے ہیں تو SDK عموماً سب سے براہ راست نقطۂ آغاز ہوتا ہے۔ کیٹلاگ میں سرکاری JavaScript اور TypeScript اور Python کلائنٹس کے ساتھ کئی دوسری زبانوں کے کمیونٹی نفاذ بھی شامل ہیں۔
اگر آپ کے ماحول میں پہلے سے کوئی مخصوص انٹیگریشن موجود ہے تو اسے ابتدا ہی سے استعمال کریں۔ مثال کے طور پر، کیٹلاگ میں Home Assistant، Hono، Laravel، Rails، PostgreSQL، RubyLLM، MCP کلائنٹس اور براؤزر آٹومیشن کے لیے انٹیگریشنز درج ہیں۔
مرحلہ 3: منصوبے کی تفصیلات کی تصدیق کریں
فہرست شدہ منصوبہ اختیار کرنے سے پہلے اس کی ریپوزٹری کھولیں اور دستاویزات اور ماخذ کا جائزہ لیں۔ انسٹالیشن کے مراحل، دیکھ بھال کی حالت، معاون API رویے اور لائسنس کی جانچ کریں۔ Awesome Jev ریپوزٹری واضح طور پر بتاتی ہے کہ فہرست شدہ منصوبے اپنے لائسنس برقرار رکھتے ہیں۔
بنیادی استعمال کی مثالیں
مثال 1: ایپلیکیشن SDK منتخب کرنا
فرض کریں کہ آپ Python سروس میں ٹائپ شدہ Jev فیصلے چاہتے ہیں۔ SDKs پر جائیں اور سرکاری TypeSafe Python SDK کا موازنہ jevclient کے نام سے درج غیر ہم وقت ساز کمیونٹی کلائنٹ سے کریں۔ کیٹلاگ کی تفصیلات ان کے اعلیٰ سطحی کردار واضح کرتی ہیں، لیکن اصل انسٹالیشن اور API کی ہدایات ان کی انفرادی ریپوزٹریز میں موجود ہیں۔
مقصد: Python سروس میں Jev شامل کرنا
زمرہ: SDKs
امیدوار: TypeSafe Python SDK، jevclient
اگلا مرحلہ: ان کی ریپوزٹری دستاویزات اور کلائنٹ ماڈلز کا موازنہ کریںمثال 2: ترقیاتی ورک فلو میں معنوی جانچ شامل کرنا
پل ریکویسٹ کے جائزے یا مقامی Git جانچ کے لیے Developer tools سیکشن دیکھیں۔ متعلقہ مثالوں میں Jev Review، Jev Review Action، jev-git، jev-pref، Leanest، اور Supercov شامل ہیں۔ ان کی وضاحتیں کوڈ کے جائزے، اسٹیج کیے گئے فرق کی جانچ، ترجیحات کے نفاذ، ٹیسٹ کے انتخاب، اور سورس کے معیار کے جائزے میں فرق واضح کرتی ہیں۔
مقصد: اسٹیج کی گئی تبدیلیوں میں خطرناک مواد کی جانچ
زمرہ: Developer tools
امیدوار: jev-git
وجہ: اس کے کیٹلاگ کے اندراج میں pre-commit اور pre-push جانچ کی وضاحت ہےمثال 3: تلاش کے نتائج کی درجہ بندی
دستاویز کی مطابقت کے لیے Search سیکشن میں hev reranker شامل ہے، جو ایک Python لائبریری ہے۔ یہ امیدوار دستاویزات کے اسکور کے لیے Jev Noul کے فیصلے استعمال کرتی ہے، پھر انہیں ترتیب دیتی یا فلٹر کرتی ہے۔ Jev Search ایک وسیع تر ورک فلو کو پورا کرتا ہے، جس میں نتائج کی درجہ بندی سے پہلے ذرائع، وقت کی حدود، اور استفسار کے امیدوار منتخب کیے جاتے ہیں۔
مثال 4: موجودہ فریم ورک انٹیگریشن تلاش کرنا
اگر آپ کی ایپلیکیشن PostgreSQL استعمال کرتی ہے تو pg_typesafe کا جائزہ لیں، جو Choice، Noul، اور Score آپریشنز کے لیے SQL سے Jev کو کال کرتا ہے، جن میں بیچ کی صورت میں شناخت اور درجہ بندی بھی شامل ہے۔ Laravel ایپلیکیشن کے لیے کیٹلاگ میں ٹائپ شدہ جوابات، غیر ہم وقت درخواستوں، محدود دائرہ کار والی dependency injection، اور ٹیسٹنگ fakes کے ساتھ ایک غیر سرکاری انٹیگریشن درج ہے۔
جائزے کے عمل کو سمجھنا
ریپوزٹری جمع کرائی گئی تجاویز کے جائزے میں مدد کے لیے Jev Review Action استعمال کرتی ہے۔ یہ ایکشن سورس کے شواہد کی جانچ کرتا ہے، مجوزہ وضاحت اور سیٹ اپ کی ہدایات کا جائزہ لیتا ہے، اور ایک زمرہ تجویز کرتا ہے۔
یہ عمل مشینی فیصلے کو ریپوزٹری کی حکمرانی سے الگ رکھتا ہے:
- جمع کرایا گیا کوڈ اور دستاویزات شواہد فراہم کرتے ہیں۔
- Jev جمع کرائی گئی تجویز کے بارے میں ٹائپ شدہ فیصلے واپس کرتا ہے۔
- ریپوزٹری کا کوڈ ان فیصلوں کو جائزے کے تبصرے میں تبدیل کرتا ہے۔
- مینٹینرز حتمی merge کا فیصلہ کرتے ہیں۔
مزید تفصیل کے لیے جائزے کی پالیسی اور ریپوزٹری کے توثیقی ریکارڈز دیکھیں۔
اعلیٰ درجے کی تجاویز
سرکاری اور کمیونٹی پروجیکٹس میں فرق کریں
کچھ اندراجات کو واضح طور پر سرکاری کلائنٹس کے طور پر شناخت کیا گیا ہے، جبکہ دیگر کو کمیونٹی یا آزاد implementations کے طور پر بیان کیا گیا ہے۔ معاونت سے متعلق توقعات کا جائزہ لیتے وقت ان لیبلز کو استعمال کریں، لیکن ہر پروجیکٹ کی ریپوزٹری میں موجودہ حیثیت کی پھر بھی تصدیق کریں۔
پروجیکٹس کا فیصلہ سازی کے انداز سے موازنہ کریں
زمرے بتاتے ہیں کہ پروجیکٹ کہاں موزوں ہے، جبکہ وضاحتیں ظاہر کرتی ہیں کہ یہ Jev کو کیسے استعمال کرتا ہے۔ routing، ranking، verification، classification، اسکور پر مبنی filtering، tool gating، اور action selection جیسے بار بار آنے والے انداز تلاش کریں۔ ان انداز کی بنیاد پر پروجیکٹس کا موازنہ مختلف زبانیں استعمال کرنے کے باوجود قابلِ دوبارہ استعمال معماری کے خیالات سامنے لا سکتا ہے۔
مطابقت سمجھنے کے لیے تحقیقی پروجیکٹس استعمال کریں
تحقیقی سیکشن میں LitJev شامل ہے، جو ایک اوپن reproduction ہے اور choice، score، اور noul آپریشنز کے لیے Jev کے /v1/systemone درخواست اور جواب کے schema کو فراہم کرتا ہے۔ اس میں TypeSafe Jev کا Qwen کے ساتھ متعدد مصنوعی workloads پر موازنہ کرنے والا benchmark بھی شامل ہے۔ انہیں تحقیقی وسائل سمجھیں اور implementation یا کارکردگی کے نتائج اخذ کرنے سے پہلے ان کی ریپوزٹریز دیکھیں۔
جمع کرانے سے پہلے سیٹ اپ کی دستاویزات کی توثیق کریں
چونکہ جائزے کا عمل سیٹ اپ کی ہدایات کا بھی معائنہ کرتا ہے، اس لیے یقینی بنائیں کہ صارفین سمجھ سکیں کہ آپ کے پروجیکٹ کو کیسے چلانا یا انٹیگریٹ کرنا ہے۔ کیٹلاگ کی وضاحت کو محدود اور شواہد پر مبنی رکھیں، اور ایسی صلاحیتوں کا دعویٰ نہ کریں جن کا سورس مظاہرہ نہیں کرتا۔
لائسنس کا الگ سے جائزہ لیں
Awesome Jev خود MIT لائسنس کے تحت ہے، لیکن یہ لائسنس درج شدہ پروجیکٹس پر خودکار طور پر لاگو نہیں ہوتا۔ اس کا کوڈ استعمال، ترمیم، یا دوبارہ تقسیم کرنے سے پہلے ہر منتخب ریپوزٹری کا لائسنس چیک کریں۔
نتیجہ
Awesome Jev، TypeSafe Jev کے اوپن سورس ماحولیاتی نظام کا ایک عملی نقشہ فراہم کرتا ہے۔ اپنے استعمال کے معاملے سے مطابقت رکھنے والے زمرے سے آغاز کریں، پروجیکٹس کی وضاحتوں کا موازنہ کریں، پھر اصل ریپوزٹری میں انسٹالیشن، API کے رویے، دیکھ بھال، اور لائسنس کی تصدیق کریں۔ اگر آپ نے مطلوبہ معیار پر پورا اترنے والا پروجیکٹ بنایا ہے تو تعاون کی رہنما ہدایات پر عمل کریں اور اسے شامل کرنے کی تجویز دینے کے لیے شواہد پر مبنی جائزے کا عمل استعمال کریں۔