help:
	@echo Developer commands for zoetty
	@echo
	@grep -E '^[ .a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
	@echo

install:  ## Install requirements ready for development
	uv sync

deploy-docs:  ## Build and deploy the documentation
	uv run mkdocs build
	uv run mkdocs gh-deploy

docs-serve:  ## Run a local documentation server
	uv run mkdocs serve

release:  ## Build a new version and release it
	uv build
	uv publish

ty: ## Run a static syntax check
	uv run ty check .

lint-imports: ## Check the import contracts in pyproject.toml
	uv run lint-imports

format: ## Format the code correctly
	uv run ruff format .
	uv run ruff check --fix .

clean:  ## Clear any cache files and test files
	rm -rf .ty_cache
	rm -rf .pytest_cache
	rm -rf .ruff_cache
	rm -rf .import_linter_cache
	rm -rf site/
	rm -rf dist/
	find zoetty tests -name __pycache__ -prune -exec rm -rf {} +
	rm -rf htmlcov/
	rm -rf .coverage

test:  ## Run tests
	uv run pytest -vvv -x --cov=zoetty --cov-report=term-missing --cov-report=html --cov-config=pyproject.toml

shell:  ## Run an ipython shell
	uv run ipython
