Simple, fast, safe, compiled language for developing maintainable software. Compiles itself in <1s with zero library dependencies. https://vlang.io
 
 
Go to file
unknown-v 22eaceb17c http_win: set status_code ,remove unused var 2019-08-05 09:59:07 +02:00
.github vlib: update and cleanup tests + fix PR template 2019-06-29 22:49:57 +02:00
compiler compiler: rename pkg to mod and auto save file import table 2019-08-05 09:49:52 +02:00
examples http: use optionals (finally) 2019-07-31 22:15:24 +02:00
thirdparty MSVC: Use vswhere instead of mscrazy (#1307) 2019-07-25 12:29:24 +02:00
tools bring back map.str() 2019-08-05 04:34:12 +02:00
vlib http_win: set status_code ,remove unused var 2019-08-05 09:59:07 +02:00
.gitattributes .gitattributes etc 2019-06-22 20:24:15 +02:00
.gitignore Windows: fix some heap corruptions, fix msvc not building with unicode flags, fix os.getwd, fix mscrazy using a less recent installation 2019-07-24 15:00:26 +02:00
.travis.yml travis: install glfw vpm module 2019-08-01 17:40:45 +02:00
CHANGELOG.md clean up map initialization 2019-08-03 10:26:36 +02:00
CONDUCT.md Update CONDUCT.md 2019-06-24 18:07:25 +02:00
CONTRIBUTING.md Rename CodeStructure.md to CONTRIBUTING.md 2019-06-30 22:34:25 +02:00
Dockerfile use /opt/ instead of /etc/ for binary storage 2019-07-27 01:15:20 +02:00
LICENSE README.md 2019-06-22 20:22:41 +02:00
Makefile Makefile: don't build thirdparty modules on installation 2019-07-24 17:39:04 +02:00
README.md readme: add `v install glfw` 2019-08-02 02:13:33 +02:00
azure-pipelines.yml Azure: remove `cd compiler` 2019-06-29 13:04:59 +02:00
make.bat Update make.bat 2019-07-24 13:15:00 +02:00
make_tests.bat make_tests.bat: exit with error on failed test 2019-08-01 13:23:36 +02:00
test.sh http: replace escape() with escape_url() 2019-07-31 20:57:34 +02:00

README.md

The V Programming Language 0.1.x

Build Status

https://vlang.io

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 half an hour, less if you already know Go
  • Fast compilation: ~100k loc/s right now, ~1.2 million loc/s once x64 generation is mature enough
  • Easy to develop: V compiles itself in less than a second
  • Performance: within 5% 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

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

Notes

GitHub marks V's code as written in Go. It's actually written in V, GitHub doesn't support the language yet.

The compilation is temporarily slower for this release:

  • Debug builds are used (use ./v -prod -o v compiler to get faster compilation).
  • vlib is recompiled with every program you build.
  • The new formatter runs on every single token and slows the compiler down by ~20%. This will be taken care of.

Installing V from source

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

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

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

C compiler

You'll need Clang or GCC.

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

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

Building without make

# Download the V compiler's source translated to C
curl -O https://raw.githubusercontent.com/vlang/vc/master/v.c
cc -std=gnu11 -w -o v v.c -lm  # Build it with Clang or GCC
./v -o v compiler              # Use the resulting V binary to build V from V source

(These instructions won't work on Windows, use make.bat instead).

Symlinking and updates

You can create a symlink so that it's globally available:

sudo ln -s [path to V repo]/v /usr/local/bin/v

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

v up

Docker

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

Testing

$ cd examples
$ v run hello_world.v
hello world

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

>>> println('hello world')
hello world
>>>

Now if you want, you can start tinkering with the compiler. 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.

Running the 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 libcurl.

macOS:
brew install glfw freetype curl

Ubuntu:
sudo apt install libglfw3 libglfw3-dev libfreetype6-dev libcurl3-dev

Arch:
sudo pacman -S glfw-x11 curl freetype2

glfw and libcurl dependencies will be removed soon.

Code structure

https://github.com/vlang/v/blob/master/CONTRIBUTING.md