منصوبے کے بارے میں

یہ ریپوزٹری AWS کے زیرِ انتظام ہے اور اس میں کوڈ کی مثالیں جمع کی گئی ہیں جو دکھاتی ہیں کہ AWS SDKs کو AWS سروسز کے ساتھ تعامل کے لیے کیسے استعمال کیا جائے۔ بہت سی مثالیں براہِ راست سرکاری AWS دستاویزات اور SDK ڈویلپر گائیڈز میں شامل کی جاتی ہیں۔ ترتیب زبان اور SDK ورژن کے لحاظ سے ہے۔ ہر زبان کی اپنی ذیلی ڈائریکٹری ہے، اور کچھ زبانوں میں پرانے اور نئے SDK نسلوں کے لیے الگ الگ فولڈرز ہیں: - .NET: dotnetv3 (SDK 3.5+) اور dotnet (3.5 سے کم) - C++: cpp (SDK 1) - Go: gov2 (SDK 2) اور go (SDK 1) - Java: javav2 (SDK 2) اور java (SDK 1) - JavaScript: javascriptv3 (SDK 3) اور javascript (SDK 2) - Kotlin: kotlin (SDK 1) - PHP: php (SDK 3) - Python: pythonv4 (SDK 4) اور python (SDK 3) - Ruby: ruby (SDK 3) - Rust: rustv1 (SDK 1) - Swift: swift (preview) ہر ڈائریکٹری میں مثالیں سمجھنے اور چلانے کے لیے SDK سے متعلق ہدایات شامل ہیں۔ README میں نوٹ کیا گیا ہے کہ AWS SDK for Java v1.x 31 جولائی 2024 کو maintenance mode میں داخل ہو گیا اور 31 دسمبر 2025 کو end-of-support تک پہنچ جائے گا۔ فی زبان فولڈرز کے علاوہ، اضافی ڈائریکٹریاں بھی ہیں: - applications: مثالی ایپلیکیشنز کے غیر زبان مخصوص اجزاء جو پروڈکشن جیسے منظرناموں میں SDK کے استعمال کو دکھاتے ہیں۔ زبان مخصوص حصے ہر زبان کے cross-service فولڈر میں رہتے ہیں۔ - test: ایک حسبِ ضرورت ٹیسٹ آٹومیشن فریم ورک کی معاونت کرنے والے اجزاء جو معمول کے مطابق ریپوزٹری کوڈ کی جانچ کرتے ہیں، اور AWS پر polyglot کنٹینر پر مبنی انٹیگریشن ٹیسٹنگ حل کے طور پر تعینات کیے جاتے ہیں۔ README اسے 2023 تک ابھی فعال تعمیر کے تحت قرار دیتا ہے۔ - resources: بہت سی مثالوں کے ذریعے استعمال ہونے والے مشترکہ اجزاء، جو فرنٹ اینڈ کلائنٹس یا بیک اینڈ CDK/CloudFormation اجزاء کے طور پر تعینات کیے جاتے ہیں۔ مثالیں چلانے کے لیے AWS اکاؤنٹ اور ترتیب شدہ AWS اسناد درکار ہیں، مثلاً AWS CLI کے ذریعے۔ README میں استعمال سے متعلق ایک ڈس کلیمر شامل ہے: مثالیں ایسی سروسز کے ساتھ تعامل کرتی ہیں جن پر چارجز لگ سکتے ہیں، اور AWS وسائل تخلیق یا حذف کر سکتی ہیں۔ یہ صارفین کو مشورہ دیتا ہے کہ تخلیق یا حذف کیے گئے وسائل، ممکنہ اخراجات سے آگاہ رہیں، اور اہم ڈیٹا کا بیک اپ رکھیں۔ شراکتیں CONTRIBUTING.md گائیڈ کے ذریعے خوش آمدید ہیں۔ مثال کی درخواستیں issue tracker کے ذریعے enhancement ٹیمپلیٹ استعمال کرتے ہوئے جمع کرائی جا سکتی ہیں۔ ٹیم درخواستوں کا جائزہ وضاحت، مطابقت اور عملی امکان کی بنیاد پر کرتی ہے، اور کہتی ہے کہ درخواستیں جلد از جلد، مثالی طور پر بڑی مثالوں کے لیے کم از کم دو ماہ پہلے، دی جائیں۔ بگ فکسز اور سیکیورٹی مسائل کو نئی مثالوں پر ترجیح دی جاتی ہے، اور ساتھ ایک اعلیٰ معیار کی pull request بھیجنے سے درخواست کے حل ہونے کے امکانات بڑھ جاتے ہیں۔ README میں "tributaries" کا بھی ذکر ہے: اضافی ذرائع جن کے کوڈ کی مثالیں AWS دستاویزات میں شامل ہوتی ہیں، جن میں یہ ریپوزٹری، aws-samples/serverless-snippets، اور aws/aws-tools-for-powershell شامل ہیں۔ لائسنسنگ: مواد Amazon Web Services, Inc. یا اس کے ملحقہ اداروں کے کاپی رائٹ کے تحت ہے۔ جب تک بصورتِ دیگر ذکر نہ ہو، مثالیں Apache License 2.0 کے تحت لائسنس یافتہ ہیں، جس کا مکمل متن LICENSE فائل میں ہے۔ README شراکت کاروں سے کہتا ہے کہ جہاں ممکن ہو فائلوں کے اوپر کاپی رائٹ اور SPDX-License-Identifier: Apache-2.0 کمنٹ شامل کریں۔