pytest-socket 0.2.0

Features

• Disables all network calls flowing through Python’s socket interface.

Requirements

• Pytest 3.0.0 or greater

Installation

You can install “pytest-socket” via pip from PyPI:

$ pip install pytest-socket

Usage

• Run pytest --disable-socket, tests should fail on any access to socket or libraries using socket with a SocketBlockedError.

  To add this flag as the default behavior, add this section to your pytest.ini or setup.cfg:

  [pytest]
  addopts = --disable-socket

  or update your conftest.py to include:

  from pytest_socket import disable_socket
  
  def pytest_runtest_setup():
      disable_socket()

• To enable specific tests use of socket, pass in the fixture to the test or use a marker:

  def test_explicitly_enable_socket(socket_enabled):
      assert socket.socket(socket.AF_INET, socket.SOCK_STREAM)
  
  
  @pytest.mark.enable_socket
  def test_explicitly_enable_socket_with_mark():
    assert socket.socket(socket.AF_INET, socket.SOCK_STREAM)

Contributing

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the MIT license, “pytest-socket” is free and open source software

Issues

If you encounter any problems, please file an issue along with a detailed description.

References

This plugin came about due to the efforts by @hangtwenty solving a StackOverflow question, then converted into a pytest plugin by @miketheman.