rust-anything: переносим приложение на Rust по частям и доказываем, что поведение не изменилось

· 7 мин чтения
rust migration ai-coding cli mcp
📂 Исходный код на GitHub

CLI-инструмент, который помогает переписать приложение на Rust по частям: записывает поведение оригинала на тестовых входных данных, генерирует мост для вызова Rust-кода с прежним API и не выпускает ни одну часть, пока она не совпадёт с записью.

rust-anything: переносим приложение на Rust по частям и доказываем, что поведение не изменилось

rust-anything — это CLI-инструмент для переноса приложений на Rust. Вы указываете на своё приложение, а он записывает, что оригинал делает на сотнях тестовых входных данных. Дальше кодинг-агент пишет Rust по кусочкам, и каждый кусочек проверяется на совпадение с записью, прежде чем двигаться дальше. Инструмент не переводит код сам: Rust пишет ваш агент (Claude Code, Codex, Cursor, OpenCode) или вы. rust-anything даёт то, что агент угадать не может: куда уходит время, что переносить первым, мост, чтобы остальной код вызывал Rust через прежний API, и финальную проверку, которая говорит, когда перенос готов. Проект написан на Rust, распространяется по лицензии MIT и собрал на GitHub больше шести тысяч звёзд.

Четыре шага цикла

Работа делится на четыре шага:

  1. Record — команда record запускает оригинал на сгенерированных краевых случаях, смысловых ловушках и ваших входных данных. Она сохраняет то, что функции возвращают и что бросают.
  2. Port — команда bridge создаёт крейт (пакет на Rust) и обёртку, чтобы вызывающий код работал через прежний API. Сам Rust пишет агент или человек.
  3. Check — команда diff прогоняет каждую записанную ситуацию против Rust-версии. Пока всё не совпадёт и gate не пройдёт, перенос не считается готовым.
  4. Lift — когда проверка прошла без откатов к оригиналу, команда app lift собирает чистое Rust-приложение. Оригинал при этом не трогают.

Мост строится на готовых библиотеках napi-rs, PyO3 и wasm-bindgen. Они передают вызовы между вашим языком и Rust, а rust-anything решает, что переносить, и доказывает, что перенос совпадает с оригиналом.

Типовой набор команд для одной функции выглядит так:

rust-anything profile . -- node bench.mjs              # what is hot, and who calls it
rust-anything bridge . src/fuzzy.ts --batch fuzzyScore:text
# write src/port.rs (or let your agent), then:
rust-anything record rust/fuzzy-rs && rust-anything build rust/fuzzy-rs
rust-anything diff rust/fuzzy-rs                       # every recorded case must match
rust-anything fuzz rust/fuzzy-rs --time 60 --keep      # fresh inputs: what the recording missed
rust-anything bench rust/fuzzy-rs                      # faster? the verdict says
rust-anything gate rust/fuzzy-rs                       # done means this passes

Команда profile показывает, какие участки кода самые медленные. Команда fuzz подбрасывает порту новые входные данные, которых не было при записи. Это ловит то, что не попало в первоначальную запись. Команда bench меряет скорость и говорит, стоит ли переносить.

Зачем это нужно: цифры из реальных проектов

Авторы померили перенос нескольких известных проектов на Apple M4. Каждый вывод сравнивали с оригиналом перед замером скорости:

Проект Оригинал С rust-anything
Prettier 3.6.2, 2 360 файлов JS/TS из командной строки 128,6 с 6,9 с: в 19 раз быстрее
Prettier, 6 305 файлов Markdown 352 с 22,5 с: в 15,6 раза быстрее
json-server, целый Node-сервер: память в покое 74 МБ 3,5 МБ, один бинарник на 5,3 МБ
json-server: от старта до первого ответа 79–85 мс 8–10 мс
Fuse.js, поиск по 50 000 строк, один запрос 91,2 мс 2,8 мс: в 32 раза быстрее

Детали важны. В Prettier полностью на Rust работают 15 837 из 17 224 записанных прогонов, но все 17 224 совпадают с оригиналом байт в байт: неперенесённые части пока откатываются к Prettier. У json-server все 514 записанных HTTP-ситуаций совпали на чистом Rust-бинарнике.

При этом одно вызывание Rust на каждую маленькую функцию обычно медленнее, чем работа JIT. Поэтому rust-anything ищет цикл, который стоит перенести целиком, а не дробит код на мелкие вызовы. Против C выигрыш не в скорости, а в безопасности: перенесённая библиотека libavutil из ffmpeg совпала по всем 135 773 записанным вызовам и работает примерно на скорости C.

