Commit graph

487 commits

Author SHA1 Message Date
sogaiu 19148eaa0d docs: mention ~ and $HOME for parser-directories 2025-05-28 11:21:09 +02:00
Max Brunsfeld ca7ff033db
Fix wasm build issues introduced by switching to wasi-sdk (#4407)
* Don't shell out for extracting tar.gz files

* Avoid wasi-sdk adding dependency on libc.so

* Clippy

* Fix -nostdlib flag
2025-04-27 19:42:34 -07:00
Tamchuk 70cf2a7a22
docs: fix typo 2025-04-23 08:26:51 -04:00
Daniel Jalkut 4514751803
docs(cli): improve documentation for the edits argument when parsing code 2025-04-18 23:45:52 -04:00
Bernardo Sulzbach 3d4d13ea1e Fix typo of "corresponds" 2025-04-07 18:34:12 -04:00
Peter Hill 4ec8aacaec docs: Fix link to named-vs-anonymous-nodes section 2025-04-06 10:58:42 -04:00
Jon Shea ec3a889758 fix(docs): update test command flag from -f to -i
Some checks failed
CI / sanitize (push) Failing after 12s
CI / build (push) Failing after 12s
CI / checks (push) Has been cancelled
Deploy Docs / deploy-docs (push) Has been cancelled
The `-f` flag on `tree-sitter test` seems to have been removed or
replaced with a `-i, --include` flag. This PR updates the "Writing Tests"
page to reflect this change.
2025-03-10 11:18:59 -04:00
Andrew Dunbar ab7eb70a3c
typo: but is only works → but it only works (#4242) 2025-02-26 09:29:27 -08:00
Amaan Qureshi a40265cbeb refactor(web): rename tree-sitter.js to web-tree-sitter.js
This is not breaking for consumers of the web bindings, nor the
playground as both filenames will be kept in the .github.io repo
2025-02-11 22:56:50 -05:00
Amaan Qureshi f20d4b0897
docs: correct build steps for WASM files 2025-02-02 02:07:36 -05:00
Amaan Qureshi 8f3ceb471a docs: add missing summary element 2025-01-25 14:08:56 -05:00
ObserverOfTime 5cfeba9c0d feat(bindings): add opt-in zig bindings 2025-01-25 03:47:19 -05:00
WillLillis 3074c0adf2 docs: add guidance about node naming conventions 2025-01-25 03:46:33 -05:00
Amaan Qureshi bde94aed4d feat(init): add a class-name field to grammars 2025-01-25 03:20:43 -05:00
Amaan Qureshi 6dbcfdf282 feat(init): add an optional funding field 2025-01-25 03:20:43 -05:00
Amaan Qureshi a70b2fee4b feat(init): allow dashes in scopes 2025-01-25 03:20:43 -05:00
Amaan Qureshi ca087d2c07 docs: add documentation on updating and publishing grammars 2025-01-25 01:14:30 -05:00
Amaan Qureshi 3e72969ce4 fix(playground): work around lack of module support in mdbook
Some checks failed
CI / checks (push) Waiting to run
CI / sanitize (push) Failing after 11s
CI / build (push) Failing after 13s
Deploy Docs / deploy-docs (push) Has been cancelled
2025-01-22 04:09:08 -05:00
Amaan Qureshi 692332ed1c feat!: update playground with new web bindings 2025-01-21 12:36:15 -05:00
Scorg 40eb26e580 build(bindings): move header to tree_sitter subdirectory
Some checks failed
CI / checks (push) Waiting to run
Deploy Docs / deploy-docs (push) Waiting to run
CI / sanitize (push) Failing after 13s
CI / build (push) Failing after 14s
This patch allows users to include the parser by the same path from
local build as well as installed location. Previously it was not
possible to include the header prior to installing the built parser.
2025-01-20 13:17:24 -05:00
Yusuf Raji 1c9a2fa455
docs: fix broken link
Some checks failed
CI / checks (push) Waiting to run
Deploy Docs / deploy-docs (push) Waiting to run
CI / sanitize (push) Failing after 14s
CI / build (push) Failing after 16s
2025-01-19 16:27:36 -05:00
Amaan Qureshi 1695e454a7 docs: improve docs around lexical precedence 2025-01-10 23:37:16 -05:00
Amaan Qureshi 5a2c5ed865 docs: improve docs for contributing to docs 2025-01-10 22:57:54 -05:00
Amaan Qureshi 8ab351ba32 docs: add example usage of conflicts 2025-01-10 22:36:12 -05:00
Amaan Qureshi 7668192a49 docs: clarify that the optional fields are a function that take in the grammar object 2025-01-10 22:36:12 -05:00
Emmanuel Ferdman 17017da7a6 docs: update playground references
Signed-off-by: Emmanuel Ferdman <emmanuelferdman@gmail.com>
2025-01-10 21:57:17 -05:00
Amaan Qureshi e58b1faac1 docs: add note on not duplicating the word token rule
Some checks failed
CI / checks (push) Waiting to run
Deploy Docs / deploy-docs (push) Waiting to run
CI / sanitize (push) Failing after 14s
CI / build (push) Failing after 16s
2025-01-10 02:58:38 -05:00
Amaan Qureshi 21d74b8482 docs: add mdbook-admonish for better tooltips 2025-01-10 02:58:38 -05:00
WillLillis c8bd78a29c feat(playground): provide colored highlight for captures in code editor 2025-01-10 00:45:08 -05:00
Amaan Qureshi 68e707eb4f feat: support passing in a Rust regex in the grammar dsl
Some checks failed
CI / checks (push) Waiting to run
CI / sanitize (push) Failing after 14s
CI / build (push) Failing after 16s
Deploy Docs / deploy-docs (push) Has been cancelled
2025-01-06 20:52:19 -05:00
WillLillis a2f6b96683 docs: add --test-number entries for query, highlight, and tag subcommands 2025-01-03 16:16:17 -05:00
Amaan Qureshi 3456330fe9 fix: update outdated links 2025-01-03 15:09:33 -05:00
Amaan Qureshi d2db7eb8ef
docs: add back detailed info about points 2024-12-28 16:12:45 -05:00
Amaan Qureshi 48fe030bdd
fix(playground): gracefully fallback to JavaScript if the select info is undefined
Some checks are pending
Deploy Docs / deploy-docs (push) Waiting to run
2024-12-27 17:08:49 -05:00
Amaan Qureshi 9228a31f94
fix(playground): restore select value's text from local storage
Some checks failed
Deploy Docs / deploy-docs (push) Has been cancelled
2024-12-26 00:17:49 -05:00
Amaan Qureshi e3b2545ab7 fix(playground): add back underline on tree nodes, and query error underline 2024-12-25 21:23:36 -05:00
Amaan Qureshi b70843a033 fix(playground): add dark theme, align ui more akin to upstream playground 2024-12-25 21:23:36 -05:00
Amaan Qureshi 5bd0d11982 fix(playground): ensure local playground is initialized 2024-12-25 21:23:36 -05:00
Amaan Qureshi 87c4df3ff3 docs: add favicon and logo 2024-12-25 21:23:36 -05:00
Amaan Qureshi dda45cfbb6 docs: move assets to correct path 2024-12-25 21:23:36 -05:00
Amaan Qureshi 432f4fd9b5 docs: add guide on contributing to docs 2024-12-24 22:43:06 -05:00
Amaan Qureshi 03b7760275 docs(scanner): add overview to the scan function
Co-authored-by: David Baynard <git@baynard.dev>
2024-12-24 22:43:06 -05:00
Amaan Qureshi 043969ef18 docs: migrate to mdbook
Some checks failed
CI / checks (push) Waiting to run
Deploy Docs / deploy-docs (push) Waiting to run
CI / sanitize (push) Failing after 14s
CI / build (push) Failing after 15s
Check Bindgen Output / check-bindgen (push) Has been cancelled
2024-12-24 20:54:59 -05:00
Max Brunsfeld 201b41cf11
feat: add 'reserved word' construct
Some checks failed
CI / sanitize (push) Failing after 13s
CI / build (push) Failing after 14s
Check Bindgen Output / check-bindgen (push) Has been cancelled
CI / checks (push) Has been cancelled
Co-authored-by: Amaan Qureshi <amaanq12@gmail.com>
2024-12-23 03:06:32 -05:00
Will Lillis 2a63077cac
style: correct typos 2024-12-23 02:11:09 -05:00
Amaan Qureshi 00674e3162 docs: clarify the start rule of a grammar 2024-12-22 23:35:13 -05:00
Juyeong Maing b68c64b332
docs: fix typo
Some checks failed
Check Bindgen Output / check-bindgen (push) Waiting to run
CI / checks (push) Waiting to run
CI / sanitize (push) Failing after 14s
CI / build (push) Failing after 15s
2024-12-22 18:43:22 -05:00
Riley Bruins 495fe2a6c5
feat: support querying missing nodes
Some checks failed
Check Bindgen Output / check-bindgen (push) Waiting to run
CI / checks (push) Waiting to run
CI / sanitize (push) Failing after 13s
CI / build (push) Failing after 14s
Co-authored-by: Amaan Qureshi <amaanq12@gmail.com>
2024-12-14 14:57:36 -05:00
Karl Traunmüller 9c80557658
docs: add documentation for TSPoint coordinates (#3949)
Some checks failed
CI / sanitize (push) Failing after 14s
CI / build (push) Failing after 14s
Check Bindgen Output / check-bindgen (push) Has been cancelled
CI / checks (push) Has been cancelled
* docs: add documentation for TSPoint coordinates

* docs: applied suggestion for TSPoint coordinates documentation
2024-11-19 12:24:31 -08:00
crvdgc 15c2957993 fix(xtask): bring back language and example filter 2024-11-12 19:09:49 -05:00
crvdgc d363f0921f doc(xtask): update doc to use xtask, not scripts
Follow-up of dbe8bbf. Also removed `-l` flag since it's not used
anymore.
2024-11-12 19:09:49 -05:00
Daiki Noda 738c956a3e docs: add missing tags description
Some checks failed
Check Bindgen Output / check-bindgen (push) Waiting to run
CI / checks (push) Waiting to run
CI / sanitize (push) Failing after 13s
CI / build (push) Failing after 13s
2024-11-10 17:24:22 +01:00
Peter Oliver 25e36bda87
Link to Emacs’ Tree-sitter documentation (#3881)
Some checks failed
Check Bindgen Output / check-bindgen (push) Waiting to run
CI / checks (push) Waiting to run
CI / sanitize (push) Failing after 12s
CI / build (push) Failing after 13s
Since Emacs 29, Tree-sitter is a built-in feature not requiring a third-party Emacs module.
2024-11-04 14:08:52 -08:00
Will Lillis 9d86cb2c20
fix(docs): update link for "Error Detection and Recovery in LR Parsers" 2024-11-02 01:34:49 -04:00
Amaan Qureshi 500f4326d5 feat: add the ability to specify a custom decode function 2024-10-31 22:51:40 -04:00
Sam Estep a767f89967 docs: fix missing links 2024-10-30 17:24:16 -04:00
Sam Estep 31af4294a7
docs: recommend npm install for editor integration 2024-10-30 17:06:23 -04:00
Amaan Qureshi 40606dd632
feat: add version subcommand for versioning grammars 2024-10-18 22:08:57 -04:00
Will Lillis 4705a3153a
feat: Add CST pretty-printer for parser output
Co-authored-by: Amaan Qureshi <amaanq12@gmail.com>
2024-10-12 18:37:12 -04:00
ObserverOfTime 608506cb57 fix(init): fix some schema issues
- Validate CamelCase name, TextMate scope
- Skip serialization of unused properties
- Disallow additional properties in schema
2024-10-01 11:37:57 -04:00
Amaan Qureshi ea3846a2c5
feat: move tree-sitter configuration to dedicated file (#3700) 2024-09-30 11:11:23 -04:00
ObserverOfTime cd837df295 chore: update generate crate paths 2024-09-28 13:58:30 -04:00
ObserverOfTime f212605dda refactor: improve the grammar schema
- Publish on the GitHub page
- Specify in the generated file
- Use const/enum instead of pattern
2024-09-28 13:58:30 -04:00
Amaan Qureshi 9301d38b77 feat!: remove C++ support for external scanners 2024-09-07 20:14:36 -04:00
Amaan Qureshi 30d5607cdb docs: add Kotlin to the playground 2024-08-29 21:22:55 -04:00
Amaan Qureshi 973b01071e fix(go): update parser name in binding files, add to docs 2024-08-24 19:24:06 -04:00
Ron Panduwana 2bb20fe2fe
feat: allow external scanners to use the logger
Co-authored-by: Amaan Qureshi <amaanq12@gmail.com>
2024-08-17 14:46:28 -04:00
ObserverOfTime 18d902cd20 docs: clean up binding & parser lists
- Separate official and third-party bindings
- Remove links to outdated bindings
- Move parser list to the wiki
2024-08-17 00:59:52 -04:00
dependabot[bot] 4f97cf8505 build(deps-dev): bump rexml from 3.3.2 to 3.3.3 in /docs
Some checks failed
CI / sanitize (push) Failing after 12s
CI / build (push) Failing after 12s
CI / checks (push) Has been cancelled
Bumps [rexml](https://github.com/ruby/rexml) from 3.3.2 to 3.3.3.
- [Release notes](https://github.com/ruby/rexml/releases)
- [Changelog](https://github.com/ruby/rexml/blob/master/NEWS.md)
- [Commits](https://github.com/ruby/rexml/compare/v3.3.2...v3.3.3)

---
updated-dependencies:
- dependency-name: rexml
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-08-09 12:04:24 +03:00
dependabot[bot] 42d5a34735 build(deps-dev): bump rexml from 3.2.8 to 3.3.2 in /docs
Bumps [rexml](https://github.com/ruby/rexml) from 3.2.8 to 3.3.2.
- [Release notes](https://github.com/ruby/rexml/releases)
- [Changelog](https://github.com/ruby/rexml/blob/master/NEWS.md)
- [Commits](https://github.com/ruby/rexml/compare/v3.2.8...v3.3.2)

---
updated-dependencies:
- dependency-name: rexml
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-07-29 15:53:42 +03:00
Segev Finer 149a2a9081
docs: add tsserver annotation to example (#3460) 2024-07-28 09:17:20 +03:00
Stefano Volpe 3095fbe07b
docs: fix syntax highlighting unit testing example 2024-07-06 03:33:24 -04:00
Amaan Qureshi 34c4784ac5
docs: add note for bullet 2024-06-23 13:38:57 -04:00
dependabot[bot] 35c0fad26f build(deps-dev): bump rexml from 3.2.5 to 3.2.8 in /docs
Bumps [rexml](https://github.com/ruby/rexml) from 3.2.5 to 3.2.8.
- [Release notes](https://github.com/ruby/rexml/releases)
- [Changelog](https://github.com/ruby/rexml/blob/master/NEWS.md)
- [Commits](https://github.com/ruby/rexml/compare/v3.2.5...v3.2.8)

---
updated-dependencies:
- dependency-name: rexml
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-05-24 22:24:50 -04:00
dependabot[bot] 2653fac99b build(deps-dev): bump nokogiri from 1.16.2 to 1.16.5 in /docs
Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.16.2 to 1.16.5.
- [Release notes](https://github.com/sparklemotion/nokogiri/releases)
- [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md)
- [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.16.2...v1.16.5)

---
updated-dependencies:
- dependency-name: nokogiri
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-05-24 22:24:37 -04:00
ObserverOfTime 6bfdae00f2 docs: mention build command variables 2024-05-05 13:06:45 -04:00
Davis Vaughan 937dfbfbab Swap \s for \\s 2024-04-20 07:51:45 -04:00
Amaan Qureshi 96d18408a3 refactor(js): misc fixes & tidying 2024-04-11 22:35:43 -04:00
ObserverOfTime 63babea301 fix: proper function prototypes 2024-04-11 16:28:21 -04:00
JonCoole d569d0ea6a
docs: add NGINX grammar
Added the NGINX tree-sitter repository to the index.md list
2024-03-17 19:01:37 -04:00
Amaan Qureshi 99b93d83a1 feat(cli)!: add a separate build command to compile parsers
This allows users to build parsers without having to run `test` or
`parse` to invoke the compilation process, and allows them to output the
object file to wherever they like. The `build-wasm` command was merged
into this by just specifying the `--wasm` flag.
2024-03-17 05:36:30 -04:00
Giftpflanze 647d2e5c37
docs: fix typo 2024-03-12 02:29:55 -04:00
Boris Verkhovskiy c070c92722 refactor(wasm)!: make current*, is*, and has* methods properties 2024-03-08 00:27:06 -05:00
Novus Nota 43358f0c59
docs: Add Ohm language parser 2024-02-29 19:13:53 +01:00
Amaan Qureshi 3eb7366500 docs: document test attributes 2024-02-29 02:17:30 -05:00
Amaan Qureshi 60a935139b refactor!: remove top-level corpus dir for tests
It's confusing to have tests in two different top-level directories when working between different grammars, and most of them use `test/corpus` which is more fitting, so time to go.
2024-02-29 02:17:30 -05:00
ObserverOfTime b4b2d9cecc refactor: remove extern/const where possible 2024-02-29 01:50:04 -05:00
ObserverOfTime 502dacf220 refactor: rename TS_REUSE_ALLOCATOR flag
TREE_SITTER_REUSE_ALLOCATOR is more consistent
2024-02-27 15:54:38 -05:00
Amaan Qureshi f1eecf9786 feat: expose the allocator and array header files for external scanners 2024-02-26 09:43:13 -05:00
Amaan Qureshi 9e5bf6591f feat: improve language bindings
Co-authored-by: ObserverOfTime <chronobserver@disroot.org>
2024-02-25 19:06:01 -05:00
Seonghyeon Cho 80006d2f28
docs: add css for inline code 2024-02-24 18:36:23 -05:00
Novus Nota 464dbef794
docs: add Tact language parser 2024-02-16 23:31:07 +01:00
Amaan Qureshi 4342efd57e feat: allow specifying an external scanner's files 2024-02-16 16:31:56 -05:00
dundargoc bf9154febe docs: small fixes
Co-authored-by: Wang <bonede@qq.com>
Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
2024-02-16 00:15:49 +01:00
Nickolay 6895b7a1e1
Add some documentation to the playground page
The minimal UI of the Playground could benefit from some documentation to make it easier for the newer users to understand what's going on. Also added a link to the new documentation from the local playground.

Closes https://github.com/tree-sitter/tree-sitter/issues/1305
2024-02-15 16:24:21 +01:00
Amaan Qureshi 665f5a0793 docs: explicitly mention behavior of walking outside the given "root" node for a TSTreeCursor 2024-02-14 15:54:46 -05:00
Amaan Qureshi 74812ced1b chore: deprecate C++ scanners
C++ has been a headache to deal with throughout the ecosystem and for
several downstream projects. It is difficult to get working with WASM,
and induces potential issues with compilation on Windows. It has been
proven that writing scanners in C is a much better alternative, and is
the recommended way to write scanners now. C++ support will likely be
removed in 0.21.0
2024-02-14 15:43:53 -05:00
Amaan Qureshi 792cbde728 docs: mention that token($.foo) is illegal 2024-02-12 17:17:37 -05:00
Amaan Qureshi 0109c877d5 docs: document regex limitations 2024-02-12 17:17:37 -05:00
Caleb White 6ccc1d11c8 chore: document preferred language for scanner 2024-02-09 03:21:23 -05:00
dundargoc df1fe842eb docs: various fixes
Closes https://github.com/tree-sitter/tree-sitter/issues/1317.
Closes https://github.com/tree-sitter/tree-sitter/issues/1752.
Closes https://github.com/tree-sitter/tree-sitter/issues/2439.

Co-authored-by: Simon Hengel <sol@typeful.net>
Co-authored-by: Akash Yadav <itsaky01@gmail.com>
Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: Laytan Laats <laytanlaats@hotmail.com>
2024-02-08 00:08:59 +01:00
dependabot[bot] 7f3122bc00
build(deps-dev): bump nokogiri from 1.14.3 to 1.16.2 in /docs
Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.14.3 to 1.16.2.
- [Release notes](https://github.com/sparklemotion/nokogiri/releases)
- [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md)
- [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.14.3...v1.16.2)

---
updated-dependencies:
- dependency-name: nokogiri
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-02-05 21:04:01 +00:00
Amaan Qureshi 03abb6179c
Merge pull request #2780 from bugwelle/patch-1
fix(docs): Fix link to contributing guide
2024-02-05 01:13:03 -05:00
dependabot[bot] eb821761a1
build(deps-dev): bump activesupport from 7.0.4.3 to 7.1.3 in /docs
Bumps [activesupport](https://github.com/rails/rails) from 7.0.4.3 to 7.1.3.
- [Release notes](https://github.com/rails/rails/releases)
- [Changelog](https://github.com/rails/rails/blob/v7.1.3/activesupport/CHANGELOG.md)
- [Commits](https://github.com/rails/rails/compare/v7.0.4.3...v7.1.3)

---
updated-dependencies:
- dependency-name: activesupport
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-02-03 23:02:35 +00:00
Steven Kalt d35efd4608
feat(cli): support building WASM via podman
Previously, `tree-sitter build-wasm` had the ability to build WASM
by using docker to pull in an image with a complete emscripten toolchain.
This commit adds the ability to use podman to do the same thing.

Using podman requires two notable changes:
1. Using the fully-qualified image name. Docker defaults to prepending
    `docker.io` to the image name, but podman does not.
2. Podman will mount the `/src/` volume as belonging to root unless
  `--userns=keep-id` is passed. I think podman's different
  volume-ownership is related to podman's daemonless execution and
  `--uidmap` functionality, but I'm not 100% sure.

To test, I ran
```sh
script/fetch-fixtures
script/generate-fixtures
script/generate-fixtures-wasm # <- the important one!
```

which worked as well as the docker version.
2024-01-29 00:50:32 -05:00
Amaan Qureshi 571fc02bd4
docs: add various binding and grammar links
Co-authored-by: Ramkumar Ramachandra <r@artagnon.com>
Co-authored-by: Yutaro Sakamoto <yutaro-sakamoto@yutaro-sakamoto.com>
Co-authored-by: Philipp Mildenberger <philipp@mildenberger.me>
Co-authored-by: Sepehr Laal <5657848+3p3r@users.noreply.github.com>
Co-authored-by: Lachance, Alexandre <alexandrelachance@me.com>
Co-authored-by: Derek Stride <derek@stride.host>
Co-authored-by: John Didion <github@didion.net>
Co-authored-by: Felix Rath <felixm.rath@gmail.com>
Co-authored-by: Javier Suarez <jsuarez@salesforce.com>
Co-authored-by: Fabian Wermelinger <fab4100@posteo.net>
Co-authored-by: Colin Kennedy <ckanimate@gmail.com>
Co-authored-by: Alfred Fuller <afuller@buf.build>
Co-authored-by: Boris Verkhovskiy <boris.verk@gmail.com>
Co-authored-by: Stanislav Romanov <kaermorchen@gmail.com>
Co-authored-by: Hamza Hamud <53880692+hhamud@users.noreply.github.com>
Co-authored-by: Tomas Sandven <tomas@sandven.email>
Co-authored-by: Vladimir Kazanov <vkazanov@inbox.ru>
Co-authored-by: citronneur <citronneur@gmail.com>
Co-authored-by: DennySun2100 <138833544+DennySun2100@users.noreply.github.com>
Co-authored-by: Z572 <37945516+Z572@users.noreply.github.com>
Co-authored-by: alaviss <leorize+oss@disroot.org>
2024-01-25 21:41:07 -05:00
Adrian Alic 6fd3582ae3
Add missing closing parenthesis 2024-01-25 20:45:46 -05:00
Andre Meyering 0da0da043e
fix(docs): Fix link to contributing guide
The link to the contribution guide on 
https://tree-sitter.github.io/tree-sitter/using-parsers was dead.
2023-11-24 09:59:00 +01:00
Firas al-Khalil 665da5e230 doc: fix multi-language program typo 2023-11-06 13:18:09 +01:00
Amaan Qureshi c5cb27e522
docs: improve predicate docs 2023-08-31 16:01:37 -04:00
Amaan Qureshi 95ab103f48
docs: update injection properties 2023-08-22 01:36:25 -04:00
Amaan Qureshi 45313e0dfb
feat: add injection.self to inject a node with itself 2023-08-18 18:37:57 -04:00
dependabot[bot] 5cca35e2ef
chore(deps-dev): bump commonmarker from 0.23.9 to 0.23.10 in /docs
Bumps [commonmarker](https://github.com/gjtorikian/commonmarker) from 0.23.9 to 0.23.10.
- [Release notes](https://github.com/gjtorikian/commonmarker/releases)
- [Changelog](https://github.com/gjtorikian/commonmarker/blob/v0.23.10/CHANGELOG.md)
- [Commits](https://github.com/gjtorikian/commonmarker/compare/v0.23.9...v0.23.10)

---
updated-dependencies:
- dependency-name: commonmarker
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2023-08-08 20:25:20 +00:00
Ganesan Arjuna Maharaja f9f51480eb correcting the spelling of valid_symbols in indent dedent example 2023-07-29 20:55:33 +05:30
Amaan Qureshi c1d227bdb7
docs: document negative assertions 2023-07-25 00:32:40 -04:00
Andrew Hlynskyi 3c806913d8 docs: improve external scanner details and fix conflicting tokens details
* Removed convention notes introduced in #1947 due to:
  * It doesn't so strict for bindings and they may need to obey to some
    target language conventions.
  * For language grammars there is a note that states the same in the
    `Creating Parsers` section.
* Removed `External Scanning` item introduced in 87a0517 commit
  originated from #1612 due to unclear consistency with other
  5 original statements. There is a similar explanation in the
  `Other External Scanner Details` section.
2023-04-16 23:46:21 +03:00
Andrew Hlynskyi 613382c70a docs: update badges; fix markdown lint complains
Linter config `.vscode/settings.json`:
```json
{
    "[markdown]": {
        "files.trimTrailingWhitespace": false,
    },
    "markdownlint.config": {
        "default": true,
        // "ul-style": {
        //     "style": "asterisk"
        // },
        "MD001": false,
        "MD024": false,
        "MD025": false,
        "MD033": false,
        "MD041": false,
        "MD053": false,
    },
}
```
2023-04-16 23:39:08 +03:00
Andrew Hlynskyi d7fcc7aad3
Merge pull request #2206 from tree-sitter/fix-docs-prec-rules
docs: remove controversial statement
2023-04-15 05:43:04 +03:00
dependabot[bot] e47f05062a chore(deps): bump commonmarker from 0.23.8 to 0.23.9 in /docs
Bumps [commonmarker](https://github.com/gjtorikian/commonmarker) from 0.23.8 to 0.23.9.
- [Release notes](https://github.com/gjtorikian/commonmarker/releases)
- [Changelog](https://github.com/gjtorikian/commonmarker/blob/main/CHANGELOG.md)
- [Commits](https://github.com/gjtorikian/commonmarker/compare/v0.23.8...v0.23.9)

---
updated-dependencies:
- dependency-name: commonmarker
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2023-04-15 05:15:36 +03:00
Andrew Hlynskyi b5e6d18086 docs: add a grammar syntax sample for lexical precedence 2023-04-15 05:10:02 +03:00
Andrew Hlynskyi bfd56a1e59 docs: remove controversial Earliest Starting Position item added previously by 87a0517 2023-04-15 05:10:02 +03:00
Andrew Hlynskyi 1f051d339c chore(docs): fix misprint repetitions and remove dangling spaces 2023-04-09 20:40:18 +03:00
Kait Lam e3ea048db1 docs: alphabetise language bindings on front page
This helps with readability when scanning for a particular language. It is, strangely, almost sorted with the exception of Java and Kotlin.
2023-04-09 17:48:00 +03:00
Carlo Teubner 34e0ab696c
docs: remove mention of Atom
Atom is dead, so this mention seems unnecessary now.
2023-04-08 18:10:44 +01:00
Andrew Hlynskyi c26dde0414
Merge pull request #1947 from hickford/patch-3
docs: explain naming convention for bindings and parsers
2023-04-04 18:37:18 +03:00
M Hickford 5ce60ef9e5 docs: clarify naming convention for bindings and parsers 2023-04-04 18:29:52 +03:00
Andreas Deininger 0751736d17 docs: convert various links to https protocol 2023-04-04 18:05:46 +03:00
Andrew Hlynskyi 2ce06b623e docs: update Gemfile.lock to fix GH dependabot complains
Updated with commands like:
  > gem install bundler
  > bundle config set --local path 'vendor/bundle'
  > bundle update --bundler
  > #bundle add webrick
  > bundle update
  > #bundle exec jekyll serve
2023-03-15 12:38:06 +02:00
Andrew Hlynskyi 1b2a3e3c73 docs: add webrick to Gemfile to fix a compat issue 2023-03-15 12:31:54 +02:00
Andrew Hlynskyi 5766b8a0a7 docs: apply scheme marker for all query syntax snippets 2023-02-06 21:33:50 +02:00
Andrew Hlynskyi 2e732d17dd docs: merge of all binding and grammar link PRs
Joined commit messages:
---

Closes: #2048

    docs: add capnp, smali, thrift

Closes: #2026

    Add Perl binding

Closes: #1989

    Add Ada to the list of available parsers

Closes: #1980

    Add clojure to list of available parsers

    After some discussion in
    https://github.com/sogaiu/tree-sitter-clojure/issues/28

    I decided to submit an issue to the tree-sitter organization
    to include tree-sitter-clojure in their list of available parsers.
    This repository is used by a couple of editors and tools, and
    I am using it to build a tree-sitter based programming mode
    for Clojure in Emacs.
    Since there are a couple of tools that depend on it, it seems
    worthy of inclusion in an official list of tree-sitter grammars.

Closes: #1943

    Add meson grammar to list.

Closes: #1926

    docs(meson): add parse for meson
    add meson

Closes: #1912

    Merge branch 'master' into add-heex-parser

Closes: #1908

    Add Apex to available parsers

Closes: #1876

    Add tree-sitter-gleam to list of available parsers

Closes: #1862

    DOCS: Add entries various SQL flavor parsers

Closes: #1857

    Add Go to the available language bindings

Closes: #1856

    docs: add jq grammar

Closes: #1828

    Add tree sitter lalrpop

    This is a parser for https://github.com/lalrpop/lalrpop,
    a parser generator for use in Rust.

    It is still in development because it should support some kind
    of highlighting of the pseudo rust code used in rules.

Closes: #1733

    Add YANG parser to parser list
    I wrote this parser over summer vacation last year and I've been using it at work every day since.

Closes: #1728

    Add link to m68k grammar
    Link to m68k (Motorola 68000 assembly) grammar in docs.

Closes: #1697

    Added rego language

Closes: #1694

    docs: add Formula parser

Closes: #1672

    docs: Add link to QML (Qt UI spec/programming language) parser

Closes: #1671

    parser: add beancount parser link

Closes: #1623

    Add link to llvm grammars
    Add links to LLVM IR, MIR and TableGen parsers.

Closes: #1579

    Add my Smali parser to the WIP list

Closes: #1575

    Update index.md

Closes: #1563

    Add re2c and sort alphabetically

    Added re2c parser (lexer generator).
    Sorted the list alphabetically case-insensitively.

Closes: #1209

    add link to chess Portable Game Notation grammar

Closes: #1176

    Add tree-sitter-lean.

Closes: #1123

    Add parsers to list

---
Co-authored-by: Amaan Qureshi <amaanq12@gmail.com>
Co-authored-by: Felipe Gasper <FGasper@users.noreply.github.com>
Co-authored-by: Emmanuel Briot <briot.emmanuel@gmail.com>
Co-authored-by: Danny Freeman <dannyfreeman@users.noreply.github.com>
Co-authored-by: Garrett D'Amore <garrett@damore.org>
Co-authored-by: ShootingStarDragons <ShootingStarDragons@protonmail.com>
Co-authored-by: Clay <connorlay@users.noreply.github.com>
Co-authored-by: Anthony Heber <anthony@heber.dev>
Co-authored-by: Jonathan Arnett <jonarnett90@gmail.com>
Co-authored-by: takegue <takegue@gmail.com>
Co-authored-by: Cédric Fabianski <cedric@bearer.sh>
Co-authored-by: flurie <flurie@gmail.com>
Co-authored-by: traxys <quentin+dev@familleboyer.net>
Co-authored-by: Tomas Sandven <597206+Hubro@users.noreply.github.com>
Co-authored-by: Graham Bates <info@grahambates.com>
Co-authored-by: Lex <mr.x97@mail.ru>
Co-authored-by: Ben Siraphob <bensiraphob@gmail.com>
Co-authored-by: Yuya Nishihara <yuya@tcha.org>
Co-authored-by: WeiZhang <kweizh@gmail.com>
Co-authored-by: Flakebi <flakebi@t-online.de>
Co-authored-by: Yotam <me@yotam.net>
Co-authored-by: Fymyte <34305318+Fymyte@users.noreply.github.com>
Co-authored-by: Alexandre A. Muller <muller@outlook.com>
Co-authored-by: Roland Walker <walker@pobox.com>
Co-authored-by: Julian Berman <Julian@GrayVines.com>
Co-authored-by: Santos Gallegos <stsewd@protonmail.com>
2023-01-27 10:15:23 +02:00
Andrew Hlynskyi cca626afe7 docs: remove duplicated link 2023-01-27 07:49:07 +02:00
Matt ae3b60bd29
Include many new parsers in a unified list 2023-01-17 09:14:57 -05:00
Andrew Helwer 278ff01e71 Added additional documentation details
* External scanners and infinite loops
* Terminal keywords in externals array
* Using error sentinel external token
* Good practice to erase state variables in deserialize func
* Emphasize external scanner is called first
2023-01-03 02:48:55 +02:00
Andrew Helwer 87a0517f3c Various updates to Creating Parsers docs
* Documented test separator suffixes
* Documented partial precedences field
* Added external scanning to conflicting tokens rules
* Added earliest starting position to conflicting tokens rules
* Added note about lexical precedence vs. parse precedence
* Added note about tree-sitter calling external scanner with all
  tokens marked valid during error recovery
2023-01-03 02:48:48 +02:00
Andrew Helwer dddbc2d4f7 Added working commands for Windows users
Windows users are likely to be using either Windows Terminal (which uses PowerShell) or PowerShell directly.
2023-01-02 02:31:06 +02:00
Max Brunsfeld 8883d43bee
Merge pull request #1941 from mliszcz/master
Fix test output formatting for rules starting with M/U
2022-11-15 17:13:39 -08:00
Max Brunsfeld 37e0e8a7ab
Merge pull request #1918 from alanz/add-erlang-complete
Add Erlang to list of Available Parsers
2022-11-15 16:27:39 -08:00
mliszcz 7bf2484d81 Fix test output formatting for rules starting with M/U
Previously the rule names could not begin with an uppercase M or U
because the test output formatter assumed that they represent special
tokens: MISSING or UEXPECTED.

Fixes #1940.
2022-11-15 20:20:44 +01:00
Jonathan Arnett 245e3b0092 Add note about including an external scanner in Rust crate 2022-10-30 23:24:50 -04:00
Garrett D'Amore db846931c6
Add D grammar - it is quite complete for D 2.100. 2022-10-20 08:33:43 -07:00
Alan Zimmerman 54ace9fe27 Add Erlang to list of Available Parsers
Switching from under-development

  https://github.com/AbstractMachinesLab/tree-sitter-erlang

to

  https://github.com/WhatsApp/tree-sitter-erlang/

which is based originally on it.
2022-10-20 09:50:14 +01:00
Gilles Roustan 346572a348 Add twig parser in documentation 2022-10-04 10:08:56 +02:00
Max Brunsfeld d1d8193d2f
Merge pull request #1858 from mattmassicotte/swift-docs-update
Update ref to swift parser
2022-09-06 14:09:02 -07:00
Matt 94b828f4fb
Update ref to swift parser 2022-09-05 16:21:12 -04:00
Max Brunsfeld 3563fe009a Explain in the docs that npm install supports limited platforms 2022-09-02 15:31:21 -07:00
Max Brunsfeld 366210ae92
Merge pull request #1766 from 6cdh/racket-link
Add link to Racket language parser
2022-08-25 10:52:34 -07:00
petrisch 40a2afad49
Update section-2-using-parsers.md
Typo
2022-06-27 10:15:23 +02:00
6cdh 1acbb9bd84 Add link to Racket language parser 2022-06-04 10:44:59 +08:00
Cycatz 369c88713c
Add link to Org language parser 2022-05-16 15:58:33 +00:00