pytest-socket 0.6.0__tar.gz → 0.8.0__tar.gz

{pytest_socket-0.6.0 → pytest_socket-0.8.0}/PKG-INFO

@@ -1,34 +1,32 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pytest-socket
-Version: 0.6.0
+Version: 0.8.0
 Summary: Pytest Plugin to disable socket calls during tests
-Home-page: https://pypi.org/project/pytest-socket/
-License: MIT
 Author: Mike Fiedler
-Author-email: miketheman@gmail.com
-Requires-Python: >=3.7,<4.0
+Author-email: Mike Fiedler <miketheman@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Testing
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Topic :: Software Development :: Testing
-Requires-Dist: pytest (>=3.6.3)
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Typing :: Typed
+Requires-Dist: pytest>=7.0.0
+Requires-Python: >=3.10
+Project-URL: Homepage, https://pypi.org/project/pytest-socket/
+Project-URL: Repository, https://github.com/miketheman/pytest-socket
 Project-URL: Bug Tracker, https://github.com/miketheman/pytest-socket/issues
 Project-URL: Change Log, https://github.com/miketheman/pytest-socket/blob/main/CHANGELOG.md
-Project-URL: Repository, https://github.com/miketheman/pytest-socket
+Project-URL: Funding, https://github.com/sponsors/miketheman
 Description-Content-Type: text/markdown
 
 # pytest-socket
