Skip to content

Docs: rbs and toml#92

Open
pboling wants to merge 2 commits intostackmystack:masterfrom
kettle-rb:feat/rbs-and-toml
Open

Docs: rbs and toml#92
pboling wants to merge 2 commits intostackmystack:masterfrom
kettle-rb:feat/rbs-and-toml

Conversation

@pboling
Copy link
Copy Markdown

@pboling pboling commented Apr 8, 2026

Description

The toml tree-sitter grammar is maintained under the tree-sitter-grammars org, not the default tree-sitter org - pinned at v0.7.0.

The rbs tree-sitter grammar is maintained by @joker1007, not the default tree-sitter org - pinned at v0.2.2.

Add toml and rbs as a documented examples of the from override in README, rustdoc, and test fixtures.

Motivation and Context

Just adds documentation and test support for toml and rbs grammars, since they are becoming more widely used in Ruby-land. ;)

I have also integrated tsdl into my ts-grammar-action, so it now downloads released version of tsdl, and uses it to install grammars! I am now beginning use that GitHub Action in at least one workflow in all of my gems, as I begin validating their coherence with my gem template, and they will use tree sitter grammars to accomplish much of that work via my ast-merge gem & friends. in other words - all of my gems will depend on this in GHA soon.

How Has This Been Tested?

Both grammars built and verified successfully:
• toml v0.7.0 → libtree-sitter-toml.so (37K) — exports tree_sitter_toml + external scanner symbols
• rbs v0.2.2 → libtree-sitter-rbs.so (129K) — exports tree_sitter_rbs

Total build time: 2.3s (including tree-sitter-cli download). The from overrides for both non-standard repos (tree-sitter-grammars/tree-sitter-toml and joker1007/tree-sitter-rbs) work correctly.

Types of Changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation (no code change)
  • Refactor (refactoring production code)
  • Other

Checklist:

  • My code follows the code style of this project.
  • I have updated the documentation accordingly.
  • I have formatted the code with rustfmt.
  • I checked the lints with clippy.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

Copilot AI review requested due to automatic review settings April 8, 2026 04:39
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR expands the documented/tested from override support by adding real-world examples for Tree-sitter grammars that live outside the default tree-sitter/tree-sitter-<lang> GitHub org/repo naming pattern (TOML and RBS), pinned to known versions.

Changes:

  • Document from overrides for toml (tree-sitter-grammars) and rbs (joker1007) in the README example config.
  • Mirror those same examples in the crate-level rustdoc configuration snippet (src/lib.rs).
  • Extend the CLI build integration tests to cover pinned from overrides for toml and rbs.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
tests/cmd/build.rs Adds pinned build test cases and config fixtures for toml and rbs using from overrides.
src/lib.rs Updates rustdoc TOML config example to include toml and rbs from overrides.
README.md Updates user-facing config example to include toml and rbs from overrides.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@pboling pboling changed the title Feat/rbs and toml Docs: rbs and toml Apr 8, 2026
@stackmystack
Copy link
Copy Markdown
Owner

Thanks for the PR.

I would only ask to follow the commit style of the repo and avoid emojis.

Once that's done and the test suite passes, I'll merge.

The toml tree-sitter grammar is maintained under the
tree-sitter-grammars org, not the default tree-sitter org.
Add toml as a documented example of the `from` override
in README, rustdoc, and test fixtures.

Pinned at v0.7.0 (64b56832c2cffe41758f28e05c756a3a98d16f41).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@pboling pboling force-pushed the feat/rbs-and-toml branch from 473225d to 5afbba6 Compare April 9, 2026 04:13
- Add tree-sitter-rbs v0.2.2 with from override to README, rustdoc, and tests
- rbs-merge can use tree-sitter-rbs as a backend for RBS type signature parsing

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@pboling pboling force-pushed the feat/rbs-and-toml branch from 5afbba6 to 808c0ef Compare April 9, 2026 04:16
@pboling
Copy link
Copy Markdown
Author

pboling commented Apr 9, 2026

@stackmystack fixed!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants