tree-sitter

What's Changed

• fix(docs): QueryCursor page was missing from index by @MisakaVan in #385
• fix: pattern_index parameter to generic predicates is incorrect by @davidt in #388
• docs(readme): update query usage examples by @TomJGooding in #390
• docs(query_cursor): fix missing space in hint by @TomJGooding in #391
• ci: bump pypa/cibuildwheel from 3.0 to 3.1 in the actions group by @dependabot[bot] in #392
• build: work around GCC optimizer bug for aarch64 by @tree-sitter-ci-bot[bot] in #393
• build: bump tree_sitter/core from 58edb3a to 3624198 by @dependabot[bot] in #397
• chore: release 0.25.1 by @tree-sitter-ci-bot[bot] in #398
• ci(pypi): disable free-threaded builds by @tree-sitter-ci-bot[bot] in #399

New Contributors

• @MisakaVan made their first contribution in #385
• @davidt made their first contribution in #388
• @TomJGooding made their first contribution in #390
• @tree-sitter-ci-bot[bot] made their first contribution in #393

Full Changelog: v0.25.0...v0.25.1

Breaking changes are marked with !.

Additions:

• Language.name (getter)
• Language.abi_version (getter)
• Language.semantic_version (getter)
• Language.supertypes (getter)
• Language.subtypes(supertype)
• Node.first_child_for_byte(byte)
• Node.first_named_child_for_byte(byte)
• Query.string_count (getter)
• Query.capture_name(index)
• Query.capture_quantifier(pattern_index, capture_index)
• Query.string_value(index)
• QueryCursor(query)
• QueryCursor.match_limit (getter, setter, deleter)
• QueryCursor.timeout_micros (getter, setter, deleter)
• QueryCursor.did_exceed_match_limit (getter)
• QueryCursor.set_max_start_depth(depth)
• QueryCursor.set_byte_range(start, end)
• QueryCursor.set_point_range(start, end)
• QueryCursor.captures(node, predicate, progress_callback)
• QueryCursor.matches(node, predicate, progress_callback)
• LookaheadIterator.names()
• LookaheadIterator.symbols()

Deprecations:

• Language.version: use Language.abi_version
• Language.query(source): use Query(language, source)
• Parser.timeout_micros: use the progress_callback in parse()
• QueryCursor.timeout_micros: use the progress_callback in matches() or captures()

Removals:

• Node.child_containing_descendant(descendant): use Node.child_with_descendant(descendant) !
• Query.match_limit: moved to QueryCursor.match_limit !
• Query.set_match_limit(limit): moved to QueryCursor.match_limit !
• Query.did_exceed_match_limit: moved to QueryCursor.did_exceed_match_limit !
• Query.timeout_micros: moved to QueryCursor.timeout_micros !
• Query.set_timeout_micros(timeout): moved to QueryCursor.timeout_micros !
• Query.set_max_start_depth(depth): moved to QueryCursor.set_max_start_depth(depth) !
• Query.set_byte_range(byte_range): moved to QueryCursor.set_byte_range(start, end) !
• Query.set_point_range(point_range): moved to QueryCursor.set_point_range(start, end) !
• Query.captures(node, predicate): moved to QueryCursor.captures(node, predicate, progress_callback) !
• Query.matches(node, predicate): moved to QueryCursor.matches(node, predicate, progress_callback) !
• LookaheadIterator.iter_names(): use LookaheadIterator.names() !

Changes:

• Parser.parse(): encoding parameter also accepts "utf16le" & "utf16be"
• Parser.parse(): added progress_callback parameter
• LookaheadIterator.__next__(): yields tuple[int, str] !
• LookaheadIterator.reset(state, language): renamed from reset_state !

Breaking changes are marked with !.

Additions:

• Language.copy()
• Language.node_kind_is_supertype(id)
• Language.__copy__()
• LogType (enum)
• Node.child_with_descendant(descendant)
• Node.field_name_for_named_child(descendant)
• Parser.print_dot_graphs(file)
• Parser.logger (getter + setter)
• Tree.copy()
• Tree.print_dot_graph(file)
• Tree.__copy__()

Deprecations:

• Language(ptr: int)
• Node.child_containing_descendant(descendant): use Node.child_with_descendant(descendant)

What's Changed

• Update documentation on Query.captures() by @Bzero in #306
• build: bump tree_sitter/core from 46bdc14 to f629fd4 by @dependabot in #307
• fix(query): iterate over captures for the shortest size, not longest by @amaanq in #309

New Contributors

• @Bzero made their first contribution in #306

Full Changelog: v0.23.1...v0.23.2

What's Changed

• build: bump tree_sitter/core from 12fb318 to ee06325 by @dependabot in #286
• ci: bump pypa/cibuildwheel from 2.20 to 2.21 in the actions group by @dependabot in #291

Full Changelog: v0.23.0...v0.23.1

Additions:

• Node.child_containing_descendant(descendant)
• Tree.language (getter)
• Query.pattern_count (getter)
• Query.capture_count (getter)
• Query.match_limit (getter)
• Query.did_exceed_match_limit (getter)
• Query.set_match_limit(match_limit): returns self
• Query.set_max_start_depth(max_start_depth): returns self
• Query.set_byte_range(byte_range): returns self
• Query.set_point_range(point_range): returns self
• Query.disable_pattern(index): returns self
• Query.disable_capture(capture): returns self
• Query.pattern_settings(index)
• Query.pattern_assertions(index)
• Query.start_byte_for_pattern(index)
• Query.end_byte_for_pattern(index)
• Query.is_pattern_rooted(index)
• Query.is_pattern_non_local(index)
• Query.is_pattern_guaranteed_at_step(offset)
• QueryError (exception class)
• QueryPredicate (typing protocol)

