الصفحة الرئيسية>المتعلقة بالبرمجة>بايثون
تنزيل

هيكل كايتاي

ملحوظة: إذا كنت تريد إجراء تغييرات على المشروع، فلا تقم بتفرع هذا المستودع kaitai_struct . بدلاً من ذلك، اختر المكون الذي تريد تعديله في شجرة الملفات أعلاه وقم بتقسيم هذا المكون الفردي بدلاً من ذلك.

هذا مستودع شامل، يحتوي على المكونات فقط كوحدات فرعية لتسهيل التحقق من المشروع بأكمله. ما لم تكن ترغب في تعديل ملف README هذا، فهو ليس الريبو الذي يمكنك من خلاله إجراء التعديلات.

ما هو هيكل كايتاي؟

Kaitai Struct هي لغة تعريفية تستخدم لوصف هياكل البيانات الثنائية المختلفة الموضوعة في الملفات أو في الذاكرة: أي تنسيقات الملفات الثنائية، وتنسيقات حزم تدفق الشبكة، وما إلى ذلك.

الفكرة الرئيسية هي أن تنسيقًا معينًا يتم وصفه بلغة Kaitai Struct مرة واحدة فقط ومن ثم يمكن تجميعه باستخدام ملف ksc في ملفات مصدر بإحدى لغات البرمجة المدعومة. ستتضمن هذه الوحدات رمزًا تم إنشاؤه لمحلل يمكنه قراءة بنية البيانات الموصوفة من ملف/دفق ومنح حق الوصول إليها في واجهة برمجة تطبيقات لطيفة وسهلة الفهم.

ما هو استخدامه ل؟

هل سبق لك أن وجدت نفسك تكتب تعليمات برمجية متكررة وعرضة للخطأ ويصعب تصحيحها والتي تقرأ هياكل البيانات الثنائية من تدفق الملفات/الشبكة وتمثلها بطريقة ما في الذاكرة لتسهيل الوصول إليها؟

يحاول Kaitai Struct تسهيل هذه المهمة - ما عليك سوى وصف التنسيق الثنائي مرة واحدة وبعد ذلك يمكن للجميع استخدامه من لغات البرمجة الخاصة بهم - عبر اللغات والأنظمة الأساسية.

يتضمن Kaitai Struct مجموعة متزايدة من أوصاف التنسيقات، المتوفرة في مستودع الوحدات الفرعية للتنسيقات.

هل يمكنك أن تعطيني مثالا سريعا؟

بالتأكيد. خذ بعين الاعتبار ملف الوصف البسيط بتنسيق .ksy الذي يصف رأس ملف GIF (تنسيق صور الويب الشائع): 

 meta :
  id : gif
  file-extension : gif
  endian : le
seq :
  - id : header
    type : header
  - id : logical_screen
    type : logical_screen
types :
  header :
    seq :
      - id : magic
        contents : ' GIF '
      - id : version
        size : 3
  logical_screen :
    seq :
      - id : image_width
        type : u2
      - id : image_height
        type : u2
      - id : flags
        type : u1
      - id : bg_color_index
        type : u1
      - id : pixel_aspect_ratio
        type : u1

تعلن أن ملفات GIF عادة ما يكون لها امتداد .gif وتستخدم ترميزًا صحيحًا ذو نهاية صغيرة. يبدأ الملف نفسه بكتلتين: يأتي أولاً header ثم يأتي logical_screen :

  • يتكون "الرأس" من سلسلة "سحرية" مكونة من 3 بايت ("GIF") تحدد أنه ملف GIF يبدأ ثم هناك 3 بايت أخرى تحدد إصدار التنسيق ( 87a أو 89a ).
  • "واصف الشاشة المنطقي" عبارة عن كتلة من الأعداد الصحيحة:
    • image_width و image_height عبارة عن ints غير موقعة بحجم 2 بايت
    • تأخذ flags و bg_color_index و pixel_aspect_ratio بايت واحد غير موقع لكل منهما

يمكن تجميع ملف .ksy هذا في Gif.cs / Gif.java / Gif.js / Gif.php / gif.py / gif.rb وبعد ذلك يمكن على الفور تحميل ملف .gif والوصول إليه، على سبيل المثال، عرضه و ارتفاع.

شركة# 

 Gif g = Gif . FromFile ( "path/to/some.gif" ) ;
Console . WriteLine ( "width = " + g . LogicalScreen . ImageWidth ) ;
Console . WriteLine ( "height = " + g . LogicalScreen . ImageHeight ) ;

في جافا 

 Gif g = Gif . fromFile ( "path/to/some.gif" );
System . out . println ( "width = " + g . logicalScreen (). imageWidth ());
System . out . println ( "height = " + g . logicalScreen (). imageHeight ());

في جافا سكريبت

