bonsaipython

package module

v0.1.0 Latest Latest Go to latest Published: Jun 17, 2026 License: MIT Imports: 7 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/msuozzo/bonsai

Links

Open Source Insights

Documentation ¶

Overview ¶

Package bonsaipython provides a tree-sitter Python parser built on the bonsai snapshot runtime.

Typical use:

p := bonsaipython.NewParser()
root, err := p.Parse(src)
if err != nil { ... }
for n := range root.Find("function_definition") { ... }

The Parser, Node, and Point types are aliases for the corresponding bonsai runtime types, so values flow naturally between bonsai-aware code and this package.

The wasm module + grammar are generated. See Dockerfile.builder at the repo root. `go generate ./bonsai-python` regenerates module_gen.{go,dat}, libc_gen.go, and meta_gen.go in this directory.

Grammar source: https://github.com/tree-sitter/tree-sitter-python

Constants ¶

View Source

const InitialPages = 8

InitialPages is the wasm module's declared initial linear-memory size, in 64 KiB WebAssembly pages. Memory passed to New must already be sized to at least InitialPages * 65536 bytes before the call.

Variables ¶

View Source

var LicenseGrammar string

LicenseGrammar is the license of the grammar (https://github.com/tree-sitter/tree-sitter-python.git @ v0.25.0) whose compiled form this package embeds.

View Source

var LicenseTreeSitter string

LicenseTreeSitter is the license of the tree-sitter runtime (v0.25.10) whose compiled form this package embeds.

Functions ¶

This section is empty.

Types ¶

type Memory ¶

type Memory = interface {
	Slice() *[]byte
	Grow(delta, max int64) int64
}

type Module ¶

type Module struct {
	// contains filtered or unexported fields
}

func New ¶

func New(v0 Xenv) *Module

func (*Module) X__indirect_function_table ¶

func (m *Module) X__indirect_function_table() *[]any

func (*Module) X_initialize ¶

func (m *Module) X_initialize()

func (*Module) Xfree ¶

func (m *Module) Xfree(v0 int32)

func (*Module) Xmalloc ¶

func (m *Module) Xmalloc(v0 int32) int32

func (*Module) Xtree_sitter_python ¶

func (m *Module) Xtree_sitter_python() int32

func (*Module) Xts_node_end_byte ¶

func (m *Module) Xts_node_end_byte(v0 int32) int32

func (*Module) Xts_node_end_point ¶

func (m *Module) Xts_node_end_point(v0, v1 int32)

func (*Module) Xts_node_has_error ¶

func (m *Module) Xts_node_has_error(v0 int32) int32

func (*Module) Xts_node_is_error ¶

func (m *Module) Xts_node_is_error(v0 int32) int32

func (*Module) Xts_node_is_missing ¶

func (m *Module) Xts_node_is_missing(v0 int32) int32

func (*Module) Xts_node_is_named ¶

func (m *Module) Xts_node_is_named(v0 int32) int32

func (*Module) Xts_node_is_null ¶

func (m *Module) Xts_node_is_null(v0 int32) int32

func (*Module) Xts_node_start_byte ¶

func (m *Module) Xts_node_start_byte(v0 int32) int32

func (*Module) Xts_node_start_point ¶

func (m *Module) Xts_node_start_point(v0, v1 int32)

func (*Module) Xts_node_string ¶

func (m *Module) Xts_node_string(v0 int32) int32

func (*Module) Xts_node_type ¶

func (m *Module) Xts_node_type(v0 int32) int32

func (*Module) Xts_parser_delete ¶

func (m *Module) Xts_parser_delete(v0 int32)

func (*Module) Xts_parser_new ¶

func (m *Module) Xts_parser_new() int32

func (*Module) Xts_parser_parse_string ¶

func (m *Module) Xts_parser_parse_string(v0, v1, v2, v3 int32) int32

func (*Module) Xts_parser_set_language ¶

func (m *Module) Xts_parser_set_language(v0, v1 int32) int32

func (*Module) Xts_tree_cursor_current_field_name ¶

func (m *Module) Xts_tree_cursor_current_field_name(v0 int32) int32

func (*Module) Xts_tree_cursor_current_node ¶

func (m *Module) Xts_tree_cursor_current_node(v0, v1 int32)

func (*Module) Xts_tree_cursor_delete ¶

func (m *Module) Xts_tree_cursor_delete(v0 int32)

func (*Module) Xts_tree_cursor_goto_first_child ¶

func (m *Module) Xts_tree_cursor_goto_first_child(v0 int32) int32

func (*Module) Xts_tree_cursor_goto_next_sibling ¶

func (m *Module) Xts_tree_cursor_goto_next_sibling(v0 int32) int32

func (*Module) Xts_tree_cursor_goto_parent ¶

func (m *Module) Xts_tree_cursor_goto_parent(v0 int32) int32

func (*Module) Xts_tree_cursor_new ¶

func (m *Module) Xts_tree_cursor_new(v0, v1 int32)

func (*Module) Xts_tree_delete ¶

func (m *Module) Xts_tree_delete(v0 int32)

func (*Module) Xts_tree_root_node ¶

func (m *Module) Xts_tree_root_node(v0, v1 int32)

type Node ¶

type Node = bonsai.Node

Type aliases so callers can import only this package.

type Parser ¶

type Parser = bonsai.Parser

Type aliases so callers can import only this package.

func NewParser ¶

func NewParser() *Parser

NewParser instantiates a tree-sitter Python parser.

The parser owns one wasm module instance and is NOT safe for concurrent use. Pool a Parser per goroutine. Reuse across files. Instantiation is the expensive part.

type Point ¶

type Point = bonsai.Point

Type aliases so callers can import only this package.

type Xenv ¶

type Xenv = interface {
	Xfputc(v0, v1 int32) int32
	Xmemory() Memory
	Xts_language_is_wasm(v0 int32) int32
	Xts_wasm_store_delete(v0 int32)
	Xvfprintf(v0, v1, v2 int32) int32
	Xvsnprintf(v0, v1, v2, v3 int32) int32
}

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL