Code navigation for new language: <LANGUAGE>

[314eter]

Language

OCaml (https://ocaml.org/)

Linguist entry

• Linguist language name: OCaml
• Linguist language ID: 255
• Permalink: https://github.com/github-linguist/linguist/blob/be39d09a3789d068afb33533f285df02d8e9c367/lib/linguist/languages.yml#L4944-L4963

Linguist is currently using a TextMate grammar for OCaml that hasn't been updated in 10 years and doesn't support many recent language features.

Tree-sitter parser

Parser URL: https://github.com/tree-sitter/tree-sitter-ocaml

• Parser is open source: MIT license
• Repository includes tags queries
• Tags queries include @scope for fully-qualified names: not applicable
• Rust crate: https://crates.io/crates/tree-sitter-ocaml

The tree-sitter-ocaml grammar has been one of the grammars in the upstream tree-sitter organization for 7 years. It's well-maintained (often getting support for new language features before they're released) and has no known bugs or unsupported syntax.

Other remarks

The containers relevant for fully-qualified names are modules and classes. For modules the separator is Module.item and for classes class#method, but classes are almost never used.

Linguist currently considers .ml, .mli, .eliom, .eliomi, .ml4, .mll and .mly as OCaml. In tree-sitter-ocaml there is a different grammar for .ml (source.ocaml) and .mli (source.ocaml.interface) files.