rust-anything 2.1.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,32 +4,42 @@
4
4
 
5
5
  <h1 align="center">rust-anything</h1>
6
6
 
7
- <p align="center"><b>Rewrite your app in Rust, and prove it still behaves the same.</b></p>
7
+ <p align="center"><sub>English · <a href="docs/README_TR.md">Türkçe</a> · <a href="docs/README_UK.md">Українська</a> · <a href="docs/README_ZH.md">简体中文</a> · <a href="docs/README_ZH-TW.md">繁體中文</a> · <a href="docs/README_DE.md">Deutsch</a> · <a href="docs/README_FR.md">Français</a> · <a href="docs/README_RU.md">Русский</a> · <a href="docs/README_JA.md">日本語</a> · <a href="docs/README_KO.md">한국어</a> · <a href="docs/README_AZ.md">Azərbaycanca</a> · <a href="docs/README_UZ.md">Oʻzbekcha</a> · <a href="docs/README_KK.md">Қазақша</a> · <a href="docs/README_KY.md">Кыргызча</a> · <a href="docs/README_TK.md">Türkmençe</a> · <a href="docs/README_TT.md">Татарча</a> · <a href="docs/README_UG.md">ئۇيغۇرچە</a> · <a href="docs/README_PT.md">Português</a> · <a href="docs/README_VI.md">Tiếng Việt</a></sub></p>
8
8
 
9
- <p align="center">New in 2.0: <a href="docs/real-world.md#prettier">Prettier, ported to Rust</a>. 19x faster · 15,837 of 17,224 recorded runs fully in Rust · every run byte-identical</p>
9
+ <p align="center"><b>Rewrite your app in Rust, and prove it still behaves the same.</b><br>
10
+ Point it at your app: it records what the original does, your coding agent writes the Rust one piece at a time,<br>
11
+ and every piece is checked against that recording before it moves on. It doesn't translate code; it proves the rewrite.</p>
10
12
 
11
13
  <p align="center">
14
+ <img src="https://img.shields.io/github/languages/top/erkamyaman/rust-anything?logo=rust&label=Rust&color=CE422B" alt="Rust share of the code">
15
+ <img src="https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows-native-2563EB" alt="Native binaries for macOS, Linux and Windows">
16
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-555" alt="MIT license"></a>
12
17
  <a href="https://crates.io/crates/rust-anything"><img src="https://img.shields.io/crates/v/rust-anything?color=E2862A&label=crates.io" alt="crates.io version"></a>
13
18
  <a href="https://www.npmjs.com/package/rust-anything"><img src="https://img.shields.io/npm/v/rust-anything?color=E2862A&label=npm" alt="npm version"></a>
14
- <a href="https://github.com/erkamyaman/rust-anything/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/erkamyaman/rust-anything/ci.yml?branch=main&label=tests" alt="Tests"></a>
15
- <a href="https://github.com/erkamyaman/rust-anything"><img src="https://img.shields.io/github/stars/erkamyaman/rust-anything?style=social" alt="GitHub stars"></a>
19
+ <br>
20
+ <a href="https://coderabbit.link/erkamyaman"><img src="https://img.shields.io/coderabbit/prs/github/erkamyaman/rust-anything?labelColor=171717&color=FF570A&label=Reviewed+by+CodeRabbit" alt="Pull requests reviewed by CodeRabbit"></a>
21
+ <a href="https://github.com/rust-unofficial/awesome-rust#development-tools"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Rust"></a>
16
22
  <a href="https://github.com/AIshihzong/awesome-reverse-engineer-anything"><img src="https://img.shields.io/badge/Featured%20in-Awesome%20REA-f0b429" alt="Featured in Awesome REA"></a>
23
+ <a href="https://github.com/erkamyaman/rust-anything"><img src="https://img.shields.io/github/stars/erkamyaman/rust-anything?style=social" alt="GitHub stars"></a>
17
24
  </p>
18
25
 
19
- <p align="center">
20
- <a href="#quick-start">Quick start</a> ·
21
- <a href="#languages">Languages</a> ·
22
- <a href="docs/real-world.md">Real-world ports</a> ·
23
- <a href="docs/how-it-works.md#how-it-works">How it works</a> ·
24
- <a href="docs/whole-apps.md#port-a-whole-app">Whole apps</a> ·
25
- <a href="docs/faq.md#faq">FAQ</a>
26
- </p>
26
+ <p align="center"><a href="https://github.com/erkamyaman/rust-anything/discussions/127"><img src="https://img.shields.io/badge/Join%20the%20discussion-6E40C9?style=for-the-badge&logo=github&logoColor=white" alt="Join the discussion"></a></p>
27
27
 
