develop

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [thewebscraping]

.github/workflows/ci.yml

@@ -3,69 +3,47 @@ name: CI
 on:
   push:
     branches: ['master', 'main']
-
   pull_request:
-    branches: ['master', 'main', 'dev', 'develop']
+    branches: ['master', 'main', 'dev', 'develop', 'feat/*']
 
 jobs:
-  build-on-ubuntu:
-    runs-on: ubuntu-latest
+  tests:
+    name: Tests on ${{ matrix.os }} / ${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
-      max-parallel: 3
       matrix:
-        python-version: ['3.9', '3.10', '3.11']
-    steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
-      with:
-        python-version: ${{ matrix.python-version }}
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+        exclude:
+          - os: windows-latest
+            python-version: '3.10'
+          - os: windows-latest
+            python-version: '3.11'
+          - os: windows-latest
+            python-version: '3.12'
+          - os: macos-latest
+            python-version: '3.10'
+          - os: macos-latest
+            python-version: '3.11'
+          - os: macos-latest
+            python-version: '3.12'
 
-    - name: Install Dependencies, Lint and Tests
-      run: |
-        make init-actions
-
-  build-on-mac:
-    runs-on: macos-latest
-    strategy:
-      fail-fast: false
-      max-parallel: 1
-      matrix:
-        python-version: ['3.9']
     steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
-      with:
-        python-version: ${{ matrix.python-version }}
-
-    - name: Install Dependencies, Lint and Tests
-      run: |
-        make init-actions
-
-    - name: Pytest
-      run: |
-        make pytest
-
-  build-on-windows:
-    runs-on: windows-latest
-    strategy:
-      fail-fast: false
-      max-parallel: 1
-      matrix:
-        python-version: ['3.9']
-    steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
-      with:
-        python-version: ${{ matrix.python-version }}
-
-    - name: Install Dependencies, Lint
-      run: |
-        make init-actions
-
-    - name: Pytest
-      run: |
-        make pytest
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run linting
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.9'
+        run: |
+          uv run ruff check .
+          uv run mypy src/tls_requests
+
+      - name: Run tests
+        run: |
+          uv run pytest

.github/workflows/documentation.yml

@@ -1,35 +1,30 @@
 name: Build Documentation
 on:
-  release:
-    types: [created]
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+  workflow_dispatch:
 jobs:
   build:
     runs-on: ubuntu-latest
-    strategy:
-      max-parallel: 1
-      matrix:
-        python-version: ['3.9']
+    permissions:
+      contents: write
     steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
-    - name: Install Dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements-dev.txt
-    - name: Configure Git Credentials
-      run: |
-        git config user.name github-actions[bot]
-        git config user.email 41898282+github-actions[bot]@users.noreply.github.com
-    - uses: actions/cache@v4
-      with:
-        key: mkdocs-material-${{ env.cache_id }}
-        path: .cache
-        restore-keys: |
-          mkdocs-material-
-    - name: Publish Documentation
-      run: |
-        echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
-        mkdocs gh-deploy --force
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: '3.11'
+
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+      - name: Publish Documentation
+        run: |
+          uv run mkdocs gh-deploy --force

.github/workflows/publish.yml

@@ -1,26 +1,31 @@
-name: Upload Python Package
+name: Publish to PyPI
 
 on:
-  release:
-    types: [created]
+  push:
+    tags:
+      - 'v*'
 
 jobs:
-  deploy:
-    name: Publish PyPI
+  build-n-publish:
+    name: Build and publish to PyPI
     runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/wrapper-tls-requests
+    permissions:
+      id-token: write  # Required for Trusted Publishing
+      contents: read
+
     steps:
-      - uses: actions/checkout@main
-      - name: Set up Python 3.9
-        uses: actions/setup-python@v4
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.9'
+          enable-cache: true
+
       - name: Build package
-        run: |
-          python -m pip install -U pip build setuptools twine
-      - name: Publish
-        env:
-          TWINE_USERNAME: __token__
-          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
-        run: |
-          python setup.py sdist bdist_wheel
-          twine upload --skip-existing dist/*
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -160,4 +160,8 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 .idea/
-tls_requests/bin/*xgo*
+src/tls_requests/bin/*.dll
+src/tls_requests/bin/*.so
+src/tls_requests/bin/*.dylib
+src/tls_requests/bin/*.json
+!src/tls_requests/bin/__init__.py

.pre-commit-config.yaml

@@ -1,33 +1,62 @@
-exclude: '^docs.sh/|scripts/'
-default_stages: [pre-commit]
-
-default_language_version:
-  python: python3.10
+# Pre-commit hooks configuration
+# See https://pre-commit.com for more information
 
 repos:
+  # General file checks
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: [--maxkb=1500]
       - id: check-json
       - id: check-toml
-      - id: check-xml
-      - id: check-yaml
-      - id: debug-statements
-      - id: check-builtin-literals
+      - id: check-merge-conflict
       - id: check-case-conflict
-      - id: check-docstring-first
-      - id: detect-private-key
+      - id: mixed-line-ending
 
-  # run the isort.
-  - repo: https://github.com/PyCQA/isort
-    rev: 5.13.2
+  # Ruff - Fast Python linter and formatter
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.13
     hooks:
-      - id: isort
+      # Run the linter
+      - id: ruff
+        args: [--extend-select, I, --fix, --exit-non-zero-on-fix]
+      # Run the formatter
+      - id: ruff-format
+        args: [--exit-non-zero-on-fix]
 
-  # run the flake8.
-  - repo: https://github.com/PyCQA/flake8
-    rev: 7.0.0
+  # Type checking with mypy
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.15.0
     hooks:
-      - id: flake8
+      - id: mypy
+        additional_dependencies:
+          - types-setuptools
+          - idna
+          - orjson
+          - charset-normalizer
+          - chardet
+        args: [--ignore-missing-imports, --config-file=pyproject.toml]
+
+  # Markdown linting (disabled due to duplicate heading issues)
+  # - repo: https://github.com/igorshubovych/markdownlint-cli
+  #   rev: v0.46.0
+  #   hooks:
+  #     - id: markdownlint
+  #       args: [--fix]
+
+# CI configuration
+ci:
+  autofix_commit_msg: |
+    [pre-commit.ci] auto fixes from pre-commit.com hooks
+
+    for more information, see https://pre-commit.ci
+  autofix_prs: true
+  autoupdate_branch: ''
+  autoupdate_commit_msg: '[pre-commit.ci] pre-commit autoupdate'
+  autoupdate_schedule: weekly
+  skip: []
+  submodules: false

CHANGELOG.md

@@ -1,5 +1,55 @@
 Release History
-===============
+================
+
+1.2.3 (2026-01-24)
+------------------
+**Improvements:**
+
+- **Enhanced IPv6 Support**: Implemented automatic repair for naked IPv6 addresses (e.g., `2001:db8::1` -> `[2001:db8::1]`) and strict bracket validation.
+- **Robust URL Handling**: Added default `http://` scheme for schemeless URLs and improved component-based building logic to prevent crashes.
+- **Type Safety**: Resolved Mypy strict type inconsistencies and added comprehensive test coverage for IPv6 edge cases.
+
+**Bugfixes:**
+
+- **Python 3.9 Compatibility**: Fixed `RuntimeError: There is no current event loop` during rotator initialization by implementing lazy asyncio lock loading.
+- **Redirect Logic**: Fixed `Headers.__getitem__` to correctly raise `KeyError` for missing keys, ensuring compatibility with standard redirect handling.
+
+1.2.2 (2026-01-21)
+------------------
+**Improvements:**
+
+- **Standardized API Parameters**: Renamed `tls_identifier` to `client_identifier` and `tls_debug` to `debug` for better consistency and professional API surface.
+- **Src Layout Migration**: Refactored the project structure to use a modern `src/` layout, improving package isolation and build reliability.
+- **Type Safety & Testing**: Integrated `mypy` for strict type checking and migrated to `uv run pytest` for comprehensive test verification (80+ tests passing).
+- **Backward Compatibility**: Implemented a centralized fallback and logging warning system for legacy parameters (planned removal in v1.3.0).
+- **Modernized CI/CD**: Fully migrated from `Makefile` to `uv`. Optimized GitHub Actions matrix to support Python 3.9 through 3.13 across Linux, macOS, and Windows.
+- **Enhanced Platform Support**: Improved detection and loading logic for ARM64/aarch64 architectures (Apple Silicon, AWS Graviton).
+- **Project Sustainability**: Added GitHub Sponsors support to the repository metadata and documentation.
+
+1.1.7 (2025-11-23)
+------------------
+**Improvements:**
+
+- Optimized logging. ([#46](https://github.com/thewebscraping/tls-requests/issues/46))
+- Fixed cookie response handling. ([#47](https://github.com/thewebscraping/tls-requests/issues/47))
+
+1.1.6 (2025-10-14)
+------------------
+**Enhancements:**
+This pull request introduces two major enhancements that significantly improve the library's anti‑detection capabilities and overall robustness:
+
+**A Smart Rotator System**
+- Automatically rotates proxies, headers, and TLS identifiers to mimic authentic traffic.
+- Introduced three new rotator classes: `ProxyRotator`, `HeaderRotator`, and `TLSIdentifierRotator`.
+- Client and AsyncClient now enable header and TLS identifier rotation by default, using built‑in realistic templates.
+- Unified parameters accept a single value, a list, or a pre‑configured Rotator instance.
+- Proxy feedback loop (`mark_result`/`amark_result`) optimizes weighted rotation strategy.
+
+**Robust Library Management**
+- Dependency‑free, self‑managing mechanism for the core `tls-client` C library lifecycle.
+- Removed `requests` and `tqdm`; now uses built‑in `urllib` and [json](cci:1://file:///Users/twofarm/Desktop/works/tls_requests/tls_requests/models/response.py:204:4-205:43).
+- TLSLibrary is version‑aware, automatically downloading the correct version from GitHub when needed.
+- Automatic cleanup of old library files after successful updates.
 
 1.0.7 (2024-12-14)
 -------------------