quantum-loop 0.1.0__py3-none-any.whl

quantum_loop/__init__.py

@@ -0,0 +1,20 @@
+"""A set of tools for quantum calculations.
+
+A Qubit in a regular computer is quantum of algorithm that is executed in
+one iteration of a cycle in a separate processor thread.
+
+Quantum is a function with an algorithm of task for data processing.
+
+In this case, the Qubit is not a single information,
+but it is a concept of the principle of operation of quantum calculations on a regular computer.
+"""
+
+from __future__ import annotations
+
+__all__ = (
+    "LoopMode",
+    "QuantumLoop",
+    "count_qubits",
+)
+
+from quantum_loop.loop import LoopMode, QuantumLoop, count_qubits

quantum_loop/loop.py

@@ -0,0 +1,132 @@
+"""A set of tools for quantum calculations.
+
+A Qubit in a regular computer is quantum of algorithm that is executed in
+one iteration of a cycle in a separate processor thread.
+
+Quantum is a function with an algorithm of task for data processing.
+
+In this case, the Qubit is not a single information,
+but it is a concept of the principle of operation of quantum calculations on a regular computer.
+
+The module contains the following tools:
+
+- `LoopMode` - Quantum loop mode.
+- `count_qubits()` - Counting the number of conceptual qubits of your computer.
+- `QuantumLoop` - Separation of the cycle into quantum algorithms for multiprocessing data processing.
+"""
+
+from __future__ import annotations
+
+import concurrent.futures
+import multiprocessing
+from collections.abc import Callable, Iterable
+from enum import Enum
+from typing import Any, Never, assert_never
+
+
+class LoopMode(Enum):
+    """Quantum loop mode."""
+
+    PROCESS_POOL = 1
+    THREAD_POOL = 2
+
+
+def count_qubits() -> int:
+    """Counting the number of conceptual qubits of your computer.
+
+    Conceptual qubit is quantum of algorithm (task) that is executed in
+    iterations of a cycle in a separate processor thread.
+
+    Quantum of algorithm is a function for data processing.
+
+    Examples:
+        >>> from xloft.quantum import count_qubits
+        >>> count_qubits()
+        16
+
+    Returns:
+        The number of conceptual qubits.
+    """
+    return multiprocessing.cpu_count()
+
+
+class QuantumLoop:
+    """Separation of the cycle into quantum algorithms for multiprocessing data processing.
+
+    Examples:
+        >>> from xloft.quantum import QuantumLoop
+        >>> def task(item):
+        ... return item * item
+        >>> data = range(10)
+        >>> QuantumLoop(task, data).run()
+        [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]
+
+    Args:
+        task: Function with a task algorithm.
+        data: The data that needs to be processed.
+        max_workers: The maximum number of processes that can be used to
+                     execute the given calls. If None or not given then as many
+                     worker processes will be created as the machine has processors.
+        timeout: The maximum number of seconds to wait. If None, then there
+                 is no limit on the wait time.
+        chunksize: The size of the chunks the iterable will be broken into
+                   before being passed to a child process. This argument is only
+                   used by ProcessPoolExecutor; it is ignored by ThreadPoolExecutor.
+        mode: The operating mode for a quantum loop: LoopMode.PROCESS_POOL | LoopMode.THREAD_POOL.
+    """
+
+    def __init__(  # noqa: D107
+        self,
+        task: Callable,
+        data: Iterable[Any],
+        max_workers: int | None = None,
+        timeout: float | None = None,
+        chunksize: int = 1,
+        mode: LoopMode = LoopMode.PROCESS_POOL,
+    ) -> None:
+        self.quantum = task
+        self.data = data
+        self.max_workers = max_workers
+        self.timeout = timeout
+        self.chunksize = chunksize
+        self.mode = mode
+
+    def process_pool(self) -> list[Any]:
+        """Better suitable for operations for which large processor resources are required."""
+        with concurrent.futures.ProcessPoolExecutor(self.max_workers) as executor:
+            results = list(
+                executor.map(
+                    self.quantum,
+                    self.data,
+                    timeout=self.timeout,
+                    chunksize=self.chunksize,
+                ),
+            )
+        return results  # noqa: RET504
+
+    def thread_pool(self) -> list[Any]:
+        """More suitable for tasks related to input-output
+        (for example, network queries, file operations),
+        where GIL is freed during input-output operations."""  # noqa: D205, D209
+        with concurrent.futures.ThreadPoolExecutor(self.max_workers) as executor:
+            results = list(
+                executor.map(
+                    self.quantum,
+                    self.data,
+                    timeout=self.timeout,
+                    chunksize=self.chunksize,
+                ),
+            )
+        return results  # noqa: RET504
+
+    def run(self) -> list[Any]:
+        """Run the quantum loop."""
+        results: list[Any] = []
+        match self.mode.value:
+            case 1:
+                results = self.process_pool()
+            case 2:
+                results = self.thread_pool()
+            case _ as unreachable:
+                assert_never(Never(unreachable))
+        return results