Removals:

• Parser.set_language(language)
• Parser.set_included_ranges(ranges)
• Parser.set_timeout_micros(timeout)
• Node.sexp()
• Tree.text()
• TreeCursor.goto_first_child_for_point(row, column)
• LookaheadIterator.reset(language, state)

Changes:

• Language() accepts a capsule as an argument.
• Parser.parse(...) no longer accepts a keep_text argument.
• Query.captures(...)
  • Range arguments were removed (use set_* instead).
  • Added an argument for custom query predicates.
  • Return type was changed to dict[str, list[Node]].
• Query.matches(...)
  • Range arguments were removed (use set_* instead).
  • Added an argument for custom query predicates.
  • Return type was changed to list[tuple[int, dict[str, list[Node]]]].
• TreeCursor.goto_first_child_for_byte(byte) returns int | None.
• TreeCursor.goto_first_child_for_point(point) returns int | None.

Full Changelog: v0.22.2...v0.22.3

Full Changelog: v0.22.1...v0.22.2

Full Changelog: https://github.com/tree-sitter/py-tree-sitter/compare/v0.22.0...v0.22.1

Breaking changes are marked with !.

Additions:

• LANGUAGE_VERSION
• MIN_COMPATIBLE_LANGUAGE_VERSION
• Point(row, column)
• Language.__repr__()
• Language.__eq__(): checks ptr
• Language.__int__(): returns ptr
• Language.__index__(): returns ptr
• Language.__hash__(): returns ptr
• Node.__str__(): returns the S-expression
• TreeCursor.goto_first_child_for_point(point)
• TreeCursor.__copy__(): returns copy()
• Query(language, source)
• Parser(language, included_ranges, timeout_micros)
• Parser.language (getter + setter)
• Parser.included_ranges (getter + setter)
• Parser.timeout_micros (getter + setter)
• Range.__hash__()

Deprecations:

• Node.sexp(): use str()
• Tree.text: use root_node.text
• TreeCursor.goto_first_child_for_point(row, column): use goto_first_child_for_point(point)
• LookaheadIterator.reset(language, state): use reset_state(state, language)
• Parser.set_language(language): use Parser(language) or language setter
• Parser.set_included_ranges(ranges): use included_ranges setter
• Parser.set_timeout_micros(timeout): use timeout_micros setter

Removals:

• Language(path, name) !
• Language.build_library(...) !
• Language.name !
• Language.lib
• Language.language_id: use int()

Changes:

• Language() only accepts a single integer argument. !
• Parser.parse(...) accepts an optional encoding argument. !
• TreeCursor.descendant_index is changed to a property. !
• LookaheadIterator.language returns a Language instance. !
• LookaheadIterator.reset_state(...) accepts an optional language argument.
• Query.captures(...) arguments must be keywords (except for node).
• Query.matches(...) arguments must be keywords (except for node).
• Range.__repr__() prints attributes in the same order as the Range() arguments.
• Range() arguments are no longer considered optional.

Full Changelog: https://github.com/tree-sitter/py-tree-sitter/compare/v0.21.2...v0.21.3

Full Changelog: https://github.com/tree-sitter/py-tree-sitter/compare/v0.21.1...v0.21.2

Full Changelog: https://github.com/tree-sitter/py-tree-sitter/compare/v0.21.0...v0.21.1

What's Changed

• Fix type of Tree.text property by @jhandley in https://github.com/tree-sitter/py-tree-sitter/pull/176
• fix: typo by @Thabokani in https://github.com/tree-sitter/py-tree-sitter/pull/185
• ci: add dependabot by @dundargoc in https://github.com/tree-sitter/py-tree-sitter/pull/190
• ci: make dependabot group updates in single PR by @dundargoc in https://github.com/tree-sitter/py-tree-sitter/pull/194
• ci: bump the actions group with 3 updates by @dependabot in https://github.com/tree-sitter/py-tree-sitter/pull/195
• get_children_by_field_id and get_children_by_field_name returns empty list on invalid argument by @wstevick in https://github.com/tree-sitter/py-tree-sitter/pull/180
• Prepare for bindings PR, add Query.matches by @amaanq in https://github.com/tree-sitter/py-tree-sitter/pull/159
• ci: major overhaul by @ObserverOfTime in https://github.com/tree-sitter/py-tree-sitter/pull/198
• Make match captures a dict[str,Node|list[Node]] by @jhandley in https://github.com/tree-sitter/py-tree-sitter/pull/165
• docs: update readme by @ObserverOfTime in https://github.com/tree-sitter/py-tree-sitter/pull/201

New Contributors

• @Thabokani made their first contribution in https://github.com/tree-sitter/py-tree-sitter/pull/185
• @dundargoc made their first contribution in https://github.com/tree-sitter/py-tree-sitter/pull/190
• @dependabot made their first contribution in https://github.com/tree-sitter/py-tree-sitter/pull/195
• @wstevick made their first contribution in https://github.com/tree-sitter/py-tree-sitter/pull/180
• @ObserverOfTime made their first contribution in https://github.com/tree-sitter/py-tree-sitter/pull/198

Full Changelog: https://github.com/tree-sitter/py-tree-sitter/compare/v0.20.4...v0.21.0

Full Changelog: https://github.com/tree-sitter/py-tree-sitter/compare/v0.20.3...v0.20.4