liza

Zig codebase initializer.

Usage

Executable

• Build from source:

git clone https://codeberg.org/tensorush/liza.git
cd liza/
zig build run -- -h

• Download latest release:

wget https://github.com/tensorush/liza/releases/latest/download/<archive>
tar -xf <archive> # Unix
unzip <archive> # Windows
./<binary> -h

Features

• Zig Executable Template (exe):

  • Public API module creation.
  • Dependency package usage.
  • Build steps:
    • install (default):
      • Zig executable installation.
      • Common build steps execution (see below).
    • run: Zig executable run.
    • release: Release binaries' installation and archiving.
    • Optional build steps (see below).

• Zig Library Template (lib):

  • Public root module creation.
  • Build steps:
    • install (default):
      • Zig static library installation.
      • Common build steps execution (see below).
    • run: Example suite execution.
    • Optional build steps (see below).

• Zig Build Template (bld):

  • Public Translate-C module creation.
  • Lazy dependency package usage.
  • Configuration option usage.
  • Build steps:
    • install (default):
      • C/C++ static library installation.
      • Common build steps execution (see below).

• Common Build Steps:

  • test: Test suite execution.
  • fmt: Formatting check execution.

• Optional Build Steps:

  • doc ($d): Documentation emission (--add-doc).
  • cov ($c): Code coverage generation (--add-cov).
  • check ($k): Compilation check for ZLS Build-On-Save (--add-check).

• GitHub / Forgejo / Woodpecker CI Workflow Template Jobs:

  • install:
    • Main artifacts' installation.
    • test: Test suite execution.
    • fmt: Formatting check execution.
    • (GitHub-only) cov ($c): Code coverage publication to Codecov (--add-cov).

• GitHub / Forgejo / Woodpecker CD Workflow Template Jobs:

  • (exe-/lib-only) emit→deploy: Documentation emission and deployment to GitHub Pages or Codeberg Pages (--add-doc):
    • (Woodpecker-only) Generate Codeberg access token with repository:write permission and add it as TOKEN secret available on Push event.
    • (Woodpecker-only) Add email as EMAIL secret available on Push event.

• GitHub / Woodpecker Release Workflow Jobs:

  • (exe-only) release: Release publication using minisign:
    • Generate key pair without password: minisign -GW.
    • Add ./minisign.pub as MINISIGN_PUBLIC_KEY secret (available on Tag event in Woodpecker).
    • Add ~/.minisign/minisign.key as MINISIGN_SECRET_KEY secret (available on Tag event in Woodpecker).
    • (Woodpecker-only) Generate Codeberg access token with misc:read and repository:write permissions and add it as TOKEN secret available to woodpeckerci/plugin-release on Tag event.

• MIT License Template:

  • $y: Current year.
  • $n: User name.

• .gitignore Template:

  • $c: Code coverage artifacts (--add-cov).

• .gitattributes.