Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

git-iterm2 backend

Python backend for the git-iterm2 toolbelt panel: git service, active-repo controller and a local REST/WebSocket API. See CONTRIBUTING.md for the layer boundaries.

Development

uv sync
uv run pytest
uv run ruff check src tests
uv run ruff format --check src tests
uv run mypy src

Standalone server

Serves one repository without iTerm2 (UI development, end-to-end tests):

uv run python -m git_iterm2.standalone --repo /path/to/repo [--token TOKEN] [--static ../web/dist]

The first line printed is the panel URL, including the token.

API contract

openapi.json is generated from the pydantic models and consumed by the web UI. Regenerate it after changing src/git_iterm2/models.py:

uv run python -m git_iterm2.schema > openapi.json

tests/test_schema.py fails when the file is stale.