Release 0.2.1 (#21)

* [BUGFIX] Fix Broken Release (#19)

* fix: resolve Linux and macOS build failures, add CI build tests

  Build Fixes:
  - Add pthread.h include for Linux builds (network.c)
    Fixes missing PTHREAD_MUTEX_INITIALIZER and pthread function declarations

  - Remove duplicate _POSIX_C_SOURCE definition (http2_session_manager.c)
    Fixes redefinition warning and implicit usleep declaration
    The macro is already defined in internal.h with a newer POSIX standard

  - Fix -march=native flag for macOS ARM64 builds (setup.py)
    Refactored architecture detection to skip unsupported flags on ARM64 macOS
    * x86_64/AMD64: Use -march=native
    * ARM64 on Linux: Use -mcpu=native
    * ARM64 on macOS: Skip architecture flags (clang doesn't support them)

  CI Improvements:
  - Add build test jobs for Linux, macOS, and Windows to CI pipeline
  - Build and test all Python versions (3.8-3.14) on every push/PR
  - Align CI build workflow with release pipeline for consistency
  - Add build status reporting in CI summary

  These changes ensure builds succeed on all platforms and catch build
  failures early in the development process.

* fix: skip C extension build on Read the Docs

  Read the Docs doesn't need C extensions to build documentation.
  Detect READTHEDOCS environment variable and skip Cython/C compilation
  when building on RTD infrastructure.

  This allows documentation builds to succeed without requiring
  vendor dependencies (nghttp2, BoringSSL) to be available.

* chore: Fixed indentation in setup.py:
  - All Extension() constructor parameters are now properly indented
  - The build will now work correctly on Linux/macOS/Windows
  - Read the Docs will skip C extensions entirely (no compilation needed for docs)

* fix: resolve Linux/macOS build failures and add CI build tests for all platforms

* fix: Resolve Linux and macOS build failures

  - Add OpenSSL 1.0.x compatibility for old manylinux containers
  - Add TLS 1.3 guards for OpenSSL versions without TLS 1.3 support
  - Force static library linking on macOS to avoid Homebrew dylib version mismatches
  - Prioritize vendor-built libraries over system libraries on macOS

* fix: Resolve Linux sign-compare warnings and macOS library linking issues

  - Fix sign-compare warnings in tls.c by using int instead of size_t for browser profile
  counts
  - Force static library linking on macOS to avoid Homebrew dylib version conflicts
  - Prioritize vendor-built libraries over system libraries on both Linux and macOS

* fix: Resolve Python 3.8 setuptools compatibility and build issues

  - Constrain setuptools <75.4.0 for Python 3.8 (dropped support in 75.4.0)

* fix: Resolve build and runtime failures across all platforms

  - Constrain setuptools <75.4.0 for Python 3.8 (dropped in 75.4.0)
  - Remove -march=native flags to fix "Illegal instruction" on Linux
  - Fix sign-compare warnings in tls.c (use int for profile counts)
  - Force static library linking on macOS to avoid Homebrew conflicts
  - Ensure portable wheels that work across different CPUs

* fix: Resolve build failures across all platforms

  - Cap setuptools <75.4.0 for Python 3.8 compatibility
  - Remove -march=native to create portable wheels
  - Fix sign-compare warnings in tls.c
  - Force static library linking on macOS
  - Ensure wheels work across different CPUs and Python versions

* fix: Add OpenSSL 1.0.x compatibility for manylinux builds

  - Add compatibility wrappers for OpenSSL 1.1.0+ APIs
  - Map TLS_client_method to SSLv23_client_method for 1.0.x
  - Add fallback for SSL_CTX_set_min/max_proto_version
  - Skip X25519 curve when not available in OpenSSL 1.0.x
  - Remove duplicate POSIX feature test macros
  - Ensure all builds work with OpenSSL 1.0.x (manylinux) and 1.1.0+

* fix: Add comprehensive OpenSSL 1.0.x and POSIX compatibility

* fix: Fixed io_uring detection, added liburing static library support, and properly linked BoringSSL with C++ runtime support

* [CHORE] Attribution and Version Bump to 0.2.1 (#20)

Author: arman-bd

.github/workflows/_build_linux.yml

@@ -2,12 +2,6 @@ name: Build Linux Wheels
 
 on:
   workflow_call:
-    inputs:
-      python-versions:
-        description: 'Python versions to build for'
-        required: false
-        type: string
-        default: '["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]'
 
 jobs:
   build-linux:
@@ -42,7 +36,7 @@ jobs:
     - name: Build wheels
       uses: pypa/cibuildwheel@v2.22.0
       env:
-        # Build for specified Python versions
+        # Build for all Python versions
         CIBW_BUILD: cp38-manylinux_x86_64 cp39-manylinux_x86_64 cp310-manylinux_x86_64 cp311-manylinux_x86_64 cp312-manylinux_x86_64 cp313-manylinux_x86_64 cp314-manylinux_x86_64
         # Vendor build happens inside manylinux container via before-build (from pyproject.toml)
         # The script will detect cached libraries and skip rebuilding

.github/workflows/_build_macos.yml

@@ -2,12 +2,6 @@ name: Build macOS Wheels
 
 on:
   workflow_call:
-    inputs:
-      python-versions:
-        description: 'Python versions to build for'
-        required: false
-        type: string
-        default: '["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]'
 
 jobs:
   build-macos:
@@ -84,7 +78,7 @@ jobs:
       env:
         # Skip before-build since we already built vendors
         CIBW_BEFORE_BUILD: ""
-        # Build for specified Python versions (universal2 for both Intel and Apple Silicon)
+        # Build for all Python versions (universal2 for both Intel and Apple Silicon)
         CIBW_BUILD: cp38-macosx_* cp39-macosx_* cp310-macosx_* cp311-macosx_* cp312-macosx_* cp313-macosx_* cp314-macosx_*
         # Use delocate to bundle dependencies
         CIBW_REPAIR_WHEEL_COMMAND_MACOS: "delocate-wheel --require-archs {delocate_archs} -w {dest_dir} {wheel} --ignore-missing-dependencies"

.github/workflows/_build_windows.yml

@@ -2,12 +2,6 @@ name: Build Windows Wheels
 
 on:
   workflow_call:
-    inputs:
-      python-versions:
-        description: 'Python versions to build for'
-        required: false
-        type: string
-        default: '["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]'
 
 jobs:
   build-windows:
@@ -94,7 +88,7 @@ jobs:
       env:
         # Skip before-build since we already built vendors
         CIBW_BEFORE_BUILD: ""
-        # Build for specified Python versions
+        # Build for all Python versions
         CIBW_BUILD: cp38-win_amd64 cp39-win_amd64 cp310-win_amd64 cp311-win_amd64 cp312-win_amd64 cp313-win_amd64 cp314-win_amd64
 
     # Setup Python versions for testing

.github/workflows/ci.yml

@@ -30,12 +30,30 @@ jobs:
       TEST_PROXY_URL: ${{ secrets.TEST_PROXY_URL }}
       CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
+  # ============================================================
+  # Build Test Jobs
+  # ============================================================
+  build-test-linux:
+    name: Build Test (Linux)
+    needs: load-config
+    uses: ./.github/workflows/_build_linux.yml
+
+  build-test-macos:
+    name: Build Test (macOS)
+    needs: load-config
+    uses: ./.github/workflows/_build_macos.yml
+
+  build-test-windows:
+    name: Build Test (Windows)
+    needs: load-config
+    uses: ./.github/workflows/_build_windows.yml
+
   # ============================================================
   # Summary
   # ============================================================
   summary:
     name: CI Summary
-    needs: [load-config, test]
+    needs: [load-config, test, build-test-linux, build-test-macos, build-test-windows]
     if: always()
     runs-on: ubuntu-latest
 
@@ -59,6 +77,40 @@ jobs:
           echo "⊘ Tests: DISABLED"
         fi
 
+        # Build Tests
+        echo ""
+        echo "Build Tests:"
+
+        # Linux
+        if [ "${{ needs.build-test-linux.result }}" == "success" ]; then
+          echo "  ✅ Linux: PASSED"
+        elif [ "${{ needs.build-test-linux.result }}" == "skipped" ]; then
+          echo "  ⊘ Linux: SKIPPED"
+        else
+          echo "  ❌ Linux: FAILED"
+          EXIT_CODE=1
+        fi
+
+        # macOS
+        if [ "${{ needs.build-test-macos.result }}" == "success" ]; then
+          echo "  ✅ macOS: PASSED"
+        elif [ "${{ needs.build-test-macos.result }}" == "skipped" ]; then
+          echo "  ⊘ macOS: SKIPPED"
+        else
+          echo "  ❌ macOS: FAILED"
+          EXIT_CODE=1
+        fi
+
+        # Windows
+        if [ "${{ needs.build-test-windows.result }}" == "success" ]; then
+          echo "  ✅ Windows: PASSED"
+        elif [ "${{ needs.build-test-windows.result }}" == "skipped" ]; then
+          echo "  ⊘ Windows: SKIPPED"
+        else
+          echo "  ❌ Windows: FAILED"
+          EXIT_CODE=1
+        fi
+
         echo ""
         if [ "${EXIT_CODE:-0}" == "1" ]; then
           echo "❌ CI Pipeline FAILED"

docs/source/conf.py

@@ -12,8 +12,8 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = "httpmorph"
-copyright = "2025, httpmorph contributors"
-author = "httpmorph contributors"
+copyright = "2025, Arman Hossain"
+author = "Arman Hossain"
 
 # Read version from package metadata (single source of truth: pyproject.toml)
 try:
@@ -43,6 +43,30 @@
 html_theme = "sphinx_rtd_theme"
 html_static_path = ["_static"]
 
+# Theme options for Read the Docs theme
+html_theme_options = {
+    "display_version": True,
+    "prev_next_buttons_location": "bottom",
+    "style_external_links": False,
+    "collapse_navigation": False,
+    "sticky_navigation": True,
+    "navigation_depth": 4,
+}
+
+# Add author contact information
+html_context = {
+    "display_github": True,
+    "github_user": "arman-bd",
+    "github_repo": "httpmorph",
+    "github_version": "main",
+    "conf_py_path": "/docs/source/",
+}
+
+# Additional metadata
+html_show_sourcelink = True
+html_show_sphinx = True
+html_show_copyright = True
+
 # -- Options for autodoc -----------------------------------------------------
 autodoc_member_order = "bysource"
 autodoc_typehints = "description"

docs/source/index.rst

@@ -89,3 +89,11 @@ License
 -------
 
 MIT License
+
+Author
+------
+
+**Arman Hossain**
+
+- GitHub: `arman-bd <https://github.com/arman-bd>`_
+- Email: arman@bytetunnels.com

pyproject.toml

@@ -1,6 +1,6 @@
 [build-system]
 requires = [
-    "setuptools>=68.0",
+    "setuptools>=68.0,<75.4.0",
     "wheel",
     "Cython>=3.0",
     "tomli>=2.0.0; python_version < '3.11'"
@@ -9,7 +9,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "httpmorph"
-version = "0.2.0"
+version = "0.2.1"
 description = "A Python HTTP client focused on mimicking browser fingerprints."
 readme = "README.md"
 requires-python = ">=3.8"