Boto3 هي مجموعة أدوات تطوير البرامج (SDK) الخاصة بشركة Amazon Web Services (AWS) لـ Python، والتي تتيح لمطوري Python كتابة برامج تستخدم خدمات مثل Amazon S3 وAmazon EC2. يمكنك العثور على أحدث وأحدث الوثائق على موقع المستندات الخاص بنا، بما في ذلك قائمة الخدمات المدعومة.
تتم صيانة Boto3 ونشره بواسطة Amazon Web Services.
تم تسمية Boto (تُنطق boh-toh) على اسم دلفين المياه العذبة الذي يعيش في نهر الأمازون. تم اختيار الاسم من قبل مؤلف مكتبة بوتو الأصلية، ميتش جارنات، كمرجع للشركة.
في 13-12-2023، انتهى دعم Python 3.7 لـ Boto3. يأتي ذلك بعد انتهاء دعم Python Software Foundation لوقت التشغيل والذي حدث بتاريخ 27-06-2023. لمزيد من المعلومات، راجع منشور المدونة هذا.
بافتراض أن لديك إصدارًا مدعومًا من Python مثبتًا، يمكنك أولاً إعداد بيئتك باستخدام:
$ python -m venv .venv
...
$ . .venv/bin/activateبعد ذلك، يمكنك تثبيت boto3 من PyPI باستخدام:
$ python -m pip install boto3أو التثبيت من المصدر باستخدام:
$ git clone https://github.com/boto/boto3.git
$ cd boto3
$ python -m pip install -r requirements.txt
$ python -m pip install -e .بعد تثبيت boto3
بعد ذلك، قم بإعداد بيانات الاعتماد (على سبيل المثال ~/.aws/credentials ):
[default]
aws_access_key_id = YOUR_KEY
aws_secret_access_key = YOUR_SECRET ثم قم بإعداد المنطقة الافتراضية (على سبيل المثال ~/.aws/config ):
[default]
region =us-east-1يمكن العثور على طرق تكوين بيانات الاعتماد الأخرى هنا
ثم من مترجم بايثون:
>> > import boto3
>> > s3 = boto3 . resource ( 's3' )
>> > for bucket in s3 . buckets . all ():
print ( bucket . name ) يمكنك إجراء الاختبارات في جميع إصدارات Python المدعومة باستخدام tox . افتراضيًا، سيتم تشغيل جميع اختبارات الوحدة والوظائف، ولكن يمكنك أيضًا تحديد خيارات pytest الخاصة بك. لاحظ أن هذا يتطلب تثبيت كافة الإصدارات المدعومة من Python، وإلا فيجب عليك تمرير -e أو تشغيل الأمر pytest مباشرة:
$ tox
$ tox -- unit/test_session.py
$ tox -e py26,py33 -- integration/يمكنك أيضًا إجراء اختبارات فردية باستخدام إصدار Python الافتراضي الخاص بك:
$ pytest tests/unitنحن نستخدم مشكلات GitHub لتتبع الأخطاء وطلبات الميزات ولدينا نطاق ترددي محدود لمعالجتها. يرجى استخدام موارد المجتمع هذه للحصول على المساعدة:
نحن نقدر ردود الفعل والمساهمات من مجتمعنا. سواء كان ذلك تقرير خطأ، أو ميزة جديدة، أو تصحيحًا، أو وثائق إضافية، فإننا نرحب بمشكلاتك ونطلب طلباتك. يرجى قراءة مستند المساهمة هذا قبل إرسال أي مشكلات أو سحب الطلبات للتأكد من أن لدينا جميع المعلومات اللازمة للرد بشكل فعال على مساهمتك.
أصبح Boto3 متاحًا بشكل عام في 22/06/2015 وهو حاليًا في مرحلة الدعم الكامل لدورة حياة التوفر.
للحصول على معلومات حول الصيانة والدعم للإصدارات الرئيسية من SDK وتبعياتها الأساسية، راجع ما يلي في دليل AWS SDKs والأدوات المشتركة للتكوين وبيانات الاعتماد:
