treesitter

package module
v0.0.0-...-ed3c4b3 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 6, 2024 License: MIT Imports: 15 Imported by: 0

README

Go bindings for treesitter

Go bindings for tree-sitter

Light fork of https://github.com/smacker/go-tree-sitter.

Documentation

Overview

Code generated by test_grammar_generate.sh; DO NOT EDIT.

Index

Constants

View Source 
const (
	QuantifierZero = iota
	QuantifierZeroOrOne
	QuantifierZeroOrMore
	QuantifierOne
	QuantifierOneOrMore
)

Variables

View Source 
var (
	ErrOperationLimit = errors.New("operation limit was hit")
	ErrNoLanguage     = errors.New("cannot parse without language")
)

Functions

func QueryErrorTypeToString 

func QueryErrorTypeToString(errorType QueryErrorType) string

func RegisterLanguage 

func RegisterLanguage(langName string, l *Language)

RegisterLanguage registers a language with the parser. It is called on init from packages that contain a language parser. E.g. 

import _ "github.com/boldsoftware/treesitter/golang"

calls RegisterLanguage("go", l) allowing go to be used as a language.

Types

type EditInput 

type EditInput struct {
	StartIndex  int
	OldEndIndex int
	NewEndIndex int
	StartPoint  Point
	OldEndPoint Point
	NewEndPoint Point
}

type Input 

type Input struct {
	Read     ReadFunc
	Encoding InputEncoding
}

Input defines parameters for parse method

type InputEncoding 

type InputEncoding int

InputEncoding is a encoding of the text to parse 

const (
	InputEncodingUTF8 InputEncoding = iota
	InputEncodingUTF16
)

type IterMode 

type IterMode int
const (
	DFSMode IterMode = iota
	BFSMode
)

type Iterator 

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

Iterator for a tree of nodes

func NewIterator 

func NewIterator(n Node, mode IterMode) *Iterator

NewIterator takes a node and mode (DFS/BFS) and returns iterator over children of the node

func NewNamedIterator 

func NewNamedIterator(n Node, mode IterMode) *Iterator

NewNamedIterator takes a node and mode (DFS/BFS) and returns iterator over named children of the node

func (*Iterator) ForEach 

func (iter *Iterator) ForEach(fn func(Node) error) error

func (*Iterator) Next 

func (iter *Iterator) Next() (Node, error)

type Language 

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

Language defines how to parse a particular programming language

func NewLanguage 

func NewLanguage(ptr unsafe.Pointer) *Language

NewLanguage creates new Language from c pointer

func (*Language) FieldCount 

func (l *Language) FieldCount() int

func (*Language) FieldName 

func (l *Language) FieldName(idx int) string

func (*Language) SymbolCount 

func (l *Language) SymbolCount() int

SymbolCount returns the number of distinct field names in the language.

func (*Language) SymbolName 

func (l *Language) SymbolName(s Symbol) string

SymbolName returns a node type string for the given Symbol.

func (*Language) SymbolType 

func (l *Language) SymbolType(s Symbol) SymbolType

SymbolType returns named, anonymous, or a hidden type for a Symbol.

type Node 

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

Node represents a single node in the syntax tree.

It tracks its start and end positions in the source code, as well as its relation to other nodes like its parent, siblings and children.

func Parse 

func Parse(ctx context.Context, content []byte, lang string) (Node, error)

Parse is a shortcut for parsing bytes of source code, returns root node

func (Node) Child 

func (n Node) Child(idx int) Node

Child returns the node's child at the given index, where zero represents the first child.

func (Node) ChildByFieldName 

func (n Node) ChildByFieldName(name string) Node

ChildByFieldName returns the node's child with the given field name.

func (Node) ChildCount 

func (n Node) ChildCount() int

func (Node) Children 

func (n Node) Children() iter.Seq2[int, Node]

Children returns an iterator over n's children.

func (Node) Edit 

func (n Node) Edit(i EditInput)

Edit the node to keep it in-sync with source code that has been edited.

func (Node) EndByte 

func (n Node) EndByte() int

EndByte returns the node's end byte.

func (Node) EndPoint 

func (n Node) EndPoint() Point

EndPoint returns the node's end position in terms of rows and columns.

