responder

المستجيب: إطار خدمة HTTP مألوف لـ Python

مدعوم من ستارليت. يعد إعلان async هذا اختياريًا. عرض الوثائق.

يمنحك هذا تطبيق ASGI، مع خادم ملفات إنتاج ثابت مثبت مسبقًا، وقوالب Jinja (بدون واردات إضافية)، وخادم ويب إنتاجي يعتمد على uvloop، يخدم الطلبات بضغط gzip تلقائيًا.

الشهادات

"من دواعي سروري أن أتعامل مع python-responder. @kennethreitz في أفضل حالاته على الإطلاق." —رودراكش إم كيه

"ستعمل ASGI على تمكين جميع أنواع خدمات الويب الجديدة عالية الأداء. ومن الرائع أن نرى Responder يبدأ في الاستفادة من ذلك." — توم كريستي مؤلف كتاب Django REST Framework

"يعجبني أنك تستكشف أنماطًا جديدة. انطلق، انطلق!" - داني جرينفيلد، مؤلف كتاب "مغرفتان من جانغو".

المزيد من الأمثلة

راجع جولة ميزات الوثائق للحصول على مزيد من التفاصيل حول الميزات المتوفرة في Responder.

تثبيت المستجيب

قم بتثبيت أحدث إصدار ثابت:

 pip install --upgrade 'responder'

تضمين الدعم لجميع الملحقات والواجهات:

 pip install --upgrade 'responder[full]'

إضافات التثبيت الاختيارية الفردية هي:

• graphql: يضيف دعم GraphQL عبر الجرافين
• openapi: يضيف دعم واجهة OpenAPI/Swagger

أو قم بالتثبيت مباشرة من المستودع:

 pip install 'responder[full] @ git+https://github.com/kennethreitz/responder.git'

المستجيب يدعم بايثون 3.6+ .

الفكرة الأساسية

المفهوم الأساسي هنا هو جلب التفاصيل الدقيقة التي تم تقديمها من كل من Flask وFalcon وتوحيدهما في إطار واحد، بالإضافة إلى بعض الأفكار الجديدة التي لدي. أردت أيضًا أخذ بعض أساسيات واجهة برمجة التطبيقات (API) التي تم غرسها في مكتبة الطلبات ووضعها في إطار عمل الويب. لذلك، ستجد الكثير من أوجه التشابه هنا مع الطلبات.

• يؤدي إعداد resp.content إلى إرسال البايتات مرة أخرى.
• يؤدي ضبط resp.text إلى إرسال Unicode مرة أخرى، بينما يؤدي ضبط resp.html إلى إرسال HTML مرة أخرى.
• يؤدي إعداد resp.media إلى إرسال JSON/YAML ( .text / .html / .content يتجاوز هذا).
• تملي req.headers غير الحساسة لحالة الأحرف (من الطلبات مباشرةً).
• resp.status_code و req.method و req.url وغيرهم من الأصدقاء المألوفين.

أفكار

• تعبير مسار بنمط القارورة، مع إمكانات جديدة - كل ذلك أثناء استخدام بناء جملة f-string الجديد في Python 3.6+.
• أنا أحب منهجية Falcon المتمثلة في "تمرير كل طلب واستجابة إلى كل عرض وتغييره"، وخاصة response.media ، وقد استخدمتها هنا. بالإضافة إلى دعم JSON، قررت دعم YAML أيضًا، حيث يسيطر Kubernetes على العالم ببطء، ويستخدم YAML في كل الأشياء. التفاوض على المحتوى وكل ذلك.
• عميل اختبار مدمج يستخدم الطلبات الفعلية التي تعرفها وتحبها .
• القدرة على تحميل تطبيقات WSGI الأخرى بسهولة.
• ردود gzipped التلقائية.
• بالإضافة إلى أساليب on_get و on_post وغيرها من أساليب Falcon، يتميز Responder بطريقة on_request ، والتي يتم استدعاؤها في كل نوع من أنواع الطلبات، تمامًا مثل الطلبات.
• تم تضمين خادم ملفات ثابت للإنتاج.
• Uvicorn مدمج كخادم ويب للإنتاج. كنت سأختار Gunicorn، لكنه لا يعمل على نظام Windows. بالإضافة إلى ذلك، يعمل Uvicorn بشكل جيد للحماية من هجمات البطيء، مما يجعل nginx غير ضروري في الإنتاج.
• دعم GraphQL عبر الجرافين. الهدف هنا هو جعل أي استعلام GraphQL قابلاً للعرض بأي طريق بطريقة سحرية.
• توفير طريقة رسمية لتشغيل حزمة الويب.

تطوير

راجع وضع الحماية للتطوير.