2019-09-11 13:35:03 +03:00
|
|
|
module main
|
|
|
|
|
|
|
|
const (
|
2019-09-15 14:08:40 +03:00
|
|
|
HelpText = 'Usage: v [options/commands] [file.v | directory]
|
2019-09-11 13:35:03 +03:00
|
|
|
|
2019-09-15 14:08:40 +03:00
|
|
|
When V is run without any arguments, it is run in REPL mode.
|
2019-09-11 13:35:03 +03:00
|
|
|
|
2019-09-15 14:08:40 +03:00
|
|
|
When given a .v file, it will be compiled. The executable will have the
|
|
|
|
same name as the input .v file: `v foo.v` produces `./foo` on *nix systems,
|
|
|
|
`foo.exe` on Windows.
|
2019-09-11 13:35:03 +03:00
|
|
|
|
2019-09-15 14:15:31 +03:00
|
|
|
You can use -o to specify a different output executable\'s name.
|
2019-09-15 14:08:40 +03:00
|
|
|
|
|
|
|
When given a directory, all .v files contained in it will be compiled as
|
|
|
|
part of a single main module.
|
|
|
|
|
|
|
|
By default the executable will have the same name as the directory.
|
|
|
|
|
|
|
|
To compile all V files in current directory, run `v .`
|
2019-09-11 13:35:03 +03:00
|
|
|
|
2019-09-13 16:19:41 +03:00
|
|
|
Any file ending in _test.v, will be treated as a test.
|
2019-09-15 14:08:40 +03:00
|
|
|
It will be compiled and run, evaluating the assert statements in every
|
|
|
|
function named test_xxx.
|
2019-09-11 13:35:03 +03:00
|
|
|
|
2019-09-15 14:08:40 +03:00
|
|
|
You can put common options inside an environment variable named VFLAGS, so that
|
|
|
|
you don\'t have to repeat them.
|
2019-09-13 16:19:41 +03:00
|
|
|
|
2019-09-15 14:08:40 +03:00
|
|
|
You can set it like this: `export VFLAGS="-cc clang -debug"` on *nix,
|
|
|
|
`set VFLAGS=-os msvc` on Windows.
|
|
|
|
|
|
|
|
Options/commands:
|
|
|
|
-h, help Display this information.
|
|
|
|
-o <file> Write output to <file>.
|
|
|
|
-o <file>.c Produce C source without compiling it.
|
|
|
|
-o <file>.js Produce JavaScript source.
|
|
|
|
-prod Build an optimized executable.
|
|
|
|
-v, version Display compiler version and git hash of the compiler source.
|
2019-09-11 13:35:03 +03:00
|
|
|
-live Enable hot code reloading (required by functions marked with [live]).
|
2019-09-13 16:19:41 +03:00
|
|
|
-os <OS> Produce an executable for the selected OS.
|
2019-09-15 14:08:40 +03:00
|
|
|
OS can be linux, mac, windows, msvc.
|
|
|
|
Use msvc if you want to use the MSVC compiler on Windows.
|
2019-09-13 16:19:41 +03:00
|
|
|
-cc <ccompiler> Specify which C compiler you want to use as a C backend.
|
2019-09-11 13:35:03 +03:00
|
|
|
The C backend compiler should be able to handle C99 compatible C code.
|
2019-09-13 16:19:41 +03:00
|
|
|
Common C compilers are gcc, clang, tcc, icc, cl...
|
|
|
|
-cflags <flags> Pass additional C flags to the C backend compiler.
|
2019-09-11 13:35:03 +03:00
|
|
|
Example: -cflags `sdl2-config --cflags`
|
2019-09-11 22:24:22 +03:00
|
|
|
-debug Keep the generated C file for debugging in program.tmp.c even after compilation.
|
2019-10-03 02:01:49 +03:00
|
|
|
-shared Build a shared library.
|
2019-10-09 06:01:43 +03:00
|
|
|
-stats Show additional stats when compiling/running tests. Try `v -stats test .`
|
2019-09-13 16:19:41 +03:00
|
|
|
-g Show v line numbers in backtraces. Implies -debug.
|
2019-09-11 13:35:03 +03:00
|
|
|
-obf Obfuscate the resulting binary.
|
|
|
|
-show_c_cmd Print the full C compilation command and how much time it took.
|
2019-09-15 14:08:40 +03:00
|
|
|
- Shorthand for `v runrepl`.
|
2019-09-13 16:19:41 +03:00
|
|
|
|
2019-09-11 13:35:03 +03:00
|
|
|
up Update V. Run `v up` at least once per day, since V development is rapid and features/bugfixes are added constantly.
|
2019-09-13 16:19:41 +03:00
|
|
|
run <file.v> Build and execute the V program in file.v. You can add arguments for the V program *after* the file name.
|
|
|
|
build <module> Compile a module into an object file.
|
2019-09-11 22:24:22 +03:00
|
|
|
runrepl Run the V REPL. If V is running in a tty terminal, the REPL is interactive, otherwise it just reads from stdin.
|
2019-09-11 13:35:03 +03:00
|
|
|
symlink Useful on unix systems. Symlinks the current V executable to /usr/local/bin/v, so that V is globally available.
|
2019-09-13 16:19:41 +03:00
|
|
|
install <module> Install a user module from https://vpm.vlang.io/.
|
2019-09-11 13:35:03 +03:00
|
|
|
test v Run all V test files, and compile all V examples.
|
2019-10-09 06:01:43 +03:00
|
|
|
test folder/ Run all V test files located in the folder and its subfolders. You can also pass individual _test.v files too.
|
2019-09-11 13:35:03 +03:00
|
|
|
fmt Run vfmt to format the source code. [wip]
|
2019-09-11 22:24:22 +03:00
|
|
|
doc Run vdoc over the source code and produce documentation. [wip]
|
2019-09-13 16:19:41 +03:00
|
|
|
translate Translates C to V. [wip, will be available in V 0.3]
|
2019-09-11 13:35:03 +03:00
|
|
|
'
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
- To disable automatic formatting:
|
|
|
|
v -nofmt file.v
|
|
|
|
*/
|