traxys/tree-sitter
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
tree-sitter/docs/src/using-parsers/7-abi-versions.md
Will Lillis e92a7803eb fix(docs): final updates before 0.26.1 
- Indicate where xtask looks for wasi-sdk
- Indicate where `build --wasm` looks for and downloads wasi-sdk binary
  to
- Mark native runtime as experimental, describe limitations
- Note ABI 13 support limitations
- Mention that `test --wasm` and `parse --wasm` require
  `--features=wasm` build
2025-11-24 15:18:12 +01:00

1.5 KiB
Raw Blame History

ABI versions

Parsers generated with tree-sitter have an associated ABI version, which establishes hard compatibility boundaries between the generated parser and the tree-sitter library.

A given version of the tree-sitter library is only able to load parsers generated with supported ABI versions:

tree-sitter version Min parser ABI version Max parser ABI version
0.14 9 9
>=0.15.0, <=0.15.7 9 10
>=0.15.8, <=0.16 9 11
0.17, 0.18 9 12
>=0.19, <=0.20.2 13 13
>=0.20.3, <=0.24 13 14
>=0.25 13 15

By default, the tree-sitter CLI will generate parsers using the latest available ABI for that version, but an older ABI (supported by the CLI) can be selected by passing the --abi option to the generate command.

Note that the ABI version range supported by the CLI can be smaller than for the library: When a new ABI version is released, older versions will be phased out over a deprecation period, which starts with no longer being able to generate parsers with the oldest ABI version.