func (Node) Equal 

func (n Node) Equal(other Node) bool

Equal checks if two nodes are identical.

func (Node) FieldNameForChild 

func (n Node) FieldNameForChild(idx int) string

FieldNameForChild returns the field name of the child at the given index, or "" if not named.

func (Node) HasChanges 

func (n Node) HasChanges() bool

HasChanges checks if a syntax node has been edited.

func (Node) HasError 

func (n Node) HasError() bool

HasError check if the node is a syntax error or contains any syntax errors.

func (Node) ID 

func (n Node) ID() uintptr

TODO: consider unexporting this function

func (Node) IsError 

func (n Node) IsError() bool

IsError checks if the node is a syntax error. Syntax errors represent parts of the code that could not be incorporated into a valid syntax tree.

func (Node) IsExtra 

func (n Node) IsExtra() bool

IsExtra checks if the node is *extra*. Extra nodes represent things like comments, which are not required the grammar, but can appear anywhere.

func (Node) IsMissing 

func (n Node) IsMissing() bool

IsMissing checks if the node is *missing*. Missing nodes are inserted by the parser in order to recover from certain kinds of syntax errors.

func (Node) IsNamed 

func (n Node) IsNamed() bool

IsNamed checks if the node is *named*. Named nodes correspond to named rules in the grammar, whereas *anonymous* nodes correspond to string literals in the grammar.

func (Node) IsNull 

func (n Node) IsNull() bool

IsNull checks if the node is null.

func (Node) NamedChild 

func (n Node) NamedChild(idx int) Node

NamedChild returns the node's *named* child at the given index.

func (Node) NamedChildCount 

func (n Node) NamedChildCount() int

NamedChildCount returns the node's number of *named* children.

func (Node) NamedChildren 

func (n Node) NamedChildren() iter.Seq2[int, Node]

NamedChildren returns an iterator over n's named children.

func (Node) NamedDescendantForPointRange 

func (n Node) NamedDescendantForPointRange(start Point, end Point) Node

func (Node) NextNamedSibling 

func (n Node) NextNamedSibling() Node

NextNamedSibling returns the node's next *named* sibling.

func (Node) NextSibling 

func (n Node) NextSibling() Node

NextSibling returns the node's next sibling.

func (Node) Parent 

func (n Node) Parent() Node

Parent returns the node's immediate parent.

func (Node) PrevNamedSibling 

func (n Node) PrevNamedSibling() Node

PrevNamedSibling returns the node's previous *named* sibling.

func (Node) PrevSibling 

func (n Node) PrevSibling() Node

PrevSibling returns the node's previous sibling.

func (Node) Range 

func (n Node) Range() Range

func (Node) StartByte 

func (n Node) StartByte() int

StartByte returns the node's start byte.

func (Node) StartPoint 

func (n Node) StartPoint() Point

StartPoint returns the node's start position in terms of rows and columns.

func (Node) String 

func (n Node) String() string

String returns an S-expression representing the node as a string.

func (Node) Symbol 

func (n Node) Symbol() Symbol

Symbol returns the node's type as a Symbol.

func (Node) Type 

func (n Node) Type() string

Type returns the node's type as a string.

type Parser 

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

Parser produces concrete syntax tree based on source code using Language

func NewParser 

func NewParser(language string) *Parser

NewParser creates new Parser.

func (*Parser) Close 

func (p *Parser) Close()

Close should be called to ensure that all the memory used by the parse is freed.

As the constructor in go-tree-sitter would set this func call through runtime.SetFinalizer, parser.Close() will be called by Go's garbage collector and users would not have to call this manually.

func (*Parser) Debug 

func (p *Parser) Debug()

Debug enables debug output to stderr

func (*Parser) OperationLimit 

func (p *Parser) OperationLimit() int

OperationLimit returns the duration in microseconds that parsing is allowed to take

func (*Parser) Parse 

func (p *Parser) Parse(ctx context.Context, oldTree *Tree, content []byte) (*Tree, error)

Parse produces new Tree from content using old tree

func (*Parser) ParseInput 

func (p *Parser) ParseInput(ctx context.Context, oldTree *Tree, input Input) (*Tree, error)

