"$HOME/.local/bin" має стояти в $PATH. Для NixOS/home-manager:
home.sessionPath = [ "$HOME/.local/bin" ];
Качаємо бінарник anyzig з https://marler8997.github.io/anyzig/.
Розпаковуємо його в ~/.local/bin.
mkdir -p ~/.local/bin
tar -xf anyzig-*.tar.* -C ~/.local/bin
chmod +x ~/.local/bin/zig
zig any version
zig 0.16.0 version # first run downloads Zig 0.16.0 into the cache
zig any list-installed
Встановлюємо anyzls:
mkdir -p ~/src
git clone https://codeberg.org/knightpp/anyzls ~/src/anyzls
cd ~/src/anyzls
zig build --release=safe
cp zig-out/bin/anyzls ~/.local/bin/zls
Для нового (hello) проєкту вказуємо версію (zig 0.16.0 init), оскільки вона ще не прописана у файлі build.zig.zon:
mkdir -p ~/src/hello && cd ~/src/hello
zig 0.16.0 init
zig build run
zls --version
Відтепер можемо використовувати в командах просто zig. Потрібна версія підтягнеться з build.zig.zon файлу.
Vim На NixOS ставимо плаґіни:
programs.vim = {
enable = true;
plugins = with pkgs.vimPlugins; [ zig-vim vim-lsp ];
extraConfig = ''
augroup zls_setup
au!
if executable('zls')
au User lsp_setup call lsp#register_server({
\ 'name': 'zls',
\ 'cmd': {server_info->['zls']},
\ 'allowlist': ['zig'],
\ })
endif
augroup END
function! s:on_lsp_buffer_enabled() abort
setlocal omnifunc=lsp#complete
setlocal signcolumn=yes
nmap <buffer> gd <plug>(lsp-definition)
nmap <buffer> K <plug>(lsp-hover)
nmap <buffer> gr <plug>(lsp-references)
nmap <buffer> <leader>rn <plug>(lsp-rename)
endfunction
augroup lsp_install
au!
autocmd User lsp_buffer_enabled call s:on_lsp_buffer_enabled()
augroup END
let g:zig_fmt_autosave = 1
'';
...
}
Для полегшення роботи з різними версіями Zig:
https://marler8997.github.io/anyzig/
Для полегшення роботи з різними версіями Zls:
https://codeberg.org/knightpp/anyzls/
Заповнювачі виводу:
https://ziglang.org/documentation/0.15.2/std/#std.Io.Writer.print
Книга Педро:
https://pedropark99.github.io/zig-book/Chapters/01-zig-weird.html
Документація мови:
https://ziglang.org/documentation/0.15.2/
Документація стандартної бібліотеки:
https://ziglang.org/documentation/0.15.2/std/
Навчання на основі виправлення помилок:
https://codeberg.org/ziglings/exercises
Туторіал по Зіґ:
https://sonicfromnewyoke.github.io/learning-zig-ukr/
Оригінал тут: https://www.openmymind.net/learning_zig/
TODO: https://www.openmymind.net/TCP-Server-In-Zig-Part-1-Single-Threaded/
zig 0.16.0 cc -mcpu=baseline -mtune=baseline -fsanitize=undefined -fsanitize-trap=undefined -target x86_64-linux-musl -g -o zig.out main.c
Команда вище вмикає UBSan (Undefined Behaviour Sanitizer),
створює повністю статичний, відладоподібний виконуваний файл x86-64 для Linux,
який аварійно завершує роботу при невизначеній поведінці.
sudo xbps-install -S neovim
vim .bashrc
alias nv="nvim"
mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak
mv ~/.local/state/nvim ~/.local/state/nvim.bak
mv ~/.cache/nvim ~/.cache/nvim.bak
git clone --depth 1 https://github.com/AstroNvim/template ~/.config/nvim
rm -rf ~/.config/nvim/.git
nvim
:LspInstall zls
:TSInstall zig
:DapInstall codelldb
Manage plugins
:Lazy check
:Lazy update
:Lazy clean
:Lazy sync
:AstroUpdate
https://github.com/andrewrk/tetris
Встановлюємо основні залежності:
sudo xbps-install -Su zig libX11-devel MesaLib-devel glfw-devel
Встановлюємо libepoxy:
git clone git@github.com:anholt/libepoxy.git
cd libepoxy
mkdir _build && cd _build
meson
ninja
sudo ninja install
Вже після написання статті побачив, що libepoxy є в репозиторії Void, тому можете пробувати також sudo xbps-install -Su libepoxy.
Відповідно, залежності libX11-devel та MesaLib-devel вище можуть бути непотрібними, але це не точно:
sudo xbps-install -Su zig libepoxy glfw-devel
Встановлюємо tetris:
git clone git@github.com:andrewrk/tetris.git
Патчимо його під версію Zig 0.13, яка (поки що) за замовчуванням постачається Void.
На версії Zig 0.15 цього, мабуть, вже не доведеться робити, не перевіряв.
cd tetris
build.zig:
const exe = b.addExecutable(.{
.name = "tetris",
.root_source_file = b.path("src/main.zig"),
.optimize = optimize,
.target = target,
});
src/main.zig:
---callconv(.c)
+++callconv(.C)
Запускаємо:
zig build play
Зазвичай залежності, прописані в build.zig.zon, будуть компілюватися при запуску zig build.
Але якщо вам потрібно не компілювати залежності, а тільки підключити їх з системи, то можна додати рядок exe.linkSystemLibrary("ІМ'Я-БІБЛІОТЕКИ"); у файлі build.zig після об’явлення змінної exe.
Звісно, бібліотека має бути встановлена перед цим.
Наприклад, нас цікавить бібліотека SDL3, яка є залежністю для dvui.
Встановлюємо обидва пакети SDL3 та SDL3-devel:
sudo xbps-install -S SDL3 SDL3-devel
У файлі build.zig.zon маємо тільки згадку dvui:
.dependencies = .{
.dvui = .{
.url = "...",
.hash = "...",
},
},
Тоді у файлі build.zig після:
const exe = b.addExecutable(.{
...
});
дописуємо:
exe.linkSystemLibrary("SDL3");
І zig build має злінкувати системну бібліотеку:
$ zig build
[3] Compile Build Script
├─ [2375/9753] Linking
├─ [2371/2920] Code Generation
└─ [12406] Semantic Analysis
└─ meta.stringToEnum__anon_84415
std.debug.print() пише в stderr. А для того, аби писати в stdout, потрібно створити writer та взяти в нього interface:
const std = @import("std");
pub fn main(init: std.process.Init) !void {
const stdout = std.Io.File.stdout();
var out_buf: [4096]u8 = undefined;
var file_writer = std.Io.File.writer(stdout, init.io, &out_buf);
const output = &file_writer.interface;
try output.print("Hello, World!\n", .{});
try output.flush();
}
Для читання stdin можна використати takeDelimiter, тоді рядок читатиметься до обраного вами розподільника:
const std = @import("std");
pub fn main(init: std.process.Init) !void {
const stdout = std.Io.File.stdout();
var out_buf: [4096]u8 = undefined;
var file_writer = std.Io.File.writer(stdout, init.io, &out_buf);
const output = &file_writer.interface;
const stdin = std.Io.File.stdin();
var in_buf: [4096]u8 = undefined;
var file_reader = std.Io.File.reader(stdin, init.io, &in_buf);
const input = &file_reader.interface;
while (try input.takeDelimiter('\n')) |line| {
try output.print("{s}\n", .{line});
}
try output.flush();
}