YamlManager

Yamlmanager

مكتبة لتبسيط إدارة وإنشاء ملفات JSON و YAML.

وظائف:

1. to_json_file:

   • وظيفة:
     • يحول القاموس إلى jsonfile
   • الحجج:
     • json_path - سلسلة أو jsonfile ، موقع jsonfile
     • dictionary - البيانات التي ينبغي أن يكون لها JSONFILE
   • الحجج الاختيارية:
     • save - ما إذا كان ينبغي حفظ jsonfile (تم إنشاؤها أو تعديلها) بمجرد أن تتطابق البيانات مع القاموس
   • عائدات:
     • jsonfile تقع في json_path

2. JSON_FILE_TO_DICT:

   • وظيفة:
     • يحول البيانات من jsonfile إلى قاموس
   • الحجج:
     • json_path - سلسلة أو jsonfile ، موقع jsonfile
   • عائدات:
     • قاموس يحتوي على جميع البيانات من jsonfile

3. json_file_to_yaml_file:

   • وظيفة:
     • يحول البيانات من jsonfile إلى yamlfile
   • الحجج:
     • json_path - سلسلة أو jsonfile ، موقع jsonfile
     • yaml_path - سلسلة أو yamlfile ، موقع yamlfile
   • الحجج الاختيارية:
     • save - ما إذا كان ينبغي حفظ Yamlfile (تم إنشاؤه أو تعديله) بمجرد تطابق البيانات مع JSONFILE
   • عائدات:
     • yamlfile تقع في yaml_path

4. to_yaml_file:

   • وظيفة:
     • يحول القاموس إلى Yamlfile
   • الحجج:
     • yaml_path - سلسلة أو yamlfile ، موقع yamlfile
     • dictionary - البيانات التي يجب أن يكون لدى Yamlfile
   • الحجج الاختيارية:
     • save - ما إذا كان ينبغي حفظ Yamlfile (تم إنشاؤه أو تعديله) بمجرد تطابق البيانات مع القاموس
   • عائدات:
     • yamlfile تقع في yaml_path

5. yaml_file_to_dict:

   • وظيفة:
     • يحول البيانات من Yamlfile إلى قاموس
   • الحجج:
     • yaml_path - سلسلة أو yamlfile ، موقع yamlfile
   • عائدات:
     • قاموس يحتوي على جميع البيانات من Yamlfile

6. yaml_file_to_json_file:

   • وظيفة:
     • يحول البيانات من yamlfile إلى jsonfile
   • الحجج:
     • yaml_path - سلسلة أو yamlfile ، موقع yamlfile
     • json_path - سلسلة أو jsonfile ، موقع jsonfile
   • الحجج الاختيارية:
     • save - ما إذا كان ينبغي حفظ jsonfile (تم إنشاؤه أو تعديله) بمجرد تطابق البيانات مع Yamlfile
   • عائدات:
     • jsonfile تقع في json_path

الفئات / الكائنات

Yamlfile

• وصف:
  • يمثل ملف yaml ويوفر طرقًا لمعالجة بياناته.
• طُرق:
  • load() : يقوم بتحميل بيانات ملف yaml.
  • save() : يحفظ البيانات الحالية إلى ملف YAML.

jsonfile

• وصف:
  • يمثل ملف JSON ويوفر طرقًا لمعالجة بياناته.
• طُرق:
  • load() : يقوم بتحميل بيانات ملف JSON.
  • save() : يحفظ البيانات الحالية إلى ملف JSON.

FileController

• وصف:
  • يمثل وحدة تحكم ملف مجردة ويوفر طرقًا لمعالجة بيانات الملف.
• طُرق:
  • __init__(file_path: str) : تهيئة مثيل FileController مع مسار الملف.
  • reload() : طريقة مجردة لتحميل البيانات من الملف. يجب تنفيذها بواسطة الفئات الفرعية.
  • save() : طريقة مجردة لحفظ البيانات في الملف. يجب تنفيذها بواسطة الفئات الفرعية.
  • contains(key: str) -> bool : يتحقق إذا كان هناك مفتاح في قاموس البيانات.
  • set(key: str, value: any) -> None : مجموعات أو تعديل أو حذف القيم في التكوين.
  • string(key: str, default_value: str | None = None) -> str | None : يحصل على قيمة سلسلة من البيانات.
  • float(key: str, default_value: float | int | None = None) -> float | None : يحصل على قيمة تعويم من البيانات.
  • int(key: str, default_value: int | None = None) -> int | None : يحصل على قيمة عدد صحيح من البيانات.
  • boolean(key: str, default_value: bool | None = None) -> bool | None : يحصل على قيمة منطقية من البيانات.
  • str_list(key: str, default_value: list[str] | None = None) -> list[str] | None : يحصل على قائمة من السلاسل من البيانات.
  • float_list(key: str, default_value: list[float | int] | None = None) -> list[float] | None : يحصل على قائمة من قيم التعويم من البيانات.
  • int_list(key: str, default_value: list[int | float] | None = None) -> list[int] | None : يحصل على قائمة بقيم عدد صحيح من البيانات.
  • bool_list(key: str, default_value: list[bool] | None = None) -> list[bool] | None : يحصل على قائمة بالقيم المنطقية من البيانات.
  • dictionary(key: str, default_value: dict | None = None) -> dict | None : يحصل على قاموس من البيانات.