Поддерживаемые языки

Запись и проверка работают для TypeScript/JavaScript, Python, C, Go, Ruby, Java и Kotlin. Для PHP и C# сегодня доступны запись, повтор и «передняя дверь» для целых приложений (CLI и серверы), а перенос отдельных функций — следующий шаг.

Язык Мост
TypeScript/JavaScript napi-rs или wasm-bindgen, классы и async включены
Python PyO3 (abi3), прямое преобразование типов
C функции extern "C" с исходными именами и заголовок
Go типизированные вызовы cgo в пакете с прежним API
Ruby расширение magnus под исходные модули
Java типизированный JNI в классах-обёртках
Kotlin тот же Java-мост, компиляция через kotlinc
PHP следующим шагом: FFI поверх C ABI
C# следующим шагом: P/Invoke поверх C ABI

Язык определяется по файлам репозитория: go.mod, pom.xml, package.json, pyproject.toml и другим. Типы берутся из исходников: аннотации TypeScript и Python, подписи C, Go, Java, Kotlin и C#, теги YARD в Ruby. Непечатаемые параметры, которые используются как числа, определяются как числа. Для каждого языка, кроме C, есть пакетный режим (--batch): данные переходят в Rust один раз, и каждый вызов обрабатывает их на всех ядрах. Есть и поддержка Android: сборка JNI-библиотеки через NDK и запись поведения на подключённом устройстве через adb.

Проверка побочных эффектов

Совпадающий вывод — это ещё не всё. Если переписанный код дважды отправляет письмо, тест на вывод это не заметит. Режим --effects записывает и то, что приложение отправляет наружу: письма, вебхуки, записи в базу. Переписанная версия, которая отправляет письмо дважды, провалит проверку со счётом 0 из 2.

Работа с кодинг-агентами

Установка в один шаг: cargo install rust-anything, затем rust-anything setup. Команда setup добавляет MCP-сервер каждому найденному агенту и ставит рабочий skill туда, где агент читает skills:

Агент Что добавляет setup
Claude Code MCP-сервер в ~/.claude.json, skill в ~/.claude/skills/
Codex MCP-сервер в ~/.codex/config.toml, skill в ~/.codex/skills/
Cursor MCP-сервер в ~/.cursor/mcp.json
Gemini CLI MCP-сервер в ~/.gemini/settings.json
OpenCode MCP-сервер и skill в ~/.config/opencode/

Любой другой MCP-клиент подключает команду rust-anything mcp как stdio-сервер вручную. setup можно запускать повторно: он сохраняет копию изменяемого файла рядом (<file>.rust-anything.bak), а --remove отменяет все изменения. В Claude Code есть и вариант в виде плагина: /plugin install rust-anything --marketplace erkamyaman/rust-anything.

После установки агенту можно писать, например, так:

  • «Перепиши этот CLI на Rust с rust-anything от начала до конца и докажи, что поведение то же».
  • «Поиск работает медленно. Запусти profile через rust-anything и перенеси самый горячий цикл в Rust».
  • «Спланируй перенос src/parser/ на Rust; перенеси первую функцию и докажи совпадение».
  • «Прогони bench для Rust-порта в rust/text-rs против оригинала и скажи, стоит ли выпускать».

Установка

cargo install rust-anything   # from crates.io
rust-anything setup           # registers it with Claude Code, Codex, Cursor, Gemini CLI and OpenCode

Если тулчейна Rust ещё нет, на каждой странице релизов лежат готовые бинарники для macOS, Linux и Windows. Для JavaScript-проектов тот же бинарник ставится через npm install -g rust-anything.

Ограничения и предостережения

rust-anything ловит только то, что покрывает запись: поведение, которое ни разу не записано, проверка не заметит. Об этом честно написано в разделе What it can't catch.

Второе предостережение — от авторов: команды record и diff по много раз запускают ваш настоящий код, и код, который пишет в файлы, ходит в базу или в сеть, делает это на каждом прогоне. Запускайте их на копии проекта, с тестовой базой и без рабочих ключей в окружении.

Проект независимый и не связан с Rust Project или Rust Foundation. Подробности о внутреннем устройстве — в документации, разборы реальных переносов json-server, Fuse.js и vercel/ms — в docs/real-world.md, перенос целых приложений — в docs/whole-apps.md, все способы установки — в docs/install.md, а частые вопросы — в FAQ.

Источник: https://github.com/erkamyaman/rust-anything