Entrevista de Rust: ¿Cómo migras un crate que usa identificadores gen a Rust 2024?

Planteamiento y alcance

Un equipo está migrando varios crates de Rust 2021 a Rust 2024. Funciones, módulos, campos y salidas de macros utilizan el identificador gen; Rust 2024 lo reserva como palabra clave, por lo que algunos crates fallan durante el análisis sintáctico (parsing). Diseña la detección, las correcciones, las validaciones en CI y la reversión (rollback).

Enfócate en la migración de edición. No asumas que los bloques gen son estables y mantén las actualizaciones del compilador separadas del cambio de edición.

Qué evalúa el entrevistador

• Explicar que una edición cambia las reglas de parsing, mientras que los crates de diferentes ediciones aún pueden depender entre sí.
• Utilizar el lint keyword_idents_2024 y cargo fix --edition para encontrar identificadores gen.
• Evaluar el renombramiento frente al uso de identificadores raw para mantener la compatibilidad.
• Cubrir macros, APIs públicas, scripts de compilación, pruebas y dependencias del workspace.

Preguntas para clarificar

1. ¿Qué edición, MSRV y toolchain utiliza cada crate?
2. ¿Aparece gen en APIs públicas, nombres serializados o interfaces de macros externas?
3. ¿Los tokens afectados provienen del código fuente, de una macro procedimental (proc macro) o de un script de compilación?
4. ¿La migración debe ser compatible con Rust 2021 y 2024 simultáneamente?
5. ¿Puede CI ejecutar ambas ediciones a través de combinaciones de features?

Una respuesta en 30 segundos

“Hago un inventario de la edición del workspace, el toolchain y cada fuente de gen, y luego habilito keyword_idents_2024. Renombro los símbolos internos; si una API pública debe conservar la misma grafía, utilizo el identificador raw r#gen y verifico a los llamadores en ambas ediciones. Ejecuto cargo fix --edition para cambios mecánicos, reviso macros e interfaces públicas, actualizo el manifiesto de Cargo manualmente y ejecuto check, test, docs y lint en Rust 2021, Rust 2024 y la matriz completa de features. Cada crate se migra en orden de dependencias con un commit reversible y un informe de compatibilidad.”

Diseño paso a paso

1. Separar los cambios del compilador y de la edición

El compilador puede compilar ediciones anteriores; una edición selecciona las reglas de parsing para un crate. Fija el toolchain y el archivo lockfile, establece una línea base en Rust 2021 y cambia el campo edition de un crate a la vez. Esto evita que los cambios de compilador, dependencias y lenguaje se oculten en un único diff.

2. Encontrar cada fuente de gen

Habilita keyword_idents_2024 para que se reporten los identificadores válidos en una edición anterior pero en conflicto en 2024. La búsqueda estática debe complementarse con la expansión de macros, tokens de proc-macros, scripts de compilación y pruebas. Corrige las plantillas antes del código generado en lugar de editar la salida generada.

3. Elegir entre renombrar o usar un identificador raw

Renombra funciones internas, variables locales y módulos para mejorar la claridad a largo plazo. Si una API pública, un nombre serializado o una llamada entre crates debe conservar gen, un identificador raw mantiene el símbolo direccionable en la edición requerida. Trátalo como un puente de migración, no como una excusa para mantener nombres internos confusos para siempre.

pub fn r#gen() -> IteratorType {
    // implementation
}

fn call() {
    let _items = r#gen();
}

4. Automatizar correcciones con revisión

cargo fix --edition eleva el lint relevante a advertencia y aplica sugerencias del compilador como cambiar gen a r#gen. No puede decidir sobre la nomenclatura de producto o la política de APIs y no debe sobrescribir trabajo sin confirmar. Ejecútalo en una rama limpia, revisa los diffs de macros, doctests, código generado y APIs públicas, y luego actualiza la edición en el manifiesto manualmente.

5. Verificar los límites de edición

Los crates de diferentes ediciones pueden enlazarse, por lo que debes migrar los crates del workspace de forma incremental. CI debe ejecutar cargo check, cargo test, cargo doc, clippy y combinaciones de features para 2021 y 2024. Agrega ejemplos en tiempo de compilación para las APIs públicas para que los llamadores no sufran regresiones debido a un identificador raw o a un renombramiento.

6. Observar, procesar por lotes y revertir

Registra las ocurrencias del lint, edición, toolchain, crate, feature, origen de la macro y pruebas fallidas; nunca registres credenciales o datos sensibles. Migra los crates hoja antes de los crates de los que muchos dependen. Mantén etiquetas antiguas, lockfiles y compilaciones reproducibles por lote; si algo downstream falla, revierte el lote en lugar de mezclar correcciones parciales a mano.

Respuesta modelo de alta calidad

“Una edición cambia las reglas de parsing, mientras que una actualización de compilador es una variable independiente, por lo que fijo el toolchain y establezco una línea base en Rust 2021. Habilito keyword_idents_2024 e inventarío el código fuente, macros, proc macros, scripts de compilación y pruebas que producen gen. Los símbolos internos se renombran; una API pública que deba mantener la grafía utiliza r#gen, con pruebas de serialización y llamadas entre crates. Ejecuto cargo fix --edition, reviso el diff, actualizo el manifiesto y ejecuto check, test, docs y clippy en 2021, 2024 y combinaciones de features. Los crates cambian en orden de dependencias, con telemetría de lints y fallas, y un punto de reversión reproducible.”

Errores comunes

• Actualizar solo el compilador → el parsing de la edición nunca se verificó → fijar una línea base y cambiar la edición por separado.
• Hacer grep solo en archivos fuente → las macros o el código generado aún emiten gen → aplicar lints en la fuente de generación de tokens y probar las expansiones.
• Cambiar todos los nombres a r#gen → la legibilidad de la API a largo plazo se degrada → renombrar elementos internos y reservar identificadores raw para límites de compatibilidad.
• Aceptar cargo fix sin revisión → las APIs públicas o la documentación pueden romperse → revisar cada diff y ejecutar CI entre ediciones.
• Cambiar todo el workspace a la vez → las regresiones downstream son difíciles de localizar → migrar según la topología de dependencias con puntos de reversión.

Preguntas de seguimiento y respuestas

¿Puede Rust 2024 utilizar bloques gen actualmente?

gen se reservó para dejar espacio sintáctico para futuros bloques gen. La migración no debe asumir que esa característica es estable; verifica la documentación actual del toolchain y el estado de la feature.

¿Un identificador raw cambia la ABI o un nombre serializado?

Un identificador raw cambia principalmente cómo el parser lee un nombre. El hecho de que la ABI, la reflexión, la serialización o FFI cambien depende del símbolo público real y del generador, por lo que se deben verificar esos límites. Protege los protocolos externos con nombres de transmisión (wire names) explícitos y pruebas de compatibilidad.

¿Por qué editar Cargo.toml después de cargo fix?

cargo fix --edition aplica sugerencias de lint a nivel de código, pero el campo de edición aún requiere confirmación y commit deliberados. Revisa el cambio en el manifiesto con los resultados de las pruebas para que ningún crate del workspace se cambie accidentalmente o se omita.