{"id":14990817,"url":"https://github.com/tensorush/liza","last_synced_at":"2025-04-12T03:24:33.690Z","repository":{"id":226282219,"uuid":"768258978","full_name":"tensorush/liza","owner":"tensorush","description":"Command-line Zig codebase initializer.","archived":false,"fork":false,"pushed_at":"2025-04-07T18:37:41.000Z","size":242,"stargazers_count":26,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-07T19:39:58.541Z","etag":null,"topics":["zig-package"],"latest_commit_sha":null,"homepage":"https://codeberg.org/tensorush/liza","language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tensorush.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-06T18:55:03.000Z","updated_at":"2025-04-07T18:37:45.000Z","dependencies_parsed_at":"2024-03-20T22:26:27.697Z","dependency_job_id":"060d9627-f324-49e3-9afd-0d8446dd617c","html_url":"https://github.com/tensorush/liza","commit_stats":{"total_commits":47,"total_committers":1,"mean_commits":47.0,"dds":0.0,"last_synced_commit":"79847af6ccb93df42bd6b91b29ae695b44ad871f"},"previous_names":["tensorush/liza"],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorush%2Fliza","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorush%2Fliza/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorush%2Fliza/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorush%2Fliza/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tensorush","download_url":"https://codeload.github.com/tensorush/liza/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248511067,"owners_count":21116345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["zig-package"],"created_at":"2024-09-24T14:20:54.388Z","updated_at":"2025-04-12T03:24:33.676Z","avatar_url":"https://github.com/tensorush.png","language":"Zig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# liza\n\n## Command-line Zig codebase initializer.\n\n### Usage\n\n#### Executable\n\n- Build from source:\n\n```sh\ngit clone https://codeberg.org/tensorush/liza.git\ncd liza/\nzig build exe -- -h\n```\n\n- Download latest release:\n\n```sh\nwget https://github.com/tensorush/liza/releases/latest/download/\u003carchive\u003e\ntar -xf \u003carchive\u003e # Unix\nunzip \u003carchive\u003e # Windows\n./\u003cbinary\u003e -h\n```\n\n#### Module\n\n1. Add `liza` dependency to `build.zig.zon`:\n\n```sh\nzig fetch --save git+https://codeberg.org/tensorush/liza.git\n```\n\n2. Use `liza` dependency in `build.zig`:\n\n```zig\nconst liza_dep = b.dependency(\"liza\", .{\n    .target = target,\n    .optimize = optimize,\n});\nconst liza_mod = liza_dep.module(\"liza\");\n\u003cstd.Build.Step.Compile\u003e.root_module.addImport(\"liza\", liza_mod);\n```\n\n### Features\n\n- #### [Zig Executable Template (`exe`)](src/templates/exe/):\n    - Public API module creation.\n    - Dependency package usage.\n    - [Build steps](src/templates/exe/build.zig):\n        - `install` (default):\n            - Zig executable installation.\n            - Common steps execution (see below).\n            \u003c!-- - Common steps execution, except for `tag` (see below). --\u003e\n            - Common optional steps execution, except for `check` (see below).\n        - `run`: Zig executable run.\n        - `release`: Release binaries' installation and archiving.\n\n- #### [Zig Library Template (`lib`)](src/templates/lib/):\n    - Public root module creation.\n    - [Build steps](src/templates/lib/build.zig):\n        - `install` (default):\n            - Zig static library installation.\n            - Example suite installation.\n            - Common steps execution (see below).\n            \u003c!-- - Common steps execution, except for `tag` (see below). --\u003e\n            - Common optional steps execution, except for `check` (see below).\n        - `run`: Example run.\n\n- #### [Zig Build Template (`bld`)](src/templates/bld/):\n    - Public Translate-C module creation.\n    - Lazy dependency package usage.\n    - Configuration option usage.\n    - [Build steps](src/templates/bld/build.zig):\n        - `install` (default):\n            - C/C++ static library installation.\n            - Common steps execution (see below).\n            \u003c!-- - Common steps execution, except for `tag` (see below). --\u003e\n\n- #### [Mach Application Template (`app`)](src/templates/app/):\n    - [WGSL](https://www.w3.org/TR/WGSL/) shader usage.\n    - [Build steps](src/templates/app/build.zig):\n        - `install` (default):\n            - [Mach](https://machengine.org/) executable installation.\n            - Common steps execution (see below).\n            \u003c!-- - Common steps execution, except for `tag` (see below). --\u003e\n        - `run`: [Mach](https://machengine.org/) executable run.\n\n- #### Common Build Steps:\n    - `test`: Test suite execution.\n    - `fmt`: Formatting check execution.\n    \u003c!-- - `mzv`: Minimum Zig version update.\n    - `tag`: Next version tag. --\u003e\n\n- #### Common Optional Build Steps:\n    - `doc` (`$d`): Documentation emission (`--add-doc`).\n    - `cov` (`$c`): Code coverage generation (`--add-cov`).\n    - `check` (`$s`): Compilation check for [ZLS Build-On-Save](https://zigtools.org/zls/guides/build-on-save/) (`--add-check`).\n\n- #### [GitHub](src/templates/.github/workflows/ci.yaml) / [Forgejo](src/templates/.forgejo/workflows/ci.yaml) / [Woodpecker](src/templates/.woodpecker/ci.yaml) CI Workflow Template:\n    - `run`/`example`/`lib`/`exe` (`$s`): either `exe`'s executable run, `lib`'s example suite execution, `bld`'s library installation, or `app`'s executable installation.\n    - `test`: Test suite execution and either `exe`'s or `lib`'s GitHub-only code coverage publication to [Codecov](https://docs.codecov.com/docs/github-2-getting-a-codecov-account-and-uploading-coverage#install-the-github-app-integration) (`--add-cov`).\n    - `fmt`: Formatting check execution.\n\n- #### [GitHub](src/templates/.github/workflows/cd.yaml) / [Forgejo](src/templates/.forgejo/workflows/cd.yaml) / [Woodpecker](src/templates/.woodpecker/cd.yaml) CD Workflow Template (`--add-doc`):\n    - `emit`→`deploy`: either `exe`'s or `lib`'s documentation emission and deployment to [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow) or [Codeberg Pages](https://codeberg.page):\n        - (Woodpecker-only) [Generate Codeberg access token](https://docs.codeberg.org/advanced/access-token/) with `repository:write` permission and add it as `TOKEN` secret available on `Push` event.\n        - (Woodpecker-only) Add email as `EMAIL` secret available on `Push` event.\n\n- #### [GitHub](src/templates/.github/workflows/release.yaml) / [Woodpecker](src/templates/.woodpecker/release.yaml) Release Workflow:\n    - `release`: `exe`'s release publication using [`minisign`](https://jedisct1.github.io/minisign/):\n      - Generate key pair without password: `minisign -GW`.\n      - Add `./minisign.pub` as `MINISIGN_PUBLIC_KEY` secret (available on `Tag` event in Woodpecker).\n      - Add `~/.minisign/minisign.key` as `MINISIGN_SECRET_KEY` secret (available on `Tag` event in Woodpecker).\n      - (Woodpecker-only) [Generate Codeberg access token](https://docs.codeberg.org/advanced/access-token/) with `misc:read` and `repository:write` permissions and add it as `TOKEN` secret available to `woodpeckerci/plugin-release` on `Tag` event.\n\n- #### [MIT License Template](src/templates/LICENSE):\n    - `$y`: Current year.\n    - `$n`: User name.\n\n- #### [`.gitignore` Template](src/templates/.gitignore):\n    - `$c`: Code coverage artifacts.\n\n- #### [`.gitattributes`](src/templates/.gitattributes).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftensorush%2Fliza","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftensorush%2Fliza","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftensorush%2Fliza/lists"}