vorelang programming language
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
joe-conigliaro b7361d00aa compiler: fix v test v on paths with spaces 2 years ago
.github Update PULL_REQUEST_TEMPLATE 2 years ago
compiler compiler: fix v test v on paths with spaces 2 years ago
examples vweb: fix headers 2 years ago
thirdparty compiler: build tetris executable on windows with both msvc and mingw gcc 2 years ago
tools tools: gen_vc - add purge flag 2 years ago
vlib string: implement is_space in V & make trim_space use trim 2 years ago
.gitattributes Create .gitattributes 2 years ago
.gitignore Force git to ignore temporary *.tmp.c files too. 2 years ago
.travis.yml travis: don't run msvc tests for now 2 years ago
CHANGELOG.md update september.plan 2 years ago
CONDUCT.md Update CONDUCT.md 2 years ago
CONTRIBUTING.md Rename CodeStructure.md to CONTRIBUTING.md 2 years ago
Dockerfile Docker: minor fixes 2 years ago
LICENSE README.md 2 years ago
Makefile makefile: uname osx fix & detect MinGW & MSYS 2 years ago
README.md readme: Add CentOS / RHEL / Fedora instructions 2 years ago
make.bat make.bat: remove diagnostic output and msvc banners 2 years ago
september.plan readme: Visual Studio is now supported 2 years ago


The V Programming Language 0.1.x

Build Status


Documentation: https://vlang.io/docs

Twitter: https://twitter.com/v_language

Discord (primary community): https://discord.gg/n7c74HM

Installing V: https://github.com/vlang/v#installing-v-from-source

Key Features of V

  • Simplicity: the language can be learned in less than an hour
  • Fast compilation: ~100k - 1.2 million loc/s
  • Easy to develop: V compiles itself in less than a second
  • Performance: within 3% of C
  • Safety: no null, no globals, no undefined behavior, immutability by default
  • C to V translation
  • Hot code reloading
  • Powerful UI and graphics libraries
  • Easy cross compilation
  • REPL
  • Built-in ORM

V 1.0 release is planned for December 2019. Right now V is in an alpha stage.

Installing V from source

Linux, macOS, Windows, *BSD, WSL, Android, Raspbian

git clone https://github.com/vlang/v
cd v

That's it! Now you have a V executable at [path to V repo]/v. [path to V repo] can be anywhere.

V is being constantly updated. To update V, simply run

v up

C compiler

You'll need Clang or GCC or Visual Studio. If you are doing development, you most likely already have one of those installed.

On macOS run xcode-select --install if you don't have XCode or XCode tools.

On Debian/Ubuntu run sudo apt install build-essential.

On CentOS/RHEL run 'sudo yum groupinstall "Development Tools"`.

On Fedora run sudo dnf install @development-tools.

On Windows follow these instructions: github.com/vlang/v/wiki/Installing-a-C-compiler-on-Windows


You can create a /usr/local/bin/v symlink so that V is globally available:

sudo v symlink


git clone https://github.com/vlang/v
cd v
docker build -t vlang .
docker run --rm -it vlang:latest

Testing and running the examples

Make sure V can compile itself:

v -o v compiler
$ v
V 0.1.x
Use Ctrl-D to exit

>>> println('hello world')
hello world
cd examples
v hello_world.v && ./hello_world    # or simply
v run hello_world.v                 # this builds the program and runs it right away

v word_counter.v && ./word_counter cinderella.txt
v run news_fetcher.v
v run tetris/tetris.v

In order to build Tetris and anything else using the graphics module, you will need to install glfw and freetype.

v install glfw

If you plan to use the http package, you also need to install OpenSSL on non-Windows systems.

brew install glfw freetype openssl

sudo apt install libglfw3 libglfw3-dev libfreetype6-dev libssl-dev

sudo pacman -S glfw-x11 freetype2

sudo dnf install glfw glfw-devel freetype-devel

glfw dependency will be removed soon.


Code structure:


If you introduce a breaking change and rebuild V, you will no longer be able to use V to build itself. So it's a good idea to make a backup copy of a working compiler executable.