feat: process-per-connection architecture with full proxy support

.github/workflows/erlang.yml

@@ -7,54 +7,113 @@ on:
   pull_request:
     branches:
       - master
+
+permissions:
+  contents: read
+
 jobs:
-  ci:
-    name: Run checks and tests over ${{matrix.otp_vsn}} and ${{matrix.os}}
-    runs-on: ${{matrix.os}}
+  # Linux x86_64 - main CI
+  linux:
+    name: Linux x86_64 OTP-${{matrix.otp}}
+    runs-on: ubuntu-latest
     strategy:
       matrix:
-        otp: ["27.3", "28.0"]
-        rebar3: ['3.25.0']
-        os: [ubuntu-22.04]
+        otp: ["27.2", "28.0"]
+        rebar3: ['3.24.0']
     steps:
       - uses: actions/checkout@v4
+        with:
+          submodules: recursive
       - uses: erlef/setup-beam@v1
         with:
           otp-version: ${{matrix.otp}}
           rebar3-version: ${{matrix.rebar3}}
       - uses: awalsh128/cache-apt-pkgs-action@latest
         with:
-          packages: python3 python3-httpbin python3-pip
+          packages: python3 python3-httpbin python3-pip cmake golang
           version: 1.1
       - run: |
           pip3 install gunicorn
           gunicorn -b 127.0.0.1:8000 -b unix:httpbin.sock httpbin:app&
       - run: rebar3 xref
       - run: rebar3 eunit
       - run: rebar3 dialyzer
-  legacy:
-    name: Run checks and tests over ${{matrix.otp_vsn}} and ${{matrix.os}}
-    runs-on: ${{matrix.os}}
+
+  # Linux ARM64
+  linux-arm64:
+    name: Linux ARM64 OTP-${{matrix.otp}}
+    runs-on: ubuntu-24.04-arm
     strategy:
       matrix:
-        otp: ["24.3", "25.3", "26.2"]
-        rebar3: ['3.22.1']
-        os: [ubuntu-22.04]
+        otp: ["27.2"]
+        rebar3: ['3.24.0']
     steps:
       - uses: actions/checkout@v4
+        with:
+          submodules: recursive
       - uses: erlef/setup-beam@v1
         with:
           otp-version: ${{matrix.otp}}
           rebar3-version: ${{matrix.rebar3}}
       - uses: awalsh128/cache-apt-pkgs-action@latest
         with:
-          packages: python3 python3-httpbin python3-pip
+          packages: cmake golang
           version: 1.1
-      - run: |
-          pip3 install gunicorn
-          gunicorn -b 127.0.0.1:8000 -b unix:httpbin.sock httpbin:app&
       - run: rebar3 xref
       - run: rebar3 eunit
-      - run: rebar3 dialyzer
 
+  # macOS ARM64 (Apple Silicon)
+  macos:
+    name: macOS ARM64 OTP-${{matrix.otp}}
+    runs-on: macos-15
+    strategy:
+      matrix:
+        otp: ["27"]
+        rebar3: ['3.24.0']
+    steps:
+      - name: Install Erlang and Go
+        env:
+          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: "1"
+        run: |
+          brew update
+          brew install erlang@${{ matrix.otp }} go
+          echo "$(brew --prefix erlang@${{ matrix.otp }})/bin" >> $GITHUB_PATH
+      - name: Install rebar3
+        run: |
+          wget https://github.com/erlang/rebar3/releases/download/${{ matrix.rebar3 }}/rebar3 && chmod +x rebar3
+          sudo mv rebar3 /usr/local/bin/ && sudo chmod +x /usr/local/bin/rebar3
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - run: make test
+
+  # FreeBSD
+  freebsd:
+    name: FreeBSD 14.2 OTP-28
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - name: Test on FreeBSD
+        uses: vmactions/freebsd-vm@v1
+        with:
+          release: "14.2"
+          usesh: true
+          prepare: |
+            pkg install -y erlang-runtime28 rebar3 cmake git gmake go llvm18
+          run: |
+            # Ensure Erlang 28 is in PATH
+            export PATH="/usr/local/lib/erlang28/bin:$PATH"
+            echo "Erlang version:"
+            erl -eval 'erlang:display(erlang:system_info(otp_release)), halt().' -noshell
+            echo "Architecture:"
+            uname -m
+            # Use LLVM 18 clang which fully supports C++20
+            export CC=/usr/local/bin/clang18
+            export CXX=/usr/local/bin/clang++18
+            echo "Using CC=$CC CXX=$CXX"
+            $CXX --version
+            git config --global --add safe.directory $GITHUB_WORKSPACE
+            rebar3 eunit
 

.gitignore

@@ -11,3 +11,7 @@ mime.types
 *.plt
 *_plt
 rebar3.crashdump
+.aider*
+doc/
+priv/*.so
+priv/*.dll

CONTRIBUTING.md

@@ -0,0 +1,112 @@
+# Contributing to hackney
+
+Thank you for your interest in contributing to hackney!
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/hackney.git`
+3. Create a branch: `git checkout -b my-feature`
+4. Make your changes
+5. Run tests: `rebar3 eunit`
+6. Push and open a pull request
+
+## Pull Request Guidelines
+
+### Title Format
+
+We use [Conventional Commits](https://www.conventionalcommits.org/) for PR titles:
+
+```
+<type>: <description>
+```
+
+**Types:**
+
+| Type | Description |
+|------|-------------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `docs` | Documentation only |
+| `refactor` | Code change that neither fixes a bug nor adds a feature |
+| `perf` | Performance improvement |
+| `test` | Adding or updating tests |
+| `chore` | Maintenance tasks, dependencies |
+| `security` | Security fix |
+
+**Examples:**
+
+- `feat: add HTTP/3 connection pooling`
+- `fix: handle timeout in async responses`
+- `docs: update WebSocket guide`
+- `refactor: simplify connection state machine`
+- `perf: reduce memory allocation in header parsing`
+- `security: update SSL certificate bundle`
+
+### Description
+
+Include in your PR description:
+
+- **What** the change does
+- **Why** the change is needed
+- **How** to test it (if applicable)
+
+## Development Setup
+
+### Requirements
+
+- Erlang/OTP 27+
+- rebar3
+
+### Building
+
+```sh
+rebar3 compile
+```
+
+### Building with QUIC support
+
+QUIC/HTTP3 requires lsquic and BoringSSL (vendored in `c_src/`):
+
+```sh
+HACKNEY_QUIC_OPTS="-DCMAKE_BUILD_TYPE=Release" rebar3 compile
+```
+
+### Running Tests
+
+```sh
+# All tests
+rebar3 eunit
+
+# Specific test module
+rebar3 eunit --module=hackney_conn_tests
+
+# With verbose output
+rebar3 eunit --verbose
+```
+
+### Running Dialyzer
+
+```sh
+rebar3 dialyzer
+```
+
+## Code Style
+
+- Follow existing code conventions
+- Keep functions short and focused
+- Add specs for exported functions
+- Update documentation for API changes
+
+## Reporting Issues
+
+When reporting bugs, include:
+
+- Erlang/OTP version (`erl -version`)
+- hackney version
+- Minimal reproduction case
+- Expected vs actual behavior
+
+## Questions?
+
+Open an issue or reach out to the maintainers.