v0.23.0

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.

v0.22.3

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

v0.22.2

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

v0.22.1

Full Changelog: v0.22.0...v0.22.1

v0.22.0

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.

v0.21.3

Full Changelog: v0.21.2...v0.21.3

v0.21.2

Full Changelog: v0.21.1...v0.21.2

v0.21.1

Full Changelog: v0.21.0...v0.21.1

v0.21.0

What's Changed

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

New Contributors

• @Thabokani made their first contribution in #185
• @dundargoc made their first contribution in #190
• @dependabot made their first contribution in #195
• @wstevick made their first contribution in #180
• @ObserverOfTime made their first contribution in #198

Full Changelog: v0.20.4...v0.21.0

v0.20.4

Full Changelog: v0.20.3...v0.20.4