tree-sitter-objectscript 1.7.5

Objectscript grammar for tree-sitter

tree-sitter-objectscript

Tree-sitter grammars for InterSystems ObjectScript.

Grammars

This repository publishes five related grammars:

• objectscript: playground/snippet grammar.
• objectscript_udl: class-file grammar for .cls.
• objectscript_core: routine/statement grammar.
• objectscript_expr: expression grammar.
• objectscript_routine: routine-file grammar for .mac, .inc, .rtn, and .int.

Grammar extension graph: objectscript_expr -> objectscript_core -> objectscript_udl -> objectscript objectscript_expr -> objectscript_core -> objectscript_routine

Packages

• npm: tree-sitter-objectscript
• PyPI: tree-sitter-objectscript (ships tree_sitter_objectscript, tree_sitter_objectscript_udl, and tree_sitter_objectscript_routine)
• Rust crates:
  • tree-sitter-objectscript (UDL grammar)
  • tree-sitter-objectscript-routine (routine grammar)
  • tree-sitter-objectscript-playground (playground grammar)

Bindings

Language bindings are available under bindings/:

• C: bindings/c
• Go: bindings/go
• Node.js: bindings/node
• Python: bindings/python
• Rust: bindings/rust, bindings/rust-routine, and bindings/rust-playground
• Swift: bindings/swift

Quick binding checks from repo root:

nvm use
npm ci
cargo test --lib --package tree-sitter-objectscript
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -U pip setuptools wheel pytest tree-sitter
python3 setup.py build_ext --inplace
PYTHONPATH=$PWD/bindings/python python3 -m pytest -q bindings/python/tests/test_binding.py
npm test
go test ./bindings/go/...
swift test
make test

The routine and playground Rust crates are staged from bindings/rust-routine and bindings/rust-playground via helper scripts. See CONTRIBUTING.md for the current local build workflow and the temporary studio-highlights.scm copy step those staged crates need today.

For Node bindings specifically, .nvmrc pins the expected Node version.

Quick Development

Install the tree-sitter CLI, then run commands from a grammar directory (objectscript, udl, core, expr, or objectscript_routine):

tree-sitter generate
tree-sitter test
tree-sitter build

For playground work:

tree-sitter build --wasm
tree-sitter playground

If you change an upstream grammar (expr or core), regenerate downstream grammars as needed (udl, objectscript, objectscript_routine).

Query Sync

scripts/sync_queries.py manages the canonical query trio for each grammar:

• highlights.scm
• indents.scm
• injections.scm

It composes the layered query trees for core, udl, objectscript, and objectscript_routine, then mirrors those composed files into the Python binding query directories. studio-highlights.scm files are intentionally left out of that sync process and are maintained separately.

Corpus Sync

objectscript/test/corpus is treated as a synced corpus directory. On commit, the repository pre-commit hook:

• Replaces objectscript/test/corpus contents with files from:
  • core/test/corpus
  • udl/test/corpus
  • objectscript_routine/test/corpus
• Removes objectscript/test/corpus/invalid.txt
• Removes objectscript/test/corpus/compiled-header.txt

Contributing

See CONTRIBUTING.md for setup, workflow, query sync, and binding test instructions.

References

• InterSystems ObjectScript documentation
• Tree-sitter documentation

Editor Integration

• Zed On Zed, you can use tree-sitter-objectscript by downloading the InterSystems ObjectScript extension

• Neovim We currently have a PR open with nvim-treesitter, and if that gets merged in, the setup process will be automated. However, this repo is currently archived, so for now do the following to setup the grammars in neovim:

  Step 1: Create ~/.config/nvim/lua/plugins/objectscript-treesitter.lua

  Add the following content to that file: IMPORTANT: Make sure to replace the revision section with the commit that you want.

  return {
  -- configure nvim-treesitter
  {
    "nvim-treesitter/nvim-treesitter",
    init = function()
      vim.filetype.add({
        extension = {
          cls = "objectscript_udl",
          mac = "objectscript_routine",
          inc = "objectscript_routine",
          int = "objectscript_routine",
          rtn = "objectscript_routine"
        },
      })
  
      vim.api.nvim_create_autocmd("FileType", {
        pattern = { "objectscript_udl", "objectscript_routine" },
        callback = function(args)
          vim.treesitter.start(args.buf)
        end,
      })
  
      vim.api.nvim_create_autocmd('User', { pattern = 'TSUpdate',
      callback = function()
      local parsers = require("nvim-treesitter.parsers")
  
        parsers.objectscript_udl = {
          install_info = {
            url = "https://github.com/intersystems/tree-sitter-objectscript",
            revision = "f1c568c622a0a43191563fd4c5e649a61eef11cc", 
            location = "udl",
            queries = "udl/queries",
          }
        }
  
        parsers.objectscript_routine = {
          install_info = {
            url = "https://github.com/intersystems/tree-sitter-objectscript",
            revision = "f1c568c622a0a43191563fd4c5e649a61eef11cc", 
            location = "objectscript_routine",
            queries = "objectscript_routine/queries",
          }
        }
      end})
    end,
  
      opts = function(_, opts)
        opts.ensure_installed = opts.ensure_installed or {}
        for _, lang in ipairs({ "objectscript_udl", "objectscript_routine" }) do
          if not vim.tbl_contains(opts.ensure_installed, lang) then
            table.insert(opts.ensure_installed, lang)
          end
        end
      end,
    },
  }
  

  Step 2: Remove cached data from nvim if necessary (if previously installed)

  rm -rf ~/.local/share/nvim/site/parser \
    ~/.local/share/nvim/site/parser-info \
    ~/.local/share/nvim/site/queries
  

  Step 3: Open Neovim and Install objectscript_udl and objectscript_routine

  :TSInstall objectscript_udl objectscript_routine