Merge pull request #4 from thewebscraping/develop

Develop

Author: thewebscraping

.coveragerc

@@ -0,0 +1,2 @@
+[run]
+omit = tests/*

.editorconfig

@@ -0,0 +1,23 @@
+# http://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{py,rst,ini}]
+indent_style = space
+indent_size = 4
+
+[*.{html,css,scss,json,yml,xml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

.github/workflows/ci.yml

@@ -11,9 +11,10 @@ jobs:
   build:
     runs-on: ubuntu-latest
     strategy:
-      max-parallel: 4
+      fail-fast: false
+      max-parallel: 3
       matrix:
-        python-version: ['3.9', '3.10', '3.11']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python ${{ matrix.python-version }}
@@ -23,11 +24,15 @@ jobs:
 
     - name: Install Dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements.txt
+        make init
 
-    - name: Run pre-commit
-      uses: pre-commit/[email protected]
+    - name: Lint
+      run: |
+        make lint
+
+    - name: Tests
+      run: |
+        make pytest
 
   deploy:
     needs: build

CHANGELOG.md

@@ -1,6 +1,35 @@
 Release History
 ===============
 
+1.0.3 (2024-12-11)
+-------------------
+**Improvements:**
+
+- Add unit tests.
+- Improve document.
+
+**Bugfixes:**
+
+- Fix timeout.
+- Fix missing port redirection.
+
+
+1.0.3 (2024-12-05)
+-------------------
+**Improvements**
+
+- improve document.
+
+**Bugfixes**
+
+- Fix multipart encoders, cross share auth.
+
+1.0.2 (2024-12-05)
+-------------------
+**Improvements**
+- Download specific TLS library versions.
+- Add a document.
+
 1.0.1 (2024-12-04)
 -------------------
-* First release
+- First release

Makefile

@@ -1,6 +1,11 @@
 .PHONY: docs
 init:
-	python -m pip install -r requirements.txt
+	python -m pip install --upgrade pip
+	python -m pip install -r requirements-dev.txt
+
+test:
+	tox -p
+	rm -rf *.egg-info
 
 test-readme:
 	python setup.py check --restructuredtext --strict && ([ $$? -eq 0 ] && echo "README.rst and CHANGELOG.md ok") || echo "Invalid markup in README.md or CHANGELOG.md!"
@@ -10,11 +15,25 @@ lint:
 	python -m isort tls_requests
 	python -m flake8 tls_requests
 
+pytest:
+	python -m pytest tests
+
+coverage:
+	python -m pytest --cov-config .coveragerc --verbose --cov-report term --cov-report xml --cov=tls_requests tests
+
+docs:
+	mkdocs serve
+
+publish-test-pypi:
+	python -m pip install -r requirements-dev.txt
+	python -m pip install 'twine>=6.0.1'
+	python setup.py sdist bdist_wheel
+	twine upload --repository testpypi dist/*
+	rm -rf build dist .egg wrapper_tls_requests.egg-info
+
 publish-pypi:
+	python -m pip install -r requirements-dev.txt
 	python -m pip install 'twine>=6.0.1'
 	python setup.py sdist bdist_wheel
 	twine upload dist/*
 	rm -rf build dist .egg wrapper_tls_requests.egg-info
-
-docs:
-	mkdocs serve

README.md

@@ -1,5 +1,5 @@
-# TLS REQUESTS
-**A powerful and lightweight Python library for making secure and reliable HTTP/TLS Fingerprint requests.**
+# TLS Requests
+TLS Requests is a powerful Python library for secure HTTP requests, offering browser-like TLS fingerprinting, anti-bot bypassing, and high performance.
 
 * * *
 

docs/advanced/hooks.md

@@ -100,7 +100,7 @@ client.hooks = {
 Best Practices
 --------------
 
-1.  **Access Content**: Use `.read()` or `await read()` in asynchronous contexts to access `response.content` before returning it.
+1.  **Access Content**: Use `.read()` or `await .aread()` in asynchronous contexts to access `response.content` before returning it.
 2.  **Always Use Lists:** Hooks must be registered as **lists of callables**, even if you are adding only one function.
 3.  **Combine Hooks:** You can register multiple hooks for the same event type to handle various concerns, such as logging and error handling.
 4.  **Order Matters:** Hooks are executed in the order they are registered.

pyproject.toml

@@ -1,3 +1,6 @@
 [build-system]
 requires = ['setuptools>=40.8.0']
 build-backend = 'setuptools.build_meta'
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

requirements-dev.txt

@@ -0,0 +1,25 @@
+-r requirements.txt
+
+# Documentation
+mkdocs==1.6.1
+mkautodoc==0.2.0
+mkdocs-material==9.5.39
+
+# Packaging
+setuptools~=75.3.0
+twine~=6.0.1
+
+# Tests & Linting
+pre-commit==3.7.0
+black==24.3.0
+coverage[toml]==7.6.1
+pre-commit==3.7.0
+isort==5.13.2
+flake8==7.1.1
+mypy==1.11.2
+pytest==8.3.3
+pytest-asyncio==0.24.0
+pytest-cov==6.0.0
+pytest_httpserver==1.1.0
+Werkzeug==3.1.3
+tox==4.23.2

requirements.txt

@@ -2,22 +2,4 @@
 chardet~=5.2.0
 requests~=2.32.3
 tqdm~=4.67.1
-
-# Documentation
-mkdocs==1.6.1
-mkautodoc==0.2.0
-mkdocs-material==9.5.39
-
-# Packaging
-setuptools~=75.3.0
-twine~=6.0.1
-
-# Tests & Linting
-pre-commit==3.7.0
-black==24.3.0
-flake8==7.0.0
-coverage[toml]==7.6.1
-pre-commit==3.7.0
-isort==5.13.2
-mypy==1.11.2
-pytest==8.3.3
+idna~=3.10