ParseInput produces new Tree by reading from a callback defined in input it is useful if your data is stored in specialized data structure as it will avoid copying the data into []bytes and faster access to edited part of the data

func (*Parser) Reset 

func (p *Parser) Reset()

Reset causes the parser to parse from scratch on the next call to parse, instead of resuming so that it sees the changes to the beginning of the source code.

func (*Parser) SetIncludedRanges 

func (p *Parser) SetIncludedRanges(ranges []Range)

SetIncludedRanges sets text ranges of a file

func (*Parser) SetOperationLimit 

func (p *Parser) SetOperationLimit(limit int)

SetOperationLimit limits the maximum duration in microseconds that parsing should be allowed to take before halting

type Point 

type Point struct {
	Row    int
	Column int
}

type Quantifier 

type Quantifier int

type Query 

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

Query API

func NewQuery 

func NewQuery(pattern []byte, language string) (*Query, error)

NewQuery creates a query by specifying a string containing one or more patterns. In case of error returns QueryError.

func (*Query) CaptureCount 

func (q *Query) CaptureCount() uint32

func (*Query) CaptureNameForId 

func (q *Query) CaptureNameForId(id int) string

func (*Query) CaptureQuantifierForId 

func (q *Query) CaptureQuantifierForId(id uint32, captureId uint32) Quantifier

func (*Query) Close 

func (q *Query) Close()

Close should be called to ensure that all the memory used by the query is freed.

As the constructor in go-tree-sitter would set this func call through runtime.SetFinalizer, parser.Close() will be called by Go's garbage collector and users would not have to call this manually.

func (*Query) PatternCount 

func (q *Query) PatternCount() uint32

func (*Query) PredicatesForPattern 

func (q *Query) PredicatesForPattern(patternIndex uint32) [][]QueryPredicateStep

func (*Query) StringCount 

func (q *Query) StringCount() uint32

func (*Query) StringValueForId 

func (q *Query) StringValueForId(id int) string

type QueryCapture 

type QueryCapture struct {
	Index int
	Node  Node
}

QueryCapture is a captured node by a query with an index

type QueryCursor 

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

QueryCursor carries the state needed for processing the queries.

func NewQueryCursor 

func NewQueryCursor() *QueryCursor

NewQueryCursor creates a query cursor.

func (*QueryCursor) Close 

func (qc *QueryCursor) Close()

Close should be called to ensure that all the memory used by the query cursor is freed.

As the constructor in go-tree-sitter would set this func call through runtime.SetFinalizer, parser.Close() will be called by Go's garbage collector and users would not have to call this manually.

func (*QueryCursor) Exec 

func (qc *QueryCursor) Exec(q *Query, n Node)

Exec executes the query on a given syntax node.

func (*QueryCursor) FilterPredicates 

func (qc *QueryCursor) FilterPredicates(m *QueryMatch, input []byte) *QueryMatch

func (*QueryCursor) NextCapture 

func (qc *QueryCursor) NextCapture() (*QueryMatch, int, bool)

func (*QueryCursor) NextMatch 

func (qc *QueryCursor) NextMatch() (*QueryMatch, bool)

NextMatch iterates over matches. This function will return (nil, false) when there are no more matches. Otherwise, it will populate the QueryMatch with data about which pattern matched and which nodes were captured.

func (*QueryCursor) SetPointRange 

func (qc *QueryCursor) SetPointRange(startPoint Point, endPoint Point)

type QueryError 

type QueryError struct {
	Offset  uint32
	Type    QueryErrorType
	Message string
}

QueryError - if there is an error in the query, then the Offset argument will be set to the byte offset of the error, and the Type argument will be set to a value that indicates the type of error.

func (*QueryError) Error 

func (qe *QueryError) Error() string

type QueryErrorType 

type QueryErrorType int

QueryErrorType - value that indicates the type of QueryError. 

const (
	QueryErrorNone QueryErrorType = iota
	QueryErrorSyntax
	QueryErrorNodeType
	QueryErrorField
	QueryErrorCapture
	QueryErrorStructure
	QueryErrorLanguage
)

type QueryMatch 

type QueryMatch struct {
	ID           int
	PatternIndex uint16
	Captures     []QueryCapture
}

