build: support 0.15.0-dev

addStaticLibrary -> addLibrary
target and optimize are now in a module

.github/workflows/ci.yaml

@@ -2,8 +2,6 @@ name: CI
 
 on:
   push:
-    branches:
-      - master
   pull_request:
     branches:
       - master
@@ -14,25 +12,30 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        zig-version: [master]
-        os: [ubuntu-latest, macos-latest, windows-latest]
+        zig-version: ["0.14.1"]
+        os: [macos-latest, windows-latest]
         include:
-          - zig-version: "0.12.1"
+          - zig-version: "0.14.1"
+            check-format: true
             os: ubuntu-latest
-          - zig-version: "0.13.0"
+            build-options: "-Dbuild-apps"
+
+          - zig-version: "master"
             os: ubuntu-latest
+
     runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
       - name: Setup Zig
-        uses: mlugg/setup-zig@v1
+        uses: mlugg/setup-zig@v2
         with:
           version: ${{ matrix.zig-version }}
 
-      - name: Check Formatting
+      - if: ${{ matrix.check-format }}
+        name: Check Formatting
         run: zig fmt --ast-check --check .
 
       - name: Build
-        run: zig build --summary all
+        run: zig build ${{ matrix.build-options }} --summary all

.gitignore

@@ -0,0 +1,2 @@
+.zig-cache
+zig-out

build.zig.zon

@@ -1,11 +1,12 @@
 .{
-    .name = "libressl",
-    .version = "3.9.2",
-    .minimum_zig_version = "0.12.0",
+    .name = .libressl,
+    .fingerprint = 0x203FA82BE0954AFA,
+    .version = "4.0.0",
+    .minimum_zig_version = "0.14.0",
     .dependencies = .{
         .libressl = .{
-            .url = "https://github.com/libressl/portable/releases/download/v3.9.2/libressl-3.9.2.tar.gz",
-            .hash = "1220713b293eab87698edf5d6b9bbacf6c17684e65c42da2ad00da6e7e9cf1df5517",
+            .url = "https://github.com/libressl/portable/releases/download/v4.0.0/libressl-4.0.0.tar.gz",
+            .hash = "N-V-__8AAGvDTQHGV38aqRN9PCALgEg4_XExU4juxdTJMTVQ",
         },
     },
     .paths = .{
@@ -13,6 +14,6 @@
         "build.zig.zon",
         "LICENSE",
         "LICENSE-LIBRESSL",
-        "README.md",
+        "readme.md",
     },
 }

readme.md

@@ -2,22 +2,45 @@
 
 This is [LibreSSL Portable](https://github.com/libressl/portable), packaged for [Zig](https://ziglang.org/).
 
-## Installation
+## Status
+
+This project currently builds the three main LibreSSL libraries as static libraries:
+
+- `libcrypto`: core cryptographic routines
+- `libssl`: OpenSSL 1.1 compatibility layer
+- `libtls`: LibreSSL's new cryptography API
+
+Operating systems and hardware architectures are supported on a best-effort basis, and patches to add additional OS/arch support are welcome. Building for Linux (`x86_64`), macOS (`aarch64`), and Windows (`x86_64` via `mingw64`) is directly tested by CI.
+
+The command-line programs `nc`, `ocspcheck`, and `openssl` are not built by default, and building them when targeting Windows is not supported. Building the command-line programs may be enabled by specifing the `-Dbuild-apps` option to `zig build`
+
+## Usage
 
 First, update your `build.zig.zon`:
 
-```
+```sh
 # Initialize a `zig build` project if you haven't already
 zig init
-zig fetch --save <PLACEHOLDER>
+# replace <refname> with the version you want to use, e.g. 4.0.0
+zig fetch --save git+https://github.com/allyourcodebase/libressl#<refname>
 ```
 
-You can then import `libressl` in your `build.zig` with:
+You can then use `libressl` in your `build.zig` as follows:
 
 ```zig
 const libressl_dependency = b.dependency("libressl", .{
     .target = target,
     .optimize = optimize,
+    .@"enable-asm" = true, // enable assembly routines on supported platforms
 });
-your_exe.linkLibrary(libressl_dependency.artifact("tls"));
+your_exe.linkLibrary(libressl_dependency.artifact("tls")); // or "ssl", or "crypto"
 ```
+
+## Zig Version Support Matrix
+
+| Refname   | LibreSSL Version | Zig `0.15.0-dev` | Zig `0.14.x` | Zig `0.13.x` | Zig `0.12.x` |
+|-----------|------------------|------------------|--------------|--------------|--------------|
+| `4.0.0+3` | `4.0.0`          | ✅               | ✅           | ❌           | ❌           |
+| `4.0.0+2` | `4.0.0`          | ❌               | ✅           | ❌           | ❌           |
+| `4.0.0+1` | `4.0.0`          | ❌               | ❌           | ✅           | ✅           |
+| `3.9.2+1` | `3.9.2`          | ❌               | ❌           | ✅           | ✅           |