راجع ملاحظات JavaScript في الوثائق للحصول على دليل البدء السريع الأكثر اكتمالاً. 

 var g = new Gif ( new KaitaiStream ( someArrayBuffer ) ) ;
console . log ( "width = " + g . logicalScreen . imageWidth ) ;
console . log ( "height = " + g . logicalScreen . imageHeight ) ;

في لوا 

 local g = Gif : from_file ( " path/to/some.gif " )
print ( " width = " .. g . logical_screen . image_width )
print ( " height = " .. g . logical_screen . image_height )

في نيم 

 let g = Gif . fromFile ( " path/to/some.gif " )
echo " width = " & $ g.logicalScreen.imageWidth
echo " height = " & $ g.logicalScreen.imageHeight

في PHP

logicalScreen()->imageWidth()); printf("height = %dn", $g->logicalScreen()->imageHeight());" style=";text-align:right;direction:rtl">
 $ g = Gif:: fromFile ( ' path/to/some.gif ' );
printf ( " width = %d n" , $ g -> logicalScreen ()-> imageWidth ());
printf ( " height = %d n" , $ g -> logicalScreen ()-> imageHeight ());

في بايثون 

 g = Gif . from_file ( "path/to/some.gif" )
print "width = %d" % ( g . logical_screen . image_width )
print "height = %d" % ( g . logical_screen . image_height )

في روبي 

 g = Gif . from_file ( "path/to/some.gif" )
puts "width = #{ g . logical_screen . image_width } "
puts "height = #{ g . logical_screen . image_height } "

بالطبع، يوضح هذا المثال مجموعة فرعية محدودة جدًا مما يمكن أن تفعله Kaitai Struct. يرجى الرجوع إلى البرامج التعليمية والوثائق لمزيد من الأفكار.

اللغات المدعومة

يدعم المترجم الرسمي Kaitai Struct الآن تجميع .ksy في وحدات المصدر للغات التالية:

  • ج #
  • جافا
  • جافا سكريبت
  • لوا
  • نيم
  • PHP
  • بايثون
  • روبي

تحميل وتثبيت

أسهل طريقة للتحقق من مشروع Kaitai Struct بأكمله هي تنزيل مستودع المشروع الرئيسي الذي يستورد بالفعل جميع الأجزاء الأخرى كوحدات فرعية. يستخدم: 

 git clone --recursive https://github.com/kaitai-io/kaitai_struct.git

لاحظ الخيار --recursive .

وبدلاً من ذلك، يمكن للمرء التحقق من المشاريع الفرعية الفردية التي تشكل مجموعة Kaitai Struct. هم:

  • kaitai_struct_compiler — مترجم يقوم بترجمة .ksy إلى كود مصدر محلل مكتوب بلغة برمجة مستهدفة
  • kaitai_struct_tests - الاختبارات والمواصفات للتأكد من أن المترجم يعمل كما هو مخطط له
  • مكتبات وقت التشغيل
    • kaitai_struct_cpp_stl_runtime — لـ C++/STL
    • kaitai_struct_csharp_runtime — لـ C#
    • kaitai_struct_java_runtime — لجافا
    • kaitai_struct_javascript_runtime — لجافا سكريبت
    • kaitai_struct_nim_runtime — لنيم
    • kaitai_struct_lua_runtime — لـ Lua
    • kaitai_struct_python_runtime — لبيثون
    • kaitai_struct_ruby_runtime — لروبي
    • kaitai_struct_swift_runtime - لـ Swift
  • kaitai_struct_formats — مكتبة من التنسيقات المستخدمة على نطاق واسع والهياكل الثنائية الموصوفة كملفات .ksy

استخدام KS في مشروعك

عادةً، يتضمن استخدام التنسيقات الموضحة في KS في مشروعك الخطوات التالية:

  • وصف التنسيق — أي إنشاء ملف .ksy
  • قم بتجميع ملف .ksy في ملف مصدر اللغة الهدف وقم بتضمين هذا الملف في مشروعك
  • أضف مكتبة وقت تشغيل KS للغة الخاصة بك إلى مشروعك (لا تقلق، فهي صغيرة وهي موجودة في الغالب لضمان سهولة قراءة التعليمات البرمجية التي تم إنشاؤها)
  • استخدم الفئة (الفئات) التي تم إنشاؤها لتحليل الملف الثنائي/الدفق والوصول إلى مكوناته

تحقق من البرنامج التعليمي والوثائق لمزيد من المعلومات.

الترخيص

  • المترجم — GPLv3+
  • مكتبات وقت التشغيل - MIT أو Apache v2 (=> يمكنك تضمين التعليمات البرمجية التي تم إنشاؤها حتى في التطبيقات الخاصة) - راجع المكتبات الفردية للحصول على التفاصيل
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل