aiointercept 0.1.0__tar.gz

aiointercept-0.1.0/.github/workflows/pr.yml

@@ -0,0 +1,53 @@
+name: PR
+
+on:
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Ruff
+        run: uv run ruff check .
+
+      - name: Mypy
+        run: uv run mypy aiointercept
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        aiohttp-version: ["3.13.3", "3.13.5"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Install dependencies
+        run: uv sync --group tests
+
+      - name: Pin aiohttp version
+        run: uv pip install aiohttp==${{ matrix.aiohttp-version }}
+
+      - name: Tests
+        run: uv run pytest tests/

aiointercept-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: "Publish"
+
+on:
+  push:
+    tags:
+      # Publish on any tag starting with a `v`, e.g., v0.1.0
+      - v*
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Install Python 3.13
+        run: uv python install 3.13
+      - name: Build
+        run: uv build
+      - name: Publish
+        run: uv publish

aiointercept-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+*.pyc
+.vscode/settings.json
+.claude/settings.local.json

aiointercept-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.15.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - aiohttp
+          - yarl

aiointercept-0.1.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: aiointercept
+Version: 0.1.0
+Author-email: Pablo Estevez <pablo22estevez@gmail.com>
+Requires-Python: >=3.10
+Requires-Dist: aiohttp<4.0.0,>=3.13.3
+Requires-Dist: pytest-asyncio<2.0.0,>=1.3.0
+Requires-Dist: yarl<2.0.0,>=1.23.0
+Description-Content-Type: text/markdown
+
+Proof of concept for an aioresponses-like library that uses real aiohttp server
+related to this discussion: https://github.com/orgs/aio-libs/discussions/45
+
+This is a proof of concept of how a linrary could expose aioresponses-like API
+while using real aiohttp server under the hood. It works only with GET requests,
+only compare the url, param and method, and only implements assert_called_with.
+
+The breaking changes will be:
+- The context manager will be async, as it will need to start the server
+- the assert_called_* methods will not work with arbitrary kwargs, instead they will only work with specific args that the request was made with (e.g. url, method, headers, params, etc.)
+- the fragments (after #) are not being passed on the request, so will not be compared
+- on a connector exception, aiohttp could retry, so the number of request will not be the same
+- pass timeout don't work
+- you cant raise exceptions exception clienterror
+- the decorathor need to decorate an async function
+- as this mock DNS will not work to mock request to external IPs
+
+
+Added a perf test to compare the performance of the POC with the original aioresponses implementation.
+
+Results:
+
+aioresponses (main)       :  0.7223 seconds for 1000 iter (0.72 ms/iter)
+aioresponses_2 (POC)      :  0.8272 seconds for 1000 iter (0.83 ms/iter)
+
+Probablly this overheard is tolerable, and could be optimized.
+However, once we start adding more features, the performance will degrade.
+
+
+Changing:
+
+@pytest.fixture
+def mock_aioresponse():
+    with aioresponses() as m:
+
+to:
+
+@pytest_asyncio.fixture
+async def mock_aioresponse():
+    async with aioresponses() as m:
+        yield m
+
+is passing the tests on:
+
+https://github.com/cortega26/PDF-Text-Analyzer
+https://github.com/mxr/reconciler-for-ynab
+https://github.com/pratik-choudhari/Financial-news-scraper /with some unrelated changes because is broken
+https://github.com/dorianrod/GitReviewLens
+
+https://github.com/natekspencer/pylitterbot required some changes:
+- there were raising a custom exception on request on test_litter_robot_5_dispatch_command_failure, and that is not supported.
+- - However, they were try to mimick a 500 with certain json that was supported
+- There were some calls to localhost, that should be to https://localhost. This was
+also a fixable error on the tests
+
+
+Broken on main
+https://github.com/symphony-youri/symphony-api-client-python.git
+
+too complex to work: https://github.com/mguidon/osparc-simcore

aiointercept-0.1.0/README.md

@@ -0,0 +1,60 @@
+Proof of concept for an aioresponses-like library that uses real aiohttp server
+related to this discussion: https://github.com/orgs/aio-libs/discussions/45
+
+This is a proof of concept of how a linrary could expose aioresponses-like API
+while using real aiohttp server under the hood. It works only with GET requests,
+only compare the url, param and method, and only implements assert_called_with.
+
+The breaking changes will be:
+- The context manager will be async, as it will need to start the server
+- the assert_called_* methods will not work with arbitrary kwargs, instead they will only work with specific args that the request was made with (e.g. url, method, headers, params, etc.)
+- the fragments (after #) are not being passed on the request, so will not be compared
+- on a connector exception, aiohttp could retry, so the number of request will not be the same
+- pass timeout don't work
+- you cant raise exceptions exception clienterror
+- the decorathor need to decorate an async function
+- as this mock DNS will not work to mock request to external IPs
+
+
+Added a perf test to compare the performance of the POC with the original aioresponses implementation.
+
+Results:
+
+aioresponses (main)       :  0.7223 seconds for 1000 iter (0.72 ms/iter)
+aioresponses_2 (POC)      :  0.8272 seconds for 1000 iter (0.83 ms/iter)
+
+Probablly this overheard is tolerable, and could be optimized.
+However, once we start adding more features, the performance will degrade.
+
+
+Changing:
+
+@pytest.fixture
+def mock_aioresponse():
+    with aioresponses() as m:
+
+to:
+
+@pytest_asyncio.fixture
+async def mock_aioresponse():
+    async with aioresponses() as m:
+        yield m
+
+is passing the tests on:
+
+https://github.com/cortega26/PDF-Text-Analyzer
+https://github.com/mxr/reconciler-for-ynab
+https://github.com/pratik-choudhari/Financial-news-scraper /with some unrelated changes because is broken
+https://github.com/dorianrod/GitReviewLens
+
+https://github.com/natekspencer/pylitterbot required some changes:
+- there were raising a custom exception on request on test_litter_robot_5_dispatch_command_failure, and that is not supported.
+- - However, they were try to mimick a 500 with certain json that was supported
+- There were some calls to localhost, that should be to https://localhost. This was
+also a fixable error on the tests
+
+
+Broken on main
+https://github.com/symphony-youri/symphony-api-client-python.git
+
+too complex to work: https://github.com/mguidon/osparc-simcore

aiointercept-0.1.0/aiointercept/__init__.py

@@ -0,0 +1,3 @@
+from .core import aiointercept, CallbackResult
+
+__all__ = ["aiointercept", "CallbackResult"]

aiointercept-0.1.0/aiointercept/compat.py

@@ -0,0 +1,19 @@
+from multidict import MultiDict
+from yarl import URL
+
+
+def normalize_url(url: "URL | str") -> URL:
+    """Normalize url to make comparisons."""
+    url = URL(url)
+    if url.fragment:
+        url = url.with_fragment(None)
+    return url.with_query(sorted(url.query.items()))
+
+
+def merge_params(url: "URL | str", params: "dict[str, str] | None" = None) -> URL:
+    url = URL(url)
+    if params:
+        query_params = MultiDict(url.query)
+        query_params.extend(url.with_query(params).query)
+        return url.with_query(query_params)
+    return url