28
- <p align="center">Made in Türkiye 🇹🇷 by <a href="https://github.com/erkamyaman">erKam Yaman</a> · <a href="LICENSE">MIT</a> · <a href="https://github.com/sponsors/erkamyaman">❤️ Sponsor me</a></p>
28
+ <p align="center"><a href="https://trendshift.io/repositories/363468" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/363468/daily?language=Rust" alt="erkamyaman/rust-anything: #1 Rust repository of the day on Trendshift" width="250" height="55"/></a></p>
29
29
 
30
- <p align="center">Sponsored by <a href="https://coderabbit.ai"><img src="docs/assets/brands/coderabbit.png" width="22" height="22" align="absmiddle" alt=""> <b>CodeRabbit</b></a></p>
30
+ <p align="center"><b><a href="#quick-start">Install</a></b> · <a href="https://github.com/erkamyaman/rust-anything/releases">Releases</a> · <a href="#quick-start">Claude Code plugin</a> · <a href="https://registry.modelcontextprotocol.io/v0.1/servers?search=rust-anything">MCP Registry</a> · <a href="docs/real-world.md">Real-world ports</a> · <a href="docs/faq.md#faq">FAQ</a><br>
31
+ <sub><a href="#languages">Languages</a> · <a href="docs/how-it-works.md#how-it-works">How it works</a> · <a href="docs/whole-apps.md#port-a-whole-app">Whole apps</a> · <a href="#sponsors">Sponsors</a> · <a href="LICENSE">MIT</a></sub><br>
32
+ Made in Türkiye 🇹🇷 by <a href="https://github.com/erkamyaman">erKam Yaman</a> · <a href="https://github.com/sponsors/erkamyaman">❤️ Sponsor me</a> · Sponsored by <a href="https://coderabbit.link/erkamyaman"><img src="docs/assets/brands/coderabbit.png" width="22" height="22" align="absmiddle" alt=""> <b>CodeRabbit</b></a></p>
31
33
 
32
- <p align="center"><sub>English · <a href="docs/README_TR.md">Türkçe</a> · <a href="docs/README_UK.md">Українська</a> · <a href="docs/README_ZH.md">简体中文</a> · <a href="docs/README_ZH-TW.md">繁體中文</a> · <a href="docs/README_DE.md">Deutsch</a> · <a href="docs/README_FR.md">Français</a> · <a href="docs/README_RU.md">Русский</a> · <a href="docs/README_JA.md">日本語</a> · <a href="docs/README_KO.md">한국어</a> · <a href="docs/README_AZ.md">Azərbaycanca</a> · <a href="docs/README_UZ.md">Oʻzbekcha</a> · <a href="docs/README_KK.md">Қазақша</a> · <a href="docs/README_KY.md">Кыргызча</a> · <a href="docs/README_TK.md">Türkmençe</a> · <a href="docs/README_TT.md">Татарча</a> · <a href="docs/README_UG.md">ئۇيغۇرچە</a> · <a href="docs/README_PT.md">Português</a> · <a href="docs/README_VI.md">Tiếng Việt</a></sub></p>
34
+ <p align="center">New in 2.0: <a href="docs/real-world.md#prettier">Prettier, ported to Rust</a>. 19x faster · 15,861 of 17,224 recorded runs fully in Rust · every run byte-identical</p>
35
+
36
+ <p align="center">
37
+ <img src="docs/assets/prettier.gif" alt="Prettier and its Rust port format the same 59 real files, one process per file: Prettier takes 3.63 s, the Rust port 0.20 s, with the same output byte for byte." width="820">
38
+ <br>
39
+ <sub>Prettier against its Rust port on 59 real files from ms, Fuse.js and json-server (Apple M4). Same output, byte for byte. <a href="docs/real-world.md#prettier">How it was measured</a>.</sub>
40
+ </p>
41
+
42
+ <p align="center"><sub>PHP and C#: record, replay and the front door today; unit ports come next.</sub></p>
33
43
 
34
44
  <table>
35
45
  <tr>
@@ -55,7 +65,10 @@
55
65
  **Rewrite your whole app in Rust, one piece at a time.** rust-anything records what your
56
66
  Node.js (TypeScript/JavaScript), Python, C, Go, Ruby, Java or Kotlin app does today, then checks every piece of the
57
67
  Rust rewrite against that recording before it moves on, until the app is pure Rust. CLIs, HTTP
