Ruby บน Maguyva: กราฟโค้ดสำหรับ Rails และแอป Ruby

ทำไมรีโพซิทอรี Ruby จึงยากสำหรับเครื่องมือ AI แบบผิวเผิน

Ruby พึ่งพาแบบแผนและเมทาโปรแกรมมิงอย่างมาก เมธอดถูกสร้างโดย attr_accessor คลาสถูกเปิดใหม่ในไฟล์อื่น และ namespace ซ้อนโมดูลไว้หลายชั้น พื้นผิวที่อ่านง่ายซ่อนว่าการเรียกไปจบที่เมธอดใดจริง และการค้นหาข้อความแบบหยาบจะคืนทุก call และทุก perform ในแอป

Maguyva ให้คลาส โมดูล เมธอด และผู้เรียกกับเอเจนต์ในรูปของโครงสร้าง เพื่อให้ติดตามการเปลี่ยนแปลงไปทั่วแอปแทนการเดา

Maguyva ดึงอะไรจาก Ruby ได้บ้าง

Maguyva ครอบคลุมไฟล์ .rb, .rbw, .rake และ .gemspec รวมถึง Gemfile และ Rakefile เมธอดของอินสแตนซ์และเมธอด singleton (def self.call) ถูกดึงออกมา โดยเมธอด singleton ถูกทำเครื่องหมายเป็น static การประกาศ attr_reader, attr_writer และ attr_accessor นับเป็นเมธอดแอคเซสเซอร์ และสัญลักษณ์ถูกระบุด้วย namespace ของโมดูลและคลาส

ClassName.new และ Namespace::ClassName.new นับเป็นการสร้างอินสแตนซ์ และการระบุชนิดของรีซีฟเวอร์ติดตามการกำหนดค่าตัวแปรท้องถิ่นและ @instance_variables การเรียกบนออบเจกต์ที่ถูกกำหนดค่าจึงรีโซลฟ์ไปยังคลาสของมันได้ กราฟยังบันทึกการสืบทอด การ include โมดูล การ override เส้นเชื่อม raise และ rescue และการอ่านและการเขียนด้วย

การเรียกแบบเมทาโปรแกรมมิง (define_method, send, method_missing, class_eval และอื่น ๆ ทำนองเดียวกัน) ตัวช่วยชนิดข้อมูล T:: ของ Sorbet และการเรียก Enumerable ที่พบบ่อย (each, collect, reject และอื่น ๆ ทำนองเดียวกัน) ถูกกรองออกจากความสัมพันธ์ เพื่อให้โค้ดแอปโดดเด่นขึ้นมา

ตัวอย่างพรอมต์สำหรับเอเจนต์

• “ใครเรียก Billing::ChargeCustomer.call และเรียกจาก job และ controller ใดบ้าง” (find_symbol แล้วตามด้วย dependency_search ทิศทางขาเข้า)
• “model ใดสืบทอดจาก ApplicationRecord และ include Auditable” (dependency_search)
• “ติดตามว่าเกิดอะไรขึ้นหลังคำสั่งซื้อถูกทำเครื่องหมายว่าชำระแล้ว” (get_task_context)

ข้อจำกัดที่ทราบ

• ใน Ruby require และ load เป็นการเรียกเมธอดธรรมดา พรีเซ็ต imports ใน structural_search จึงไม่เลือกอะไรเลย ใช้ text_pattern_search เพื่อแสดงรายการเหล่านี้
• เมธอดที่สร้างขณะรันไทม์ด้วย define_method หรือที่ method_missing จัดการ จะไม่ถูกดึงออกมาเป็นสัญลักษณ์ และการเรียกเหล่านั้นถูกกรองออกในฐานะสัญญาณรบกวนจากเมทาโปรแกรมมิง
• Ruby ไม่มีไวยากรณ์เดคอเรเตอร์ ความสัมพันธ์เดคอเรเตอร์จึงถูกทำเครื่องหมายว่าไม่เกี่ยวข้อง

ขั้นตอนถัดไป

เชื่อมต่อรีโพซิทอรีด้วยคู่มือเริ่มต้นใช้งาน แล้วดูตารางการรองรับได้ที่หน้าความเข้ากันได้ สำหรับรีโพซิทอรีภาษาไดนามิกอื่น ให้เทียบกับคู่มือภาษา Python