QueryMatch - you can then iterate over the matches.

type QueryPredicateStep 

type QueryPredicateStep struct {
	Type    QueryPredicateStepType
	ValueId int
}

type QueryPredicateStepType 

type QueryPredicateStepType int
const (
	QueryPredicateStepTypeDone QueryPredicateStepType = iota
	QueryPredicateStepTypeCapture
	QueryPredicateStepTypeString
)

type Range 

type Range struct {
	StartPoint Point
	EndPoint   Point
	StartByte  int
	EndByte    int
}

type ReadFunc 

type ReadFunc func(offset uint32, position Point) []byte

ReadFunc is a function to retrieve a chunk of text at a given byte offset and (row, column) position it should return nil to indicate the end of the document

type Symbol 

type Symbol = C.TSSymbol

type SymbolType 

type SymbolType int
const (
	SymbolTypeRegular SymbolType = iota
	SymbolTypeAnonymous
	SymbolTypeAuxiliary
)

func (SymbolType) String 

func (t SymbolType) String() string

type Tree 

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

Tree represents the syntax tree of an entire source code file Note: Tree instances are not thread safe; you must copy a tree if you want to use it on multiple threads simultaneously.

func (Tree) Close 

func (t Tree) Close()

Close should be called to ensure that all the memory used by the tree is freed.

As the constructor in go-tree-sitter would set this func call through runtime.SetFinalizer, parser.Close() will be called by Go's garbage collector and users would not have to call this manually.

func (*Tree) Copy 

func (t *Tree) Copy() *Tree

Copy returns a new copy of a tree

func (*Tree) Edit 

func (t *Tree) Edit(i EditInput)

Edit the syntax tree to keep it in sync with source code that has been edited.

func (*Tree) RootNode 

func (t *Tree) RootNode() Node

RootNode returns root node of a tree

type TreeCursor 

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

TreeCursor allows you to walk a syntax tree more efficiently than is possible using the `Node` functions. It is a mutable object that is always on a certain syntax node, and can be moved imperatively to different nodes.

func NewTreeCursor 

func NewTreeCursor(n Node) *TreeCursor

NewTreeCursor creates a new tree cursor starting from the given node.

func (*TreeCursor) Close 

func (c *TreeCursor) Close()

Close should be called to ensure that all the memory used by the tree cursor is freed.

As the constructor in go-tree-sitter would set this func call through runtime.SetFinalizer, parser.Close() will be called by Go's garbage collector and users would not have to call this manually.

func (*TreeCursor) CurrentFieldName 

func (c *TreeCursor) CurrentFieldName() string

CurrentFieldName gets the field name of the tree cursor's current node.

This returns empty string if the current node doesn't have a field.

func (*TreeCursor) CurrentNode 

func (c *TreeCursor) CurrentNode() Node

CurrentNode of the tree cursor.

func (*TreeCursor) GoToFirstChild 

func (c *TreeCursor) GoToFirstChild() bool

GoToFirstChild moves the cursor to the first child of its current node.

This returns `true` if the cursor successfully moved, and returns `false` if there were no children.

func (*TreeCursor) GoToFirstChildForByte 

func (c *TreeCursor) GoToFirstChildForByte(b uint32) int64

GoToFirstChildForByte moves the cursor to the first child of its current node that extends beyond the given byte offset.

This returns the index of the child node if one was found, and returns -1 if no such child was found.

func (*TreeCursor) GoToNextSibling 

func (c *TreeCursor) GoToNextSibling() bool

GoToNextSibling moves the cursor to the next sibling of its current node.

This returns `true` if the cursor successfully moved, and returns `false` if there was no next sibling node.

func (*TreeCursor) GoToParent 

func (c *TreeCursor) GoToParent() bool

GoToParent moves the cursor to the parent of its current node.

This returns `true` if the cursor successfully moved, and returns `false` if there was no parent node (the cursor was already on the root node).

func (*TreeCursor) Reset 

func (c *TreeCursor) Reset(n Node)

Reset re-initializes a tree cursor to start at a different node.

Source Files

View all Source files

Directories

Path Synopsis
_automation
treesitter_updater
predicates
c

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.