feat: added base structure ws(websocket) functionality (#13)

.dockerignore

@@ -0,0 +1,18 @@
+.git
+.github
+.out
+.build
+*.tar.gz
+libchttpx-dev
+libchttpx.so
+*.dll
+*.a
+logs/
+exmaples.c
+swagger.json
+DEBIAN/
+scripts/
+tools/
+*.md
+LICENSE
+ChangeLog

.github/pull_request_template.md

@@ -19,10 +19,15 @@ Use a **conventional commit** title — it becomes the release version on merge:
 
 - [ ] PR title follows the table above
 - [ ] Code builds on Linux (`make lin` and `make libchttpx.so`)
+- [ ] Tests pass (`make test`)
+- [ ] Example server builds separately (`make example`) if needed
 - [ ] Code builds on Windows (`make win`) if applicable
 - [ ] Source is formatted (`make lin-format` or `clang-format`)
 - [ ] README updated if public API or usage changed
 
 ## Related issues
 
 <!-- Closes #123 -->
+
+<!-- libchttpx-preview -->
+<!-- /libchttpx-preview -->

.github/workflows/ci.yml

@@ -2,9 +2,8 @@ name: CI
 
 on:
   push:
-    branches: [main, master]
+    branches: [develop, main, master]
   pull_request:
-    branches: [main, master]
 
 permissions:
   contents: read
@@ -25,6 +24,9 @@ jobs:
       - name: Build binary
         run: make lin
 
+      - name: Run tests
+        run: make test
+
       - name: Build shared library
         run: make libchttpx.so
 
@@ -50,6 +52,9 @@ jobs:
       - name: Build
         run: mingw32-make win SHELL=cmd
 
+      - name: Run tests
+        run: mingw32-make win-test-run SHELL=cmd
+
   static-analysis:
     name: Static analysis (cppcheck)
     runs-on: ubuntu-latest

.github/workflows/docker.yml

@@ -0,0 +1,54 @@
+name: Docker
+
+on:
+  push:
+    branches: [main, master]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: docker-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    name: Build and push to Docker Hub
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: netcorelink/libchttpx
+          tags: |
+            type=raw,value=latest,enable={{is_default_branch}}
+            type=ref,event=branch
+            type=sha,prefix=
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          platforms: linux/amd64,linux/arm64

.github/workflows/pr-preview.yml

@@ -0,0 +1,128 @@
+name: PR Preview Build
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  preview-linux:
+    name: Preview build (Linux)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          sudo apt update
+          sudo apt install -y gcc make libcjson-dev
+
+      - name: Build preview archive
+        run: make lin-lib
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: libchttpx-dev-pr-${{ github.event.pull_request.number }}
+          path: libchttpx-dev.tar.gz
+          retention-days: 14
+
+      - name: Update PR with install instructions
+        uses: actions/github-script@v7
+        env:
+          RUN_ID: ${{ github.run_id }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+          HEAD_REF: ${{ github.head_ref }}
+          HEAD_REPO: ${{ github.event.pull_request.head.repo.full_name }}
+        with:
+          script: |
+            const markerStart = '<!-- libchttpx-preview -->';
+            const markerEnd = '<!-- /libchttpx-preview -->';
+            const runId = process.env.RUN_ID;
+            const prNumber = process.env.PR_NUMBER;
+            const headRef = process.env.HEAD_REF;
+            const headRepo = process.env.HEAD_REPO;
+            const { owner, repo } = context.repo;
+            const fullRepo = `${owner}/${repo}`;
+            const runUrl = `https://github.com/${fullRepo}/actions/runs/${runId}`;
+            const scriptUrl = `https://raw.githubusercontent.com/${headRepo}/${headRef}/scripts/install-preview.sh`;
+            const oneLiner = `curl -sL ${scriptUrl} | sudo bash -s -- ${runId} ${prNumber} ${fullRepo}`;
+
+            const section = [
+              markerStart,
+              '## libchttpx preview build (Linux)',
+              '',
+              '> Auto-generated by CI on every push. Artifact is kept for 14 days.',
+              '',
+              '| | |',
+              '|---|---|',
+              `| **PR** | #${prNumber} |`,
+              `| **Workflow run** | [${runId}](${runUrl}) |`,
+              `| **Artifact** | \`libchttpx-dev-pr-${prNumber}\` |`,
+              '',
+              '### One-liner install (Linux)',
+              '',
+              'Requires [GitHub CLI](https://cli.github.com/) — run `gh auth login` once.',
+              '',
+              '```bash',
+              oneLiner,
+              '```',
+              '',
+              '### Manual install',
+              '',
+              '```bash',
+              `gh run download ${runId} -R ${fullRepo} -n libchttpx-dev-pr-${prNumber}`,
+              'tar -xzf libchttpx-dev.tar.gz && cd libchttpx-dev',
+              'sudo mkdir -p /usr/local/include/libchttpx /usr/local/lib/pkgconfig',
+              'sudo cp -r include/* /usr/local/include/libchttpx/',
+              'sudo cp libchttpx.so /usr/local/lib/',
+              'sudo cp libchttpx.pc /usr/local/lib/pkgconfig/',
+              'sudo ldconfig',
+              '```',
+              '',
+              '### Compile your app',
+              '',
+              '```bash',
+              'gcc main.c $(pkg-config --cflags --libs libchttpx) -lcjson',
+              '```',
+              markerEnd,
+            ].join('\n');
+
+            const isFork = headRepo !== fullRepo;
+            const { data: pr } = await github.rest.pulls.get({
+              owner,
+              repo,
+              pull_number: Number(prNumber),
+            });
+
+            if (isFork) {
+              await github.rest.issues.createComment({
+                owner,
+                repo,
+                issue_number: Number(prNumber),
+                body: section.replace(markerStart, '').replace(markerEnd, '').trim()
+                  + '\n\n> Posted as comment because this PR is from a fork.',
+              });
+              return;
+            }
+
+            let body = pr.body ?? '';
+            const startIdx = body.indexOf(markerStart);
+            const endIdx = body.indexOf(markerEnd);
+
+            if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+              body = body.slice(0, startIdx) + section + body.slice(endIdx + markerEnd.length);
+            } else {
+              body = body.trimEnd() + '\n\n' + section;
+            }
+
+            await github.rest.pulls.update({
+              owner,
+              repo,
+              pull_number: Number(prNumber),
+              body,
+            });

Dockerfile

@@ -0,0 +1,52 @@
+# syntax=docker/dockerfile:1
+
+# Dev base image: prebuilt libchttpx + toolchain for compiling C/C++ apps.
+#
+# Usage in other projects:
+#   FROM noneandundefined/libchttpx:latest
+#   WORKDIR /app
+#   COPY . .
+#   RUN gcc main.c $(pkg-config --cflags --libs libchttpx) -lcjson -o app
+
+FROM debian:bookworm-slim AS builder
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        gcc \
+        make \
+        libcjson-dev \
+        pkg-config \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /src
+
+COPY Makefile libchttpx.pc ./
+COPY include/ include/
+COPY src/ src/
+COPY tests/ tests/
+
+RUN make test \
+    && make lib-install DESTDIR=/out PREFIX=/usr/local
+
+FROM debian:bookworm-slim
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        gcc \
+        make \
+        libcjson-dev \
+        pkg-config \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /out/usr/local/ /usr/local/
+
+RUN ldconfig \
+    && pkg-config --exists libchttpx \
+    && test -f /usr/local/lib/libchttpx.so \
+    && test -d /usr/local/include/libchttpx
+
+LABEL org.opencontainers.image.source="https://github.com/netcorelink/libchttpx" \
+      org.opencontainers.image.description="libchttpx C HTTP/WebSocket library (dev base image)" \
+      org.opencontainers.image.licenses="MIT"
+
+WORKDIR /app