# tmuxp.workspace.builder.prepended_sys_path

- **Module:** tmuxp.workspace.builder
- **Package:** tmuxp
- **Language:** Python
- **Kind:** function
- **Source:** https://github.com/tmux-python/tmuxp/blob/153acdf6ff1268b14d3d03ed488f545a7123c8f1/src/tmuxp/workspace/builder/registry.py#L116
- **Page:** https://libtmux.org/en/py/latest/workspace/reference/tmuxp-workspace-builder-prepended_sys_path/

```
tmuxp.workspace.builder.prepended_sys_path(paths: list[pathlib.Path] | None) -> Iterator[None]
```

Temporarily prepend directories to ``sys.path``, restoring it on exit.

Paths are prepended in order (first entry ends up at ``sys.path[0]``). An
empty or falsy ``paths`` is a no-op. Uses only literal directory entries; it
avoids :func:`site.addsitedir` (which runs ``.pth`` startup code).

## Parameters

- `paths` (list[pathlib.Path] | None): directories to prepend

## Example

```python
>>> import sys
>>> ext = tmp_path / "ext"
>>> ext.mkdir()
>>> before = list(sys.path)
>>> with prepended_sys_path([ext]):
...     sys.path[0] == str(ext)
True
>>> sys.path == before
True
```