البرمجة

تطوير تطبيقات ويب باستخدام Bottle

اخر تحديث 10/06/2025
13 تمت قراءة 4 دقيقة

كيف تستخدم الإطار المصغر Bottle لتطوير تطبيقات Python للويب

في عالم تطوير تطبيقات الويب باستخدام لغة Python، ظهرت العديد من الأطر التي تهدف إلى تسهيل بناء التطبيقات من خلال توفير الأدوات والمكتبات الضرورية لمعالجة الطلبات، إدارة الجلسات، التوجيه، وتقديم الاستجابات للمستخدم. من بين هذه الأطر تبرز أطر خفيفة الوزن تعرف بـ “الميكروفريمورك” أو الأطر المصغّرة، وهي مصممة لتكون بسيطة، سهلة الاستخدام، ومثالية للتطبيقات الصغيرة والمتوسطة. يعد إطار Bottle أحد أشهر هذه الأطر، إذ يتميز بمرونته وسهولة تكامله مع التطبيقات الأخرى وبساطته التي تجعله خيارًا مفضلًا للمبتدئين والمحترفين على حد سواء.

نظرة عامة على Bottle

Bottle هو إطار عمل صغير الحجم مخصص لتطوير تطبيقات الويب باستخدام Python. يتميز بأنه يتكون من ملف واحد فقط ولا يحتوي على تبعيات خارجية، ما يجعله خيارًا ممتازًا للتطبيقات الصغيرة أو لأغراض التعلم والتعليم. رغم بساطته، يوفر Bottle جميع الوظائف الأساسية التي يحتاجها مطور الويب، مثل التوجيه (Routing)، التعامل مع الطلبات والاستجابات (Requests & Responses)، القوالب (Templates)، وملفات static.

مواضيع ذات صلة

أهم خصائص إطار Bottle

الخاصية الوصف
التوجيه (Routing) دعم كامل لتحديد المسارات ومعالجتها عبر Decorators
الاستجابة والطلب واجهة مبسطة للتعامل مع بيانات الطلب واسترجاع استجابات مخصصة
دعم قوالب مدمج محرك قوالب مدمج (SimpleTemplateEngine) مع إمكانية استخدام محركات خارجية
لا يحتاج إلى إعداد معقد يمكن تشغيل التطبيق بسطر واحد وبدون ملفات إعداد معقدة
خفيف وسهل التوزيع يتكون من ملف واحد يمكن تضمينه في أي مشروع بدون الحاجة لتثبيت مكتبات ضخمة

تثبيت إطار Bottle

يمكن تثبيت Bottle بسهولة باستخدام أداة pip:

bash
pip install bottle

أو يمكن تحميل الملف bottle.py ونسخه مباشرة إلى مجلد المشروع، مما يتيح دمجه ضمن أي مشروع بدون الاعتماد على مدير الحزم.

إنشاء تطبيق ويب بسيط باستخدام Bottle

يُعد تطوير تطبيق بسيط باستخدام Bottle أمرًا مباشرًا، ويبدأ بكتابة مسار (Route) يُعالج الطلبات الموجهة إلى عنوان معين في التطبيق.

python
from bottle import route, run

@route('/')
def index():
    return "مرحبًا بك في تطبيق Bottle!"

run(host='localhost', port=8080, debug=True)

بمجرد تشغيل هذا الملف، يمكن فتح المتصفح والانتقال إلى http://localhost:8080/ لرؤية النتيجة.

التوجيه (Routing)

يُستخدم التوجيه في Bottle لتحديد كيفية التعامل مع الطلبات التي تصل إلى عناوين URL محددة. ويُستخدم لذلك الـ decorator @route() لتحديد المعالج المناسب لكل مسار.

أمثلة على التوجيه:

python
@route('/hello/')
def greet(name):
    return f"أهلاً، {name}!"

يمكن إضافة قيود على المتغيرات باستخدام التعبيرات النظامية (Regex):

python
@route('/item/')
def show_item(item_id):
    return f"عرض العنصر برقم: {item_id}"

التعامل مع الطلبات والاستجابات

يوفر Bottle واجهات سهلة للتعامل مع بيانات الطلب (POST, GET, Cookies, Headers) بالإضافة إلى تخصيص الاستجابات.

الوصول إلى بيانات GET:

python
from bottle import request

@route('/search')
def search():
    query = request.query.q
    return f"نتائج البحث عن: {query}"

معالجة بيانات POST:

python
from bottle import post

@post('/submit')
def submit():
    name = request.forms.get('name')
    return f"تم استلام الاسم: {name}"

تعديل الاستجابة:

python
from bottle import response

@route('/json')
def json_response():
    response.content_type = 'application/json'
    return '{"status": "ok"}'

استخدام ملفات HTML وقوالب العرض

يدعم Bottle محرك قوالب مدمج يُعرف بـ SimpleTemplateEngine أو stpl، وهو يسمح بالفصل بين منطق التطبيق والعرض.

مثال على قوالب stpl:

ملف القالب: views/hello.tpl

