1 # This file is part of NIT ( http://www.nitlanguage.org ).
3 # Copyright 2006-2008 Floréal Morandat <morandat@lirmm.fr>
4 # Copyright 2008-2012 Jean Privat <jean@pryen.org>
5 # Copyright 2009 Jean-Sebastien Gelinas <calestar@gmail.com>
6 # Copyright 2014 Alexandre Terrasa <alexandre@moz-code.org>
8 # Licensed under the Apache License, Version 2.0 (the "License");
9 # you may not use this file except in compliance with the License.
10 # You may obtain a copy of the License at
12 # http://www.apache.org/licenses/LICENSE-2.0
14 # Unless required by applicable law or agreed to in writing, software
15 # distributed under the License is distributed on an "AS IS" BASIS,
16 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17 # See the License for the specific language governing permissions and
18 # limitations under the License.
20 # Common command-line tool infrastructure than handle options and error messages
28 # A warning or an error
31 redef type OTHER: Message
33 # The origin of the message in the source code, if any.
34 var location
: nullable Location
36 # The category of the message.
38 # Used by quality-control tool for statistics or to enable/disable things individually.
39 var tag
: nullable String
41 # The human-readable description of the message.
43 # It should be short and fit on a single line.
44 # It should also have meaningful information first in case
45 # on truncation by an IDE for instance.
48 # Comparisons are made on message locations.
49 redef fun <(other
: OTHER): Bool do
50 if location
== null then return true
51 if other
.location
== null then return false
53 return location
.as(not null) < other
.location
.as(not null)
56 redef fun to_s
: String
66 # A colored version of the message including the original source line
67 fun to_color_string
: String
70 #var red = "{esc}[0;31m"
71 #var bred = "{esc}[1;31m"
72 #var green = "{esc}[0;32m"
73 var yellow
= "{esc}[0;33m"
85 else if l
.file
== null then
86 return "{yellow}{l}{def}: {text}{tag}"
88 return "{yellow}{l}{def}: {text}{tag}\n{l.colored_line("1;31")}"
93 # Global context for tools
96 var error_count
: Int = 0
99 var warning_count
: Int = 0
101 # Directory where to generate log files
102 var log_directory
: String = "logs"
105 private var messages
= new Array[Message]
106 private var message_sorter
: Comparator = default_comparator
108 # Output all current stacked messages.
109 # If some errors occurred, exits the program.
112 if messages
.length
> 0 then
113 message_sorter
.sort
(messages
)
116 if opt_no_color
.value
then
117 sys
.stderr
.write
("{m}\n")
119 sys
.stderr
.write
("{m.to_color_string}\n")
126 if error_count
> 0 then
132 # Display (and reset) total error informations
135 if error_count
== 0 and warning_count
== 0 then return
136 if opt_no_color
.value
then return
137 sys
.stderr
.write
"Errors: {error_count}. Warnings: {warning_count}.\n"
143 fun error
(l
: nullable Location, s
: String)
145 messages
.add
(new Message(l
,null,s
))
146 error_count
= error_count
+ 1
147 if opt_stop_on_first_error
.value
then check_errors
150 # Add an error, show errors and quit
151 fun fatal_error
(l
: nullable Location, s
: String)
157 # Display a first-level warning.
159 # First-level warnings are warnings that SHOULD be corrected,
160 # and COULD usually be immediately corrected.
162 # * There is a simple correction
163 # * There is no reason to let the code this way (no reasonable @supresswarning-like annotation)
164 # * They always are real issues (no false positive)
166 # First-level warnings are displayed by default (except if option `-q` is given).
167 fun warning
(l
: nullable Location, tag
: String, text
: String)
169 if opt_warning
.value
.has
("no-{tag}") then return
170 if not opt_warning
.value
.has
(tag
) and opt_warn
.value
== 0 then return
171 messages
.add
(new Message(l
, tag
, text
))
172 warning_count
= warning_count
+ 1
173 if opt_stop_on_first_error
.value
then check_errors
176 # Display a second-level warning.
178 # Second-level warnings are warnings that should require investigation,
179 # but cannot always be immediately corrected.
181 # * The correction could be complex. e.g. require a refactorisation or an API change.
182 # * The correction cannot be done. e.g. Code that use a deprecated API for some compatibility reason.
183 # * There is not a real issue (false positive). Note that this should be unlikely.
184 # * Transitional: While a real warning, it fires a lot in current code, so a transition is needed
185 # in order to fix them before promoting the advice to a warning.
187 # In order to prevent warning inflation à la Java, second-level warnings are not displayed by
188 # default and require an additional option `-W`.
189 fun advice
(l
: nullable Location, tag
: String, text
: String)
191 if opt_warning
.value
.has
("no-{tag}") then return
192 if not opt_warning
.value
.has
(tag
) and opt_warn
.value
<= 1 then return
193 messages
.add
(new Message(l
, tag
, text
))
194 warning_count
= warning_count
+ 1
195 if opt_stop_on_first_error
.value
then check_errors
199 fun info
(s
: String, level
: Int)
201 if level
<= verbose_level
then
206 # Executes a program while checking if it's available and if the execution ended correctly
208 # Stops execution and prints errors if the program isn't available or didn't end correctly
209 fun exec_and_check
(args
: Array[String], error
: String)
211 var prog
= args
.first
214 # Is the wanted program available?
215 var proc_which
= new IProcess.from_a
("which", [prog
])
217 var res
= proc_which
.status
219 print
"{error}: executable \"{prog}\
" not found"
223 # Execute the wanted program
224 var proc
= new Process.from_a
(prog
, args
)
228 print
"{error}: execution of \"{prog} {args.join(" ")}\
" failed"
233 # Global OptionContext
234 var option_context
= new OptionContext
237 var opt_warn
= new OptionCount("Show more warnings", "-W", "--warn")
240 var opt_warning
= new OptionArray("Show/hide a specific warning", "-w", "--warning")
243 var opt_quiet
= new OptionBool("Do not show warnings", "-q", "--quiet")
246 var opt_log
= new OptionBool("Generate various log files", "--log")
249 var opt_log_dir
= new OptionString("Directory where to generate log files", "--log-dir")
252 var opt_nit_dir
= new OptionString("Base directory of the Nit installation", "--nit-dir")
255 var opt_help
= new OptionBool("Show Help (This screen)", "-h", "-?", "--help")
258 var opt_version
= new OptionBool("Show version and exit", "--version")
260 # Option --set-dummy-tool
261 var opt_set_dummy_tool
= new OptionBool("Set toolname and version to DUMMY. Useful for testing", "--set-dummy-tool")
264 var opt_verbose
= new OptionCount("Verbose", "-v", "--verbose")
266 # Option --stop-on-first-error
267 var opt_stop_on_first_error
= new OptionBool("Stop on first error", "--stop-on-first-error")
270 var opt_no_color
= new OptionBool("Do not use color to display errors and warnings", "--no-color")
272 # Option --bash-completion
273 var opt_bash_completion
= new OptionBool("Generate bash_completion file for this program", "--bash-completion")
276 var opt_stub_man
= new OptionBool("Generate a stub manpage in pandoc markdown format", "--stub-man")
279 var verbose_level
: Int = 0
283 option_context
.add_option
(opt_warn
, opt_warning
, opt_quiet
, opt_stop_on_first_error
, opt_no_color
, opt_log
, opt_log_dir
, opt_nit_dir
, opt_help
, opt_version
, opt_set_dummy_tool
, opt_verbose
, opt_bash_completion
, opt_stub_man
)
285 # Hide some internal options
286 opt_stub_man
.hidden
= true
287 opt_bash_completion
.hidden
= true
288 opt_set_dummy_tool
.hidden
= true
291 # Name, usage and synopsis of the tool.
292 # It is mainly used in `usage`.
293 # Should be correctly set by the client before calling `process_options`
294 # A multi-line string is recommmended.
296 # eg. `"Usage: tool [OPTION]... [FILE]...\nDo some things."`
297 var tooldescription
: String = "Usage: [OPTION]... [ARG]..." is writable
299 # Does `process_options` should accept an empty sequence of arguments.
300 # ie. nothing except options.
301 # Is `false` by default.
303 # If required, if should be set by the client before calling `process_options`
304 var accept_no_arguments
= false is writable
306 # print the full usage of the tool.
307 # Is called by `process_option` on `--help`.
308 # It also could be called by the client.
311 print tooldescription
315 # Parse and process the options given on the command line
316 fun process_options
(args
: Sequence[String])
318 self.opt_warn
.value
= 1
321 option_context
.parse
(args
)
323 if opt_help
.value
then
328 if opt_version
.value
then
333 if opt_bash_completion
.value
then
334 var bash_completion
= new BashCompletion(self)
335 bash_completion
.write_to
(sys
.stdout
)
339 if opt_stub_man
.value
then
341 % {{{toolname.to_upper}}}(1)
345 {{{tooldescription.split("\n")[1]}}}
349 {{{toolname}}} [*options*]...
353 for o
in option_context
.options
do
356 if first
then first
= false else printn
", "
360 print
": {o.helptext}"
366 The Nit language documentation and the source code of its tools and libraries may be downloaded from <http://nitlanguage.org>"""
370 var errors
= option_context
.get_errors
371 if not errors
.is_empty
then
372 for e
in errors
do print
"Error: {e}"
373 print tooldescription
374 print
"Use --help for help"
378 nit_dir
= compute_nit_dir
380 if option_context
.rest
.is_empty
and not accept_no_arguments
then
381 print tooldescription
382 print
"Use --help for help"
387 verbose_level
= opt_verbose
.value
389 if self.opt_quiet
.value
then self.opt_warn
.value
= 0
391 if opt_log_dir
.value
!= null then log_directory
= opt_log_dir
.value
.as(not null)
392 if opt_log
.value
then
393 # Make sure the output directory exists
399 # Get the current `nit_version` or "DUMMY_VERSION" if `--set-dummy-tool` is set.
400 fun version
: String do
401 if opt_set_dummy_tool
.value
then
402 return "DUMMY_VERSION"
407 # Get the name of the tool or "DUMMY_TOOL" id `--set-dummy-tool` is set.
408 fun toolname
: String do
409 if opt_set_dummy_tool
.value
then
412 return sys
.program_name
.basename
("")
415 # The identified root directory of the Nit project
416 var nit_dir
: String is noinit
418 private fun compute_nit_dir
: String
420 # the option has precedence
421 var res
= opt_nit_dir
.value
423 if not check_nit_dir
(res
) then
424 fatal_error
(null, "Fatal Error: the value of --nit-dir does not seem to be a valid base Nit directory: {res}")
429 # then the environ variable has precedence
430 res
= "NIT_DIR".environ
431 if not res
.is_empty
then
432 if not check_nit_dir
(res
) then
433 fatal_error
(null, "Fatal Error: the value of NIT_DIR does not seem to be a valid base Nit directory: {res}")
438 # find the runpath of the program from argv[0]
439 res
= "{sys.program_name.dirname}/.."
440 if check_nit_dir
(res
) then return res
.simplify_path
442 # find the runpath of the process from /proc
443 var exe
= "/proc/self/exe"
444 if exe
.file_exists
then
446 res
= res
.dirname
.join_path
("..")
447 if check_nit_dir
(res
) then return res
.simplify_path
451 var ps
= "PATH".environ
.split
(":")
454 if check_nit_dir
(res
) then return res
.simplify_path
457 fatal_error
(null, "Fatal Error: Cannot locate a valid base nit directory. It is quite unexpected. Try to set the environment variable `NIT_DIR` or to use the `--nit-dir` option.")
461 private fun check_nit_dir
(res
: String): Bool
463 return res
.file_exists
and "{res}/src/nit.nit".file_exists
467 # This class generates a compatible `bash_completion` script file.
469 # On some Linux systems `bash_completion` allow the program to control command line behaviour.
472 # file1.nit file2.nit file3.nit
474 # $ nitls --[TAB][TAB]
475 # --bash-toolname --keep --path --tree
476 # --depends --log --project --verbose
477 # --disable-phase --log-dir --quiet --version
478 # --gen-bash-completion --no-color --recursive --warn
479 # --help --only-metamodel --source
480 # --ignore-visibility --only-parse --stop-on-first-error
482 # Generated file can be placed in system bash_completion directory `/etc/bash_completion.d/`
483 # or source it in `~/.bash_completion`.
487 var toolcontext
: ToolContext
489 private fun extract_options_names
: Array[String] do
490 var names
= new Array[String]
491 for option
in toolcontext
.option_context
.options
do
492 for name
in option
.names
do
493 if name
.has_prefix
("--") then names
.add name
499 redef fun rendering
do
500 var name
= toolcontext
.toolname
501 var option_names
= extract_options_names
502 addn
"# generated bash completion file for {name} {toolcontext.version}"
505 addn
" local cur prev opts"
507 addn
" cur=\"$\
{COMP_WORDS[COMP_CWORD]\}\
""
508 addn
" prev=\"$\
{COMP_WORDS[COMP_CWORD-1]\}\
""
509 if not option_names
.is_empty
then
510 addn
" opts=\"{option_names.join(" ")}\
""
511 addn
" if [[ $\{cur\} == -* ]] ; then"
512 addn
" COMPREPLY=( $(compgen -W \"$\
{opts\}\
" -- $\{cur\}) )"
517 addn
"complete -o default -F _{name} {name}"