دمج الاعتماد – استخدام تخزين Supabase مع FastAPI

التعريف بمدخلات التشغيل والاعتماد: تعتبر تقنية حقن الاعتماد (Dependency Injection) من الأساليب الحديثة التي تساهم في تحسين تصميم البرمجيات وتسهيل إدارتها. يتمثل مفهوم حقن الاعتماد في جعل الكود أكثر مرونة وقابلية للإدارة من خلال تفكيك الاعتمادات وتوفيرها من الخارج بدلاً من إنشائها داخل المكونات نفسها. في هذا المقال، سنستعرض كيفية استخدام حقن الاعتماد في توثيق تخزين Supabase مع FastAPI، بناءً على إعدادات الحالة التي تم تقديمها.

تنفيذ حقن الاعتماد في FastAPI

عند بناء تطبيقات باستخدام FastAPI، يعد استخدام الـDependency Injection أسلوباً فعالاً يسهل عملية إدارة الاعتمادات. على سبيل المثال، لنأخذ إعداد الدالة المفيدة get_user_token. تقوم هذه الدالة باسترداد رمز المستخدم من رأس الطلب، مما يتيح لنا التحقق من الهوية والتفويض.

def get_user_token(request: Request, x_user_token: str = Header(None)):
    return x_user_token

تعمل هذه الدالة على تمرير الرمز المميز إلى دالة أخرى، وهي get_storage، التي تعتمد على الرمز المميز لتحديث رؤوس التخزين لـ Supabase.

def get_storage(token: str = Depends(get_user_token)):
    supabase.auth._headers.update({"Authorization": f"Bearer {token}"})

استخدام Supabase لتخزين البيانات

نستطيع استخدام الكود المذكور لإنشاء فئة تخزين تتطلب من قاعدة البيانات والانتباه إلى التخزين.

class SupabaseStorage:
    def __init__(self, db=Depends(get_db), storage=Depends(get_storage)):
        self.db = db
        self.storage = storage

تسمح هذه التقنية للتطبيق بإنشاء خدمة تخزين فعالة تستند إلى معطيات مفيدة. تتمثل إحدى خدمات الملفات في القدرة على رفع الملفات إلى التخزين.

class FileService(Service):
    def upload(self, file_name: str, file_bytes: bytes):
        self.storage.from_(config.bucket).upload(f"{file_name.__str__()}.csv", file_bytes)

نقطة النهاية مع FastAPI

لإنشاء نقطة نهاية عبر FastAPI، نحدد دالة النهاية التي تستخدم خدمة الملفات:

@router.post("/endpoint")
def create_test(name: str, file_service: FileService = Depends(FileService)):
    file_service.upload(file_name=name, file_bytes=...)

تظهر هنا إشكالية تحدث بخصوص الرمز المميز حيث يمكن أن ينتج عنها خطأ يظهر عند محاولة توثيق التخزين باستخدام الرمز المميز. قد يحدث ذلك بسبب وجود رمز مميز غير صالح أو تنسيق غير صحيح. الرسالة التالية قد تبرز تلك المشكلة:

Storage3.utils.StorageException: {'statusCode': 400, 'error': 'Unauthorized', 'message': 'jwt malformed'}

تشخيص المشكلة

في حالة حدوث هذا الخطأ، يجب التأكد من أن الرمز المميز يتم تمريره بشكل صحيح وأن عملية التوثيق تمت بنجاح. بدايةً، تأكد من أن FastAPI تم إعدادها بشكل صحيح ولا تستخدم مكتبات أو مكونات خارجية تتداخل مع عملية التوثيق.

نصيحة أخرى هي التحقق من صيغة الرمز المميز، حيث أن الأخطاء المتعلقة بالتصحيح قد تتسبب في عدم القدرة على التخزين بشكل صحيح. في بعض الأحيان، قد يكون السبب مرتبطًا بمشكلات في إصدار المكتبات المستخدمة.

خاتمة

استنادًا إلى ما تم مناقشته، فإن التقنيات المستخدمة في حقن الاعتماد (Dependency Injection) تسمح بإنشاء تطبيقات أكثر مرونة وسهولة في الاستخدام. كما أن دمج التخزين مع Supabase عبر FastAPI يعزز من قدرة التطبيقات على إدارة البيانات بشكل فعال. إن فهم كيفية عمل الاعتمادات والتفاعل بينها يساهم بشكل كبير في تحسين الأداء الوظيفي للتطبيقات. تحقيقًا لهذه الغايات، يجب التأكد دائمًا من صحة وملاءمة الرموز المستخدمة لضمان عدم ظهور الأخطاء على الطريق.