requests-mock

Mock out responses from the requests package

requests-mock Permissive license Apache-2 DORMANT ★ 466 v1.12.1 released 2024-03-29

Install

requests-mock on PyPI

pip

pip install requests-mock

uv

uv add requests-mock

poetry

poetry add requests-mock

Package facts

License	Apache-2 (permissive)
Python support	supports the current Python release (>=3.5)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — requests
Maintenance	dormant — 867 days since the last release
Last repo commit	2024-07-15
First released	2014-06-16
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: requests_mock-1.12.1-py2.py3-none-any.whl

Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Information TechnologyLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: Testing

About requests-mock

from the package's own PyPI description — quoted content, verbatim

=============================== requests-mock ===============================

.. image:: https://badge.fury.io/py/requests-mock.png :target: https://pypi.org/project/requests-mock/

Intro

requests-mock provides a building block to stub out the HTTP requests portions of your testing code. You should checkout the docs for more information.

The Basics

Everything in requests_ eventually goes through an adapter to do the transport work. requests-mock creates a custom adapter that allows you to predefine responses when certain URIs are called.

There are then a number of methods provided to get the adapter used.

A simple example:

.. code:: python

&gt;&gt;&gt; import requests
&gt;&gt;&gt; import requests_mock

&gt;&gt;&gt; session = requests.Session()
&gt;&gt;&gt; adapter = requests_mock.Adapter()
&gt;&gt;&gt; session.mount('mock://', adapter)

&gt;&gt;&gt; adapter.register_uri('GET', 'mock://test.com', text='data')
&gt;&gt;&gt; resp = session.get('mock://test.com')
&gt;&gt;&gt; resp.status_code, resp.text
(200, 'data')

Obviously having all URLs be mock:// prefixed isn't going to be useful, so you can use requests_mock.Mocker to get the adapter into place.

As a context...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

requests-mock stubs HTTP responses from the requests library during testing by intercepting calls through a custom adapter, letting you predefine mock responses for specific URIs.

Low friction: pure Python wheel with a single runtime dependency (requests). Maintenance is dormant—last release was 867 days ago—but the repository remains active with recent commits (2024-07-15) and no archived status, suggesting stability rather than abandonment.

Licensed under Apache License 2.0 (permissive), allowing commercial and private use with minimal restrictions; you must retain license and copyright notices in distributions.

Usage

pip install requests-mock

import requests
import requests_mock

with requests_mock.Mocker() as m:
    m.get('http://test.com', text='data')
    resp = requests.get('http://test.com')
    print(resp.text)  # 'data'

Verdict: Stable, low-friction testing utility for mocking requests library calls. Dormant maintenance (867 days since last release) poses minimal risk given its narrow, well-defined scope and zero known vulnerabilities. Suitable for projects that need reliable HTTP mocking without active development pressure.

Needs verification

Whether dormancy reflects genuine stability or signals future incompatibility with newer requests versions
Test coverage and integration test suite health relative to supported Python versions (3.8–3.12)

mock http requests in testsstub requests library responsesrequests adapter mockingtest http calls without networkrequests testing fixturemock requests responsesrequests library test doubles