setup-zig/README.md
2020-11-11 12:40:03 +01:00

59 lines
1.3 KiB
Markdown

# setup-zig
Use the zig compiler in your Github Actions workflows
[Usage](#usage) - [License: Apache-2.0](#license)
## Usage
In a Github Actions workflow file, do something like:
```yaml
jobs:
test:
strategy:
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
runs-on: ${{matrix.os}}
steps:
- uses: actions/checkout@v2
- uses: goto-bus-stop/setup-zig@v1
- run: zig build test
lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: goto-bus-stop/setup-zig@v1
- run: zig fmt --check src/*.zig
```
Optionally set a Zig version:
```yaml
- uses: goto-bus-stop/setup-zig@v1
with:
version: 0.7.0 # The default is 0.5.0
```
To use the nightly builds, set:
```yaml
- uses: goto-bus-stop/setup-zig@v1
with:
version: master
```
Or [pin to a specific commit](https://github.com/goto-bus-stop/setup-zig/issues/13) using `version+commithash` syntax:
```yaml
- uses: goto-bus-stop/setup-zig@v1
with:
version: 0.6.0+4b48fccad
```
If you are running Zig on Windows machines, you need to make sure that your .zig files use \n line endings and not \r\n. The `actions/checkout` action auto-converts line endings to `\r\n` on Windows runners, so add a `.gitattributes` file:
```
*.zig text eol=lf
```
## License
[Apache-2.0](LICENSE.md)