html
html>
<html>
  <head><title>تحيةtitle>head>
  <body>
    <h1>مرحبًا، {{name}}!h1>
  body>
html>

ملف التطبيق:

python
from bottle import template

@route('/hello/')
def hello(name):
    return template('views/hello', name=name)

تقديم ملفات static (مثل الصور، CSS، JavaScript)

Bottle يوفر طريقة لتقديم الملفات الثابتة عبر المسارات باستخدام static_file.

python
from bottle import static_file

@route('/static/')
def serve_static(filename):
    return static_file(filename, root='static')

التعامل مع الأخطاء

يوفر إطار Bottle آلية لمعالجة الأخطاء باستخدام @error() decorator:

python
from bottle import error

@error(404)
def error404(error):
    return 'الصفحة غير موجودة'

يمكن تخصيص استجابات الأخطاء المختلفة بنفس الطريقة، مما يساعد على تحسين تجربة المستخدم.

دعم الجلسات (Sessions)

رغم أن Bottle لا يوفر دعمًا مدمجًا للجلسات، يمكن استخدام مكتبات مثل Beaker لإضافة هذه الميزة. مثال على ذلك:

bash
pip install beaker

python
from bottle import request, response
from beaker.middleware import SessionMiddleware
from bottle import route, run, app

session_opts = {
    'session.type': 'memory',
    'session.auto': True
}

app = SessionMiddleware(app(), session_opts)

@route('/set/')
def set_session(name):
    s = request.environ.get('beaker.session')
    s['name'] = name
    s.save()
    return 'تم حفظ الاسم في الجلسة'

@route('/get')
def get_session():
    s = request.environ.get('beaker.session')
    return f"الاسم في الجلسة: {s.get('name', 'غير موجود')}"

ربط Bottle بقواعد البيانات

يُمكن استخدام أي مكتبة خارجية لقواعد البيانات مثل sqlite3 أو SQLAlchemy مع Bottle.

مثال باستخدام sqlite3:

python
import sqlite3
from bottle import route

@route('/users')
def list_users():
    conn = sqlite3.connect('users.db')
    cursor = conn.cursor()
    cursor.execute('SELECT name FROM users')
    users = cursor.fetchall()
    conn.close()
    return '
'.join(name for (name,) in users)

نشر تطبيق Bottle في بيئة الإنتاج

رغم أن Bottle يحتوي على خادم مدمج مفيد للاختبار، إلا أنه غير مناسب للإنتاج. للنشر يمكن استخدام WSGI مع خوادم مثل Gunicorn أو uWSGI.

باستخدام Gunicorn:

bash
pip install gunicorn
gunicorn myapp:app

حيث يكون app هو كائن التطبيق الناتج عن:

python
from bottle import default_app
app = default_app()

التكامل مع أطر أخرى

نظرًا لأن Bottle متوافق مع WSGI، فيمكن دمجه مع أطر عمل أخرى أو تشغيله بجانب تطبيقات Django أو Flask ضمن نفس الخادم، مما يجعله مرنًا في مشاريع متقدمة.

مقارنة بين Bottle وأطر أخرى

الخاصية Bottle Flask Django
الحجم صغير جداً (ملف واحد) متوسط كبير
التعقيد بسيط متوسط معقد
الأداء جيد للتطبيقات الصغيرة جيد للتطبيقات المتوسطة ممتاز للتطبيقات الكبيرة
دعم قواعد البيانات يدوي أو عبر مكتبات يدوي أو مع إضافات مدمج ORM
إدارة الجلسات يتطلب مكتبات خارجية مدمج مدمج
السرعة في التطوير سريع جداً سريع أبطأ بسبب التعقيد والتنظيم

حالات الاستخدام المثالية لإطار Bottle

  • تطوير أدوات داخلية سريعة وخفيفة.

  • بناء واجهات API صغيرة.

  • تطبيقات الويب التعليمية.

  • المشاريع التي تحتاج إلى أطر خفيفة وقابلة للدمج بسهولة.

  • النماذج الأولية (Prototyping) لتجربة الأفكار بسرعة.

الخلاصة

يمثل إطار Bottle أداة قوية وبسيطة لتطوير تطبيقات الويب باستخدام Python، خاصة عندما يكون حجم المشروع صغيرًا أو عندما تكون الحاجة إلى تطبيق سريع بدون تعقيدات كثيرة. يوفر للمطورين مرونة كبيرة في كتابة التطبيقات دون الحاجة إلى البنية الصارمة التي تفرضها أطر أكبر مثل Django. وبفضل دعمه لـ WSGI، يمكن توسيعه وربطه بسهولة مع مكونات مختلفة في نظام أكبر. يُعد Bottle خيارًا مثاليًا للمبتدئين الذين يتعلمون تطوير الويب باستخدام Python، كما يمكن أن يخدم المطورين المحترفين لبناء تطبيقات خفيفة وفعالة.

المراجع

اخر تحديث 10/06/2025
13 تمت قراءة 4 دقيقة