pytest-asyncio-concurrent 0.1.2__tar.gz

pytest_asyncio_concurrent-0.1.2/LICENSE

@@ -0,0 +1,22 @@
+
+The MIT License (MIT)
+
+Copyright (c) 2024 Zane Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

pytest_asyncio_concurrent-0.1.2/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.1
+Name: pytest-asyncio-concurrent
+Version: 0.1.2
+Summary: Pytest plugin to execute python async tests concurrently.
+Author-email: Zane Chen <czl970721@gmail.com>
+Maintainer-email: Zane Chen <czl970721@gmail.com>
+License: 
+        The MIT License (MIT)
+        
+        Copyright (c) 2024 Zane Chen
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in
+        all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+        THE SOFTWARE.
+        
+Project-URL: Repository, https://github.com/czl9707/pytest-asyncio-concurrent
+Project-URL: Homepage, https://github.com/czl9707/pytest-asyncio-concurrent
+Project-URL: Issues, https://github.com/czl9707/pytest-asyncio-concurrent/issues
+Classifier: Framework :: Pytest
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+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.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: pytest>=6.2.0
+Provides-Extra: testing
+Requires-Dist: coverage>=7.6.0; extra == "testing"
+
+=========================
+pytest-asyncio-concurrent
+=========================
+
+.. image:: https://img.shields.io/pypi/v/pytest-asyncio-concurrent.svg
+    :target: https://pypi.org/project/pytest-asyncio-concurrent
+    :alt: PyPI version
+
+.. image:: https://img.shields.io/pypi/pyversions/pytest-asyncio-concurrent.svg
+    :target: https://pypi.org/project/pytest-asyncio-concurrent
+    :alt: Python versions
+
+.. image:: https://codecov.io/github/czl9707/pytest-asyncio-concurrent/graph/badge.svg?token=ENWHQBWQML 
+    :target: https://codecov.io/gh/czl9707/pytest-asyncio-concurrent
+    :alt: Testing Coverage
+
+.. image:: https://github.com/czl9707/pytest-asyncio-concurrent/actions/workflows/main.yml/badge.svg
+    :target: https://github.com/czl9707/pytest-asyncio-concurrent/actions/workflows/main.yml
+    :alt: See Build Status on GitHub Actions
+
+
+=========================
+
+System/Integration tests can take a really long time. 
+
+And ``pytest-asyncio-concurrent`` A pytest plugin is a solution for this by running asynchronous tests in true parallel, enabling faster execution for high I/O or network-bound test suites. 
+
+Unlike ``pytest-asyncio``, which runs async tests **sequentially**, ``pytest-asyncio-concurrent`` takes advantage of Python's asyncio capabilities to execute tests **concurrently** by specifying **async group**.
+
+Note: This plugin would more or less `Break Test Isolation Principle` \(for none function scoped fixture\). Please make sure your tests is ok to run concurrently before you use this plugin.
+
+
+Key Features
+------------
+
+- Giving the capability to run pytest async functions.
+- Providing granular control over Concurrency
+  - Specifying Async Group to control tests that can run together. 
+  - Specifying Timeout to avoid async tests taking forever. (Under Construction)
+- Compatible with ``pytest-asyncio``.
+
+Installation
+------------
+
+You can install "pytest-asyncio-concurrent" via `pip` from `PyPI`::
+
+    $ pip install pytest-asyncio-concurrent
+
+
+Usage
+-----
+
+Run test Sequentially
+
+.. code-block:: python
+
+    @pytest.mark.asyncio_concurrent
+    async def async_test_A():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+    @pytest.mark.asyncio_concurrent
+    async def async_test_B():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+
+Run tests Concurrently
+
+.. code-block:: python
+
+    # the test below will run by itself
+    @pytest.mark.asyncio_concurrent
+    async def test_by_itself():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+    # the two tests below will run concurrently
+    @pytest.mark.asyncio_concurrent(group="my_group")
+    async def test_groupA():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+    @pytest.mark.asyncio_concurrent(group="my_group")
+    async def test_groupB():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+
+Parametrized Tests
+
+.. code-block:: python
+
+    # the parametrized tests below will run sequential
+    @pytest.mark.asyncio_concurrent
+    @pytest.parametrize("p", [0, 1, 2])
+    async def test_parametrize_sequential(p):
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+    # the parametrized tests below will run concurrently
+    @pytest.mark.asyncio_concurrent(group="my_group")
+    @pytest.parametrize("p", [0, 1, 2])
+    async def test_parametrize_concurrent():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+
+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-asyncio-concurrent" is free and open source software

pytest_asyncio_concurrent-0.1.2/README.rst

