2019-06-28 01:47:55 +03:00
# The V Programming Language 0.1.x
2019-06-22 21:22:41 +03:00
2019-06-26 19:49:01 +03:00
[![Build Status ](https://dev.azure.com/alexander0785/vlang/_apis/build/status/vlang-CI?branchName=master )](https://dev.azure.com/alexander0785/vlang/_build/latest?definitionId=1& branchName=master) [![Build Status ](https://travis-ci.org/vlang/v.svg?branch=master )](https://travis-ci.org/vlang/v)
2019-06-25 13:27:06 +03:00
2019-06-22 21:22:41 +03:00
https://vlang.io
Documentation: https://vlang.io/docs
Twitter: https://twitter.com/v_language
2019-06-24 03:11:26 +03:00
Discord (primary community): https://discord.gg/n7c74HM
2019-06-24 03:04:58 +03:00
2019-06-23 17:13:56 +03:00
Installing V: https://github.com/vlang/v#installing-v-from-source
2019-06-22 21:22:41 +03:00
2019-06-24 17:04:19 +03:00
## Key Features of V
- Simplicity: the language can be learned in half an hour, less if you already know Go
2019-06-24 19:53:22 +03:00
- Fast compilation: ~100k loc/s right now, ~1.2 million loc/s once x64 generation is mature enough
2019-06-24 17:07:41 +03:00
- Easy to develop: V compiles itself in less than a second
2019-06-24 17:04:19 +03:00
- Performance: within 5% of C
2019-06-28 02:54:42 +03:00
- Safety: no null, no globals, no undefined behavior, immutability by default
2019-06-24 17:04:19 +03:00
- C to V translation
2019-06-24 17:36:30 +03:00
- Hot code reloading
2019-06-24 17:04:19 +03:00
- Powerful UI and graphics libraries
- Easy cross compilation
- REPL
2019-06-29 17:52:36 +03:00
V 1.0 release is planned for December 2019. Right now V is in an alpha stage.
2019-06-24 17:04:19 +03:00
2019-06-25 14:16:48 +03:00
## Notes
2019-06-24 17:36:30 +03:00
GitHub marks V's code as written in Go. It's actually written in V, GitHub doesn't support the language yet.
2019-06-24 17:07:41 +03:00
2019-06-25 13:44:56 +03:00
The compilation is temporarily slower for this release:
2019-06-25 06:46:45 +03:00
2019-06-30 16:26:03 +03:00
- Debug builds are used (use `./v -prod -o v compiler` to get faster compilation).
2019-06-26 16:23:59 +03:00
- vlib is recompiled with every program you build.
2019-06-25 13:05:00 +03:00
- The new formatter runs on every single token and slows the compiler down by ~20%. This will be taken care of.
2019-06-25 14:16:48 +03:00
2019-06-25 13:07:07 +03:00
## Code structure
2019-06-22 21:22:41 +03:00
2019-06-30 23:34:51 +03:00
https://github.com/vlang/v/blob/master/CONTRIBUTING.md
2019-06-22 21:22:41 +03:00
## Installing V from source
2019-07-01 11:51:38 +03:00
### Linux, macOS, Android, Raspberry Pi
2019-06-22 21:22:41 +03:00
2019-06-25 16:14:19 +03:00
You'll need Clang or GCC. On macOS run `xcode-select --install` if you don't have XCode or XCode tools installed.
2019-06-22 21:22:41 +03:00
```bash
2019-06-25 03:02:05 +03:00
# You can clone V anywhere
git clone https://github.com/vlang/v
2019-06-29 13:58:52 +03:00
cd v
2019-06-23 12:44:40 +03:00
make
2019-06-26 00:02:25 +03:00
```
Or build without make:
2019-06-26 00:02:43 +03:00
```bash
2019-06-26 00:02:25 +03:00
# Download the V compiler's source translated to C
2019-06-29 17:54:22 +03:00
curl -O https://raw.githubusercontent.com/vlang/vc/master/v.c
2019-06-25 21:59:35 +03:00
cc -std=gnu11 -w -o v v.c # Build it with Clang or GCC
2019-06-29 17:54:22 +03:00
./v -o v compiler # Use the resulting V binary to build V from V source
2019-06-22 21:22:41 +03:00
```
2019-06-29 13:58:52 +03:00
That's it! Now you have a V executable at `[path to V repo]/v` .
2019-06-23 14:27:43 +03:00
2019-06-22 21:22:41 +03:00
You can create a symlink so that it's globally available:
```
2019-06-29 13:58:52 +03:00
sudo ln -s [path to V repo]/v /usr/local/bin/v
2019-06-22 21:22:41 +03:00
```
2019-06-27 23:32:29 +03:00
V is being constantly updated. To update V, simply run
```
git pull origin master
make
```
2019-06-22 21:22:41 +03:00
### Windows
V works great on Windows Subsystem for Linux. The instructions are the same as above.
2019-06-28 22:36:37 +03:00
If you want to build v.exe on Windows without WSL, you can use MinGW-w64 or Visual Studio.
2019-06-28 22:37:22 +03:00
#### MinGW-w64
2019-06-28 22:36:37 +03:00
2019-07-04 13:36:42 +03:00
[Download ](https://downloads.sourceforge.net/project/mingw-w64/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/installer/mingw-w64-install.exe?r=&ts=1561736169&use_mirror=gigenet ) and install MinGW-w64. I recommend installing it in `C:/mingw-w64` .
2019-06-28 22:36:37 +03:00
2019-07-04 13:36:42 +03:00
Make sure the `C:/mingw-w64/bin` directory is in system's PATH, verify that by running `gcc` in your terminal.
2019-06-28 22:36:37 +03:00
```bash
# You can clone V anywhere
git clone https://github.com/vlang/v
2019-06-29 17:52:36 +03:00
cd v
2019-06-28 22:36:37 +03:00
# Download the V compiler's source translated to C
2019-06-29 17:54:22 +03:00
curl -O https://raw.githubusercontent.com/vlang/vc/master/v.c
2019-06-28 22:36:37 +03:00
gcc -std=gnu11 -w -o v.exe v.c # Build it with GCC
2019-07-04 03:50:33 +03:00
v.exe -o v2.exe compiler # Use V to build itself to make sure it works
2019-06-28 22:36:37 +03:00
```
2019-06-22 21:22:41 +03:00
2019-07-04 13:36:42 +03:00
#### Visual Studio
Download and install Visual Studio. The community edition will suffice. In the installer select `Visual Studio core editor` , `Desktop development with C++` , and `Windows 10 SDK` .
[Download ](https://github.com/llvm/llvm-project/releases/download/llvmorg-7.1.0/LLVM-7.1.0-win32.exe ) and install Clang. The installer is ~130 MB. It will use Visual Studio's libraries and linker, but the compiler has to be Clang. V can't be compiled with Microsoft's C compiler. Make sure you check `Add Clang to PATH` when installing it.
```bash
# You can clone V anywhere
git clone https://github.com/vlang/v
cd v
# Download the V compiler's source translated to C
curl -O https://raw.githubusercontent.com/vlang/vc/master/v.c
clang -m32 -w -o v.exe v.c # Build it with Clang
```
If your Windows version doesn't have `curl` installed, you can install it, or simply download the `v.c` file via a browser.
2019-06-22 21:22:41 +03:00
### Testing
```
2019-06-26 18:58:59 +03:00
$ cd examples
$ v run hello_world.v
hello world
2019-06-22 21:22:41 +03:00
2019-06-26 18:58:59 +03:00
$ v
2019-06-30 16:26:03 +03:00
V 0.1.x
2019-06-22 21:22:41 +03:00
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
```
2019-06-26 19:04:10 +03:00
v hello_world.v & & ./hello_world # or simply
v run hello_world.v # this builds the program and runs it right away
2019-06-22 21:22:41 +03:00
v word_counter.v & & ./word_counter cinderella.txt
2019-06-24 18:13:02 +03:00
v run news_fetcher.v
2019-06-23 17:13:56 +03:00
v run tetris.v
2019-06-22 21:22:41 +03:00
```
2019-06-23 17:16:55 +03:00
< img src = 'https://raw.githubusercontent.com/vlang/v/master/examples/tetris/screenshot.png' width = 300 >
2019-06-22 21:22:41 +03:00
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.
```
2019-06-26 19:04:10 +03:00
macOS:
brew install glfw freetype curl
2019-06-25 21:48:34 +03:00
2019-06-22 21:22:41 +03:00
Ubuntu:
2019-06-24 05:35:15 +03:00
sudo apt install libglfw3 libglfw3-dev libfreetype6-dev libcurl3-dev
2019-06-22 21:22:41 +03:00
2019-06-26 19:04:10 +03:00
Arch:
sudo pacman -S glfw-x11 curl freetype2
2019-06-22 21:22:41 +03:00
```
2019-06-24 19:53:22 +03:00
glfw and libcurl dependencies will be removed soon.