quantum_loop-0.1.0.dist-info/METADATA

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: quantum-loop
+Version: 0.1.0
+Summary: A set of tools for quantum calculations.
+Project-URL: Homepage, https://github.com/kebasyaty/quantum-loop
+Project-URL: Repository, https://github.com/kebasyaty/quantum-loop
+Project-URL: Source, https://github.com/kebasyaty/quantum-loop
+Project-URL: Bug Tracker, https://github.com/kebasyaty/quantum-loop/issues
+Project-URL: Changelog, https://github.com/kebasyaty/quantum-loop/blob/v0/CHANGELOG.md
+Author-email: kebasyaty <kebasyaty@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: loop,quantum,quantum-loop,qubit
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: <4.0,>=3.12
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <p align="center">
+    <a href="https://github.com/kebasyaty/quantum-loop">
+      <img
+        height="90"
+        alt="Logo"
+        src="https://raw.githubusercontent.com/kebasyaty/quantum-loop/main/assets/logo.svg">
+    </a>
+  </p>
+  <p>
+    <h1>Quantum Loop</h1>
+    <h3>A set of tools for quantum-loop calculations.</h3>
+    <p align="center">
+      <a href="https://github.com/kebasyaty/quantum-loop/actions/workflows/test.yml" alt="Build Status"><img src="https://github.com/kebasyaty/quantum-loop/actions/workflows/test.yml/badge.svg" alt="Build Status"></a>
+      <a href="https://kebasyaty.github.io/quantum-loop/" alt="Docs"><img src="https://img.shields.io/badge/docs-available-brightgreen.svg" alt="Docs"></a>
+      <a href="https://pypi.python.org/pypi/quantum-loop/" alt="PyPI pyversions"><img src="https://img.shields.io/pypi/pyversions/quantum-loop.svg" alt="PyPI pyversions"></a>
+      <a href="https://pypi.python.org/pypi/quantum-loop/" alt="PyPI status"><img src="https://img.shields.io/pypi/status/quantum-loop.svg" alt="PyPI status"></a>
+      <a href="https://pypi.python.org/pypi/quantum-loop/" alt="PyPI version fury.io"><img src="https://badge.fury.io/py/quantum-loop.svg" alt="PyPI version fury.io"></a>
+      <br>
+      <a href="https://github.com/kebasyaty/quantum-loop/issues"><img src="https://img.shields.io/github/issues/kebasyaty/quantum-loop.svg" alt="GitHub issues"></a>
+      <a href="https://pepy.tech/projects/quantum-loop"><img src="https://static.pepy.tech/badge/quantum-loop" alt="PyPI Downloads"></a>
+      <a href="https://github.com/kebasyaty/quantum-loop/blob/main/LICENSE" alt="GitHub license"><img src="https://img.shields.io/github/license/kebasyaty/quantum-loop" alt="GitHub license"></a>
+      <a href="https://mypy-lang.org/" alt="Types: Mypy"><img src="https://img.shields.io/badge/types-Mypy-202235.svg?color=0c7ebf" alt="Types: Mypy"></a>
+      <a href="https://docs.astral.sh/ruff/" alt="Code style: Ruff"><img src="https://img.shields.io/badge/code%20style-Ruff-FDD835.svg" alt="Code style: Ruff"></a>
+      <a href="https://github.com/kebasyaty/quantum-loop" alt="PyPI implementation"><img src="https://img.shields.io/pypi/implementation/quantum-loop" alt="PyPI implementation"></a>
+      <br>
+      <a href="https://pypi.org/project/quantum-loop"><img src="https://img.shields.io/pypi/format/quantum-loop" alt="Format"></a>
+      <a href="https://github.com/kebasyaty/quantum-loop"><img src="https://img.shields.io/github/languages/top/kebasyaty/quantum-loop" alt="Top"></a>
+      <a href="https://github.com/kebasyaty/quantum-loop"><img src="https://img.shields.io/github/repo-size/kebasyaty/quantum-loop" alt="Size"></a>
+      <a href="https://github.com/kebasyaty/quantum-loop"><img src="https://img.shields.io/github/last-commit/kebasyaty/quantum-loop/main" alt="Last commit"></a>
+      <a href="https://github.com/kebasyaty/quantum-loop/releases/" alt="GitHub release"><img src="https://img.shields.io/github/release/kebasyaty/quantum-loop" alt="GitHub release"></a>
+    </p>
+    <p align="center">
+      A Qubit in a regular computer is quantum of algorithm that is executed in
+      one iteration of a cycle in a separate processor thread.
+      <br>
+      Quantum is a function with an algorithm of task for data processing.
+      <br>
+      In this case, the Qubit is not a single information,
+      but it is a concept of the principle of operation of quantum calculations on a regular computer.
+    </p>
+  </p>
+</div>
+
+## Documentation
+
+Online browsable documentation is available at [https://kebasyaty.github.io/quantum-loop/](https://kebasyaty.github.io/quantum-loop/ "Documentation").
+
+## Requirements
+
+[View the list of requirements](https://github.com/kebasyaty/quantum-loop/blob/v0/REQUIREMENTS.md "Requirements").
+
+## Installation
+
+```shell
+uv add quantum-loop
+```
+
+## Usage
+
+```python
+from quantum_loop import LoopMode, QuantumLoop, count_qubits
+
+# Counting the number of conceptual qubits of your computer.
+num = count_qubits()
+print(num)  # => 16
+
+def task(item):
+    """Quantum."""
+    return item * item
+
+data = range(10)
+
+# Separation of the cycle into quantum algorithms for
+# multiprocessing data processing.
+results = quantum-loopLoop(task, data).run()
+print(results)  # => [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]
+```
+
+## Changelog
+
+[View the change history](https://github.com/kebasyaty/quantum-loop/blob/v0/CHANGELOG.md "Changelog").
+
+## License
+
+This project is licensed under the [MIT](https://github.com/kebasyaty/quantum-loop/blob/main/LICENSE "MIT").

quantum_loop-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+quantum_loop/__init__.py,sha256=CfmdL_nJ6QHGNRYmQ0qlPUVfBdZiUeBULMTHwOp9gvU,594
+quantum_loop/loop.py,sha256=ZkFqqFROC9j5JbwJmej3yL9VJcqElPrrimFTz0Pe3Mk,4679
+quantum_loop/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+quantum_loop-0.1.0.dist-info/METADATA,sha256=A2woqHhxHBAyE-XAhJG9AXuhN4aBqh3NLU2GJ3Pg9D8,5871
+quantum_loop-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+quantum_loop-0.1.0.dist-info/licenses/LICENSE,sha256=2zZINd6m_jNYlowdQImlEizyhSui5cBAJZRhWQURcEc,1095
+quantum_loop-0.1.0.dist-info/RECORD,,

quantum_loop-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

quantum_loop-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Gennady Kostyunin
+
+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.