Simple, fast, safe, compiled language for developing maintainable software. Compiles itself in <1s with zero library dependencies. https://vlang.io
 
 
Go to file
Kaiyin Zhong 88f67680fc rename get_extension to ext, add path_sans_ext 2019-06-26 14:45:03 +02:00
.github Update PULL_REQUEST_TEMPLATE 2019-06-26 13:53:42 +02:00
base64 base64: add encode 2019-06-25 21:50:02 +02:00
builtin remove smap.v, it was not supposed to be released 2019-06-25 21:22:50 +02:00
colors Revert "add log replace color" 2019-06-26 01:28:00 +02:00
compiler added arguments handling for run 2019-06-26 14:39:31 +02:00
examples Revert "add log replace color" 2019-06-26 01:28:00 +02:00
gg remove old types and 2019-06-25 22:19:17 +02:00
gl remove old `float` type entirely 2019-06-25 22:10:22 +02:00
glfw remove old types and 2019-06-25 22:19:17 +02:00
glm use matrix and add osx build 2019-06-26 13:57:48 +02:00
gx Fixed typo in gx.v 2019-06-25 15:01:35 +02:00
http replace to_i() with int() everywhere 2019-06-25 14:57:31 +02:00
json remove old `float` type entirely 2019-06-25 22:10:22 +02:00
math added math constants (they must be in PascalCase) (change radians) 2019-06-25 10:52:49 +02:00
os rename get_extension to ext, add path_sans_ext 2019-06-26 14:45:03 +02:00
rand clean up 2019-06-26 13:17:45 +02:00
stbi main.v: fix broken thirdparty dependencies 2019-06-25 14:31:51 +02:00
sync all: add copyright 2019-06-23 09:22:49 +02:00
thirdparty add `khrplatform.h` 2019-06-24 12:28:42 +02:00
time fix a miss 2019-06-26 13:56:54 +02:00
.gitattributes .gitattributes etc 2019-06-22 20:24:15 +02:00
.gitignore ignore example binaries 2019-06-26 14:45:03 +02:00
.travis.yml use matrix and add osx build 2019-06-26 13:57:48 +02:00
CONDUCT.md Update CONDUCT.md 2019-06-24 18:07:25 +02:00
CodeStructure.md Create CodeStructure.md 2019-06-25 12:06:55 +02:00
LICENSE README.md 2019-06-22 20:22:41 +02:00
README.md Update README.md 2019-06-26 01:23:03 +02:00
azure-pipelines.yml Add Azure Pipelines Config 2019-06-24 19:32:29 +02:00

README.md

The V Programming Language 0.1.2

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 UB, 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.

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 to get faster compilation).
  • The new formatter runs on every single token and slows the compiler down by ~20%. This will be taken care of.
  • There are a lot of known issues that are quick to fix (like function lookups being O(n)).

There's some old hacky code written when V was 2 months old. All of it will be quickly cleaned up. There are ~500 lines of C code, which will be removed by the end of June.

Code structure

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

Installing V from source

Linux and macOS

You'll need Clang or GCC. On macOS run xcode-select --install if you don't have XCode or XCode tools installed.

# You can clone V anywhere
git clone https://github.com/vlang/v
cd v/compiler
make

Or build without make:

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

That's it! Now you have a V executable at v/compiler/v.

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

sudo ln -s ~/code/v/compiler/v /usr/local/bin/v

Windows

V works great on Windows Subsystem for Linux. The instructions are the same as above.

If you want to build v.exe on Windows without WSL, you will need Visual Studio. Microsoft doesn't make it easy for developers. Mingw-w64 could suffice, but if you plan to develop UI and graphical apps, VS is your only option.

V temporarily can't be compiled with Visual Studio. This will be fixed asap.

Testing

$ v

V 0.1.2
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.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.

Arch:
sudo pacman -S glfw-x11 curl freetype2

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

macOS:
brew install glfw freetype curl

glfw and libcurl dependencies will be removed soon.