# Testenix

> Testenix is an alpha, async-native, parallel-first Python testing framework with a
> dependency-free native runtime, a lossless result model, and an optional pytest bridge.

Canonical documentation: https://polishdataengineer.github.io/testenix/
Source repository: https://github.com/polishdataengineer/testenix
Package index: https://pypi.org/project/testenix/

## Start here

- [Overview](https://polishdataengineer.github.io/testenix/): project positioning, example, guarantees, and maturity.
- [Getting started](https://polishdataengineer.github.io/testenix/getting-started/): installation and the first run.
- [Pytest compatibility](https://polishdataengineer.github.io/testenix/guides/pytest-compatibility/): run existing suites unchanged,
  compare capabilities, and choose a migration boundary.
- [Safe migration](https://polishdataengineer.github.io/testenix/guides/migration/): convert supported pytest and unittest suites,
  validate parity, preserve originals, and interpret migrated-suite benchmarks.
- [Writing tests](https://polishdataengineer.github.io/testenix/guides/writing-tests/): tests, cases, tags, skips, xfail, and retries.
- [Fixtures](https://polishdataengineer.github.io/testenix/guides/fixtures/): dependency graphs, cleanup, and scopes.
- [Parallel execution](https://polishdataengineer.github.io/testenix/guides/parallelism/): workers, scheduling, crashes, and timeouts.

## Reference

- [CLI](https://polishdataengineer.github.io/testenix/reference/cli/): commands, options, and exit codes.
- [Configuration](https://polishdataengineer.github.io/testenix/reference/configuration/): every `[tool.testenix]` option.
- [Python API](https://polishdataengineer.github.io/testenix/reference/api/): authoring, execution, result, and event APIs.
- [Architecture](https://polishdataengineer.github.io/testenix/architecture/): boundaries, invariants, and worker protocol.

## Performance evidence

- [Benchmark results](https://polishdataengineer.github.io/testenix/benchmarks/results/): generated tables, chart, environment, raw
  samples, and limitations.
- [Benchmark contract](https://polishdataengineer.github.io/testenix/benchmarking/): required scenarios and validity rules.
- [Performance analysis](https://polishdataengineer.github.io/testenix/performance-analysis/): profiles, optimizations, memory, and
  native-code decision.

## Complete context

- [llms-full.txt](https://polishdataengineer.github.io/testenix/llms-full.txt): all guides, reference sources, expanded public API,
  architecture, roadmap, benchmark evidence, changelog, and security policy in one text file.
