Ruby στο Maguyva: γράφοι κώδικα για Rails και εφαρμογές Ruby

Γιατί τα αποθετήρια Ruby δυσκολεύουν τα επιφανειακά εργαλεία AI

Η Ruby στηρίζεται πολύ σε συμβάσεις και μεταπρογραμματισμό. Οι μέθοδοι παράγονται από το attr_accessor, οι κλάσεις ξανανοίγουν σε άλλα αρχεία και οι χώροι ονομάτων φωλιάζουν αρθρώματα σε πολλά επίπεδα. Η ευανάγνωστη επιφάνεια κρύβει σε ποια μέθοδο καταλήγει πραγματικά μια κλήση, και μια χοντροκομμένη αναζήτηση κειμένου επιστρέφει κάθε 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, ώστε μια κλήση σε ένα ανατεθειμένο αντικείμενο να μπορεί να επιλυθεί στην κλάση του. Ο γράφος καταγράφει επίσης κληρονομικότητα, συμπερίληψη αρθρωμάτων, επικαλύψεις, ακμές raise και rescue, καθώς και αναγνώσεις και εγγραφές.

Οι κλήσεις μεταπρογραμματισμού (define_method, send, method_missing, class_eval και παρόμοιες), οι βοηθοί τύπων T:: του Sorbet και οι συνηθισμένες κλήσεις Enumerable (each, collect, reject και παρόμοιες) φιλτράρονται από τις σχέσεις, ώστε να ξεχωρίζει ο κώδικας της εφαρμογής.

Παραδείγματα προτροπών για πράκτορες

• «Ποιος καλεί το Billing::ChargeCustomer.call και από ποιες εργασίες και ποιους ελεγκτές;» (find_symbol, μετά dependency_search incoming)
• «Ποια μοντέλα κληρονομούν από το ApplicationRecord και συμπεριλαμβάνουν το Auditable;» (dependency_search)
• «Παρακολούθησε τι συμβαίνει αφού μια παραγγελία σημειωθεί ως πληρωμένη.» (get_task_context)

Γνωστοί περιορισμοί

• Στη Ruby, τα require και load είναι απλές κλήσεις μεθόδων, οπότε η προεπιλογή imports στο structural_search δεν επιλέγει τίποτα. Για να τα απαριθμήσετε, χρησιμοποιήστε το text_pattern_search.
• Οι μέθοδοι που δημιουργούνται κατά την εκτέλεση με define_method ή που χειρίζεται το method_missing δεν εξάγονται ως σύμβολα, και αυτές οι κλήσεις φιλτράρονται ως θόρυβος μεταπρογραμματισμού.
• Η Ruby δεν έχει σύνταξη διακοσμητών, οπότε οι σχέσεις διακοσμητών σημειώνονται ως μη εφαρμόσιμες.

Επόμενα βήματα

Συνδέστε ένα αποθετήριο με τον γρήγορο οδηγό εκκίνησης και έπειτα δείτε τον πίνακα υποστήριξης στη σελίδα συμβατότητας. Για άλλα αποθετήρια σε δυναμικές γλώσσες, συγκρίνετε με τον οδηγό για την Python.