Add stubs for tree_sitter

[Akuli]

tree-sitter is a library for parsing various languages. I just merged a pull request that uses it into https://github.com/Akuli/porcupine/, so we should have a basic level of mypy_primer coverage.

[AlexWaygood]

I'm fairly useless on this one as I'm not much of a C programmer, but here's a review for the bit where I'm confident I can read the source code correctly :)

[Akuli]

I didn't read the source code when making this PR, I just experimented on the interactive prompt. But installing py-tree-sitter locally requires you to have a C compiler, so getting it to work at all on Windows isn't easy either :)

[JelleZijlstra]

I took a look at the C code and have a few pieces of feedback

[JelleZijlstra]

There's a bunch of other properties: https://github.com/tree-sitter/py-tree-sitter/blob/7dc704fa37057c685fe2d86611f318146c95c34d/tree_sitter/binding.c#L501. I didn't check them all but you're missing at least id and named_children. But we don't necessarily need to include those if they're undocumented.

[Akuli]

These don't exist in the latest released version of py-tree-sitter (0.20.0).

[JelleZijlstra]

That'll teach me to look at the master branch :)

[JelleZijlstra]

There are more methods: children_by_field_id, children_by_field_name, field_name_for_child

[Akuli]

They are not in the latest released version.

[JelleZijlstra]

Source can be any ReadableBuffer, or a Callable: https://github.com/tree-sitter/py-tree-sitter/blob/7dc704fa37057c685fe2d86611f318146c95c34d/tree_sitter/binding.c#L960

Looking at https://github.com/tree-sitter/py-tree-sitter/blob/7dc704fa37057c685fe2d86611f318146c95c34d/tree_sitter/binding.c#L895 it seems to be a Callable[[int, tuple[int, int]], bytes].

[Akuli]

Version in pypi is more strict:

>>> parser.parse(source=print)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: First argument to parse must be bytes
>>> parser.parse(source=bytearray(b'asd'))
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: First argument to parse must be bytes

[JelleZijlstra]

Suggested change

	def goto_parent(self) -> bool: ...
	def goto_parent(self) -> bool: ...
	def copy(self) -> TreeCursor: ...

One more

[Akuli]

Doesn't exist in the released version.

[github-actions]

Diff from mypy_primer, showing the effect of this PR on open source code:

porcupine (https://github.com/Akuli/porcupine)
+ porcupine/plugins/highlight/tree_sitter_highlighter.py:20: error: Unused "type: ignore" comment