@@ -38,7 +36,6 @@ Description-Content-Type: text/markdown
 [![Tests](https://github.com/miketheman/pytest-socket/workflows/Python%20Tests/badge.svg)](https://github.com/miketheman/pytest-socket/actions?query=workflow%3A%22Python+Tests%22)
 [![pre-commit.ci status](https://results.pre-commit.ci/badge/github/miketheman/pytest-socket/main.svg)](https://results.pre-commit.ci/latest/github/miketheman/pytest-socket/main)
 [![Maintainability](https://api.codeclimate.com/v1/badges/1608a75b1c3a20211992/maintainability)](https://codeclimate.com/github/miketheman/pytest-socket/maintainability)
-[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmiketheman%2Fpytest-socket.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmiketheman%2Fpytest-socket?ref=badge_shield)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 
 A plugin to use with Pytest to disable or restrict `socket` calls during
@@ -48,11 +45,17 @@ tests to ensure network calls are prevented.
 
 ## Features
 
-- Disables all network calls flowing through Python\'s `socket` interface.
+- Disables all network calls flowing through Python's `socket` interface,
+  including DNS resolution.
+- Restricts connections to an allow-list of hosts, IP addresses, or CIDR
+  network ranges.
+- Allows Unix domain sockets selectively, for example when testing async code.
+- Applies globally via CLI flags, or per-test via fixtures and markers.
 
 ## Requirements
 
-- [Pytest](https://github.com/pytest-dev/pytest) 3.6.3 or greater
+- [Pytest](https://github.com/pytest-dev/pytest) 7.0 or greater
+- Python 3.10 or greater
 
 ## Installation
 
@@ -60,14 +63,16 @@ You can install `pytest-socket` via [pip](https://pypi.python.org/pypi/pip/)
 from [PyPI](https://pypi.python.org/pypi):
 
 ```console
-$ pip install pytest-socket
+pip install pytest-socket
 ```
 
-or add to your `pyproject.toml` for [poetry](https://python-poetry.org/):
+or add to your `pyproject.toml` for [uv](https://docs.astral.sh/uv/):
 
-```ini
-[tool.poetry.dev-dependencies]
-pytest-socket = "*"
+```toml
+[project.optional-dependencies]
+dev = [
+    "pytest-socket",
+]
 ```
 
 ## Usage
@@ -76,21 +81,21 @@ 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`](https://docs.pytest.org/en/6.2.x/customize.html#pytest-ini):
+[`pytest.ini`](https://docs.pytest.org/en/stable/reference/customize.html#pytest-ini):
 
 ```ini
 [pytest]
 addopts = --disable-socket
 ```
 
-or add this to your [`setup.cfg`](https://docs.pytest.org/en/6.2.x/customize.html#setup-cfg):
+or add this to your [`setup.cfg`](https://docs.pytest.org/en/stable/reference/customize.html#setup-cfg):
 
 ```ini
 [tool:pytest]
 addopts = --disable-socket
 ```
 
-or update your [`conftest.py`](https://docs.pytest.org/en/6.2.x/writing_plugins.html#conftest-py-plugins) to include:
+or update your [`conftest.py`](https://docs.pytest.org/en/stable/how-to/writing_plugins.html#conftest-py-local-per-directory-plugins) to include:
 
 ```python
 from pytest_socket import disable_socket
@@ -99,6 +104,9 @@ def pytest_runtest_setup():
     disable_socket()
 ```
 
+If you exceptionally want to enable socket for one particular execution
+pass `--force-enable-socket`. It takes precedence over `--disable-socket`.
+
 To enable Unix sockets during the test run (e.g. for async), add this option:
 
 ```ini
@@ -134,6 +142,9 @@ or for whole test run
 addopts = --allow-hosts=127.0.0.1,127.0.1.1
 ```
 
+Entries may be hostnames, IP addresses, or CIDR network ranges such as
+`192.168.0.0/24`.
+
 ### Frequently Asked Questions
 
 Q: Why is network access disabled in some of my tests but not others?
@@ -160,8 +171,6 @@ Distributed under the terms of the
 [MIT](http://opensource.org/licenses/MIT) license, "pytest-socket" is
 free and open source software
 
-[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmiketheman%2Fpytest-socket.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmiketheman%2Fpytest-socket?ref=badge_large)
-
 ## Issues
 
 If you encounter any problems, please [file an issue](https://github.com/miketheman/pytest-socket/issues)
@@ -180,3 +189,6 @@ This plugin came about due to the efforts by
 question](https://stackoverflow.com/a/30064664), then converted into a
 pytest plugin by [\@miketheman](https://github.com/miketheman).
 
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=miketheman/pytest-socket)](https://star-history.com/#miketheman/pytest-socket&Date)

{pytest_socket-0.6.0 → pytest_socket-0.8.0}/README.md

@@ -5,7 +5,6 @@
 [![Tests](https://github.com/miketheman/pytest-socket/workflows/Python%20Tests/badge.svg)](https://github.com/miketheman/pytest-socket/actions?query=workflow%3A%22Python+Tests%22)
 [![pre-commit.ci status](https://results.pre-commit.ci/badge/github/miketheman/pytest-socket/main.svg)](https://results.pre-commit.ci/latest/github/miketheman/pytest-socket/main)
 [![Maintainability](https://api.codeclimate.com/v1/badges/1608a75b1c3a20211992/maintainability)](https://codeclimate.com/github/miketheman/pytest-socket/maintainability)
-[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmiketheman%2Fpytest-socket.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmiketheman%2Fpytest-socket?ref=badge_shield)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 
 A plugin to use with Pytest to disable or restrict `socket` calls during
@@ -15,11 +14,17 @@ tests to ensure network calls are prevented.
 
 ## Features
 
-- Disables all network calls flowing through Python\'s `socket` interface.
+- Disables all network calls flowing through Python's `socket` interface,
+  including DNS resolution.
+- Restricts connections to an allow-list of hosts, IP addresses, or CIDR
+  network ranges.
+- Allows Unix domain sockets selectively, for example when testing async code.
+- Applies globally via CLI flags, or per-test via fixtures and markers.
 
 ## Requirements
 
-- [Pytest](https://github.com/pytest-dev/pytest) 3.6.3 or greater
+- [Pytest](https://github.com/pytest-dev/pytest) 7.0 or greater
+- Python 3.10 or greater
 
 ## Installation
 
@@ -27,14 +32,16 @@ You can install `pytest-socket` via [pip](https://pypi.python.org/pypi/pip/)
 from [PyPI](https://pypi.python.org/pypi):
 
 ```console
-$ pip install pytest-socket
+pip install pytest-socket
 ```
 
-or add to your `pyproject.toml` for [poetry](https://python-poetry.org/):
+or add to your `pyproject.toml` for [uv](https://docs.astral.sh/uv/):
 
-```ini
-[tool.poetry.dev-dependencies]
-pytest-socket = "*"
+```toml
+[project.optional-dependencies]
+dev = [
+    "pytest-socket",
+]
 ```
 
 ## Usage
@@ -43,21 +50,21 @@ 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`](https://docs.pytest.org/en/6.2.x/customize.html#pytest-ini):
+[`pytest.ini`](https://docs.pytest.org/en/stable/reference/customize.html#pytest-ini):
 
 ```ini
 [pytest]
 addopts = --disable-socket
 ```
 
-or add this to your [`setup.cfg`](https://docs.pytest.org/en/6.2.x/customize.html#setup-cfg):
+or add this to your [`setup.cfg`](https://docs.pytest.org/en/stable/reference/customize.html#setup-cfg):
 
 ```ini
 [tool:pytest]
 addopts = --disable-socket
 ```
 
-or update your [`conftest.py`](https://docs.pytest.org/en/6.2.x/writing_plugins.html#conftest-py-plugins) to include:
+or update your [`conftest.py`](https://docs.pytest.org/en/stable/how-to/writing_plugins.html#conftest-py-local-per-directory-plugins) to include:
 
 ```python
 from pytest_socket import disable_socket
@@ -66,6 +73,9 @@ def pytest_runtest_setup():
     disable_socket()
 ```
 
+If you exceptionally want to enable socket for one particular execution
+pass `--force-enable-socket`. It takes precedence over `--disable-socket`.
+
 To enable Unix sockets during the test run (e.g. for async), add this option:
 
 ```ini
@@ -101,6 +111,9 @@ or for whole test run
 addopts = --allow-hosts=127.0.0.1,127.0.1.1
 ```
 
+Entries may be hostnames, IP addresses, or CIDR network ranges such as
+`192.168.0.0/24`.
+
 ### Frequently Asked Questions
 
 Q: Why is network access disabled in some of my tests but not others?
@@ -127,8 +140,6 @@ Distributed under the terms of the
 [MIT](http://opensource.org/licenses/MIT) license, "pytest-socket" is
 free and open source software
 
-[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmiketheman%2Fpytest-socket.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmiketheman%2Fpytest-socket?ref=badge_large)
-
 ## Issues
 
 If you encounter any problems, please [file an issue](https://github.com/miketheman/pytest-socket/issues)
@@ -146,3 +157,7 @@ This plugin came about due to the efforts by
 [\@hangtwenty](https://github.com/hangtwenty) solving a [StackOverflow
 question](https://stackoverflow.com/a/30064664), then converted into a
 pytest plugin by [\@miketheman](https://github.com/miketheman).
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=miketheman/pytest-socket)](https://star-history.com/#miketheman/pytest-socket&Date)

pytest_socket-0.8.0/pyproject.toml

@@ -0,0 +1,68 @@
+[project]
+name = "pytest-socket"
+version = "0.8.0"
+description = "Pytest Plugin to disable socket calls during tests"
+authors = [{ name = "Mike Fiedler", email = "miketheman@gmail.com" }]
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: Pytest",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Testing",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Operating System :: OS Independent",
+    "License :: OSI Approved :: MIT License",
+    "Typing :: Typed",
+]
+requires-python = ">= 3.10"
+dependencies = ["pytest>=7.0.0"]
+
+[dependency-groups]
+dev = [
+    "coverage[toml] >= 7.9",
+    "httpx >= 0.28.1",
+    "mypy >= 1.20",
+    "pytest-randomly >= 3.15.0",
+    "starlette >= 0.47.1",
+]
+
+[project.urls]
+"Homepage" = "https://pypi.org/project/pytest-socket/"
+"Repository" = "https://github.com/miketheman/pytest-socket"
+"Bug Tracker" = "https://github.com/miketheman/pytest-socket/issues"
+"Change Log" = "https://github.com/miketheman/pytest-socket/blob/main/CHANGELOG.md"
+"Funding" = "https://github.com/sponsors/miketheman"
+
+[project.entry-points.pytest11]
+socket = 'pytest_socket'
+
+[tool.uv.build-backend]
+source-include = [".flake8", "tests/*"]
+
+[tool.coverage.report]
+include = ["src/pytest_socket/*", "tests/*"]
+
+[tool.isort]
+known_first_party = ['pytest_socket', 'conftest']
+# https://black.readthedocs.io/en/stable/guides/using_black_with_other_tools.html#profilegcm
+profile = "black"
+
+[tool.mypy]
+strict = true
+
+[tool.vulture]
+ignore_decorators = ["@pytest.fixture"]
+ignore_names = ["pytest_*"]
+paths = ["src/pytest_socket"]
+
+[build-system]
+requires = ["uv_build>=0.7.20,<0.12.0"]
+build-backend = "uv_build"