mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-09-24 21:00:13 +01:00
Chandler Carruth
8fd4156616
This implements p7016 for tree_sitter. It also updates the build and source file to allow this to build successfully and documents how to successfully run these tests with Bazel given that it is fundamentally not hermetic. Assisted-by: Antigravity with Gemini
Tree-sitter grammar for Carbon
Tree-sitter is currently used for syntax highlighting in supported editors.
Development
We use a non-hermetic tree-sitter invocation, so it must be installed locally. To install tree-sitter, run:
npm install -g tree-sitter-cli
Building and Testing
To build and test changes to the grammar using Bazel, provide specific flags to
allow the build to access the system tree-sitter binary and environment.
bazel test //utils/tree_sitter:string_tests \
--strategy=Genrule=local \
--action_env=PATH \
--action_env=HOME
--strategy=Genrule=local: Disables sandboxing for the genrule that runstree-sitter generate, allowing it to find the system-installed binary.--action_env=PATH: Passes your currentPATHto the build actions, ensuringtree-sittercan be found. Iftree-sitteris not in your default PATH, you can specify it explicitly, for example:--action_env=PATH=/path/to/tree-sitter/bin:$PATH.--action_env=HOME: Passes yourHOMEenvironment variable, whichtree-sittermay need to locate its configuration or cache.
Editor Installation
Helix
- Install tree-sitter and Nodejs.
- Install Helix.
- Run
./helix.sh
Emacs
TODO