rustest 0.6.0__cp311-cp311-win_amd64.whl

rustest-0.6.0.dist-info/METADATA

@@ -0,0 +1,222 @@
+Metadata-Version: 2.4
+Name: rustest
+Version: 0.6.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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.14
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Testing
+Requires-Dist: typing-extensions>=4.15
+Requires-Dist: basedpyright>=1.19 ; extra == 'dev'
+Requires-Dist: maturin>=1.4,<2 ; extra == 'dev'
+Requires-Dist: poethepoet>=0.22 ; extra == 'dev'
+Requires-Dist: pre-commit>=3.5 ; extra == 'dev'
+Requires-Dist: pytest>=7.0 ; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.2.0 ; extra == 'dev'
+Requires-Dist: pytest-codeblocks>=0.17.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.1.9 ; extra == 'dev'
+Requires-Dist: mkdocs>=1.5.0 ; extra == 'docs'
+Requires-Dist: mkdocs-material>=9.5.0 ; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.24.0 ; extra == 'docs'
+Requires-Dist: mkdocs-autorefs>=0.5.0 ; extra == 'docs'
+Provides-Extra: dev
+Provides-Extra: docs
+License-File: LICENSE
+Summary: Rust powered pytest-compatible runner
+Author: rustest contributors
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/Apex-Engineers-Inc/rustest
+Project-URL: Repository, https://github.com/Apex-Engineers-Inc/rustest
+Project-URL: Documentation, https://apex-engineers-inc.github.io/rustest
+
+# rustest
+
+Rustest (pronounced like Russ-Test) is a Rust-powered test runner that aims to provide the most common pytest ergonomics with a focus on raw performance. Get **~2x faster** test execution with familiar syntax and minimal setup.
+
+📚 **[Full Documentation](https://apex-engineers-inc.github.io/rustest)** | [Getting Started](https://apex-engineers-inc.github.io/rustest/getting-started/quickstart/) | [User Guide](https://apex-engineers-inc.github.io/rustest/guide/writing-tests/) | [API Reference](https://apex-engineers-inc.github.io/rustest/api/overview/)
+
+## Why rustest?
+
+- 🚀 **About 2x faster** than pytest on the rustest integration test suite
+- ✅ Familiar `@fixture`, `@parametrize`, `@skip`, and `@mark` decorators
+- 🔄 **Built-in async support** with `@mark.asyncio` (like pytest-asyncio)
+- 🔍 Automatic test discovery (`test_*.py` and `*_test.py` files)
+- 📝 **Built-in markdown code block testing** (like pytest-codeblocks, but faster)
+- 🎯 Simple, clean API—if you know pytest, you already know rustest
+- 🧮 Built-in `approx()` helper for tolerant numeric comparisons
+- 🪤 `raises()` context manager for precise exception assertions
+- 📦 Easy installation with pip or uv
+- ⚡ Low-overhead execution keeps small suites feeling instant
+
+## Performance
+
+Rustest is designed for speed. Our latest benchmarks on the rustest integration suite (~200 tests) show a consistent **2.1x wall-clock speedup** over pytest:
+
+| Test Runner | Wall Clock | Speedup | Command |
+|-------------|------------|---------|---------|
+| pytest      | 1.33–1.59s | 1.0x (baseline) | `pytest tests/ examples/tests/ -q` |
+| rustest     | 0.69–0.70s | **~2.1x faster** | `python -m rustest tests/ examples/tests/` |
+
+### Large Parametrized Stress Test
+
+With **10,000 parametrized invocations**:
+
+| Test Runner | Avg. Wall Clock | Speedup | Command |
+|-------------|-----------------|---------|---------|
+| pytest      | 9.72s           | 1.0x    | `pytest benchmarks/test_large_parametrize.py -q` |
+| rustest     | 0.41s           | **~24x faster** | `python -m rustest benchmarks/test_large_parametrize.py` |
+
+**[📊 View Detailed Performance Analysis →](https://apex-engineers-inc.github.io/rustest/advanced/performance/)**
+
+## Installation
+
+Rustest supports Python **3.10 through 3.14**.
+
+<!--pytest.mark.skip-->
+```bash
+# Using pip
+pip install rustest
+
+# Using uv
+uv add rustest
+```
+
+**[📖 Installation Guide →](https://apex-engineers-inc.github.io/rustest/getting-started/installation/)**
+
+## Quick Start
+
+### 1. Write Your Tests
+
+Create a file `test_math.py`:
+
+```python
+from rustest import fixture, parametrize, mark, approx, raises
+import asyncio
+
+@fixture
+def numbers() -> list[int]:
+    return [1, 2, 3, 4, 5]
+
+def test_sum(numbers: list[int]) -> None:
+    assert sum(numbers) == approx(15)
+
+@parametrize("value,expected", [(2, 4), (3, 9), (4, 16)])
+def test_square(value: int, expected: int) -> None:
+    assert value ** 2 == expected
+
+@mark.slow
+def test_expensive_operation() -> None:
+    result = sum(range(1000000))
+    assert result > 0
+
+@mark.asyncio
+async def test_async_operation() -> None:
+    # Example async operation
+    await asyncio.sleep(0.001)
+    result = 42
+    assert result == 42
+
+def test_division_by_zero() -> None:
+    with raises(ZeroDivisionError, match="division by zero"):
+        1 / 0
+```
+
+### 2. Run Your Tests
+
+<!--pytest.mark.skip-->
+```bash
+# Run all tests
+rustest
+
+# Run specific tests
+rustest tests/
+
+# Filter by test name pattern
+rustest -k "test_sum"
+
+# Filter by marks
+rustest -m "slow"                    # Run only slow tests
+rustest -m "not slow"                # Skip slow tests
+rustest -m "slow and integration"    # Run tests with both marks
+
+# Show output during execution
+rustest --no-capture
+```
+
+**[📖 Full Quick Start Guide →](https://apex-engineers-inc.github.io/rustest/getting-started/quickstart/)**
+
+## Documentation
+
+**[📚 Full Documentation](https://apex-engineers-inc.github.io/rustest)**
+
+### Getting Started
+- [Installation](https://apex-engineers-inc.github.io/rustest/getting-started/installation/)
+- [Quick Start](https://apex-engineers-inc.github.io/rustest/getting-started/quickstart/)
+
+### User Guide
+- [Writing Tests](https://apex-engineers-inc.github.io/rustest/guide/writing-tests/)
+- [Fixtures](https://apex-engineers-inc.github.io/rustest/guide/fixtures/)
+- [Parametrization](https://apex-engineers-inc.github.io/rustest/guide/parametrization/)
+- [Marks & Skipping](https://apex-engineers-inc.github.io/rustest/guide/marks/)
+- [Test Classes](https://apex-engineers-inc.github.io/rustest/guide/test-classes/)
+- [Assertion Helpers](https://apex-engineers-inc.github.io/rustest/guide/assertions/)
+- [Markdown Testing](https://apex-engineers-inc.github.io/rustest/guide/markdown-testing/)
+- [CLI Usage](https://apex-engineers-inc.github.io/rustest/guide/cli/)
+- [Python API](https://apex-engineers-inc.github.io/rustest/guide/python-api/)
+
+### API Reference
+- [API Overview](https://apex-engineers-inc.github.io/rustest/api/overview/)
+- [Decorators](https://apex-engineers-inc.github.io/rustest/api/decorators/)
+- [Test Execution](https://apex-engineers-inc.github.io/rustest/api/core/)
+- [Reporting](https://apex-engineers-inc.github.io/rustest/api/reporting/)
+- [Assertion Utilities](https://apex-engineers-inc.github.io/rustest/api/approx/)
+
+### Advanced Topics
+- [Performance](https://apex-engineers-inc.github.io/rustest/advanced/performance/)
+- [Comparison with pytest](https://apex-engineers-inc.github.io/rustest/advanced/comparison/)
+- [Development Guide](https://apex-engineers-inc.github.io/rustest/advanced/development/)
+
+## Feature Comparison with pytest
+
+Rustest implements the 20% of pytest features that cover 80% of use cases, with a focus on raw speed and simplicity.
+
+**[📋 View Full Feature Comparison →](https://apex-engineers-inc.github.io/rustest/advanced/comparison/)**
+
+✅ **Supported:** Fixtures, parametrization, marks, test classes, conftest.py, markdown testing
+🚧 **Planned:** Parallel execution, mark filtering, JUnit XML output
+❌ **Not Planned:** Plugins, hooks, custom collectors (keeps rustest simple)
+
+## Contributing
+
+We welcome contributions! See the [Development Guide](https://apex-engineers-inc.github.io/rustest/advanced/development/) for setup instructions.
+
+Quick reference:
+
+<!--pytest.mark.skip-->
+```bash
+# Setup
+git clone https://github.com/Apex-Engineers-Inc/rustest.git
+cd rustest
+uv sync --all-extras
+uv run maturin develop
+
+# Run tests
+uv run poe pytests  # Python tests
+cargo test          # Rust tests
+
+# Format and lint
+uv run pre-commit install  # One-time setup
+git commit -m "message"    # Pre-commit hooks run automatically
+```
+
+## License
+
+rustest is distributed under the terms of the MIT license. See [LICENSE](LICENSE).
+

rustest-0.6.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+rustest-0.6.0.dist-info/METADATA,sha256=OaAioWZ5wAX75e9VciefGvwIWd7fa-FkCMjODMyfea8,8671
+rustest-0.6.0.dist-info/WHEEL,sha256=bNaa2-XeaoMXnkzV391Sm2NgCjpJ3A2VmfN6ZUnNTZA,96
+rustest-0.6.0.dist-info/entry_points.txt,sha256=7fUa3LO8vudQ4dKG1sTRaDnxcMdBSZsWs9EyuxFQ7Lk,48
+rustest-0.6.0.dist-info/licenses/LICENSE,sha256=Ci0bB0T1ZGkqIV237Zp_Bv8LIJJ0Vxwc-AhLhgDgAoQ,1096
+rustest/__init__.py,sha256=LL9UloOClzeNO6A-iMkEFtHDrBTAhRLko3sXy55H0QA,542
+rustest/__main__.py,sha256=yMhaWvxGAV46BYY8fB6GoRy9oh8Z8YrS9wlZI3LmoyY,188
+rustest/approx.py,sha256=sGaH15n3vSSv84dmR_QAIDV-xwaUrX-MqwpWIp5ihjk,5904
+rustest/cli.py,sha256=Y7I3sLMA7icsHFLdcGJMy0LElEcoqzrVrTkedE_vGTs,9474
+rustest/core.py,sha256=2_kav-3XPhrtXnayQBDSc_tCaaaEj07rFHq5ln4Em8Q,1227
+rustest/decorators.py,sha256=mUrnY09mn7x0--3OAB47WQRR2f8NtexVSUWAUGcHvyc,19240
+rustest/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rustest/reporting.py,sha256=g4jdlwjFoKF_fWA_sKfeDwmhDeHxPJQUqypa_E2XQlc,1686
+rustest/rust.cp311-win_amd64.pyd,sha256=_S9o4dm79Gfx9jECXTufK9JthpxZ-cGjllPWHUYY7Os,1344000
+rustest/rust.py,sha256=N_1C-uXRiC2qkV7ecKVcb51-XXyfhYNepd5zs-RIYOo,682
+rustest/rust.pyi,sha256=D2PL2GamLpcwdBDZxFeWC1ZgJ01CkvWycU62LnVTMD0,799
+rustest-0.6.0.dist-info/RECORD,,

rustest-0.6.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.6)
+Root-Is-Purelib: false
+Tag: cp311-cp311-win_amd64

rustest-0.6.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+rustest=rustest.__main__:main

rustest-0.6.0.dist-info/licenses/LICENSE

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