58
- servers and libraries; your coding agent (or you) writes the Rust. It can only catch what the
68
+ servers and libraries; your coding agent (or you) writes the Rust. It is built on
69
+ [napi-rs](https://github.com/napi-rs/napi-rs), [PyO3](https://github.com/PyO3/pyo3) and
70
+ [wasm-bindgen](https://github.com/wasm-bindgen/wasm-bindgen), which carry the calls between your
71
+ language and Rust; rust-anything decides what to move and proves it matches. It can only catch what the
59
72
  recording covers: see [What it can't catch](docs/how-it-works.md#what-it-cant-catch). Whole tools
60
73
  and servers, or only the slow part, one hot path at a time:
61
74
 
@@ -67,18 +80,15 @@ and servers, or only the slow part, one hot path at a time:
67
80
  | json-server, from start to first response | 79 to 85 ms | **8 to 10 ms** |
68
81
  | [Fuse.js](docs/real-world.md#fusejs) search over 50,000 strings, per query | 91.2 ms | **2.8 ms: 32x faster** |
69
82
 
70
- Prettier: 15,837 of 17,224 recorded runs format fully in Rust across 10 languages (JavaScript,
83
+ Prettier: 15,861 of 17,224 recorded runs format fully in Rust across 10 languages (JavaScript,
71
84
  TypeScript, JSX, JSON, GraphQL, YAML, Markdown, CSS, SCSS, Less), and all 17,224 match Prettier
72
85
  byte for byte, since anything not ported yet falls back to Prettier. json-server: 514/514
73
86
  recorded HTTP cases match on a pure Rust binary. Measured on an Apple M4, two runs each, every
74
87
  output compared before timing ([details](docs/real-world.md)). Calling Rust once per small
75
- function is usually *slower* than a JIT; rust-anything finds the loop worth moving, and moves it.
76
-
77
- <p align="center">
78
- <img src="docs/assets/prettier.gif" alt="Prettier and its Rust port format the same 59 real files, one process per file: Prettier takes 3.63 s, the Rust port 0.20 s, with the same output byte for byte." width="820">
79
- <br>
80
- <sub>Prettier against its Rust port on 59 real files from ms, Fuse.js and json-server (Apple M4). Same output, byte for byte. <a href="docs/real-world.md#prettier">How it was measured</a>.</sub>
81
- </p>
88
+ function is usually *slower* than a JIT; rust-anything finds the loop worth moving, and moves it. Against
89
+ C the win is safety, not speed: [ffmpeg's libavutil](docs/real-world.md#ffmpeg) ported to Rust
90
+ matches all 226,447 recorded calls and runs at about C's speed (18 of 42 benchmarks even, 8
91
+ faster, 16 slower by 3 to 40%).
82
92
 
83
93
  <p align="center">
84
94
  <img src="docs/assets/json-server.gif" alt="json-server as a Node server and as one Rust binary: memory at idle 74 MB and 3.5 MB, start to first response 79 to 85 ms and 8 to 10 ms, and 514 of 514 recorded HTTP cases match." width="820">
@@ -96,6 +106,28 @@ function is usually *slower* than a JIT; rust-anything finds the loop worth movi
96
106
  > database or calls the network does that once per case. Run them on a copy of the project, with a
97
107
  > test database and no production credentials in the environment.
98
108
 
109
+ ## Install the ports
110
+
111
+ The ESLint port is an npm command. It runs the Rust port for what it covers and ESLint 10.15.0,
112
+ pinned as a dependency, for everything else, so the output is ESLint's either way:
113
+
114
+ ```sh
115
+ npm install -g eslint-rs # ESLint 10.15.0
116
+ ```
117
+
118
+ | Command | Answered in Rust | Handed to ESLint 10.15.0 |
119
+ | --- | --- | --- |
120
+ | `eslint-rs` | `--no-config-lookup --rule ... --stdin` with the 90 ported rules (`stylish` and `json` output, fixes, suggestions) | `eslint.config.*` lookups (`eslint .`), files and folders, the other 202 core rules, plugins, parsers, the other formatters, parse errors |
121
+
122
+ The binary comes for macOS (arm64, x64) and Linux (x64, arm64, glibc). On Windows and elsewhere,
123
+ or with `RUST_ANYTHING_MODE=old`, `eslint-rs` runs ESLint itself: same output, no speedup.
124
+ Installed from its tarballs on macOS arm64, `eslint-rs` matches ESLint 10.15.0 installed beside it
125
+ on all 10,585 recorded runs ([how](docs/packaging.md#a-whole-cli-front-door)).
126
+
127
+ The Prettier port is packaged the same way (`prettier-rs`, Prettier 3.6.2) and replays
128
+ 17,224/17,224 recorded runs from its tarballs, 7.9% handed to Prettier, but it is not on npm.
129
+ `rust-anything package` makes this kind of package from any CLI front door.
130
+
99
131
  ## Quick start
100
132
 
101
133
  Paste this into Claude Code, Codex, Cursor, Gemini CLI or OpenCode and let your agent install it:
@@ -123,6 +155,14 @@ must be on your `PATH`):
123
155
  /plugin install rust-anything --marketplace erkamyaman/rust-anything
124
156
  ```
125
157
 
158
+ In Codex, from the agents marketplace in this repo (`.agents/plugins/marketplace.json`, the same
159
+ plugin under `plugin/`, with the skill and MCP server):
160
+
161
+ ```sh
162
+ codex plugin marketplace add erkamyaman/rust-anything
163
+ codex plugin add rust-anything@rust-anything
164
+ ```
165
+
126
166
  `setup` adds the MCP server to each agent it finds and installs the workflow skill where the agent
127
167
  reads skills. It keeps your other settings, is safe to run again, and `--remove` undoes it.
128
168
  Then ask your agent, for example:
@@ -143,7 +183,7 @@ Then ask your agent, for example:
143
183
  | OpenCode | MCP server in `~/.config/opencode/opencode.json` (`mcp.servers`), skill in `~/.config/opencode/skills/` |
144
184
  | Any other MCP client | add `rust-anything mcp` as a stdio server by hand (see [Install](docs/install.md#install)) |
145
185
 
146
- Before changing a file that exists, `setup` saves a copy beside it (`<file>.rust-anything.bak`).
186
+ Before changing a file that exists, `setup` saves a copy beside it (`<file>.rust-anything.bak`); `--no-backup` skips the copy.
147
187
 
148
188
  To wire OpenCode up by hand, put the server in `~/.config/opencode/opencode.json` (`command` is
149
189
  the whole argv) and copy [`skills/rust-anything/`](./skills/rust-anything) to
@@ -167,6 +207,7 @@ rust-anything bridge . src/fuzzy.ts --batch fuzzyScore:text
167
207
  # write src/port.rs (or let your agent), then:
168
208
  rust-anything record rust/fuzzy-rs && rust-anything build rust/fuzzy-rs
169
209
  rust-anything diff rust/fuzzy-rs # every recorded case must match
210
+ rust-anything fuzz rust/fuzzy-rs --time 60 --keep # fresh inputs: what the recording missed
170
211
  rust-anything bench rust/fuzzy-rs # faster? the verdict says
171
212
  rust-anything gate rust/fuzzy-rs # done means this passes
172
213
  ```
@@ -240,6 +281,7 @@ comes next.
240
281
  ## Learn more
241
282
 
242
283
  - [How it works](docs/how-it-works.md): the loop, what `bridge` and `analyze` decide, hot paths, what it can't catch, what a real port takes, and keeping up with the original (`map`)
284
+ - [Ship a port as a package](docs/packaging.md): maturin wheels and napi-rs per-platform npm packages, with the CI that builds them
243
285
  - [Port a whole app](docs/whole-apps.md): servers, CLIs and libraries, from the front door to `app lift`
244
286
  - [Examples and case studies](docs/examples.md): x18n, and real code in six languages
245
287
  - [Real-world ports](docs/real-world.md): json-server, Fuse.js, vercel/ms, with benchmarks
@@ -254,7 +296,7 @@ comes next.
254
296
  </p>
255
297
 
256
298
  <p align="center">
257
- <a href="https://coderabbit.ai">
299
+ <a href="https://coderabbit.link/erkamyaman">
258
300
  <picture>
259
301
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/sponsors/company-dark.svg">
260
302
  <img src="docs/assets/sponsors/company-light.svg" width="800" alt="Company sponsor: CodeRabbit">
@@ -273,6 +315,7 @@ comes next.
273
315
 
274
316
  <p align="center">
275
317
  <a href="https://github.com/sponsors/erkamyaman"><img src="https://img.shields.io/badge/Become_a_sponsor-%E2%9D%A4-db61a2?style=for-the-badge&logo=githubsponsors&logoColor=white" alt="Become a sponsor"></a>
318
+ <a href="https://buymeacoffee.com/erkamyaman"><img src="https://img.shields.io/badge/Buy_me_a_coffee-%E2%98%95-FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=black" alt="Buy me a coffee"></a>
276
319
  </p>
277
320
 
278
321
  ## Contributing
Binary file
Binary file
Binary file
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rust-anything",
3
- "version": "2.1.0",
3
+ "version": "3.0.0",
4
4
  "description": "Rewrite your app in Rust, one piece at a time, checked against the original's recorded behavior at every step. TypeScript, Python, C, Go, Ruby, Java.",
5
5
  "keywords": [
6
6
  "rust",