Skip to main content

Developer Setup

Prerequisites​

  • Python 3.11+
  • uv (recommended)
  • Git

1. Clone the repository​

git clone https://github.com/sageoz/batho.git
cd batho

2. Install dependencies​

uv sync --all-groups --all-extras

3. Run tests​

# Full suite
uv run pytest

# Optional: focused checks while iterating
uv run pytest tests/core/test_config.py -q
uv run pytest tests/utils/test_logging.py -q

4. Run the CLI from source​

uv run python -m batho_cli --help
uv run python -m batho_cli index --root .

5. Reinstall global command​

uv tool install --reinstall .
hash -r
batho index --root .

6. Troubleshooting​

If behavior differs between local and global runs, compare both paths:

uv run python -m batho_cli index --root .
batho index --root .

If they differ, reinstall the tool again:

uv tool install --reinstall .
hash -r