1 # This file is part of NIT ( http://www.nitlanguage.org ).
3 # Copyright 2009 Jean-Sebastien Gelinas <calestar@gmail.com>
5 # Licensed under the Apache License, Version 2.0 (the "License");
6 # you may not use this file except in compliance with the License.
7 # You may obtain a copy of the License at
9 # http://www.apache.org/licenses/LICENSE-2.0
11 # Unless required by applicable law or agreed to in writing, software
12 # distributed under the License is distributed on an "AS IS" BASIS,
13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 # See the License for the specific language governing permissions and
15 # limitations under the License.
17 # Nit source-file and locations in source-file
20 # A raw text Nit source file
22 # The path of the source
25 # The content of the source
26 var string
: String is noinit
28 # The original stream used to initialize `string`
33 string
= stream
.read_all
37 # Create a new sourcefile using a dummy filename and a given content
38 init from_string
(filename
: String, string
: String) is
41 self.filename
= filename
46 # Offset of each line start in the content `string`.
48 # Used for fast access to each line when rendering parts of the `string`.
49 var line_starts
= new Array[Int]
52 # A location inside a source file
55 redef type OTHER: Location
57 # The associated source-file
58 var file
: nullable SourceFile
60 # The starting line number (starting from 1)
62 # If `line_start==0` then the whole file is considered
65 # The stopping line number (starting from 1)
68 # Start of this location on `line_start`
70 # A `column_start` of 1 means the first column or character.
72 # If `column_start == 0` this location concerns the whole line.
74 # Require: `column_start >= 0`
77 # End of this location on `line_end`
80 # Builds a location instance from its string representation.
85 # var loc = new Location.from_string("location.nit:82,2--105,8")
86 # assert loc.to_s == "location.nit:82,2--105,8"
88 # loc = new Location.from_string("location.nit")
89 # assert loc.to_s == "location.nit"
91 # loc = new Location.from_string("location.nit:82,2")
92 # assert loc.to_s == "location.nit:82,2--0,0"
94 # loc = new Location.from_string("location.nit:82--105")
95 # assert loc.to_s == "location.nit:82,0--105,0"
97 # loc = new Location.from_string("location.nit:82,2--105")
98 # assert loc.to_s == "location.nit:82,2--105,0"
100 # loc = new Location.from_string("location.nit:82--105,8")
101 # assert loc.to_s == "location.nit:82,0--105,8"
103 init from_string
(string
: String) is
108 self.column_start
= 0
110 # parses the location string and init position vars
111 var parts
= string
.split_with
(":")
112 var filename
= parts
.shift
113 self.file
= new SourceFile(filename
, new FileReader.open
(filename
))
115 if parts
.is_empty
then return
116 var pos
= parts
.first
.split_with
("--")
117 # split start position
118 if pos
.first
.has
(",") then
119 var pos1
= pos
.first
.split_with
(",")
120 self.line_start
= pos1
[0].to_i
121 if pos1
.length
> 1 then
122 self.column_start
= pos1
[1].to_i
125 self.line_start
= pos
.first
.to_i
128 if pos
.length
<= 1 then return
129 if pos
[1].has
(",") then
130 var pos2
= pos
[1].split_with
(",")
131 if pos2
.length
> 1 then
132 self.line_end
= pos2
[0].to_i
133 self.column_end
= pos2
[1].to_i
135 self.line_end
= self.line_start
136 self.column_end
= pos2
[0].to_i
139 self.line_end
= pos
[1].to_i
143 # The index in the start character in the source
144 fun pstart
: Int do return file
.line_starts
[line_start-1
] + column_start-1
146 # The index on the end character in the source
147 fun pend
: Int do return file
.line_starts
[line_end-1
] + column_end-1
149 # The verbatim associated text in the source-file
152 var res
= self.text_cache
153 if res
!= null then return res
155 var pstart
= self.pstart
157 res
= l
.file
.string
.substring
(pstart
, pend-pstart
+1)
158 self.text_cache
= res
162 private var text_cache
: nullable String = null
164 redef fun ==(other
: nullable Object): Bool do
165 if other
== null then return false
166 if not other
isa Location then return false
168 if other
.file
!= file
then return false
169 if other
.line_start
!= line_start
then return false
170 if other
.line_end
!= line_end
then return false
171 if other
.column_start
!= column_start
then return false
172 if other
.column_end
!= column_end
then return false
177 # Is `self` included (or equals) to `loc`?
178 fun located_in
(loc
: nullable Location): Bool do
179 if loc
== null then return false
181 if line_start
< loc
.line_start
then return false
182 if line_start
> loc
.line_end
then return false
184 if line_end
> loc
.line_end
then return false
186 if line_start
== loc
.line_start
then
187 if column_start
< loc
.column_start
then return false
188 if column_start
> loc
.column_end
then return false
191 if line_end
== loc
.line_end
and column_end
> loc
.column_end
then return false
196 redef fun to_s
: String do
199 file_part
= file
.filename
202 if line_start
<= 0 then return file_part
204 if file
!= null and file
.filename
.length
> 0 then file_part
+= ":"
206 if line_start
== line_end
then
207 if column_start
== column_end
then
208 return "{file_part}{line_start},{column_start}"
210 return "{file_part}{line_start},{column_start}--{column_end}"
213 return "{file_part}{line_start},{column_start}--{line_end},{column_end}"
217 # Return a location message according to an observer.
219 # Currently, if both are in the same file, the file information is not present in the result.
220 fun relative_to
(loc
: nullable Location): String do
221 var relative
: Location
222 if loc
!= null and loc
.file
== self.file
then
223 relative
= new Location(null, self.line_start
, self.line_end
, self.column_start
, self.column_end
)
225 relative
= new Location(self.file
, self.line_start
, self.line_end
, self.column_start
, self.column_end
)
230 redef fun <(other
: OTHER): Bool do
231 if self == other
then return false
232 if self.located_in
(other
) then return true
233 if other
.located_in
(self) then return false
235 if line_start
!= other
.line_start
then return line_start
< other
.line_start
236 if column_start
!= other
.column_start
then return column_start
< other
.column_start
237 if line_end
!= other
.line_end
then return line_end
< other
.line_end
239 return column_end
< other
.column_end
242 # Return the associated line with the location highlighted with color and a caret under the starting position
243 # `color` must be and terminal escape sequence used as `"{escape}[{color}m;"`
245 # * `"1;31"` for bright red
246 # * `"0;32"` for green
247 fun colored_line
(color
: String): String
251 var col
= "{esc}[{color}m"
255 if i
<= 0 then return ""
257 var line_start
= l
.file
.line_starts
[i-1
]
258 var line_end
= line_start
259 var string
= l
.file
.string
260 while line_end
+1 < string
.length
and string
.chars
[line_end
+1] != '\n' and string
.chars
[line_end
+1] != '\r' do
264 if l
.column_start
> 0 then
265 lstart
= string
.substring
(line_start
, l
.column_start
- 1)
270 if i
!= l
.line_end
then
271 cend
= line_end
- line_start
+ 1
277 if line_start
+ cend
<= string
.length
then
278 lmid
= string
.substring
(line_start
+ l
.column_start
- 1, cend
- l
.column_start
+ 1)
279 lend
= string
.substring
(line_start
+ cend
, line_end
- line_start
- cend
+ 1)
284 var indent
= new FlatBuffer
285 for j
in [line_start
..line_start
+l
.column_start-1
[ do
286 if string
.chars
[j
] == '\t' then
292 return "\t{lstart}{col}{lmid}{def}{lend}\n\t{indent}^"