{"author":"Jonas Lundberg","author_email":"jonas@5monkeys.se","bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Intended Audience :: Developers","License :: OSI Approved :: BSD License","Operating System :: OS Independent","Programming Language :: Python","Programming Language :: Python :: 3","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9"],"description":"

\n \n

\n RESPX - Mock HTTPX with awesome request patterns and response side effects.\n

\n\n---\n\n[![tests](https://img.shields.io/github/actions/workflow/status/lundberg/respx/test.yml?branch=master&label=tests&logo=github&logoColor=white&style=for-the-badge)](https://github.com/lundberg/respx/actions/workflows/test.yml)\n[![codecov](https://img.shields.io/codecov/c/github/lundberg/respx?logo=codecov&logoColor=white&style=for-the-badge)](https://codecov.io/gh/lundberg/respx)\n[![PyPi Version](https://img.shields.io/pypi/v/respx?logo=pypi&logoColor=white&style=for-the-badge)](https://pypi.org/project/respx/)\n[![Python Versions](https://img.shields.io/pypi/pyversions/respx?logo=python&logoColor=white&style=for-the-badge)](https://pypi.org/project/respx/)\n\n## Documentation\n\nFull documentation is available at\n[lundberg.github.io/respx](https://lundberg.github.io/respx/)\n\n## QuickStart\n\nRESPX is a simple, _yet powerful_, utility for mocking out the\n[HTTPX](https://www.python-httpx.org/), _and\n[HTTP Core](https://www.encode.io/httpcore/)_, libraries.\n\nStart by [patching](https://lundberg.github.io/respx/guide/#mock-httpx) `HTTPX`, using\n`respx.mock`, then add request\n[routes](https://lundberg.github.io/respx/guide/#routing-requests) to mock\n[responses](https://lundberg.github.io/respx/guide/#mocking-responses).\n\n```python\nimport httpx\nimport respx\n\nfrom httpx import Response\n\n\n@respx.mock\ndef test_example():\n my_route = respx.get(\"https://example.org/\").mock(return_value=Response(204))\n response = httpx.get(\"https://example.org/\")\n assert my_route.called\n assert response.status_code == 204\n```\n\n> Read the [User Guide](https://lundberg.github.io/respx/guide/) for a complete\n> walk-through.\n\n### pytest + httpx\n\nFor a neater `pytest` experience, RESPX includes a `respx_mock` _fixture_ for easy\n`HTTPX` mocking, along with an optional `respx` _marker_ to fine-tune the mock\n[settings](https://lundberg.github.io/respx/api/#configuration).\n\n```python\nimport httpx\nimport pytest\n\n\ndef test_default(respx_mock):\n respx_mock.get(\"https://foo.bar/\").mock(return_value=httpx.Response(204))\n response = httpx.get(\"https://foo.bar/\")\n assert response.status_code == 204\n\n\n@pytest.mark.respx(base_url=\"https://foo.bar\")\ndef test_with_marker(respx_mock):\n respx_mock.get(\"/baz/\").mock(return_value=httpx.Response(204))\n response = httpx.get(\"https://foo.bar/baz/\")\n assert response.status_code == 204\n```\n\n## Installation\n\nInstall with pip:\n\n```console\n$ pip install respx\n```\n\nRequires Python 3.8+ and HTTPX 0.25+. See\n[Changelog](https://github.com/lundberg/respx/blob/master/CHANGELOG.md) for older HTTPX\ncompatibility.\n","description_content_type":"text/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":"https://lundberg.github.io/respx/","keywords":"httpx, httpcore, mock, responses, requests, async, http","license":"BSD-3-Clause","license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"respx","package_url":"https://pypi.org/project/respx/","platform":null,"project_url":"https://pypi.org/project/respx/","project_urls":{"Changelog":"https://github.com/lundberg/respx/blob/master/CHANGELOG.md","GitHub":"https://github.com/lundberg/respx","Homepage":"https://lundberg.github.io/respx/","Issues":"https://github.com/lundberg/respx/issues"},"provides_extra":null,"release_url":"https://pypi.org/project/respx/0.22.0/","requires_dist":["httpx>=0.25.0"],"requires_python":">=3.8","summary":"A utility for mocking out the Python HTTPX and HTTP Core libraries.","version":"0.22.0","yanked":false,"yanked_reason":null}

Package search

respx

project_urls

Dependencies

All package metadata

Releases