Skip to main content

tree_sitter_cli/
init.rs

1use std::{
2    fs,
3    path::{Path, PathBuf},
4    str::{self, FromStr},
5};
6
7use anyhow::{anyhow, Context, Result};
8use crc32fast::hash as crc32;
9use heck::{ToKebabCase, ToShoutySnakeCase, ToSnakeCase, ToUpperCamelCase};
10use indoc::{formatdoc, indoc};
11use log::info;
12use rand::{thread_rng, Rng};
13use semver::Version;
14use serde::{Deserialize, Serialize};
15use serde_json::{Map, Value};
16use tree_sitter_generate::write_file;
17use tree_sitter_loader::{
18    Author, Bindings, Grammar, Links, Metadata, PathsJSON, TreeSitterJSON,
19    DEFAULT_HIGHLIGHTS_QUERY_FILE_NAME, DEFAULT_INJECTIONS_QUERY_FILE_NAME,
20    DEFAULT_LOCALS_QUERY_FILE_NAME, DEFAULT_TAGS_QUERY_FILE_NAME,
21};
22
23const CLI_VERSION: &str = env!("CARGO_PKG_VERSION");
24const CLI_VERSION_PLACEHOLDER: &str = "CLI_VERSION";
25
26const ABI_VERSION_MAX: usize = tree_sitter::LANGUAGE_VERSION;
27const ABI_VERSION_MAX_PLACEHOLDER: &str = "ABI_VERSION_MAX";
28
29const PARSER_NAME_PLACEHOLDER: &str = "PARSER_NAME";
30const CAMEL_PARSER_NAME_PLACEHOLDER: &str = "CAMEL_PARSER_NAME";
31const TITLE_PARSER_NAME_PLACEHOLDER: &str = "TITLE_PARSER_NAME";
32const UPPER_PARSER_NAME_PLACEHOLDER: &str = "UPPER_PARSER_NAME";
33const LOWER_PARSER_NAME_PLACEHOLDER: &str = "LOWER_PARSER_NAME";
34const KEBAB_PARSER_NAME_PLACEHOLDER: &str = "KEBAB_PARSER_NAME";
35const PARSER_CLASS_NAME_PLACEHOLDER: &str = "PARSER_CLASS_NAME";
36
37const PARSER_DESCRIPTION_PLACEHOLDER: &str = "PARSER_DESCRIPTION";
38const PARSER_LICENSE_PLACEHOLDER: &str = "PARSER_LICENSE";
39const PARSER_NS_PLACEHOLDER: &str = "PARSER_NS";
40const PARSER_NS_CLEANED_PLACEHOLDER: &str = "PARSER_NS_CLEANED";
41const PARSER_URL_PLACEHOLDER: &str = "PARSER_URL";
42const PARSER_URL_STRIPPED_PLACEHOLDER: &str = "PARSER_URL_STRIPPED";
43const PARSER_VERSION_PLACEHOLDER: &str = "PARSER_VERSION";
44const PARSER_FINGERPRINT_PLACEHOLDER: &str = "PARSER_FINGERPRINT";
45
46const AUTHOR_NAME_PLACEHOLDER: &str = "PARSER_AUTHOR_NAME";
47const AUTHOR_EMAIL_PLACEHOLDER: &str = "PARSER_AUTHOR_EMAIL";
48const AUTHOR_URL_PLACEHOLDER: &str = "PARSER_AUTHOR_URL";
49
50const AUTHOR_BLOCK_JS: &str = "\n  \"author\": {";
51const AUTHOR_NAME_PLACEHOLDER_JS: &str = "\n    \"name\": \"PARSER_AUTHOR_NAME\",";
52const AUTHOR_EMAIL_PLACEHOLDER_JS: &str = ",\n    \"email\": \"PARSER_AUTHOR_EMAIL\"";
53const AUTHOR_URL_PLACEHOLDER_JS: &str = ",\n    \"url\": \"PARSER_AUTHOR_URL\"";
54
55const AUTHOR_BLOCK_PY: &str = "\nauthors = [{";
56const AUTHOR_NAME_PLACEHOLDER_PY: &str = "name = \"PARSER_AUTHOR_NAME\"";
57const AUTHOR_EMAIL_PLACEHOLDER_PY: &str = ", email = \"PARSER_AUTHOR_EMAIL\"";
58
59const AUTHOR_BLOCK_RS: &str = "\nauthors = [";
60const AUTHOR_NAME_PLACEHOLDER_RS: &str = "PARSER_AUTHOR_NAME";
61const AUTHOR_EMAIL_PLACEHOLDER_RS: &str = " PARSER_AUTHOR_EMAIL";
62
63const AUTHOR_BLOCK_JAVA: &str = "\n    <developer>";
64const AUTHOR_NAME_PLACEHOLDER_JAVA: &str = "\n      <name>PARSER_AUTHOR_NAME</name>";
65const AUTHOR_EMAIL_PLACEHOLDER_JAVA: &str = "\n      <email>PARSER_AUTHOR_EMAIL</email>";
66const AUTHOR_URL_PLACEHOLDER_JAVA: &str = "\n      <url>PARSER_AUTHOR_URL</url>";
67
68const AUTHOR_BLOCK_GRAMMAR: &str = "\n * @author ";
69const AUTHOR_NAME_PLACEHOLDER_GRAMMAR: &str = "PARSER_AUTHOR_NAME";
70const AUTHOR_EMAIL_PLACEHOLDER_GRAMMAR: &str = " PARSER_AUTHOR_EMAIL";
71
72const FUNDING_URL_PLACEHOLDER: &str = "FUNDING_URL";
73
74const HIGHLIGHTS_QUERY_PATH_PLACEHOLDER: &str = "HIGHLIGHTS_QUERY_PATH";
75const INJECTIONS_QUERY_PATH_PLACEHOLDER: &str = "INJECTIONS_QUERY_PATH";
76const LOCALS_QUERY_PATH_PLACEHOLDER: &str = "LOCALS_QUERY_PATH";
77const TAGS_QUERY_PATH_PLACEHOLDER: &str = "TAGS_QUERY_PATH";
78
79const GRAMMAR_JS_TEMPLATE: &str = include_str!("./templates/grammar.js");
80const PACKAGE_JSON_TEMPLATE: &str = include_str!("./templates/package.json");
81const GITIGNORE_TEMPLATE: &str = include_str!("./templates/gitignore");
82const GITATTRIBUTES_TEMPLATE: &str = include_str!("./templates/gitattributes");
83const EDITORCONFIG_TEMPLATE: &str = include_str!("./templates/.editorconfig");
84
85const RUST_BINDING_VERSION: &str = env!("CARGO_PKG_VERSION");
86const RUST_BINDING_VERSION_PLACEHOLDER: &str = "RUST_BINDING_VERSION";
87
88const LIB_RS_TEMPLATE: &str = include_str!("./templates/lib.rs");
89const BUILD_RS_TEMPLATE: &str = include_str!("./templates/build.rs");
90const CARGO_TOML_TEMPLATE: &str = include_str!("./templates/_cargo.toml");
91
92const INDEX_JS_TEMPLATE: &str = include_str!("./templates/index.js");
93const INDEX_D_TS_TEMPLATE: &str = include_str!("./templates/index.d.ts");
94const JS_BINDING_CC_TEMPLATE: &str = include_str!("./templates/js-binding.cc");
95const BINDING_GYP_TEMPLATE: &str = include_str!("./templates/binding.gyp");
96const BINDING_TEST_JS_TEMPLATE: &str = include_str!("./templates/binding_test.js");
97
98const MAKEFILE_TEMPLATE: &str = include_str!("./templates/makefile");
99const CMAKELISTS_TXT_TEMPLATE: &str = include_str!("./templates/cmakelists.cmake");
100const PARSER_NAME_H_TEMPLATE: &str = include_str!("./templates/PARSER_NAME.h");
101const PARSER_NAME_PC_IN_TEMPLATE: &str = include_str!("./templates/PARSER_NAME.pc.in");
102
103const GO_MOD_TEMPLATE: &str = include_str!("./templates/go.mod");
104const BINDING_GO_TEMPLATE: &str = include_str!("./templates/binding.go");
105const BINDING_TEST_GO_TEMPLATE: &str = include_str!("./templates/binding_test.go");
106
107const SETUP_PY_TEMPLATE: &str = include_str!("./templates/setup.py");
108const INIT_PY_TEMPLATE: &str = include_str!("./templates/__init__.py");
109const INIT_PYI_TEMPLATE: &str = include_str!("./templates/__init__.pyi");
110const PYPROJECT_TOML_TEMPLATE: &str = include_str!("./templates/pyproject.toml");
111const PY_BINDING_C_TEMPLATE: &str = include_str!("./templates/py-binding.c");
112const TEST_BINDING_PY_TEMPLATE: &str = include_str!("./templates/test_binding.py");
113
114const PACKAGE_SWIFT_TEMPLATE: &str = include_str!("./templates/package.swift");
115const TESTS_SWIFT_TEMPLATE: &str = include_str!("./templates/tests.swift");
116
117const POM_XML_TEMPLATE: &str = include_str!("./templates/pom.xml");
118const BINDING_JAVA_TEMPLATE: &str = include_str!("./templates/binding.java");
119const TEST_JAVA_TEMPLATE: &str = include_str!("./templates/test.java");
120
121const BUILD_ZIG_TEMPLATE: &str = include_str!("./templates/build.zig");
122const BUILD_ZIG_ZON_TEMPLATE: &str = include_str!("./templates/build.zig.zon");
123const ROOT_ZIG_TEMPLATE: &str = include_str!("./templates/root.zig");
124const TEST_ZIG_TEMPLATE: &str = include_str!("./templates/test.zig");
125
126pub const TREE_SITTER_JSON_SCHEMA: &str =
127    "https://tree-sitter.github.io/tree-sitter/assets/schemas/config.schema.json";
128
129#[derive(Serialize, Deserialize, Clone)]
130pub struct JsonConfigOpts {
131    pub name: String,
132    pub camelcase: String,
133    pub title: String,
134    pub description: String,
135    #[serde(skip_serializing_if = "Option::is_none")]
136    pub repository: Option<String>,
137    #[serde(skip_serializing_if = "Option::is_none")]
138    pub funding: Option<String>,
139    pub scope: String,
140    pub file_types: Vec<String>,
141    pub version: Version,
142    pub license: String,
143    pub author: String,
144    #[serde(skip_serializing_if = "Option::is_none")]
145    pub email: Option<String>,
146    #[serde(skip_serializing_if = "Option::is_none")]
147    pub url: Option<String>,
148    pub namespace: Option<String>,
149    pub bindings: Bindings,
150}
151
152impl JsonConfigOpts {
153    #[must_use]
154    pub fn to_tree_sitter_json(self) -> TreeSitterJSON {
155        TreeSitterJSON {
156            schema: Some(TREE_SITTER_JSON_SCHEMA.to_string()),
157            grammars: vec![Grammar {
158                name: self.name.clone(),
159                camelcase: Some(self.camelcase),
160                title: Some(self.title),
161                scope: self.scope,
162                path: None,
163                external_files: PathsJSON::Empty,
164                file_types: Some(self.file_types),
165                highlights: PathsJSON::Empty,
166                injections: PathsJSON::Empty,
167                locals: PathsJSON::Empty,
168                tags: PathsJSON::Empty,
169                injection_regex: Some(format!("^{}$", self.name)),
170                first_line_regex: None,
171                content_regex: None,
172                class_name: Some(format!("TreeSitter{}", self.name.to_upper_camel_case())),
173            }],
174            metadata: Metadata {
175                version: self.version,
176                license: Some(self.license),
177                description: Some(self.description),
178                authors: Some(vec![Author {
179                    name: self.author,
180                    email: self.email,
181                    url: self.url,
182                }]),
183                links: Some(Links {
184                    repository: self.repository.unwrap_or_else(|| {
185                        format!("https://github.com/tree-sitter/tree-sitter-{}", self.name)
186                    }),
187                    funding: self.funding,
188                }),
189                namespace: self.namespace,
190            },
191            bindings: self.bindings,
192        }
193    }
194}
195
196impl Default for JsonConfigOpts {
197    fn default() -> Self {
198        Self {
199            name: String::new(),
200            camelcase: String::new(),
201            title: String::new(),
202            description: String::new(),
203            repository: None,
204            funding: None,
205            scope: String::new(),
206            file_types: vec![],
207            version: Version::from_str("0.1.0").unwrap(),
208            license: String::new(),
209            author: String::new(),
210            email: None,
211            url: None,
212            namespace: None,
213            bindings: Bindings::default(),
214        }
215    }
216}
217
218struct GenerateOpts<'a> {
219    author_name: Option<&'a str>,
220    author_email: Option<&'a str>,
221    author_url: Option<&'a str>,
222    license: Option<&'a str>,
223    description: Option<&'a str>,
224    repository: Option<&'a str>,
225    funding: Option<&'a str>,
226    version: &'a Version,
227    camel_parser_name: &'a str,
228    title_parser_name: &'a str,
229    class_name: &'a str,
230    highlights_query_path: &'a str,
231    injections_query_path: &'a str,
232    locals_query_path: &'a str,
233    tags_query_path: &'a str,
234    namespace: Option<&'a str>,
235}
236
237pub fn generate_grammar_files(
238    repo_path: &Path,
239    language_name: &str,
240    allow_update: bool,
241    opts: Option<&JsonConfigOpts>,
242) -> Result<()> {
243    let dashed_language_name = language_name.to_kebab_case();
244
245    let tree_sitter_config = missing_path_else(
246        repo_path.join("tree-sitter.json"),
247        true,
248        |path| {
249            // invariant: opts is always Some when `tree-sitter.json` doesn't exist
250            let Some(opts) = opts else { unreachable!() };
251
252            let tree_sitter_json = opts.clone().to_tree_sitter_json();
253            write_file(path, serde_json::to_string_pretty(&tree_sitter_json)?)?;
254            Ok(())
255        },
256        |path| {
257            // updating the config, if needed
258            if let Some(opts) = opts {
259                let tree_sitter_json = opts.clone().to_tree_sitter_json();
260                write_file(path, serde_json::to_string_pretty(&tree_sitter_json)?)?;
261            }
262            Ok(())
263        },
264    )?;
265
266    let tree_sitter_config = serde_json::from_str::<TreeSitterJSON>(
267        &fs::read_to_string(tree_sitter_config.as_path())
268            .with_context(|| "Failed to read tree-sitter.json")?,
269    )?;
270
271    let authors = tree_sitter_config.metadata.authors.as_ref();
272    let camel_name = tree_sitter_config.grammars[0]
273        .camelcase
274        .clone()
275        .unwrap_or_else(|| language_name.to_upper_camel_case());
276    let title_name = tree_sitter_config.grammars[0]
277        .title
278        .clone()
279        .unwrap_or_else(|| language_name.to_upper_camel_case());
280    let class_name = tree_sitter_config.grammars[0]
281        .class_name
282        .clone()
283        .unwrap_or_else(|| format!("TreeSitter{}", language_name.to_upper_camel_case()));
284
285    let default_highlights_path = Path::new("queries").join(DEFAULT_HIGHLIGHTS_QUERY_FILE_NAME);
286    let default_injections_path = Path::new("queries").join(DEFAULT_INJECTIONS_QUERY_FILE_NAME);
287    let default_locals_path = Path::new("queries").join(DEFAULT_LOCALS_QUERY_FILE_NAME);
288    let default_tags_path = Path::new("queries").join(DEFAULT_TAGS_QUERY_FILE_NAME);
289
290    let generate_opts = GenerateOpts {
291        author_name: authors
292            .map(|a| a.first().map(|a| a.name.as_str()))
293            .unwrap_or_default(),
294        author_email: authors
295            .map(|a| a.first().and_then(|a| a.email.as_deref()))
296            .unwrap_or_default(),
297        author_url: authors
298            .map(|a| a.first().and_then(|a| a.url.as_deref()))
299            .unwrap_or_default(),
300        license: tree_sitter_config.metadata.license.as_deref(),
301        description: tree_sitter_config.metadata.description.as_deref(),
302        repository: tree_sitter_config
303            .metadata
304            .links
305            .as_ref()
306            .map(|l| l.repository.as_str()),
307        funding: tree_sitter_config
308            .metadata
309            .links
310            .as_ref()
311            .and_then(|l| l.funding.as_deref()),
312        version: &tree_sitter_config.metadata.version,
313        camel_parser_name: &camel_name,
314        title_parser_name: &title_name,
315        class_name: &class_name,
316        highlights_query_path: tree_sitter_config.grammars[0]
317            .highlights
318            .to_variable_value(&default_highlights_path),
319        injections_query_path: tree_sitter_config.grammars[0]
320            .injections
321            .to_variable_value(&default_injections_path),
322        locals_query_path: tree_sitter_config.grammars[0]
323            .locals
324            .to_variable_value(&default_locals_path),
325        tags_query_path: tree_sitter_config.grammars[0]
326            .tags
327            .to_variable_value(&default_tags_path),
328        namespace: tree_sitter_config.metadata.namespace.as_deref(),
329    };
330
331    // Create package.json
332    missing_path_else(
333        repo_path.join("package.json"),
334        allow_update,
335        |path| {
336            generate_file(
337                path,
338                PACKAGE_JSON_TEMPLATE,
339                dashed_language_name.as_str(),
340                &generate_opts,
341            )
342        },
343        |path| {
344            let mut contents = fs::read_to_string(path)?
345                .replace(
346                    r#""node-addon-api": "^8.3.1""#,
347                    r#""node-addon-api": "^8.5.0""#,
348                )
349                .replace(
350                    indoc! {r#"
351                    "prebuildify": "^6.0.1",
352                    "tree-sitter-cli":"#},
353                    indoc! {r#"
354                    "prebuildify": "^6.0.1",
355                    "tree-sitter": "^0.25.0",
356                    "tree-sitter-cli":"#},
357                );
358            if !contents.contains("module") {
359                info!("Migrating package.json to ESM");
360                contents = contents.replace(
361                    r#""repository":"#,
362                    indoc! {r#"
363                    "type": "module",
364                      "repository":"#},
365                );
366            }
367            write_file(path, contents)?;
368            Ok(())
369        },
370    )?;
371
372    // Do not create a grammar.js file in a repo with multiple language configs
373    if !tree_sitter_config.has_multiple_language_configs() {
374        missing_path_else(
375            repo_path.join("grammar.js"),
376            allow_update,
377            |path| generate_file(path, GRAMMAR_JS_TEMPLATE, language_name, &generate_opts),
378            |path| {
379                let mut contents = fs::read_to_string(path)?;
380                if contents.contains("module.exports") {
381                    info!("Migrating grammars.js to ESM");
382                    contents = contents.replace("module.exports =", "export default");
383                    write_file(path, contents)?;
384                }
385
386                Ok(())
387            },
388        )?;
389    }
390
391    // Write .gitignore file
392    missing_path_else(
393        repo_path.join(".gitignore"),
394        allow_update,
395        |path| generate_file(path, GITIGNORE_TEMPLATE, language_name, &generate_opts),
396        |path| {
397            let mut contents = fs::read_to_string(path)?;
398            if !contents.contains("Zig artifacts") {
399                info!("Adding zig entries to .gitignore");
400                contents.push('\n');
401                contents.push_str(indoc! {"
402                # Zig artifacts
403                .zig-cache/
404                zig-cache/
405                zig-out/
406                "});
407            }
408            Ok(())
409        },
410    )?;
411
412    // Write .gitattributes file
413    missing_path_else(
414        repo_path.join(".gitattributes"),
415        allow_update,
416        |path| generate_file(path, GITATTRIBUTES_TEMPLATE, language_name, &generate_opts),
417        |path| {
418            let mut contents = fs::read_to_string(path)?;
419            let c_bindings_entry = "bindings/c/* ";
420            if contents.contains(c_bindings_entry) {
421                info!("Updating c bindings entry in .gitattributes");
422                contents = contents.replace(c_bindings_entry, "bindings/c/** ");
423            }
424            if !contents.contains("Zig bindings") {
425                info!("Adding zig entries to .gitattributes");
426                contents.push('\n');
427                contents.push_str(indoc! {"
428                # Zig bindings
429                build.zig linguist-generated
430                build.zig.zon linguist-generated
431                "});
432            }
433            write_file(path, contents)?;
434            Ok(())
435        },
436    )?;
437
438    // Write .editorconfig file
439    missing_path(repo_path.join(".editorconfig"), |path| {
440        generate_file(path, EDITORCONFIG_TEMPLATE, language_name, &generate_opts)
441    })?;
442
443    let bindings_dir = repo_path.join("bindings");
444
445    // Generate Rust bindings
446    if tree_sitter_config.bindings.rust {
447        missing_path(bindings_dir.join("rust"), create_dir)?.apply(|path| {
448            missing_path_else(path.join("lib.rs"), allow_update, |path| {
449                generate_file(path, LIB_RS_TEMPLATE, language_name, &generate_opts)
450            }, |path| {
451                let mut contents = fs::read_to_string(path)?;
452                if !contents.contains("#[cfg(with_highlights_query)]") {
453                    info!("Updating query constants in bindings/rust/lib.rs");
454                    let replacement = indoc! {r#"
455                        #[cfg(with_highlights_query)]
456                        /// The syntax highlighting query for this grammar.
457                        pub const HIGHLIGHTS_QUERY: &str = include_str!("../../HIGHLIGHTS_QUERY_PATH");
458
459                        #[cfg(with_injections_query)]
460                        /// The language injection query for this grammar.
461                        pub const INJECTIONS_QUERY: &str = include_str!("../../INJECTIONS_QUERY_PATH");
462
463                        #[cfg(with_locals_query)]
464                        /// The local variable query for this grammar.
465                        pub const LOCALS_QUERY: &str = include_str!("../../LOCALS_QUERY_PATH");
466
467                        #[cfg(with_tags_query)]
468                        /// The symbol tagging query for this grammar.
469                        pub const TAGS_QUERY: &str = include_str!("../../TAGS_QUERY_PATH");
470                        "#}
471                        .replace(HIGHLIGHTS_QUERY_PATH_PLACEHOLDER, &generate_opts.highlights_query_path.replace('\\', "/"))
472                        .replace(INJECTIONS_QUERY_PATH_PLACEHOLDER, &generate_opts.injections_query_path.replace('\\', "/"))
473                        .replace(LOCALS_QUERY_PATH_PLACEHOLDER, &generate_opts.locals_query_path.replace('\\', "/"))
474                        .replace(TAGS_QUERY_PATH_PLACEHOLDER, &generate_opts.tags_query_path.replace('\\', "/"));
475                    contents = contents
476                        .replace(
477                            indoc! {r#"
478                            // NOTE: uncomment these to include any queries that this grammar contains:
479
480                            // pub const HIGHLIGHTS_QUERY: &str = include_str!("../../queries/highlights.scm");
481                            // pub const INJECTIONS_QUERY: &str = include_str!("../../queries/injections.scm");
482                            // pub const LOCALS_QUERY: &str = include_str!("../../queries/locals.scm");
483                            // pub const TAGS_QUERY: &str = include_str!("../../queries/tags.scm");
484                            "#},
485                            &replacement,
486                        );
487                }
488                write_file(path, contents)?;
489                Ok(())
490            })?;
491
492            missing_path_else(
493                path.join("build.rs"),
494                allow_update,
495                |path| generate_file(path, BUILD_RS_TEMPLATE, language_name, &generate_opts),
496                |path| {
497                    let mut contents = fs::read_to_string(path)?;
498                    if !contents.contains("wasm32-unknown-unknown") {
499                        info!("Adding wasm32-unknown-unknown target to bindings/rust/build.rs");
500                        let replacement = indoc!{r#"
501                            c_config.flag("-utf-8");
502
503                            if std::env::var("TARGET").unwrap() == "wasm32-unknown-unknown" {
504                                let Ok(wasm_headers) = std::env::var("DEP_TREE_SITTER_LANGUAGE_WASM_HEADERS") else {
505                                    panic!("Environment variable DEP_TREE_SITTER_LANGUAGE_WASM_HEADERS must be set by the language crate");
506                                };
507                                let Ok(wasm_src) =
508                                    std::env::var("DEP_TREE_SITTER_LANGUAGE_WASM_SRC").map(std::path::PathBuf::from)
509                                else {
510                                    panic!("Environment variable DEP_TREE_SITTER_LANGUAGE_WASM_SRC must be set by the language crate");
511                                };
512
513                                c_config.include(&wasm_headers);
514                                c_config.files([
515                                    wasm_src.join("stdio.c"),
516                                    wasm_src.join("stdlib.c"),
517                                    wasm_src.join("string.c"),
518                                ]);
519                            }
520                        "#}
521                            .lines()
522                            .map(|line| if line.is_empty() { line.to_string() } else { format!("    {line}") })
523                            .collect::<Vec<_>>()
524                            .join("\n");
525
526                        contents = contents.replace(r#"    c_config.flag("-utf-8");"#, &replacement);
527                    }
528
529                    // Introduce configuration variables for dynamic query inclusion
530                    if !contents.contains("with_highlights_query") {
531                        info!("Adding support for dynamic query inclusion to bindings/rust/build.rs");
532                        let replaced = indoc! {r#"
533                                c_config.compile("tree-sitter-KEBAB_PARSER_NAME");
534                            }"#}
535                            .replace("KEBAB_PARSER_NAME", &language_name.to_kebab_case());
536
537                        let replacement = indoc! {r#"
538                                c_config.compile("tree-sitter-KEBAB_PARSER_NAME");
539
540                                println!("cargo:rustc-check-cfg=cfg(with_highlights_query)");
541                                if !"HIGHLIGHTS_QUERY_PATH".is_empty() && std::path::Path::new("HIGHLIGHTS_QUERY_PATH").exists() {
542                                    println!("cargo:rustc-cfg=with_highlights_query");
543                                }
544                                println!("cargo:rustc-check-cfg=cfg(with_injections_query)");
545                                if !"INJECTIONS_QUERY_PATH".is_empty() && std::path::Path::new("INJECTIONS_QUERY_PATH").exists() {
546                                    println!("cargo:rustc-cfg=with_injections_query");
547                                }
548                                println!("cargo:rustc-check-cfg=cfg(with_locals_query)");
549                                if !"LOCALS_QUERY_PATH".is_empty() && std::path::Path::new("LOCALS_QUERY_PATH").exists() {
550                                    println!("cargo:rustc-cfg=with_locals_query");
551                                }
552                                println!("cargo:rustc-check-cfg=cfg(with_tags_query)");
553                                if !"TAGS_QUERY_PATH".is_empty() && std::path::Path::new("TAGS_QUERY_PATH").exists() {
554                                    println!("cargo:rustc-cfg=with_tags_query");
555                                }
556                            }"#}
557                            .replace("KEBAB_PARSER_NAME", &language_name.to_kebab_case())
558                            .replace(HIGHLIGHTS_QUERY_PATH_PLACEHOLDER, &generate_opts.highlights_query_path.replace('\\', "/"))
559                            .replace(INJECTIONS_QUERY_PATH_PLACEHOLDER, &generate_opts.injections_query_path.replace('\\', "/"))
560                            .replace(LOCALS_QUERY_PATH_PLACEHOLDER, &generate_opts.locals_query_path.replace('\\', "/"))
561                            .replace(TAGS_QUERY_PATH_PLACEHOLDER, &generate_opts.tags_query_path.replace('\\', "/"));
562
563                        contents = contents.replace(
564                            &replaced,
565                            &replacement,
566                        );
567                    }
568
569                    write_file(path, contents)?;
570                    Ok(())
571                },
572            )?;
573
574            missing_path_else(
575                repo_path.join("Cargo.toml"),
576                allow_update,
577                |path| {
578                    generate_file(
579                        path,
580                        CARGO_TOML_TEMPLATE,
581                        dashed_language_name.as_str(),
582                        &generate_opts,
583                    )
584                },
585                |path| {
586                    let contents = fs::read_to_string(path)?;
587                    if contents.contains("\"LICENSE\"") {
588                        info!("Adding LICENSE entry to bindings/rust/Cargo.toml");
589                        write_file(path, contents.replace("\"LICENSE\"", "\"/LICENSE\""))?;
590                    }
591                    Ok(())
592                },
593            )?;
594
595            Ok(())
596        })?;
597    }
598
599    // Generate Node bindings
600    if tree_sitter_config.bindings.node {
601        missing_path(bindings_dir.join("node"), create_dir)?.apply(|path| {
602            missing_path_else(
603                path.join("index.js"),
604                allow_update,
605                |path| generate_file(path, INDEX_JS_TEMPLATE, language_name, &generate_opts),
606                |path| {
607                    let contents = fs::read_to_string(path)?;
608                    if !contents.contains("Object.defineProperty") {
609                        info!("Replacing index.js");
610                        generate_file(path, INDEX_JS_TEMPLATE, language_name, &generate_opts)?;
611                    }
612                    Ok(())
613                },
614            )?;
615
616            missing_path_else(
617                path.join("index.d.ts"),
618                allow_update,
619                |path| generate_file(path, INDEX_D_TS_TEMPLATE, language_name, &generate_opts),
620                |path| {
621                    let contents = fs::read_to_string(path)?;
622                    if !contents.contains("export default binding") {
623                        info!("Replacing index.d.ts");
624                        generate_file(path, INDEX_D_TS_TEMPLATE, language_name, &generate_opts)?;
625                    }
626                    Ok(())
627                },
628            )?;
629
630            missing_path_else(
631                path.join("binding_test.js"),
632                allow_update,
633                |path| {
634                    generate_file(
635                        path,
636                        BINDING_TEST_JS_TEMPLATE,
637                        language_name,
638                        &generate_opts,
639                    )
640                },
641                |path| {
642                    let contents = fs::read_to_string(path)?;
643                    if !contents.contains("import") {
644                        info!("Replacing binding_test.js");
645                        generate_file(
646                            path,
647                            BINDING_TEST_JS_TEMPLATE,
648                            language_name,
649                            &generate_opts,
650                        )?;
651                    }
652                    Ok(())
653                },
654            )?;
655
656            missing_path(path.join("binding.cc"), |path| {
657                generate_file(path, JS_BINDING_CC_TEMPLATE, language_name, &generate_opts)
658            })?;
659
660            missing_path_else(
661                repo_path.join("binding.gyp"),
662                allow_update,
663                |path| generate_file(path, BINDING_GYP_TEMPLATE, language_name, &generate_opts),
664                |path| {
665                    let contents = fs::read_to_string(path)?;
666                    if contents.contains("fs.exists(") {
667                        info!("Replacing `fs.exists` calls in binding.gyp");
668                        write_file(path, contents.replace("fs.exists(", "fs.existsSync("))?;
669                    }
670                    Ok(())
671                },
672            )?;
673
674            Ok(())
675        })?;
676    }
677
678    // Generate C bindings
679    if tree_sitter_config.bindings.c {
680        let kebab_case_name = language_name.to_kebab_case();
681        missing_path(bindings_dir.join("c"), create_dir)?.apply(|path| {
682            let header_name = format!("tree-sitter-{kebab_case_name}.h");
683            let old_file = &path.join(&header_name);
684            if allow_update && fs::exists(old_file).unwrap_or(false) {
685                info!("Removing bindings/c/{header_name}");
686                fs::remove_file(old_file)?;
687            }
688            missing_path(path.join("tree_sitter"), create_dir)?.apply(|include_path| {
689                missing_path(
690                    include_path.join(&header_name),
691                    |path| {
692                        generate_file(path, PARSER_NAME_H_TEMPLATE, language_name, &generate_opts)
693                    },
694                )?;
695                Ok(())
696            })?;
697
698            missing_path(
699                path.join(format!("tree-sitter-{kebab_case_name}.pc.in")),
700                |path| {
701                    generate_file(
702                        path,
703                        PARSER_NAME_PC_IN_TEMPLATE,
704                        language_name,
705                        &generate_opts,
706                    )
707                },
708            )?;
709
710            missing_path_else(
711                repo_path.join("Makefile"),
712                allow_update,
713                |path| {
714                    generate_file(path, MAKEFILE_TEMPLATE, language_name, &generate_opts)
715                },
716                |path| {
717                    let mut contents = fs::read_to_string(path)?;
718                    if !contents.contains("cd '$(DESTDIR)$(LIBDIR)' && ln -sf") {
719                        info!("Replacing Makefile");
720                        generate_file(path, MAKEFILE_TEMPLATE, language_name, &generate_opts)?;
721                    } else {
722                        let replaced = indoc! {r"
723                            $(PARSER): $(SRC_DIR)/grammar.json
724                                    $(TS) generate $^
725                            "};
726                        if contents.contains(replaced) {
727                            info!("Adding --no-parser target to Makefile");
728                            contents = contents
729                                .replace(
730                                    replaced,
731                                    indoc! {r"
732                                    $(SRC_DIR)/grammar.json: grammar.js
733                                            $(TS) generate --no-parser $^
734
735                                    $(PARSER): $(SRC_DIR)/grammar.json
736                                            $(TS) generate $^
737                                    "}
738                                );
739                        }
740                        write_file(path, contents)?;
741                    }
742                    Ok(())
743                },
744            )?;
745
746            missing_path_else(
747                repo_path.join("CMakeLists.txt"),
748                allow_update,
749                |path| generate_file(path, CMAKELISTS_TXT_TEMPLATE, language_name, &generate_opts),
750                |path| {
751                    let contents = fs::read_to_string(path)?;
752                    let replaced_contents = contents
753                        .replace("add_custom_target(test", "add_custom_target(ts-test")
754                        .replace(
755                            &formatdoc! {r#"
756                            install(FILES bindings/c/tree-sitter-{language_name}.h
757                                    DESTINATION "${{CMAKE_INSTALL_INCLUDEDIR}}/tree_sitter")
758                            "#},
759                            indoc! {r#"
760                            install(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/bindings/c/tree_sitter"
761                                    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
762                                    FILES_MATCHING PATTERN "*.h")
763                            "#}
764                        ).replace(
765                            &format!("target_include_directories(tree-sitter-{language_name} PRIVATE src)"),
766                            &formatdoc! {"
767                            target_include_directories(tree-sitter-{language_name}
768                                                       PRIVATE src
769                                                       INTERFACE $<BUILD_INTERFACE:${{CMAKE_CURRENT_SOURCE_DIR}}/bindings/c>
770                                                                 $<INSTALL_INTERFACE:${{CMAKE_INSTALL_INCLUDEDIR}}>)
771                            "}
772                        ).replace(
773                            indoc! {r#"
774                            add_custom_command(OUTPUT "${CMAKE_CURRENT_SOURCE_DIR}/src/parser.c"
775                                               DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/src/grammar.json"
776                                               COMMAND "${TREE_SITTER_CLI}" generate src/grammar.json
777                                                        --abi=${TREE_SITTER_ABI_VERSION}
778                                               WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
779                                               COMMENT "Generating parser.c")
780                            "#},
781                            indoc! {r#"
782                            add_custom_command(OUTPUT "${CMAKE_CURRENT_SOURCE_DIR}/src/grammar.json"
783                                                      "${CMAKE_CURRENT_SOURCE_DIR}/src/node-types.json"
784                                               DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/grammar.js"
785                                               COMMAND "${TREE_SITTER_CLI}" generate grammar.js --no-parser
786                                               WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
787                                               COMMENT "Generating grammar.json")
788
789                            add_custom_command(OUTPUT "${CMAKE_CURRENT_SOURCE_DIR}/src/parser.c"
790                                               BYPRODUCTS "${CMAKE_CURRENT_SOURCE_DIR}/src/tree_sitter/parser.h"
791                                                          "${CMAKE_CURRENT_SOURCE_DIR}/src/tree_sitter/alloc.h"
792                                                          "${CMAKE_CURRENT_SOURCE_DIR}/src/tree_sitter/array.h"
793                                               DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/src/grammar.json"
794                                               COMMAND "${TREE_SITTER_CLI}" generate src/grammar.json
795                                                        --abi=${TREE_SITTER_ABI_VERSION}
796                                               WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
797                                               COMMENT "Generating parser.c")
798                            "#}
799                        );
800                    if !replaced_contents.eq(&contents) {
801                        info!("Updating CMakeLists.txt");
802                        write_file(path, replaced_contents)?;
803                    }
804                    Ok(())
805                },
806            )?;
807
808            Ok(())
809        })?;
810    }
811
812    // Generate Go bindings
813    if tree_sitter_config.bindings.go {
814        missing_path(bindings_dir.join("go"), create_dir)?.apply(|path| {
815            missing_path(path.join("binding.go"), |path| {
816                generate_file(path, BINDING_GO_TEMPLATE, language_name, &generate_opts)
817            })?;
818
819            missing_path(path.join("binding_test.go"), |path| {
820                generate_file(
821                    path,
822                    BINDING_TEST_GO_TEMPLATE,
823                    language_name,
824                    &generate_opts,
825                )
826            })?;
827
828            missing_path(repo_path.join("go.mod"), |path| {
829                generate_file(path, GO_MOD_TEMPLATE, language_name, &generate_opts)
830            })?;
831
832            Ok(())
833        })?;
834    }
835
836    // Generate Python bindings
837    if tree_sitter_config.bindings.python {
838        missing_path(bindings_dir.join("python"), create_dir)?.apply(|path| {
839            let snake_case_grammar_name = format!("tree_sitter_{}", language_name.to_snake_case());
840            let lang_path = path.join(&snake_case_grammar_name);
841            missing_path(&lang_path, create_dir)?;
842
843            missing_path_else(
844                lang_path.join("binding.c"),
845                allow_update,
846                |path| generate_file(path, PY_BINDING_C_TEMPLATE, language_name, &generate_opts),
847                |path| {
848                    let mut contents = fs::read_to_string(path)?;
849                    if !contents.contains("PyModuleDef_Init") {
850                        info!("Updating bindings/python/{snake_case_grammar_name}/binding.c");
851                        contents = contents
852                            .replace("PyModule_Create", "PyModuleDef_Init")
853                            .replace(
854                                "static PyMethodDef methods[] = {\n",
855                                indoc! {"
856                                static struct PyModuleDef_Slot slots[] = {
857                                #ifdef Py_GIL_DISABLED
858                                    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
859                                #endif
860                                    {0, NULL}
861                                };
862
863                                static PyMethodDef methods[] = {
864                                "},
865                            )
866                            .replace(
867                                indoc! {"
868                                .m_size = -1,
869                                    .m_methods = methods
870                                "},
871                                indoc! {"
872                                .m_size = 0,
873                                    .m_methods = methods,
874                                    .m_slots = slots,
875                                "},
876                            );
877                        write_file(path, contents)?;
878                    }
879                    Ok(())
880                },
881            )?;
882
883            missing_path_else(
884                lang_path.join("__init__.py"),
885                allow_update,
886                |path| {
887                    generate_file(path, INIT_PY_TEMPLATE, language_name, &generate_opts)
888                },
889                |path| {
890                    let contents = fs::read_to_string(path)?;
891                    if !contents.contains("uncomment these to include any queries") {
892                        info!("Replacing __init__.py");
893                        generate_file(path, INIT_PY_TEMPLATE, language_name, &generate_opts)?;
894                    }
895                    Ok(())
896                },
897            )?;
898
899            missing_path_else(
900                lang_path.join("__init__.pyi"),
901                allow_update,
902                |path| generate_file(path, INIT_PYI_TEMPLATE, language_name, &generate_opts),
903                |path| {
904                    let mut contents = fs::read_to_string(path)?;
905                    if contents.contains("uncomment these to include any queries") {
906                        info!("Replacing __init__.pyi");
907                        generate_file(path, INIT_PYI_TEMPLATE, language_name, &generate_opts)?;
908                    } else if !contents.contains("CapsuleType") {
909                        info!("Updating __init__.pyi");
910                        contents = contents
911                            .replace(
912                                "from typing import Final",
913                                "from typing import Final\nfrom typing_extensions import CapsuleType"
914                            )
915                            .replace("-> object:", "-> CapsuleType:");
916                        write_file(path, contents)?;
917                    }
918                    Ok(())
919                },
920            )?;
921
922            missing_path(lang_path.join("py.typed"), |path| {
923                generate_file(path, "", language_name, &generate_opts) // py.typed is empty
924            })?;
925
926            missing_path(path.join("tests"), create_dir)?.apply(|path| {
927                missing_path_else(
928                    path.join("test_binding.py"),
929                    allow_update,
930                    |path| {
931                        generate_file(
932                            path,
933                            TEST_BINDING_PY_TEMPLATE,
934                            language_name,
935                            &generate_opts,
936                        )
937                    },
938                    |path| {
939                        let mut contents = fs::read_to_string(path)?;
940                        if !contents.contains("Parser(Language(") {
941                            info!("Updating Language function in bindings/python/tests/test_binding.py");
942                            contents = contents
943                                .replace("tree_sitter.Language(", "Parser(Language(")
944                                .replace(".language())\n", ".language()))\n")
945                                .replace(
946                                    "import tree_sitter\n",
947                                    "from tree_sitter import Language, Parser\n",
948                                );
949                            write_file(path, contents)?;
950                        }
951                        Ok(())
952                    },
953                )?;
954                Ok(())
955            })?;
956
957            missing_path_else(
958                repo_path.join("setup.py"),
959                allow_update,
960                |path| generate_file(path, SETUP_PY_TEMPLATE, language_name, &generate_opts),
961                |path| {
962                    let mut contents = fs::read_to_string(path)?;
963                    if !contents.contains("build_ext") {
964                        info!("Replacing setup.py");
965                        generate_file(path, SETUP_PY_TEMPLATE, language_name, &generate_opts)?;
966                    }
967                    if !contents.contains(" and not get_config_var") {
968                        info!("Updating Python free-threading support in setup.py");
969                        contents = contents.replace(
970                            r#"startswith("cp"):"#,
971                            r#"startswith("cp") and not get_config_var("Py_GIL_DISABLED"):"#
972                        );
973                        write_file(path, contents)?;
974                    }
975                    Ok(())
976                },
977            )?;
978
979            missing_path_else(
980                repo_path.join("pyproject.toml"),
981                allow_update,
982                |path| {
983                    generate_file(
984                        path,
985                        PYPROJECT_TOML_TEMPLATE,
986                        dashed_language_name.as_str(),
987                        &generate_opts,
988                    )
989                },
990                |path| {
991                    let mut contents = fs::read_to_string(path)?;
992                    if !contents.contains("cp310-*") {
993                        info!("Updating dependencies in pyproject.toml");
994                        contents = contents
995                            .replace(r#"build = "cp39-*""#, r#"build = "cp310-*""#)
996                            .replace(r#"python = ">=3.9""#, r#"python = ">=3.10""#)
997                            .replace("tree-sitter~=0.22", "tree-sitter~=0.24");
998                        write_file(path, contents)?;
999                    }
1000                    Ok(())
1001                },
1002            )?;
1003
1004            Ok(())
1005        })?;
1006    }
1007
1008    // Generate Swift bindings
1009    if tree_sitter_config.bindings.swift {
1010        missing_path(bindings_dir.join("swift"), create_dir)?.apply(|path| {
1011            let lang_path = path.join(&class_name);
1012            missing_path(&lang_path, create_dir)?;
1013
1014            missing_path(lang_path.join(format!("{language_name}.h")), |path| {
1015                generate_file(path, PARSER_NAME_H_TEMPLATE, language_name, &generate_opts)
1016            })?;
1017
1018            missing_path(path.join(format!("{class_name}Tests")), create_dir)?.apply(|path| {
1019                missing_path(path.join(format!("{class_name}Tests.swift")), |path| {
1020                    generate_file(path, TESTS_SWIFT_TEMPLATE, language_name, &generate_opts)
1021                })?;
1022
1023                Ok(())
1024            })?;
1025
1026            missing_path_else(
1027                repo_path.join("Package.swift"),
1028                allow_update,
1029                |path| generate_file(path, PACKAGE_SWIFT_TEMPLATE, language_name, &generate_opts),
1030                |path| {
1031                    let contents = fs::read_to_string(path)?;
1032                    let replaced_contents = contents
1033                        .replace(
1034                            "https://github.com/ChimeHQ/SwiftTreeSitter",
1035                            "https://github.com/tree-sitter/swift-tree-sitter",
1036                        )
1037                        .replace("version: \"0.8.0\")", "version: \"0.9.0\")")
1038                        .replace("(url:", "(name: \"SwiftTreeSitter\", url:");
1039                    if !replaced_contents.eq(&contents) {
1040                        info!("Updating tree-sitter dependency in Package.swift");
1041                        write_file(path, contents)?;
1042                    }
1043                    Ok(())
1044                },
1045            )?;
1046
1047            Ok(())
1048        })?;
1049    }
1050
1051    // Generate Zig bindings
1052    if tree_sitter_config.bindings.zig {
1053        missing_path_else(
1054            repo_path.join("build.zig"),
1055            allow_update,
1056            |path| generate_file(path, BUILD_ZIG_TEMPLATE, language_name, &generate_opts),
1057            |path| {
1058                let contents = fs::read_to_string(path)?;
1059                if !contents.contains("b.pkg_hash.len") {
1060                    info!("Replacing build.zig");
1061                    generate_file(path, BUILD_ZIG_TEMPLATE, language_name, &generate_opts)
1062                } else {
1063                    Ok(())
1064                }
1065            },
1066        )?;
1067
1068        missing_path_else(
1069            repo_path.join("build.zig.zon"),
1070            allow_update,
1071            |path| generate_file(path, BUILD_ZIG_ZON_TEMPLATE, language_name, &generate_opts),
1072            |path| {
1073                let contents = fs::read_to_string(path)?;
1074                if !contents.contains(".name = .tree_sitter_") {
1075                    info!("Replacing build.zig.zon");
1076                    generate_file(path, BUILD_ZIG_ZON_TEMPLATE, language_name, &generate_opts)
1077                } else {
1078                    Ok(())
1079                }
1080            },
1081        )?;
1082
1083        missing_path(bindings_dir.join("zig"), create_dir)?.apply(|path| {
1084            missing_path_else(
1085                path.join("root.zig"),
1086                allow_update,
1087                |path| generate_file(path, ROOT_ZIG_TEMPLATE, language_name, &generate_opts),
1088                |path| {
1089                    let contents = fs::read_to_string(path)?;
1090                    if contents.contains("ts.Language") {
1091                        info!("Replacing root.zig");
1092                        generate_file(path, ROOT_ZIG_TEMPLATE, language_name, &generate_opts)
1093                    } else {
1094                        Ok(())
1095                    }
1096                },
1097            )?;
1098
1099            missing_path(path.join("test.zig"), |path| {
1100                generate_file(path, TEST_ZIG_TEMPLATE, language_name, &generate_opts)
1101            })?;
1102
1103            Ok(())
1104        })?;
1105    }
1106
1107    // Generate Java bindings
1108    if tree_sitter_config.bindings.java {
1109        missing_path(repo_path.join("pom.xml"), |path| {
1110            generate_file(path, POM_XML_TEMPLATE, language_name, &generate_opts)
1111        })?;
1112
1113        missing_path(bindings_dir.join("java"), create_dir)?.apply(|path| {
1114            missing_path(path.join("main"), create_dir)?.apply(|path| {
1115                let package_path = generate_opts
1116                    .namespace
1117                    .unwrap_or("io.github.treesitter")
1118                    .replace(['-', '_'], "")
1119                    .split('.')
1120                    .fold(path.to_path_buf(), |path, dir| path.join(dir))
1121                    .join("jtreesitter")
1122                    .join(language_name.to_lowercase().replace('_', ""));
1123                missing_path(package_path, create_dir)?.apply(|path| {
1124                    missing_path(path.join(format!("{class_name}.java")), |path| {
1125                        generate_file(path, BINDING_JAVA_TEMPLATE, language_name, &generate_opts)
1126                    })?;
1127
1128                    Ok(())
1129                })?;
1130
1131                Ok(())
1132            })?;
1133
1134            missing_path(path.join("test"), create_dir)?.apply(|path| {
1135                missing_path(path.join(format!("{class_name}Test.java")), |path| {
1136                    generate_file(path, TEST_JAVA_TEMPLATE, language_name, &generate_opts)
1137                })?;
1138
1139                Ok(())
1140            })?;
1141
1142            Ok(())
1143        })?;
1144    }
1145
1146    Ok(())
1147}
1148
1149pub fn get_root_path(path: &Path) -> Result<PathBuf> {
1150    let mut pathbuf = path.to_owned();
1151    let filename = path.file_name().unwrap().to_str().unwrap();
1152    let is_package_json = filename == "package.json";
1153    loop {
1154        let json = pathbuf
1155            .exists()
1156            .then(|| {
1157                let contents = fs::read_to_string(pathbuf.as_path())
1158                    .with_context(|| format!("Failed to read {filename}"))?;
1159                if is_package_json {
1160                    serde_json::from_str::<Map<String, Value>>(&contents)
1161                        .context(format!("Failed to parse {filename}"))
1162                        .map(|v| v.contains_key("tree-sitter"))
1163                } else {
1164                    serde_json::from_str::<TreeSitterJSON>(&contents)
1165                        .context(format!("Failed to parse {filename}"))
1166                        .map(|_| true)
1167                }
1168            })
1169            .transpose()?;
1170        if json == Some(true) {
1171            return Ok(pathbuf.parent().unwrap().to_path_buf());
1172        }
1173        pathbuf.pop(); // filename
1174        if !pathbuf.pop() {
1175            return Err(anyhow!(format!(
1176                concat!(
1177                    "Failed to locate a {} file,",
1178                    " please ensure you have one, and if you don't then consult the docs",
1179                ),
1180                filename
1181            )));
1182        }
1183        pathbuf.push(filename);
1184    }
1185}
1186
1187fn generate_file(
1188    path: &Path,
1189    template: &str,
1190    language_name: &str,
1191    generate_opts: &GenerateOpts,
1192) -> Result<()> {
1193    let filename = path.file_name().unwrap().to_str().unwrap();
1194
1195    let lower_parser_name = if path
1196        .extension()
1197        .is_some_and(|e| e.eq_ignore_ascii_case("java"))
1198    {
1199        language_name.to_snake_case().replace('_', "")
1200    } else {
1201        language_name.to_snake_case()
1202    };
1203
1204    let mut replacement = template
1205        .replace(
1206            CAMEL_PARSER_NAME_PLACEHOLDER,
1207            generate_opts.camel_parser_name,
1208        )
1209        .replace(
1210            TITLE_PARSER_NAME_PLACEHOLDER,
1211            generate_opts.title_parser_name,
1212        )
1213        .replace(
1214            UPPER_PARSER_NAME_PLACEHOLDER,
1215            &language_name.to_shouty_snake_case(),
1216        )
1217        .replace(
1218            KEBAB_PARSER_NAME_PLACEHOLDER,
1219            &language_name.to_kebab_case(),
1220        )
1221        .replace(LOWER_PARSER_NAME_PLACEHOLDER, &lower_parser_name)
1222        .replace(PARSER_NAME_PLACEHOLDER, language_name)
1223        .replace(CLI_VERSION_PLACEHOLDER, CLI_VERSION)
1224        .replace(RUST_BINDING_VERSION_PLACEHOLDER, RUST_BINDING_VERSION)
1225        .replace(ABI_VERSION_MAX_PLACEHOLDER, &ABI_VERSION_MAX.to_string())
1226        .replace(
1227            PARSER_VERSION_PLACEHOLDER,
1228            &generate_opts.version.to_string(),
1229        )
1230        .replace(PARSER_CLASS_NAME_PLACEHOLDER, generate_opts.class_name)
1231        .replace(
1232            HIGHLIGHTS_QUERY_PATH_PLACEHOLDER,
1233            &generate_opts.highlights_query_path.replace('\\', "/"),
1234        )
1235        .replace(
1236            INJECTIONS_QUERY_PATH_PLACEHOLDER,
1237            &generate_opts.injections_query_path.replace('\\', "/"),
1238        )
1239        .replace(
1240            LOCALS_QUERY_PATH_PLACEHOLDER,
1241            &generate_opts.locals_query_path.replace('\\', "/"),
1242        )
1243        .replace(
1244            TAGS_QUERY_PATH_PLACEHOLDER,
1245            &generate_opts.tags_query_path.replace('\\', "/"),
1246        );
1247
1248    if let Some(name) = generate_opts.author_name {
1249        replacement = replacement.replace(AUTHOR_NAME_PLACEHOLDER, name);
1250    } else {
1251        match filename {
1252            "package.json" => {
1253                replacement = replacement.replace(AUTHOR_NAME_PLACEHOLDER_JS, "");
1254            }
1255            "pyproject.toml" => {
1256                replacement = replacement.replace(AUTHOR_NAME_PLACEHOLDER_PY, "");
1257            }
1258            "grammar.js" => {
1259                replacement = replacement.replace(AUTHOR_NAME_PLACEHOLDER_GRAMMAR, "");
1260            }
1261            "Cargo.toml" => {
1262                replacement = replacement.replace(AUTHOR_NAME_PLACEHOLDER_RS, "");
1263            }
1264            "pom.xml" => {
1265                replacement = replacement.replace(AUTHOR_NAME_PLACEHOLDER_JAVA, "");
1266            }
1267            _ => {}
1268        }
1269    }
1270
1271    if let Some(email) = generate_opts.author_email {
1272        replacement = match filename {
1273            "Cargo.toml" | "grammar.js" => {
1274                replacement.replace(AUTHOR_EMAIL_PLACEHOLDER, &format!("<{email}>"))
1275            }
1276            _ => replacement.replace(AUTHOR_EMAIL_PLACEHOLDER, email),
1277        }
1278    } else {
1279        match filename {
1280            "package.json" => {
1281                replacement = replacement.replace(AUTHOR_EMAIL_PLACEHOLDER_JS, "");
1282            }
1283            "pyproject.toml" => {
1284                replacement = replacement.replace(AUTHOR_EMAIL_PLACEHOLDER_PY, "");
1285            }
1286            "grammar.js" => {
1287                replacement = replacement.replace(AUTHOR_EMAIL_PLACEHOLDER_GRAMMAR, "");
1288            }
1289            "Cargo.toml" => {
1290                replacement = replacement.replace(AUTHOR_EMAIL_PLACEHOLDER_RS, "");
1291            }
1292            "pom.xml" => {
1293                replacement = replacement.replace(AUTHOR_EMAIL_PLACEHOLDER_JAVA, "");
1294            }
1295            _ => {}
1296        }
1297    }
1298
1299    match (generate_opts.author_url, filename) {
1300        (Some(url), "package.json" | "pom.xml") => {
1301            replacement = replacement.replace(AUTHOR_URL_PLACEHOLDER, url);
1302        }
1303        (None, "package.json") => {
1304            replacement = replacement.replace(AUTHOR_URL_PLACEHOLDER_JS, "");
1305        }
1306        (None, "pom.xml") => {
1307            replacement = replacement.replace(AUTHOR_URL_PLACEHOLDER_JAVA, "");
1308        }
1309        _ => {}
1310    }
1311
1312    if generate_opts.author_name.is_none()
1313        && generate_opts.author_email.is_none()
1314        && generate_opts.author_url.is_none()
1315    {
1316        match filename {
1317            "package.json" => {
1318                if let Some(start_idx) = replacement.find(AUTHOR_BLOCK_JS) {
1319                    if let Some(end_idx) = replacement[start_idx..]
1320                        .find("},")
1321                        .map(|i| i + start_idx + 2)
1322                    {
1323                        replacement.replace_range(start_idx..end_idx, "");
1324                    }
1325                }
1326            }
1327            "pom.xml" => {
1328                if let Some(start_idx) = replacement.find(AUTHOR_BLOCK_JAVA) {
1329                    if let Some(end_idx) = replacement[start_idx..]
1330                        .find("</developer>")
1331                        .map(|i| i + start_idx + 12)
1332                    {
1333                        replacement.replace_range(start_idx..end_idx, "");
1334                    }
1335                }
1336            }
1337            _ => {}
1338        }
1339    } else if generate_opts.author_name.is_none() && generate_opts.author_email.is_none() {
1340        match filename {
1341            "pyproject.toml" => {
1342                if let Some(start_idx) = replacement.find(AUTHOR_BLOCK_PY) {
1343                    if let Some(end_idx) = replacement[start_idx..]
1344                        .find("}]")
1345                        .map(|i| i + start_idx + 2)
1346                    {
1347                        replacement.replace_range(start_idx..end_idx, "");
1348                    }
1349                }
1350            }
1351            "grammar.js" => {
1352                if let Some(start_idx) = replacement.find(AUTHOR_BLOCK_GRAMMAR) {
1353                    if let Some(end_idx) = replacement[start_idx..]
1354                        .find(" \n")
1355                        .map(|i| i + start_idx + 1)
1356                    {
1357                        replacement.replace_range(start_idx..end_idx, "");
1358                    }
1359                }
1360            }
1361            "Cargo.toml" => {
1362                if let Some(start_idx) = replacement.find(AUTHOR_BLOCK_RS) {
1363                    if let Some(end_idx) = replacement[start_idx..]
1364                        .find("\"]")
1365                        .map(|i| i + start_idx + 2)
1366                    {
1367                        replacement.replace_range(start_idx..end_idx, "");
1368                    }
1369                }
1370            }
1371            _ => {}
1372        }
1373    }
1374
1375    if let Some(license) = generate_opts.license {
1376        replacement = replacement.replace(PARSER_LICENSE_PLACEHOLDER, license);
1377    } else {
1378        replacement = replacement.replace(PARSER_LICENSE_PLACEHOLDER, "MIT");
1379    }
1380
1381    if let Some(description) = generate_opts.description {
1382        replacement = replacement.replace(PARSER_DESCRIPTION_PLACEHOLDER, description);
1383    } else {
1384        replacement = replacement.replace(
1385            PARSER_DESCRIPTION_PLACEHOLDER,
1386            &format!(
1387                "{} grammar for tree-sitter",
1388                generate_opts.camel_parser_name,
1389            ),
1390        );
1391    }
1392
1393    if let Some(repository) = generate_opts.repository {
1394        replacement = replacement
1395            .replace(
1396                PARSER_URL_STRIPPED_PLACEHOLDER,
1397                &repository.replace("https://", "").to_lowercase(),
1398            )
1399            .replace(PARSER_URL_PLACEHOLDER, &repository.to_lowercase());
1400    } else {
1401        replacement = replacement
1402            .replace(
1403                PARSER_URL_STRIPPED_PLACEHOLDER,
1404                &format!(
1405                    "github.com/tree-sitter/tree-sitter-{}",
1406                    language_name.to_lowercase()
1407                ),
1408            )
1409            .replace(
1410                PARSER_URL_PLACEHOLDER,
1411                &format!(
1412                    "https://github.com/tree-sitter/tree-sitter-{}",
1413                    language_name.to_lowercase()
1414                ),
1415            );
1416    }
1417
1418    if let Some(namespace) = generate_opts.namespace {
1419        replacement = replacement
1420            .replace(
1421                PARSER_NS_CLEANED_PLACEHOLDER,
1422                &namespace.replace(['-', '_'], ""),
1423            )
1424            .replace(PARSER_NS_PLACEHOLDER, namespace);
1425    } else {
1426        replacement = replacement
1427            .replace(PARSER_NS_CLEANED_PLACEHOLDER, "io.github.treesitter")
1428            .replace(PARSER_NS_PLACEHOLDER, "io.github.tree-sitter");
1429    }
1430
1431    if let Some(funding_url) = generate_opts.funding {
1432        match filename {
1433            "pyproject.toml" | "package.json" => {
1434                replacement = replacement.replace(FUNDING_URL_PLACEHOLDER, funding_url);
1435            }
1436            _ => {}
1437        }
1438    } else {
1439        match filename {
1440            "package.json" => {
1441                replacement = replacement.replace("  \"funding\": \"FUNDING_URL\",\n", "");
1442            }
1443            "pyproject.toml" => {
1444                replacement = replacement.replace("Funding = \"FUNDING_URL\"\n", "");
1445            }
1446            _ => {}
1447        }
1448    }
1449
1450    if filename == "build.zig.zon" {
1451        let id = thread_rng().gen_range(1u32..0xFFFF_FFFFu32);
1452        let checksum = crc32(format!("tree_sitter_{language_name}").as_bytes());
1453        replacement = replacement.replace(
1454            PARSER_FINGERPRINT_PLACEHOLDER,
1455            #[cfg(target_endian = "little")]
1456            &format!("0x{checksum:x}{id:x}"),
1457            #[cfg(target_endian = "big")]
1458            &format!("0x{id:x}{checksum:x}"),
1459        );
1460    }
1461
1462    write_file(path, replacement)?;
1463    Ok(())
1464}
1465
1466fn create_dir(path: &Path) -> Result<()> {
1467    fs::create_dir_all(path)
1468        .with_context(|| format!("Failed to create {:?}", path.to_string_lossy()))
1469}
1470
1471#[derive(PartialEq, Eq, Debug)]
1472enum PathState<P>
1473where
1474    P: AsRef<Path>,
1475{
1476    Exists(P),
1477    Missing(P),
1478}
1479
1480#[allow(dead_code)]
1481impl<P> PathState<P>
1482where
1483    P: AsRef<Path>,
1484{
1485    fn exists(&self, mut action: impl FnMut(&Path) -> Result<()>) -> Result<&Self> {
1486        if let Self::Exists(path) = self {
1487            action(path.as_ref())?;
1488        }
1489        Ok(self)
1490    }
1491
1492    fn missing(&self, mut action: impl FnMut(&Path) -> Result<()>) -> Result<&Self> {
1493        if let Self::Missing(path) = self {
1494            action(path.as_ref())?;
1495        }
1496        Ok(self)
1497    }
1498
1499    fn apply(&self, mut action: impl FnMut(&Path) -> Result<()>) -> Result<&Self> {
1500        action(self.as_path())?;
1501        Ok(self)
1502    }
1503
1504    fn apply_state(&self, mut action: impl FnMut(&Self) -> Result<()>) -> Result<&Self> {
1505        action(self)?;
1506        Ok(self)
1507    }
1508
1509    fn as_path(&self) -> &Path {
1510        match self {
1511            Self::Exists(path) | Self::Missing(path) => path.as_ref(),
1512        }
1513    }
1514}
1515
1516fn missing_path<P, F>(path: P, mut action: F) -> Result<PathState<P>>
1517where
1518    P: AsRef<Path>,
1519    F: FnMut(&Path) -> Result<()>,
1520{
1521    let path_ref = path.as_ref();
1522    if !path_ref.exists() {
1523        action(path_ref)?;
1524        Ok(PathState::Missing(path))
1525    } else {
1526        Ok(PathState::Exists(path))
1527    }
1528}
1529
1530fn missing_path_else<P, T, F>(
1531    path: P,
1532    allow_update: bool,
1533    mut action: T,
1534    mut else_action: F,
1535) -> Result<PathState<P>>
1536where
1537    P: AsRef<Path>,
1538    T: FnMut(&Path) -> Result<()>,
1539    F: FnMut(&Path) -> Result<()>,
1540{
1541    let path_ref = path.as_ref();
1542    if !path_ref.exists() {
1543        action(path_ref)?;
1544        Ok(PathState::Missing(path))
1545    } else {
1546        if allow_update {
1547            else_action(path_ref)?;
1548        }
1549        Ok(PathState::Exists(path))
1550    }
1551}