ruby_tree_sitter 1.3.0-x86_64-linux → 1.4.0-x86_64-linux
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +5 -1
- data/lib/tree_sitter/mixins/language.rb +161 -0
- data/lib/tree_sitter/node.rb +4 -2
- data/lib/tree_sitter/query_captures.rb +3 -1
- data/lib/tree_sitter/query_matches.rb +15 -1
- data/lib/tree_sitter/version.rb +1 -1
- data/lib/tree_sitter.rb +11 -4
- data/lib/tree_stand/node.rb +5 -13
- data/lib/tree_stand/parser.rb +14 -150
- metadata +3 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 701e16d45de25378b1f6e0b3e21b8c589cadb9f2f4e8af420a130d55637cd984
|
|
4
|
+
data.tar.gz: b1899ead2950b9ab9806076a0708c084221d3a8b59bbeb6a0e6848b57cbecf93
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: e07d00239ccab6b2ddabff6d90076bd6c42c48b9f1a5b98f8cc8fc07a4688e5d36c357c2373c2d5629676b46a3b34fc694f3ab1e97fdd5614c9e6350c2ade28c
|
|
7
|
+
data.tar.gz: 0dbbac2900d41056e4ab37b8d298351b819c9ca42296b33962f6f087a773859afc7e7de666d3d0734f883702872f90d59bf66f7546bc43510f003b47c91e11fe
|
data/README.md
CHANGED
|
@@ -200,4 +200,8 @@ To See a full list of the ruby-specific APIs, see [here](lib/README.md).
|
|
|
200
200
|
|
|
201
201
|
## Sponsors
|
|
202
202
|
|
|
203
|
-
<
|
|
203
|
+
- <a href="https://faveod.com">https://faveod.com</a>
|
|
204
|
+
|
|
205
|
+
<a href="https://faveod.com">
|
|
206
|
+
<img src="img/faveod.jpg" width="66%" />
|
|
207
|
+
</a>
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module TreeSitter
|
|
4
|
+
# A colon-separated list of paths pointing to directories that can contain parsers.
|
|
5
|
+
# Order matters.
|
|
6
|
+
# Takes precedence over default lookup paths.
|
|
7
|
+
ENV_PARSERS =
|
|
8
|
+
ENV['TREE_SITTER_PARSERS']
|
|
9
|
+
&.split(':')
|
|
10
|
+
&.map { |v| Pathname(v) }
|
|
11
|
+
.freeze
|
|
12
|
+
|
|
13
|
+
# The default paths we use to lookup parsers.
|
|
14
|
+
# Order matters.
|
|
15
|
+
LIBDIRS = [
|
|
16
|
+
'.vendor/parsers',
|
|
17
|
+
'.vendor/tree-sitter-parsers',
|
|
18
|
+
'vendor/parsers',
|
|
19
|
+
'vendor/tree-sitter-parsers',
|
|
20
|
+
'parsers',
|
|
21
|
+
'tree-sitter-parsers',
|
|
22
|
+
'/opt/local/lib',
|
|
23
|
+
'/opt/lib',
|
|
24
|
+
'/usr/local/lib',
|
|
25
|
+
'/usr/lib',
|
|
26
|
+
].map { |p| Pathname(p) }.freeze
|
|
27
|
+
|
|
28
|
+
# Mixins.
|
|
29
|
+
module Mixins
|
|
30
|
+
# Language Mixin.
|
|
31
|
+
module Language
|
|
32
|
+
# Load a language from configuration or default lookup paths.
|
|
33
|
+
#
|
|
34
|
+
# @example Load java from default paths
|
|
35
|
+
# # This will look for:
|
|
36
|
+
# #
|
|
37
|
+
# # .vendor/tree-sitter-parsers/(java/)?(libtree-sitter-)?java.{ext}
|
|
38
|
+
# # .vendor/parsers/(java/)?(libtree-sitter-)?java.{ext}
|
|
39
|
+
# # vendor/tree-sitter-parsers/(java/)?(libtree-sitter-)?java.{ext}
|
|
40
|
+
# # vendor/parsers/(java/)?(libtree-sitter-)?java.{ext}
|
|
41
|
+
# # parsers/(java/)?(libtree-sitter-)?java.{ext}
|
|
42
|
+
# # tree-sitter-parsers/(java/)?(libtree-sitter-)?java.{ext}
|
|
43
|
+
# # /opt/local/lib/(java/)?(libtree-sitter-)?java.{ext}
|
|
44
|
+
# # /opt/lib/(java/)?(libtree-sitter-)?java.{ext}
|
|
45
|
+
# # /usr/local/lib/(java/)?(libtree-sitter-)?java.{ext}
|
|
46
|
+
# # /usr/lib/(java/)?(libtree-sitter-)?java.{ext}
|
|
47
|
+
# #
|
|
48
|
+
# java = TreeSitter.language('java')
|
|
49
|
+
#
|
|
50
|
+
# @example (TreeStand) Load java from a configured path
|
|
51
|
+
# # This will look for:
|
|
52
|
+
# #
|
|
53
|
+
# # /my/path/(java/)?(libtree-sitter-)?java.{ext}
|
|
54
|
+
# #
|
|
55
|
+
# TreeStand.config.parser_path = '/my/path'
|
|
56
|
+
# java = TreeStand::Parser.language('java')
|
|
57
|
+
#
|
|
58
|
+
# @example (TreeStand) Load java from environment variables
|
|
59
|
+
# # This will look for:
|
|
60
|
+
# #
|
|
61
|
+
# # /my/forced/env/path/(java/)?(libtree-sitter-)?java.{ext}
|
|
62
|
+
# # /my/path/(java/)?(libtree-sitter-)?java.{ext}
|
|
63
|
+
# #
|
|
64
|
+
# # … and the same works for the default paths if `TreeStand.config.parser_path`
|
|
65
|
+
# # was `nil`
|
|
66
|
+
# ENV['TREE_SITTER_PARSERS'] = '/my/forced/env/path'
|
|
67
|
+
# TreeStand.config.parser_path = '/my/path'
|
|
68
|
+
# java = TreeStand::Parser.language('java')
|
|
69
|
+
#
|
|
70
|
+
# @param name [String] the name of the parser.
|
|
71
|
+
# This name is used to load the symbol from the compiled parser, replacing `-` with `_`.
|
|
72
|
+
#
|
|
73
|
+
# @return [TreeSitter:language] a language object to use in your parsers.
|
|
74
|
+
#
|
|
75
|
+
# @raise [RuntimeError] if the parser was not found.
|
|
76
|
+
#
|
|
77
|
+
# @see search_for_lib
|
|
78
|
+
def language(name)
|
|
79
|
+
lib = search_for_lib(name)
|
|
80
|
+
|
|
81
|
+
if lib.nil?
|
|
82
|
+
raise <<~MSG.chomp
|
|
83
|
+
Failed to load a parser for #{name}.
|
|
84
|
+
|
|
85
|
+
#{search_lib_message}
|
|
86
|
+
MSG
|
|
87
|
+
end
|
|
88
|
+
|
|
89
|
+
# We know that the bindings will accept `lib`, but I don't know how to tell sorbet
|
|
90
|
+
# the types in ext/tree_sitter where `load` is defined.
|
|
91
|
+
TreeSitter::Language.load(name.tr('-', '_'), T.unsafe(lib))
|
|
92
|
+
end
|
|
93
|
+
|
|
94
|
+
# The platform-specific extension of the parser.
|
|
95
|
+
# @return [String] `dylib` or `so` for mac or linux.
|
|
96
|
+
def ext
|
|
97
|
+
case Gem::Platform.local.os
|
|
98
|
+
in /darwin/ then 'dylib'
|
|
99
|
+
else 'so'
|
|
100
|
+
end
|
|
101
|
+
end
|
|
102
|
+
|
|
103
|
+
private
|
|
104
|
+
|
|
105
|
+
# The library directories we need to look into.
|
|
106
|
+
#
|
|
107
|
+
# @return [Array<Pathname>] the list of candidate places to use when searching for parsers.
|
|
108
|
+
#
|
|
109
|
+
# @see ENV_PARSERS
|
|
110
|
+
# @see LIBDIRS
|
|
111
|
+
def lib_dirs = [*TreeSitter::ENV_PARSERS, *TreeSitter::LIBDIRS]
|
|
112
|
+
|
|
113
|
+
# Lookup a parser by name.
|
|
114
|
+
#
|
|
115
|
+
# Precedence:
|
|
116
|
+
# 1. `Env['TREE_SITTER_PARSERS]`.
|
|
117
|
+
# 2. {TreeStand::Config#parser_path} if using {TreeStand}.
|
|
118
|
+
# 3. {LIBDIRS}.
|
|
119
|
+
#
|
|
120
|
+
# If a {TreeStand::Config#parser_path} is `nil`, {LIBDIRS} is used.
|
|
121
|
+
# If a {TreeStand::Config#parser_path} is a {::Pathname}, {LIBDIRS} is ignored.
|
|
122
|
+
def search_for_lib(name)
|
|
123
|
+
files = [
|
|
124
|
+
name,
|
|
125
|
+
"tree-sitter-#{name}",
|
|
126
|
+
"libtree-sitter-#{name}",
|
|
127
|
+
].map { |v| "#{v}.#{ext}" }
|
|
128
|
+
|
|
129
|
+
lib_dirs
|
|
130
|
+
.product(files)
|
|
131
|
+
.find do |dir, so|
|
|
132
|
+
path = dir / so
|
|
133
|
+
path = dir / name / so if !path.exist?
|
|
134
|
+
break path.expand_path if path.exist?
|
|
135
|
+
end
|
|
136
|
+
end
|
|
137
|
+
|
|
138
|
+
# Generates a string message on where parser lookup happens.
|
|
139
|
+
#
|
|
140
|
+
# @return [String] A pretty message.
|
|
141
|
+
def search_lib_message
|
|
142
|
+
indent = 2
|
|
143
|
+
pretty = ->(arr) {
|
|
144
|
+
if arr
|
|
145
|
+
arr
|
|
146
|
+
.compact
|
|
147
|
+
.map { |v| "#{' ' * indent}#{v.expand_path}" }
|
|
148
|
+
.join("\n")
|
|
149
|
+
end
|
|
150
|
+
}
|
|
151
|
+
<<~MSG.chomp
|
|
152
|
+
From ENV['TREE_SITTER_PARSERS']:
|
|
153
|
+
#{pretty.call(ENV_PARSERS)}
|
|
154
|
+
|
|
155
|
+
From Defaults:
|
|
156
|
+
#{pretty.call(lib_dirs)}
|
|
157
|
+
MSG
|
|
158
|
+
end
|
|
159
|
+
end
|
|
160
|
+
end
|
|
161
|
+
end
|
data/lib/tree_sitter/node.rb
CHANGED
|
@@ -3,6 +3,8 @@
|
|
|
3
3
|
module TreeSitter
|
|
4
4
|
# Node is a wrapper around a tree-sitter node.
|
|
5
5
|
class Node
|
|
6
|
+
include Enumerable
|
|
7
|
+
|
|
6
8
|
# @return [Array<Symbol>] the node's named fields
|
|
7
9
|
def fields
|
|
8
10
|
return @fields if @fields
|
|
@@ -87,10 +89,10 @@ module TreeSitter
|
|
|
87
89
|
# Iterate over a node's children.
|
|
88
90
|
#
|
|
89
91
|
# @yieldparam child [Node] the child
|
|
90
|
-
def each
|
|
92
|
+
def each(&_block)
|
|
91
93
|
return enum_for __method__ if !block_given?
|
|
92
94
|
|
|
93
|
-
(0...
|
|
95
|
+
(0...child_count).each do |i|
|
|
94
96
|
yield child(i)
|
|
95
97
|
end
|
|
96
98
|
end
|
|
@@ -3,6 +3,8 @@
|
|
|
3
3
|
module TreeSitter
|
|
4
4
|
# A sequence of {TreeSitter::QueryCapture} associated with a given {TreeSitter::QueryCursor}.
|
|
5
5
|
class QueryCaptures
|
|
6
|
+
include Enumerable
|
|
7
|
+
|
|
6
8
|
def initialize(cursor, query, src)
|
|
7
9
|
@cursor = cursor
|
|
8
10
|
@query = query
|
|
@@ -13,7 +15,7 @@ module TreeSitter
|
|
|
13
15
|
#
|
|
14
16
|
# @yieldparam match [TreeSitter::QueryMatch]
|
|
15
17
|
# @yieldparam capture_index [Integer]
|
|
16
|
-
def each
|
|
18
|
+
def each(&_block)
|
|
17
19
|
return enum_for __method__ if !block_given?
|
|
18
20
|
|
|
19
21
|
while (capture_index, match = @cursor.next_capture)
|
|
@@ -3,6 +3,8 @@
|
|
|
3
3
|
module TreeSitter
|
|
4
4
|
# A sequence of {QueryMatch} associated with a given {QueryCursor}.
|
|
5
5
|
class QueryMatches
|
|
6
|
+
include Enumerable
|
|
7
|
+
|
|
6
8
|
def initialize(cursor, query, src)
|
|
7
9
|
@cursor = cursor
|
|
8
10
|
@query = query
|
|
@@ -12,7 +14,7 @@ module TreeSitter
|
|
|
12
14
|
# Iterator over matches.
|
|
13
15
|
#
|
|
14
16
|
# @yieldparam match [TreeSitter::QueryMatch]
|
|
15
|
-
def each
|
|
17
|
+
def each(&_block)
|
|
16
18
|
return enum_for __method__ if !block_given?
|
|
17
19
|
|
|
18
20
|
while match = @cursor.next_match
|
|
@@ -21,5 +23,17 @@ module TreeSitter
|
|
|
21
23
|
end
|
|
22
24
|
end
|
|
23
25
|
end
|
|
26
|
+
|
|
27
|
+
# Iterate over all the results presented as hashes of `capture name => node`.
|
|
28
|
+
#
|
|
29
|
+
# @yieldparam match [Hash<String, TreeSitter::Node>]
|
|
30
|
+
def each_capture_hash(&_block)
|
|
31
|
+
# TODO: should we return [Array<Hash<Symbol, TreeSitter::Node]>>] instead?
|
|
32
|
+
return enum_for __method__ if !block_given?
|
|
33
|
+
|
|
34
|
+
each do |match|
|
|
35
|
+
yield match.captures.to_h { |cap| [@query.capture_name_for_id(cap.index), cap.node] }
|
|
36
|
+
end
|
|
37
|
+
end
|
|
24
38
|
end
|
|
25
39
|
end
|
data/lib/tree_sitter/version.rb
CHANGED
data/lib/tree_sitter.rb
CHANGED
|
@@ -1,14 +1,12 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
|
-
# TreeSitter is a Ruby interface to the tree-sitter parsing library.
|
|
4
|
-
module TreeSitter
|
|
5
|
-
end
|
|
6
|
-
|
|
7
3
|
require 'set'
|
|
8
4
|
|
|
9
5
|
require 'tree_sitter/tree_sitter'
|
|
10
6
|
require 'tree_sitter/version'
|
|
11
7
|
|
|
8
|
+
require 'tree_sitter/mixins/language'
|
|
9
|
+
|
|
12
10
|
require 'tree_sitter/node'
|
|
13
11
|
require 'tree_sitter/query'
|
|
14
12
|
require 'tree_sitter/query_captures'
|
|
@@ -18,4 +16,13 @@ require 'tree_sitter/query_matches'
|
|
|
18
16
|
require 'tree_sitter/query_predicate'
|
|
19
17
|
require 'tree_sitter/text_predicate_capture'
|
|
20
18
|
|
|
19
|
+
# TreeSitter is a Ruby interface to the tree-sitter parsing library.
|
|
20
|
+
module TreeSitter
|
|
21
|
+
extend Mixins::Language
|
|
22
|
+
|
|
23
|
+
class << self
|
|
24
|
+
alias_method :lang, :language
|
|
25
|
+
end
|
|
26
|
+
end
|
|
27
|
+
|
|
21
28
|
ObjectSpace.define_finalizer(TreeSitter::Tree.class, proc { TreeSitter::Tree.finalizer })
|
data/lib/tree_stand/node.rb
CHANGED
|
@@ -97,19 +97,11 @@ module TreeStand
|
|
|
97
97
|
sig { params(query_string: String).returns(T::Array[T::Hash[String, TreeStand::Node]]) }
|
|
98
98
|
def query(query_string)
|
|
99
99
|
ts_query = TreeSitter::Query.new(@tree.parser.ts_language, query_string)
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
ts_match.captures.each do |ts_capture|
|
|
106
|
-
capture_name = ts_query.capture_name_for_id(ts_capture.index)
|
|
107
|
-
captures[capture_name] = TreeStand::Node.new(@tree, ts_capture.node)
|
|
108
|
-
end
|
|
109
|
-
|
|
110
|
-
matches << captures
|
|
111
|
-
end
|
|
112
|
-
matches
|
|
100
|
+
TreeSitter::QueryCursor
|
|
101
|
+
.new
|
|
102
|
+
.matches(ts_query, @tree.ts_tree.root_node, @tree.document)
|
|
103
|
+
.each_capture_hash
|
|
104
|
+
.map { |h| h.transform_values! { |n| TreeStand::Node.new(@tree, n) } }
|
|
113
105
|
end
|
|
114
106
|
|
|
115
107
|
# Returns the first captured node that matches the query string or nil if
|
data/lib/tree_stand/parser.rb
CHANGED
|
@@ -26,6 +26,7 @@ module TreeStand
|
|
|
26
26
|
# @see LIBDIRS
|
|
27
27
|
class Parser
|
|
28
28
|
extend T::Sig
|
|
29
|
+
extend TreeSitter::Mixins::Language
|
|
29
30
|
|
|
30
31
|
sig { returns(TreeSitter::Language) }
|
|
31
32
|
attr_reader :ts_language
|
|
@@ -33,156 +34,6 @@ module TreeStand
|
|
|
33
34
|
sig { returns(TreeSitter::Parser) }
|
|
34
35
|
attr_reader :ts_parser
|
|
35
36
|
|
|
36
|
-
# A colon-seprated list of paths pointing to directories that can contain parsers.
|
|
37
|
-
# Order matters.
|
|
38
|
-
# Takes precedence over default lookup paths.
|
|
39
|
-
ENV_PARSERS =
|
|
40
|
-
ENV['TREE_SITTER_PARSERS']
|
|
41
|
-
&.split(':')
|
|
42
|
-
&.map { |v| Pathname(v) }
|
|
43
|
-
.freeze
|
|
44
|
-
|
|
45
|
-
# The default paths we use to lookup parsers when no specific
|
|
46
|
-
# {TreeStand::Config#parser_path} is `nil`.
|
|
47
|
-
# Order matters.
|
|
48
|
-
LIBDIRS = [
|
|
49
|
-
'tree-sitter-parsers',
|
|
50
|
-
'/opt/local/lib',
|
|
51
|
-
'/opt/lib',
|
|
52
|
-
'/usr/local/lib',
|
|
53
|
-
'/usr/lib',
|
|
54
|
-
].map { |p| Pathname(p) }.freeze
|
|
55
|
-
|
|
56
|
-
# The library directories we need to look into.
|
|
57
|
-
#
|
|
58
|
-
# @return [Array<Pathname>] the list of candidate places to use when searching for parsers.
|
|
59
|
-
#
|
|
60
|
-
# @see ENV_PARSERS
|
|
61
|
-
# @see LIBDIRS
|
|
62
|
-
sig { returns(T::Array[Pathname]) }
|
|
63
|
-
def self.lib_dirs = [
|
|
64
|
-
*ENV_PARSERS,
|
|
65
|
-
*(TreeStand.config.parser_path ? [TreeStand.config.parser_path] : LIBDIRS),
|
|
66
|
-
].compact
|
|
67
|
-
|
|
68
|
-
# The platform-specific extension of the parser.
|
|
69
|
-
# @return [String] `dylib` or `so` for mac or linux.
|
|
70
|
-
sig { returns(String) }
|
|
71
|
-
def self.ext
|
|
72
|
-
case Gem::Platform.local.os
|
|
73
|
-
in /darwin/ then 'dylib'
|
|
74
|
-
else 'so'
|
|
75
|
-
end
|
|
76
|
-
end
|
|
77
|
-
|
|
78
|
-
# Lookup a parser by name.
|
|
79
|
-
#
|
|
80
|
-
# Precedence:
|
|
81
|
-
# 1. `Env['TREE_SITTER_PARSERS]`
|
|
82
|
-
# 2. {TreeStand::Config#parser_path}
|
|
83
|
-
# 3. {LIBDIRS}
|
|
84
|
-
#
|
|
85
|
-
# If a {TreeStand::Config#parser_path} is `nil`, {LIBDIRS} is used.
|
|
86
|
-
# If a {TreeStand::Config#parser_path} is a {::Pathname}, {LIBDIRS} is ignored.
|
|
87
|
-
sig { params(name: String).returns(T.nilable(Pathname)) }
|
|
88
|
-
def self.search_for_lib(name)
|
|
89
|
-
files = [
|
|
90
|
-
name,
|
|
91
|
-
"tree-sitter-#{name}",
|
|
92
|
-
"libtree-sitter-#{name}",
|
|
93
|
-
].map { |v| "#{v}.#{ext}" }
|
|
94
|
-
|
|
95
|
-
res = lib_dirs
|
|
96
|
-
.product(files)
|
|
97
|
-
.find do |dir, so|
|
|
98
|
-
path = dir / so
|
|
99
|
-
path = dir / name / so if !path.exist?
|
|
100
|
-
break path.expand_path if path.exist?
|
|
101
|
-
end
|
|
102
|
-
res.is_a?(Array) ? nil : res
|
|
103
|
-
end
|
|
104
|
-
|
|
105
|
-
# Generates a string message on where parser lookup happens.
|
|
106
|
-
#
|
|
107
|
-
# @return [String] A pretty message.
|
|
108
|
-
sig { returns(String) }
|
|
109
|
-
def self.search_lib_message
|
|
110
|
-
indent = 2
|
|
111
|
-
pretty = ->(arr) {
|
|
112
|
-
if arr
|
|
113
|
-
arr
|
|
114
|
-
.compact
|
|
115
|
-
.map { |v| "#{' ' * indent}#{v.expand_path}" }
|
|
116
|
-
.join("\n")
|
|
117
|
-
end
|
|
118
|
-
}
|
|
119
|
-
<<~MSG
|
|
120
|
-
From ENV['TREE_SITTER_PARSERS']:
|
|
121
|
-
#{pretty.call(ENV_PARSERS)}
|
|
122
|
-
|
|
123
|
-
From TreeStand.config.parser_path:
|
|
124
|
-
#{pretty.call([TreeStand.config.parser_path])}
|
|
125
|
-
|
|
126
|
-
From Defaults:
|
|
127
|
-
#{pretty.call(LIBDIRS)}
|
|
128
|
-
MSG
|
|
129
|
-
end
|
|
130
|
-
|
|
131
|
-
# Load a language from configuration or default lookup paths.
|
|
132
|
-
#
|
|
133
|
-
# @example Load java from default paths
|
|
134
|
-
# # This will look for:
|
|
135
|
-
# #
|
|
136
|
-
# # tree-sitter-parsers/(java/)?(libtree-sitter-)?java.{ext}
|
|
137
|
-
# # /opt/local/lib/(java/)?(libtree-sitter-)?java.{ext}
|
|
138
|
-
# # /opt/lib/(java/)?(libtree-sitter-)?java.{ext}
|
|
139
|
-
# # /usr/local/lib/(java/)?(libtree-sitter-)?java.{ext}
|
|
140
|
-
# # /usr/lib/(java/)?(libtree-sitter-)?java.{ext}
|
|
141
|
-
# #
|
|
142
|
-
# java = TreeStand::Parser.language('java')
|
|
143
|
-
#
|
|
144
|
-
# @example Load java from a configured path
|
|
145
|
-
# # This will look for:
|
|
146
|
-
# #
|
|
147
|
-
# # /my/path/(java/)?(libtree-sitter-)?java.{ext}
|
|
148
|
-
# #
|
|
149
|
-
# TreeStand.config.parser_path = '/my/path'
|
|
150
|
-
# java = TreeStand::Parser.language('java')
|
|
151
|
-
#
|
|
152
|
-
# @example Load java from environment variables
|
|
153
|
-
# # This will look for:
|
|
154
|
-
# #
|
|
155
|
-
# # /my/forced/env/path/(java/)?(libtree-sitter-)?java.{ext}
|
|
156
|
-
# # /my/path/(java/)?(libtree-sitter-)?java.{ext}
|
|
157
|
-
# #
|
|
158
|
-
# # … and the same works for the default paths if `TreeStand.config.parser_path`
|
|
159
|
-
# # was `nil`
|
|
160
|
-
# ENV['TREE_SITTER_PARSERS'] = '/my/forced/env/path'
|
|
161
|
-
# TreeStand.config.parser_path = '/my/path'
|
|
162
|
-
# java = TreeStand::Parser.language('java')
|
|
163
|
-
#
|
|
164
|
-
# @param name [String] the name of the parser.
|
|
165
|
-
# This name is used to load the symbol from the compiled parser, replacing `-` with `_`.
|
|
166
|
-
# @return [TreeSitter:language] a language object to use in your parsers.
|
|
167
|
-
# @raise [RuntimeError] if the parser was not found.
|
|
168
|
-
# @see search_for_lib
|
|
169
|
-
sig { params(name: String).returns(TreeSitter::Language) }
|
|
170
|
-
def self.language(name)
|
|
171
|
-
lib = search_for_lib(name)
|
|
172
|
-
|
|
173
|
-
if lib.nil?
|
|
174
|
-
raise <<~MSG
|
|
175
|
-
Failed to load a parser for #{name}.
|
|
176
|
-
|
|
177
|
-
#{search_lib_message}
|
|
178
|
-
MSG
|
|
179
|
-
end
|
|
180
|
-
|
|
181
|
-
# We know that the bindings will accept `lib`, but I don't know how to tell sorbet
|
|
182
|
-
# the types in ext/tree_sitter where `load` is defined.
|
|
183
|
-
TreeSitter::Language.load(name.tr('-', '_'), T.unsafe(lib))
|
|
184
|
-
end
|
|
185
|
-
|
|
186
37
|
# @param language [String]
|
|
187
38
|
sig { params(language: String).void }
|
|
188
39
|
def initialize(language)
|
|
@@ -192,6 +43,19 @@ module TreeStand
|
|
|
192
43
|
end
|
|
193
44
|
end
|
|
194
45
|
|
|
46
|
+
# The library directories we need to look into.
|
|
47
|
+
#
|
|
48
|
+
# @return [Array<Pathname>] the list of candidate places to use when searching for parsers.
|
|
49
|
+
#
|
|
50
|
+
# @see ENV_PARSERS
|
|
51
|
+
# @see LIBDIRS
|
|
52
|
+
def self.lib_dirs
|
|
53
|
+
[
|
|
54
|
+
*TreeSitter::ENV_PARSERS,
|
|
55
|
+
*(TreeStand.config.parser_path ? [TreeStand.config.parser_path] : TreeSitter::LIBDIRS),
|
|
56
|
+
]
|
|
57
|
+
end
|
|
58
|
+
|
|
195
59
|
# Parse the provided document with the TreeSitter parser.
|
|
196
60
|
# @param tree [TreeStand::Tree, nil] providing the old tree will allow the
|
|
197
61
|
# parser to take advantage of incremental parsing and improve performance
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: ruby_tree_sitter
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.
|
|
4
|
+
version: 1.4.0
|
|
5
5
|
platform: x86_64-linux
|
|
6
6
|
authors:
|
|
7
7
|
- Firas al-Khalil
|
|
@@ -9,7 +9,7 @@ authors:
|
|
|
9
9
|
autorequire:
|
|
10
10
|
bindir: bin
|
|
11
11
|
cert_chain: []
|
|
12
|
-
date: 2024-
|
|
12
|
+
date: 2024-07-03 00:00:00.000000000 Z
|
|
13
13
|
dependencies:
|
|
14
14
|
- !ruby/object:Gem::Dependency
|
|
15
15
|
name: sorbet-runtime
|
|
@@ -75,6 +75,7 @@ files:
|
|
|
75
75
|
- ext/tree_sitter/tree_sitter.h
|
|
76
76
|
- lib/tree_sitter.rb
|
|
77
77
|
- lib/tree_sitter/helpers.rb
|
|
78
|
+
- lib/tree_sitter/mixins/language.rb
|
|
78
79
|
- lib/tree_sitter/node.rb
|
|
79
80
|
- lib/tree_sitter/query.rb
|
|
80
81
|
- lib/tree_sitter/query_captures.rb
|