Saltar a contenido

Las páginas sin traducir se abren en inglés y se indican como inglés.

Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.

Inteligencia de código para C++, Python, TypeScript, Go, Rust, Java e infraestructura como código

El índice de código de Loom responde a las preguntas de estructura de un agente de programación en los lenguajes que contiene un repositorio: dónde se define un símbolo, quién lo llama y qué toca un cambio. Requiere un repositorio añadido y LOOM_CODE_INGEST_ENABLED=true. Todos los lenguajes cuentan con el nivel rápido, analizado con gramáticas de tree-sitter o con escáneres escritos a mano; C/C++, Python, TypeScript y Go pueden añadir un nivel del compilador que resuelve los nombres como lo hace el compilador. La lista completa de extensiones y aristas está en la tabla de lenguajes admitidos, y la configuración de los niveles del compilador está en operaciones del índice de código.

Una respuesta indica el nivel que la origina (tier: "scip" para el nivel del compilador, "treesitter" para el nivel rápido), y code.coverage informa de lo que contiene un espacio de nombres por lenguaje y nivel. Consúltalo antes de fiarte de las respuestas de code.callers o code.impact en un lenguaje con el que no hayas usado Loom.

C y C++

Los símbolos, las llamadas, los includes, la herencia y las sobrescrituras provienen del nivel rápido; el nivel del compilador (scip-clang) resuelve sobrecargas, plantillas y espacios de nombres a partir de la compilación del proyecto, de modo que code.symbol con uses_brief: true sobre un nombre calificado como DB::IMergeTreeDataPart::getBytesOnDisk devuelve la única definición, su número de sitios de llamada y los principales sitios de llamada con sus funciones contenedoras, cada uno marcado con tier: "scip". El nivel del compilador necesita la configuración de compilación CMake del proyecto.

Python

Las llamadas, las importaciones, la herencia y las sobrescrituras provienen del nivel rápido, incluidas las celdas de código de los notebooks; el nivel del compilador (scip-python) resuelve nombres entre módulos. En el propio repositorio de Loom, code.symbol sobre writer_actor devuelve su definición en server/memory/app/provenance.py con su firma y su docstring en el nivel del compilador, y uses_brief: true añade sus sitios de llamada.

TypeScript y JavaScript

Las llamadas (incluido new), las importaciones, la herencia y las sobrescrituras provienen del nivel rápido, al igual que los bloques de script de los componentes de Vue, Svelte y Astro; una plantilla .component.html de Angular se indexa como una sola unidad junto con su componente. El nivel del compilador (scip-typescript) resuelve nombres a través del tsconfig.json, jsconfig.json o package.json del proyecto.

Go

Las llamadas, la incrustación de interfaces y la implementación estructural provienen del nivel rápido, y el SQL en cadenas de Go se convierte en referencias a tablas; el nivel del compilador (scip-go) resuelve nombres entre paquetes, incluidos los monorrepositorios.

Rust y Java

Rust obtiene llamadas, importaciones use e implementaciones de traits; Java obtiene llamadas, con importaciones que enlazan nombres, y SQL en cadenas de Java. Ambos tienen solo el nivel rápido: una llamada enlazada en el mismo archivo tiene confianza 1.0, a través de la clase contenedora 0.8 y por coincidencia de nombre en todo el repositorio 0.6; una llamada que no puede enlazar se descarta en lugar de adivinarse, y code.impact añade las pruebas asociadas y los compañeros de cambio conjunto a nivel de archivo.

SQL y migraciones

Los archivos .sql se indexan por defecto para búsqueda y grep. Con LOOM_CODE_SQL_STATEMENT_RECORDS activado, cada sentencia se convierte en un registro con sus referencias a tablas, de modo que un agente puede preguntar qué migraciones y consultas leen o escriben una tabla. Activarlo en un espacio de nombres ya indexado requiere un loom code backfill --paths-file con los archivos SQL (interruptores).

Infraestructura como código

Terraform y HCL, los manifiestos de Kubernetes, los charts de Helm y las plantillas de Go, Jsonnet, CMake, Protocol Buffers y los scripts de shell se indexan con sus referencias, includes y llamadas, de modo que un agente sigue un include de Helm hasta su define, o una referencia de Terraform hasta lo que nombra. Los trabajos de Dockerfile, Makefile, Jenkinsfile y YAML de CI se convierten en símbolos con LOOM_CODE_HOST_ISLANDS activado, tras un backfill de esos archivos cuando el espacio de nombres ya está indexado.

Primeros pasos

  1. Indexa un repositorio. Los niveles del compilador que se ejecutan para él están en operaciones del índice de código.
  2. Conecta un agente de programación con el toolset coding.
  3. Haz una pregunta de estructura; consulta code.coverage para los lenguajes en los que confías.

Relacionado