Perl no Maguyva: grafos de pacotes e sub-rotinas

Por que é difícil mudar Perl com segurança

Código Perl é denso, flexível e muitas vezes escrito por pessoas que saíram há anos. Sigils mudam o sentido de um nome, pacotes servem também como classes, e o mesmo módulo é carregado por scripts em muitos diretórios. Uma busca textual encontra as strings, mas não diz a um agente qual sub-rotina um script realmente chama.

O Maguyva entrega ao agente pacotes, sub-rotinas, importações e construtores como estrutura, para que ele delimite uma mudança antes de mexer no código.

O que o Maguyva extrai em Perl

O Maguyva cobre .pl, .pm, .t, .pod e .perl. Sub-rotinas são extraídas como funções e declarações package como classes, e os nomes de definição têm os sigils ($, @, %, &, *) removidos, para que variáveis e sub-rotinas sejam encontradas pelo nome simples.

As importações vêm das instruções use, require e package. Chamadas de método na forma Class->new contam como instanciação, e bless e tie são mantidos de propósito no grafo de chamadas. O grafo também registra herança, sobrescritas, referências de tipo, leituras e escritas, e lançamento de exceções.

Cerca de 189 funções embutidas (print, open, die, warn e semelhantes) são filtradas das relações de chamada para que o código do repositório se destaque.

Exemplos de prompts para agentes

• “Quais scripts usam Billing::Invoice e quais das suas sub-rotinas eles chamam?” (dependency_search incoming)
• “Onde Report::Monthly é construído e o que acontece depois de ->new?” (find_symbol, depois get_task_context)
• “Encontre todos os arquivos de teste que exercitam Auth::Session.” (text_pattern_search, depois find_symbol)

Limitações conhecidas

• Métodos Perl clássicos são declarações sub comuns dentro de um pacote, então na busca estrutural só a sintaxe dedicada mais recente method é classificada como método. Use o preset functions para Perl orientado a objetos mais antigo.
• Chamadas a funções embutidas filtradas não aparecem como arestas do grafo. Use text_pattern_search quando precisar de cada chamada a open ou print.

Próximos passos

Conecte um repositório pelo início rápido e depois confira a matriz de suporte na página de compatibilidade. Se o acervo está migrando para outra linguagem de script, compare com o guia de Python.