# ERROR: usage: pytest [options] [file_or_dir] [file_or_dir] [...]
pytest: error: unrecognized arguments: --timeout=60
  inifile: /app/pytest.ini
  rootdir: /app

- **ID:** `python/pytest-timeout-plugin-missing`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The pytest.ini contains `addopts = --timeout=60` but the pytest-timeout plugin is not installed, so pytest rejects the unknown option.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 6.x | active | — | — |
| 7.x | active | — | — |
| 8.x | active | — | — |

## Workarounds

1. **** (98% success)
   ```
   pip install pytest-timeout
# then pytest.ini's addopts = --timeout=60 works
   ```
2. **** (75% success)
   ```
   import signal
import pytest

@pytest.fixture
def timeout():
    def handler(signum, frame):
        raise TimeoutError('test timed out')
    signal.signal(signal.SIGALRM, handler)
    signal.alarm(60)
    yield
    signal.alarm(0)
   ```

## Dead Ends

- **** — Removes the timeout protection entirely; long-hanging tests can block CI indefinitely. (80% fail)
- **** — Same unrecognized-argument error occurs because the plugin is still missing. (98% fail)