mocket

What it is and what it does

Mocket monkey-patches Python's socket and ssl modules to intercept network calls during testing, allowing you to define mock responses without touching the real network. It serves two roles: as a low-level framework for building custom protocol mocks (e.g., for new databases or protocols) and as a ready-to-use HTTP/HTTPS mock. The package includes a basic Redis mock and supports gevent, asyncio, and SSL out of the box.

You register mock entries with expected URLs, methods, and response bodies, then use a decorator or context manager to activate mocking for your test. Mocket also offers strict mode to fail tests that attempt real network access, and can verify that all registered mock entries were actually used. It depends on decorator, h11, puremagic, typing-extensions, and urllib3 at runtime.

Use it for:

• Test HTTP/HTTPS clients without hitting real endpoints or rate limits.
• Mock HTTPS calls with SSL support in unit tests for web service integrations.
• Build custom protocol mocks for testing database clients or proprietary socket-based services.
• Enforce network isolation in CI/CD by using strict mode to fail tests that leak real socket calls.
• Test error paths by mocking socket exceptions and connection failures.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Mocket is a socket mocking framework that intercepts and replaces socket and SSL module calls, enabling you to test socket-based clients without real network traffic.

Yes. Mocket is mature (active maintenance, 312 GitHub stars, no known vulnerabilities), has low install friction, and solves a real testing problem—isolating socket-based code from the network. Use it if you need to mock HTTP clients, test asyncio/gevent code, or build custom protocol mocks. The permissive BSD-3-Clause license poses no restriction.

Install

mocket on PyPI

pip install mocket

uv add mocket

poetry add mocket

Installing mocket

Before you install

Low friction: pure Python wheel with five lightweight runtime dependencies (decorator, h11, puremagic, typing-extensions, urllib3). Actively maintained with a recent release; last commit 2026-07-13. Supports modern Python versions (3.8–3.14) and PyPy.

License in practice

BSD-3-Clause (permissive): you can use, modify, and distribute mocket in proprietary projects without restriction, provided you include the license notice.

Quickstart

pip install mocket

from mocket import mocketize
from mocket.mocks.mockhttp import Entry

@mocketize
def test_api():
    Entry.single_register(
        Entry.GET,
        'https://api.example.com/data',
        body='{"key": "value"}',
        headers={'content-type': 'application/json'}
    )

Verify before relying

• Whether the Redis mock implementation is feature-complete enough for production test scenarios.
• Performance characteristics when mocking high-volume socket interactions.
• Compatibility with less common async frameworks beyond gevent and asyncio.

Package facts

Evidence: mocket-3.14.3-py3-none-any.whl

Tags

More Software Development packages