rustest 0.7.0__cp310-cp310-macosx_10_12_x86_64.whl

rustest-0.7.0.dist-info/METADATA

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: rustest
+Version: 0.7.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
+
+# Rerun only failed tests
+rustest --lf                         # Last failed only
+rustest --ff                         # Failed first, then all others
+
+# Exit on first failure
+rustest -x                           # Fail fast
+
+# Combine options
+rustest --ff -x                      # Run failed tests first, stop on first failure
+
+# 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.7.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+rustest-0.7.0.dist-info/METADATA,sha256=4oreZ3cw8nBFQuC5UMDhGkci1x-9p5KT6sz0YXkuhoA,8818
+rustest-0.7.0.dist-info/WHEEL,sha256=6OEI0fn46RZW776jnDyvYKnzOfyEBMUSBYc_YzRdWnE,107
+rustest-0.7.0.dist-info/entry_points.txt,sha256=7fUa3LO8vudQ4dKG1sTRaDnxcMdBSZsWs9EyuxFQ7Lk,48
+rustest-0.7.0.dist-info/licenses/LICENSE,sha256=s64ibUGtb6jEDBsYuxUFtMr_c4PaqYP-vj3YY6QtTGw,1075
+rustest/__init__.py,sha256=0CkHfrmIjpGw6DMu2VcZLOUpBVtdwsN-aitn-RzOglo,514
+rustest/__main__.py,sha256=bBvo5gsSluUzlDTDvn5bP_gZZEXMwJQZMqVA5W1M1v8,178
+rustest/approx.py,sha256=MKmuorBBHqpH0h0QaIMVjbm3-mXJ0E90limEgSHHVfw,5744
+rustest/cli.py,sha256=26zaX635WqW0q8B-alb0Kk0wzIDZVkF-y9ZqzKtHDbI,10185
+rustest/core.py,sha256=FBnr3yzHQequ83R-pRlwlCdbcYlkjjucwtHpp0gnqdQ,1461
+rustest/decorators.py,sha256=mZDieFSaUx5FIeDqsWO07H6E0urk70cOYtQIuCIjKzY,18703
+rustest/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rustest/reporting.py,sha256=3-R8aljv2ZbmjOa9Q9KZeCPsMaitm8nZ96LoJS_NnUQ,1623
+rustest/rust.cpython-310-darwin.so,sha256=ElGdG4FcCR6AcsSTphhOzc0g5wnktFv8SLzIKS2vl-g,1668672
+rustest/rust.py,sha256=tCIvjYd06VxoT_rKvv2o8CpXW_pFNua5VgcRDjLgU78,659
+rustest/rust.pyi,sha256=bJDdaokbRZWPtTZ1bwsXWb43L9jwOm2gLkk7LzNlQcw,810
+rustest-0.7.0.dist-info/RECORD,,

rustest-0.7.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.10.0)
+Root-Is-Purelib: false
+Tag: cp310-cp310-macosx_10_12_x86_64

rustest-0.7.0.dist-info/entry_points.txt

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

rustest-0.7.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.