🏠 > Технології

Zig

Зміст:
  1. З чого почати
    1. Для користувачів Vim
  2. Корисні посилання
    1. Для самостійного навчання
  3. Як скомпілювати С програму
  4. Налаштування Neovim
  5. Як встановити гру Tetris на Void Linux [Zig 0.13.0]
  6. Як злінкувати програму з системною бібліотекою [Zig 0.15.2]
  7. stdout
  8. stdin

З чого почати

"$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,
який аварійно завершує роботу при невизначеній поведінці.

Налаштування Neovim

astro-nvim

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

Як встановити гру Tetris на Void Linux [Zig 0.13.0]

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

Як злінкувати програму з системною бібліотекою [Zig 0.15.2]

Зазвичай залежності, прописані в 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

stdout

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

Для читання 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();
}


Побудовано за допомогою Eleventy