Simple, fast, safe, compiled language for developing maintainable software. Compiles itself in <1s with zero library dependencies. https://vlang.io
 
 
Go to file
F1ssi0N ca70d1f8a3 os: Make windows allocations more consistent & LocalFree args_list
if max is 512 then allocate `max * sizeof(wchar_t)`
2019-07-24 19:10:06 +02:00
.github vlib: update and cleanup tests + fix PR template 2019-06-29 22:49:57 +02:00
compiler Change CGen so that v.c is compileable with msvc 2019-07-24 17:46:41 +02:00
examples fix log example 2019-07-24 17:59:54 +02:00
thirdparty 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
vlib os: Make windows allocations more consistent & LocalFree args_list 2019-07-24 19:10:06 +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 Windows Unicode I/O 2019-07-24 12:16:45 +02:00
CHANGELOG.md os.flush_stdout() 2019-07-24 16:15:28 +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 Dockerfile 2019-07-23 00:31:43 +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 Update README.md (#1280) 2019-07-24 00:09:56 +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
test.zsh main.v: update help 2019-07-21 14:42:54 +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

git pull origin master
make

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.

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