@@ -0,0 +1,118 @@
+=========================
+pytest-asyncio-concurrent
+=========================
+
+.. image:: https://img.shields.io/pypi/v/pytest-asyncio-concurrent.svg
+    :target: https://pypi.org/project/pytest-asyncio-concurrent
+    :alt: PyPI version
+
+.. image:: https://img.shields.io/pypi/pyversions/pytest-asyncio-concurrent.svg
+    :target: https://pypi.org/project/pytest-asyncio-concurrent
+    :alt: Python versions
+
+.. image:: https://codecov.io/github/czl9707/pytest-asyncio-concurrent/graph/badge.svg?token=ENWHQBWQML 
+    :target: https://codecov.io/gh/czl9707/pytest-asyncio-concurrent
+    :alt: Testing Coverage
+
+.. image:: https://github.com/czl9707/pytest-asyncio-concurrent/actions/workflows/main.yml/badge.svg
+    :target: https://github.com/czl9707/pytest-asyncio-concurrent/actions/workflows/main.yml
+    :alt: See Build Status on GitHub Actions
+
+
+=========================
+
+System/Integration tests can take a really long time. 
+
+And ``pytest-asyncio-concurrent`` A pytest plugin is a solution for this by running asynchronous tests in true parallel, enabling faster execution for high I/O or network-bound test suites. 
+
+Unlike ``pytest-asyncio``, which runs async tests **sequentially**, ``pytest-asyncio-concurrent`` takes advantage of Python's asyncio capabilities to execute tests **concurrently** by specifying **async group**.
+
+Note: This plugin would more or less `Break Test Isolation Principle` \(for none function scoped fixture\). Please make sure your tests is ok to run concurrently before you use this plugin.
+
+
+Key Features
+------------
+
+- Giving the capability to run pytest async functions.
+- Providing granular control over Concurrency
+  - Specifying Async Group to control tests that can run together. 
+  - Specifying Timeout to avoid async tests taking forever. (Under Construction)
+- Compatible with ``pytest-asyncio``.
+
+Installation
+------------
+
+You can install "pytest-asyncio-concurrent" via `pip` from `PyPI`::
+
+    $ pip install pytest-asyncio-concurrent
+
+
+Usage
+-----
+
+Run test Sequentially
+
+.. code-block:: python
+
+    @pytest.mark.asyncio_concurrent
+    async def async_test_A():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+    @pytest.mark.asyncio_concurrent
+    async def async_test_B():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+
+Run tests Concurrently
+
+.. code-block:: python
+
+    # the test below will run by itself
+    @pytest.mark.asyncio_concurrent
+    async def test_by_itself():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+    # the two tests below will run concurrently
+    @pytest.mark.asyncio_concurrent(group="my_group")
+    async def test_groupA():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+    @pytest.mark.asyncio_concurrent(group="my_group")
+    async def test_groupB():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+
+Parametrized Tests
+
+.. code-block:: python
+
+    # the parametrized tests below will run sequential
+    @pytest.mark.asyncio_concurrent
+    @pytest.parametrize("p", [0, 1, 2])
+    async def test_parametrize_sequential(p):
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+    # the parametrized tests below will run concurrently
+    @pytest.mark.asyncio_concurrent(group="my_group")
+    @pytest.parametrize("p", [0, 1, 2])
+    async def test_parametrize_concurrent():
+        res = await wait_for_something_async()
+        assert result.is_valid()
+
+
+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-asyncio-concurrent" is free and open source software

pytest_asyncio_concurrent-0.1.2/pyproject.toml

@@ -0,0 +1,120 @@
+[build-system]
+requires = [
+  "setuptools>=61.0",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pytest-asyncio-concurrent"
+description = "Pytest plugin to execute python async tests concurrently."
+version = "0.1.2"
+readme = "README.rst"
+requires-python = ">=3.8"
+authors = [
+    { name = "Zane Chen", email = "czl970721@gmail.com" },
+]
+maintainers = [
+    { name = "Zane Chen", email = "czl970721@gmail.com" },
+]
+license = {file = "LICENSE"}
+classifiers = [
+    "Framework :: Pytest",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Testing",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3 :: Only",
+    "License :: OSI Approved :: MIT License",
+]
+dependencies = [
+    "pytest>=6.2.0",
+]
+optional-dependencies.testing = [
+    "coverage>=7.6.0",
+]
+[project.urls]
+Repository = "https://github.com/czl9707/pytest-asyncio-concurrent"
+Homepage = "https://github.com/czl9707/pytest-asyncio-concurrent"
+Issues = "https://github.com/czl9707/pytest-asyncio-concurrent/issues"
+
+[project.entry-points.pytest11]
+asyncio-concurrent = "pytest_asyncio_concurrent.plugin"
+
+[tool.setuptools]
+packages = [
+  "pytest_asyncio_concurrent",
+]
+include-package-data = true
+license-files = [
+  "LICENSE",
+]
+
+[tool.black]
+line-length = 100
+
+[tool.flake8]
+max-line-length = 100
+
+[tool.pytest.ini_options]
+asyncio_mode = "strict"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.coverage.run]
+source = [
+  "pytest_asyncio_concurrent",
+]
+branch = true
+data_file = "coverage/coverage"
+omit = [
+  "*/_version.py",
+]
+parallel = true
+concurrency = [ 
+    "multiprocessing"
+]
+
+[tool.coverage.report]
+show_missing = true
+
+[tool.bumpversion]
+current_version = "0.1.2"
+parse = """(?x)
+  (?P<major>0|[1-9]\\d*)\\.
+  (?P<minor>0|[1-9]\\d*)\\.
+  (?P<patch>0|[1-9]\\d*)
+  (?:
+      -prerelease-(?P<pre>0|[1-9]\\d*)
+  )?
+"""
+serialize = [
+  "{major}.{minor}.{patch}-prerelease-{pre}",
+  "{major}.{minor}.{patch}",
+]
+search = "{current_version}"
+replace = "{new_version}"
+regex = false
+ignore_missing_version = false
+ignore_missing_files = false
+tag = true
+sign_tags = false
+tag_name = "v{new_version}"
+tag_message = "Bump version: {current_version} → {new_version}"
+allow_dirty = false
+commit = true
+message = "Bump version: {current_version} → {new_version}"
+commit_args = ""
+setup_hooks = []
+pre_commit_hooks = []
+post_commit_hooks = []
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = "version = \"{current_version}\""
+replace = "version = \"{new_version}\""

pytest_asyncio_concurrent-0.1.2/pytest_asyncio_concurrent/__init__.py

@@ -0,0 +1,8 @@
+"""The main point for importing pytest-asyncio-concurrent items."""
+
+from typing import List
+from .plugin import AsyncioConcurrentGroup
+
+__all__: List[str] = [
+    AsyncioConcurrentGroup.__name__,
+]