rust-anything: переносим приложение на Rust по частям и доказываем, что поведение не изменилось
📂 Исходный код на GitHubCLI-инструмент, который помогает переписать приложение на Rust по частям: записывает поведение оригинала на тестовых входных данных, генерирует мост для вызова Rust-кода с прежним API и не выпускает ни одну часть, пока она не совпадёт с записью.
rust-anything — это CLI-инструмент для переноса приложений на Rust. Вы указываете на своё приложение, а он записывает, что оригинал делает на сотнях тестовых входных данных. Дальше кодинг-агент пишет Rust по кусочкам, и каждый кусочек проверяется на совпадение с записью, прежде чем двигаться дальше. Инструмент не переводит код сам: Rust пишет ваш агент (Claude Code, Codex, Cursor, OpenCode) или вы. rust-anything даёт то, что агент угадать не может: куда уходит время, что переносить первым, мост, чтобы остальной код вызывал Rust через прежний API, и финальную проверку, которая говорит, когда перенос готов. Проект написан на Rust, распространяется по лицензии MIT и собрал на GitHub больше шести тысяч звёзд.
Четыре шага цикла
Работа делится на четыре шага:
- Record — команда
recordзапускает оригинал на сгенерированных краевых случаях, смысловых ловушках и ваших входных данных. Она сохраняет то, что функции возвращают и что бросают. - Port — команда
bridgeсоздаёт крейт (пакет на Rust) и обёртку, чтобы вызывающий код работал через прежний API. Сам Rust пишет агент или человек. - Check — команда
diffпрогоняет каждую записанную ситуацию против Rust-версии. Пока всё не совпадёт иgateне пройдёт, перенос не считается готовым. - 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.