starlette

إطار عمل ASGI الصغير الذي يلمع.

---

---

التوثيق : https://www.starlette.io

كود المصدر : https://github.com/encode/starlette

---

ستارليت

Starlette عبارة عن إطار/مجموعة أدوات ASGI خفيفة الوزن، وهي مثالية لبناء خدمات ويب غير متزامنة في Python.

إنه جاهز للإنتاج، ويمنحك ما يلي:

• إطار ويب HTTP خفيف الوزن ومنخفض التعقيد.
• دعم ويب سوكيت.
• مهام الخلفية أثناء العملية.
• أحداث بدء التشغيل والإيقاف.
• عميل اختبار مبني على httpx .
• CORS، GZip، الملفات الثابتة، استجابات البث.
• دعم الجلسة وملفات تعريف الارتباط.
• تغطية اختبارية 100%.
• 100% نوع قاعدة التعليمات البرمجية المشروحة.
• عدد قليل من التبعيات الصعبة.
• متوافق مع الواجهات الخلفية asyncio trio .
• أداء عام رائع مقارنة بالمعايير المستقلة.

تثبيت

$ pip install starlette

ستحتاج أيضًا إلى تثبيت خادم ASGI، مثل uvicorn أو daphne أو Hypercorn.

$ pip install uvicorn

مثال

 from starlette . applications import Starlette
from starlette . responses import JSONResponse
from starlette . routing import Route


async def homepage ( request ):
    return JSONResponse ({ 'hello' : 'world' })

routes = [
    Route ( "/" , endpoint = homepage )
]

app = Starlette ( debug = True , routes = routes )

ثم قم بتشغيل التطبيق باستخدام Uvicorn:

$ uvicorn example:app

للحصول على مثال أكثر اكتمالا، راجع مثال التشفير/النجمة.

التبعيات

يتطلب Starlette فقط anyio ، وما يلي اختياري:

• httpx - مطلوب إذا كنت تريد استخدام TestClient .
• jinja2 - مطلوب إذا كنت تريد استخدام Jinja2Templates .
• python-multipart - مطلوب إذا كنت تريد دعم تحليل النموذج باستخدام request.form() .
• itsdangerous - مطلوب لدعم SessionMiddleware .
• pyyaml ​​- مطلوب لدعم SchemaGenerator .

يمكنك تثبيت كل هذه الأشياء باستخدام pip install starlette[full] .

الإطار أو مجموعة الأدوات

تم تصميم Starlette لاستخدامه إما كإطار عمل كامل أو كمجموعة أدوات ASGI. يمكنك استخدام أي من مكوناته بشكل مستقل.

 from starlette . responses import PlainTextResponse


async def app ( scope , receive , send ):
    assert scope [ 'type' ] == 'http'
    response = PlainTextResponse ( 'Hello, world!' )
    await response ( scope , receive , send )

قم بتشغيل تطبيق app في example.py :

$ uvicorn example:app
INFO: Started server process [11509]
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

قم بتشغيل uvicorn باستخدام --reload لتمكين إعادة التحميل التلقائي عند تغيير التعليمات البرمجية.

نمطية

تعمل الوحدة النمطية التي تم تصميم Starlette عليها على تعزيز بناء مكونات قابلة لإعادة الاستخدام والتي يمكن مشاركتها بين أي إطار عمل ASGI. ومن المفترض أن يؤدي ذلك إلى تمكين نظام بيئي من البرامج الوسيطة المشتركة والتطبيقات القابلة للتركيب.

ويعني الفصل النظيف لواجهة برمجة التطبيقات (API) أيضًا أنه من الأسهل فهم كل مكون على حدة.

---

Starlette هو رمز مرخص من BSD.
مصممة ومصنوعة بعناية.
— ️ —