Metadata-Version: 2.4
Name: waypin
Version: 0.1.0
Summary: Locate a project root by anchor directory name and optionally patch sys.path.
Author: Your Name
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: notebook
Requires-Dist: ipynbname>=2021.3.2; extra == "notebook"

# waypin

A tiny utility to locate a project root by an anchor directory name (default: `scripts`) and optionally
patch `sys.path` so absolute imports like `from scripts...` work in script/main execution and notebooks.

## Install

```bash
pip install waypin
```

## Usage

```python
from waypin import reel

ROOT_DIR, is_notebook = reel("scripts")
print(ROOT_DIR, is_notebook)
```

## Behavior

- Searches upward from the executing context (caller `__file__`, or notebook path if available) to find a
  directory named `anchor_dirname`.
- Returns the *parent* of that directory as `ROOT_DIR`.
- Optionally appends `ROOT_DIR` to `sys.path`.

## License

MIT
