نظرة عامة على Code Generation

لنقم ببناء مولد أكواد (code generator) ينشئ طرق String() لأنواع تشبه الـ enum! بينما لا يمكننا تشغيل go generate الفعلي في هذه البيئة، ستقوم بمحاكاة ما تفعله أدوات توليد الأكواد — إنتاج كود مصدر Go برمجياً بناءً على تعريفات الأنواع.

ستقوم بتنظيم الكود الخاص بك عبر ملفين:

• generator.go: أنشئ منطق توليد الكود الخاص بك.

  قم ببناء هيكل EnumType يمثل تعريف نوع يشبه الـ enum مع Name (سلسلة نصية) و Values (شريحة من السلاسل النصية تمثل أسماء الثوابت).

  أنشئ دالة GenerateStringMethod(e EnumType) string تنتج كود مصدر Go لطريقة String(). يجب أن يتبع الكود المولد هذا النمط:

  func (e TypeName) String() string {
      switch e {
      case Value1:
          return "Value1"
      case Value2:
          return "Value2"
      default:
          return "Unknown"
      }
  }

  أنشئ أيضاً دالة GenerateConstants(e EnumType) string تنتج إعلانات الثوابت باستخدام iota:

  const (
      Value1 TypeName = iota
      Value2
      Value3
  )

  أخيراً، أنشئ GenerateFullCode(e EnumType) string التي تجمع بين المخرجين مع تعليق رأسي يشير إلى أن هذا كود مولد:

  // Code generated by enum generator. DO NOT EDIT.
  
  [constants]
  
  [string method]
• main.go: استخدم المولد الخاص بك لإنتاج كود لأنواع enum مختلفة.

  اقرأ اسم نوع الـ enum، ثم اقرأ عدد القيم متبوعاً باسم كل قيمة. مرر هذه المعلومات إلى المولد الخاص بك واطبع الكود المولد بالكامل.

سيتم توفير المدخلات التالية:

• السطر 1: اسم نوع الـ Enum
• السطر 2: عدد القيم
• الأسطر التالية: اسم كل قيمة

على سبيل المثال، إذا كان المعطى:

Status
3
Pending
Active
Completed

يجب أن يكون مخرجك:

// Code generated by enum generator. DO NOT EDIT.

const (
    Pending Status = iota
    Active
    Completed
)

func (e Status) String() string {
    switch e {
    case Pending:
        return "Pending"
    case Active:
        return "Active"
    case Completed:
        return "Completed"
    default:
        return "Unknown"
    }
}

وإذا كان المعطى:

Priority
2
Low
High

يجب أن يكون مخرجك:

// Code generated by enum generator. DO NOT EDIT.

const (
    Low Priority = iota
    High
)

func (e Priority) String() string {
    switch e {
    case Low:
        return "Low"
    case High:
        return "High"
    default:
        return "Unknown"
    }
}

يوضح هذا التمرين المفهوم الأساسي وراء أدوات مثل stringer — توليد كود متكرر ولكنه آمن من حيث النوع (type-safe) في وقت التجميع بدلاً من استخدام الانعكاس (reflection) في وقت التشغيل. ينتج المولد الخاص بك كود Go صالحاً يمكن حفظه في ملف وتجميعه مع بقية المشروع.