Installation

For most users, you'll want to install this as a text editor extension. Each editor has its own installation instructions to follow. If you're looking to use tree-sitter-fasta as a library through Tree-sitter's supported language bindings, see Library installation.

Tree-sitter parsers are dynamic libraries compiled from C code, so you'll need a C compiler available on your system. Common choices include:

The parser is generated with tree-sitter version 0.26, which has a minimum parser application binary interface (ABI) of 13 and max parser ABI of 15.

Editor extensions

The following editors are supported:

• Helix

Tree-sitter parsers are supported by the following editors, but installation is not supported at this time:

• Visual Studio Code / VSCodium / Other forks ¹
• Sublime Text ²
• Neovim ³
• Zed / Gram ⁴
• Lapce ⁵
• Emacs ⁶

Helix

We need to add a fasta language and grammar to Helix's languages.toml configuration file.

[[language]] # (1)!
name = "fasta"
scope = "source.fasta"
file-types = ["fasta", "ffn", "fa", "fas", "faa", "frn", "mpfa", "fna"]
roots = []

[[grammar]] # (2)!
name = "fasta"
source = { git = "https://gitlab.com/jrhawley/tree-sitter-fasta", rev = "0110bfa32c90f12a82fe14233dbb482c4d1a4a8c" } # (3)!

[[language]] # (1)!
name = "fasta"
scope = "source.fasta"
file-types = ["fasta", "ffn", "fa", "fas", "faa", "frn", "mpfa", "fna"]
roots = []

[[grammar]] # (2)!
name = "fasta"
source = { git = "https://gitlab.com/jrhawley/tree-sitter-fasta", rev = "0110bfa32c90f12a82fe14233dbb482c4d1a4a8c" } # (3)!

[[language]] # (1)!
name = "fasta"
scope = "source.fasta"
file-types = ["fasta", "ffn", "fa", "fas", "faa", "frn", "mpfa", "fna"]
roots = []

[[grammar]] # (2)!
name = "fasta"
source = { git = "https://gitlab.com/jrhawley/tree-sitter-fasta", rev = "0110bfa32c90f12a82fe14233dbb482c4d1a4a8c" } # (3)!

Then fetch and build the grammars to install it into Helix's runtime directory.

hx --grammar fetch
hx --grammar build

hx --health fasta

Configured language servers: None
Configured debug adapter: None
Configured formatter: None
Tree-sitter parser: ✓ # (1)!
Highlight queries: ✓  # (2)!
Textobject queries: ✘
Indent queries: ✘

hx --health fasta

Configured language servers: None
Configured debug adapter: None
Configured formatter: None
Tree-sitter parser: ✓ # (1)!
Highlight queries: ✓  # (2)!
Textobject queries: ✘
Indent queries: ✘

hx --health fasta

Configured language servers: None
Configured debug adapter: None
Configured formatter: None
Tree-sitter parser: ✓ # (1)!
Highlight queries: ✓  # (2)!
Textobject queries: ✘
Indent queries: ✘

See Helix's language configuration docs for additional details.

Library installation

Tree-sitter has multiple official language bindings that allow Tree-sitter parsers to be used from other programming languages. Below are some examples of how to load tree-sitter-fasta parsers in those languages.

Rust

Add tree-sitter and tree-sitter-fasta to your project's Cargo.toml manifest.

[dependencies]
tree-sitter = "0.26.8"
tree-sitter-fasta = { git = "https://gitlab.com/jrhawley/tree-sitter-fasta" }

Then, in your code you can add the parser.

use tree_sitter::{InputEdit, Language, Parser, Point};

let mut parser = Parser::new();
parser.set_language(&tree_sitter_fasta::LANGUAGE.into()).expect("Error loading FASTA grammar");

let source_code = r#">chr1
ACTAGTAGTCTA"#;
let mut tree = parser.parse(source_code, None).unwrap();
let root_node = tree.root_node();

assert_eq!(root_node.kind(), "source_file");
assert_eq!(root_node.start_position().column, 0);
assert_eq!(root_node.end_position().column, 12);

See tree-sitter for details.

Python

pip install tree-sitter
pip install git+https://gitlab.com/jrhawley/tree-sitter-fasta.git

conda install -c conda-forge tree_sitter
python -m pip install git+https://gitlab.com/jrhawley/tree-sitter-fasta.git

Then, in your code you can add the parser.

import tree_sitter_fasta as tsfasta
from tree_sitter import Language, Parser

FA_LANGUAGE = Language(tsfasta.language())
parser = Parser(FA_LANGUAGE)

source_code = """>chr1
ACTAGTAGTCTA"""
tree = parser.parse(bytes(source_code, "utf8"))
root_node = tree.root_node

assert root_node.type == "source_file"
assert root_node.start_point == (0, 0)
assert root_node.end_point == (1, 12)

See py-tree-sitter for details.