const (
emanager = new_error_manager()
)emanager.support_color - should the error and other messages
have ANSI terminal escape color codes in them.
By default, v tries to autodetect, if the terminal supports colors.
Use -color and -nocolor options to override the detection decision.
const (
builtin_module_parts = ['math.bits', 'strconv', 'strconv.ftoa', 'strings', 'builtin']
bundle_modules = ['clipboard', 'fontstash', 'gg', 'gx', 'sokol', 'szip', 'ui']
)math.bits is needed by strconv.ftoa
const (
external_module_dependencies_for_tool = {
'vdoc': ['markdown']
}
)fn args_quote_paths(args []string) stringfn bold(msg string) stringfn cached_file2sourcelines(path string) []stringfn cached_read_source_file(path string) ?stringfn cescaped_path(s string) stringfn check_module_is_installed(modulename string, is_verbose bool) ?boolfn color_compare_files(diff_cmd string, file1 string, file2 string) stringfn color_compare_strings(diff_cmd string, unique_prefix string, expected string, found string) stringfn contains_capital(s string) boolfn ensure_modules_for_all_tools_are_installed(is_verbose bool)fn find_all_v_files(roots []string) ?[]stringfind_all_v_files - given a list of files/folders, finds all .v/.vsh files if some of the files/folders on the list does not exist, or a file is not a .v or .vsh file, returns an error instead.
fn find_working_diff_command() ?stringiterates through a list of known diff cli commands and returns it with basic options
fn formatted_error(kind string, omsg string, filepath string, pos token.Position) stringformatted_error - kind may be 'error' or 'warn'
fn free_caches()free_caches knows about all util caches and makes sure that they are freed if you add another cached unsafe function using static, do not forget to add
a mechanism to clear its cache, and call it here.
fn get_timers() &Timersfn get_vtmp_folder() stringfn good_type_name(s string) boolHTTPRequest bad HttpRequest good
fn is_func_char(c byte) boolfn is_generic_type_name(name string) boolis_generic_type_name returns true if the current token is a generic type name.
fn is_name_char(c byte) boolfn join_env_vflags_and_os_args() []stringfn launch_tool(is_verbose bool, tool_name string, args []string)launch_tool - starts a V tool in a separate process, passing it the args.
All V tools are located in the cmd/tools folder, in files or folders prefixed by
the letter v, followed by the tool name, i.e. cmd/tools/vdoc/ or cmd/tools/vpm.v.
The folder variant is suitable for larger and more complex tools, like v doc, because it provides you the ability to split their source in separate .v files, organized by topic,
as well as have resources like static css/text/js files, that the tools can use.
launch_tool uses a timestamp based detection mechanism, so that after v self, each tool will be recompiled too, before it is used, which guarantees that it would be up to date with V itself. That mechanism can be disabled by package managers by creating/touching a small cmd/tools/.disable_autorecompilation file, OR by changing the timestamps of all executables
in cmd/tools to be < 1024 seconds (in unix time).
fn mod_path_to_full_name(pref &pref.Preferences, mod string, path string) ?stringTODO: * properly define module location / v.mod rules * if possible split this function in two, one which gets the parent module path and another which turns it into the full name * create shared logic between these fns and builder.find_module_path
fn new_error_manager() &EManagerfn new_suggestion(wanted string, possibilities []string) Suggestionfn new_timers(should_print bool) &Timersfn no_cur_mod(typename string, cur_mod string) stringno_cur_mod - removes cur_mod. prefix from typename, but only when it is at the start, i.e.: no_cur_mod('vproto.Abdcdef', 'proto') == 'vproto.Abdcdef' even though proto. is a substring
fn no_dots(s string) stringfn path_of_executable(path string) stringfn prepare_tool_when_needed(source_name string)fn qualify_import(pref &pref.Preferences, mod string, file_path string) stringfn qualify_module(pref &pref.Preferences, mod string, file_path string) stringfn quote_path(s string) stringfn read_file(file_path string) ?stringfn recompile_file(vexe string, file string)fn replace_op(s string) stringfn resolve_env_value(str string, check_for_presence bool) ?stringresolve_env_value replaces all occurrences of $env('ENV_VAR_NAME')
in str with the value of the env variable $ENV_VAR_NAME.
fn resolve_vmodroot(str string, dir string) ?stringfn set_vroot_folder(vroot_path string)fn short_module_name(name string) stringfn should_bundle_module(mod string) boolfn should_recompile_tool(vexe string, tool_source string, tool_name string, tool_exe string) boolNB: should_recompile_tool/4 compares unix timestamps that have 1 second resolution
That means that a tool can get recompiled twice, if called in short succession.
TODO: use a nanosecond mtime timestamp, if available.
fn skip_bom(file_content string) stringfn smart_quote(str string, raw bool) stringfn source_file_context(kind string, filepath string, pos token.Position) []stringfn strip_main_name(name string) stringfn strip_mod_name(name string) stringfn tabs(n int) stringfn timing_measure(label string)fn timing_measure_cumulative(label string)fn timing_set_should_print(should_print bool)fn timing_start(label string)fn verror(kind string, s string)fn vlines_escape_path(path string, ccompiler string) stringfn (mut s Suggestion) add(val string)fn (mut s Suggestion) add_many(many []string)fn (mut s Suggestion) sort()fn (s Suggestion) say(msg string) stringstruct EManager {
mut:
support_color bool
}fn (e &EManager) set_support_color(b bool)struct Timers {
pub mut:
swatches map[string]time.StopWatch
should_print bool
already_shown []string
}fn (mut t Timers) start(name string)fn (mut t Timers) measure(name string) i64fn (mut t Timers) measure_cumulative(name string) i64fn (mut t Timers) measure_pause(name string)fn (mut t Timers) measure_resume(name string)fn (mut t Timers) message(name string) stringfn (mut t Timers) show(label string)fn (mut t Timers) show_if_exists(label string)fn (mut t Timers) show_remaining()fn (mut t Timers) dump_all()