initial commit

Author: Techatrix

.gitattributes

@@ -0,0 +1,2 @@
+*.zig text eol=lf
+*.zon text eol=lf

.github/workflows/ci.yaml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+  workflow_dispatch:
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        zig-version: [0.14.0]
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Zig
+        uses: mlugg/setup-zig@v1
+        with:
+          version: ${{ matrix.zig-version }}
+
+      - name: Check Formatting
+        run: zig fmt --ast-check --check .
+
+      - name: Build (Windows)
+        if: matrix.os == 'windows-latest'
+        run: zig build -Dlibpsl=false -Dlibssh2=false -Dlibidn2=false -Dnghttp2=false --summary all
+
+      - name: Build (MacOS)
+        if: matrix.os == 'macos-latest'
+        run: zig build -Duse-openssl=false -Dlibpsl=false -Dlibssh2=false -Dlibidn2=false -Dnghttp2=false --summary all
+
+      - name: Build (Linux)
+        if: matrix.os == 'ubuntu-latest'
+        run: zig build -Dlibpsl=false -Dlibssh2=false -Dlibidn2=false -Dnghttp2=false -Ddisable-ldap --summary all

.gitignore

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

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (Expat)
+
+Copyright (c) contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,77 @@
+[![CI](https://github.com/allyourcodebase/curl/actions/workflows/ci.yaml/badge.svg)](https://github.com/allyourcodebase/curl/actions)
+
+# curl
+
+This is [curl](https://github.com/curl/curl), packaged for [Zig](https://ziglang.org/).
+
+## Installation
+
+> [!WARNING]
+>
+> Curl depends on https://github.com/allyourcodebase/openssl which currently doesn't work on macOS. Consider using a different openssl implementation.
+
+### Standalone library (libcurl) and command-line tool (curl)
+
+```bash
+git clone https://github.com/allyourcodebase/curl
+cd curl
+zig build -Doptimize=ReleaseFast
+```
+
+The library and CLI tool can be found in the newly created `./zig-out` directory. The `zig build run` build step may be used to directly run curl.
+
+#### Avoid system dependencies
+
+By default, curl requires some system dependencies that have not been ported to the zig build system yet. These dependencies may be either manually installed on the host system or disabled with the following build command:
+
+```bash
+# Windows
+zig build -Doptimize=ReleaseFast -Dlibpsl=false -Dlibssh2=false -Dlibidn2=false -Dnghttp2=false
+# Posix
+zig build -Doptimize=ReleaseFast -Dlibpsl=false -Dlibssh2=false -Dlibidn2=false -Dnghttp2=false -Ddisable-ldap
+```
+
+### Zig Build System
+
+First, update your `build.zig.zon`:
+
+```
+# Initialize a `zig build` project if you haven't already
+zig init
+zig fetch --save git+https://github.com/allyourcodebase/curl.git
+```
+
+You can then import curl in your `build.zig` with:
+
+```zig
+const curl_dependency = b.dependency("curl", .{
+    .target = target,
+    .optimize = optimize,
+});
+
+// A custom `artifact` function is provided because the build system
+// provides no way to differentiate between the library (libcurl) and
+// the command-line tool (curl) since they are both named "curl" in
+// the build system.
+// See https://github.com/ziglang/zig/issues/20377
+const curlExe = @import("curl").artifact(curl_dependency, .exe);
+const libCurl = @import("curl").artifact(curl_dependency, .lib);
+
+your_exe.root_module.linkLibrary(libCurl);
+```
+
+#### Avoid system dependencies
+
+By default, curl requires some system dependencies that have not been ported to the zig build system yet. These dependencies may be either manually installed on the host system or disabled with the following change to the `build.zig`:
+
+```zig
+const curl_dependency = b.dependency("curl", .{
+    .target = target,
+    .optimize = optimize,
+    .libpsl = false,
+    .libssh2 = false,
+    .libidn2 = false,
+    .nghttp2 = false,
+    .disable-ldap = true,
+});
+```