kindex/Makefile at main · jmcentire/kindex · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
.PHONY: install dev test test-verbose test-coverage lint check clean docs help all build-dist verify-dist-install validate-mcp-registry distribute

PYTHON ?= python3
VERSION := $(shell $(PYTHON) -c "from kindex import __version__; print(__version__)")
DIST_WHEEL := dist/kindex-$(VERSION)-py3-none-any.whl

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

all: install test ## Install and run tests

install: ## Install kindex (kin CLI)
	$(PYTHON) -m pip install -e .

dev: ## Install with dev + LLM dependencies
	$(PYTHON) -m pip install -e ".[dev,llm]"

test: ## Run test suite
	$(PYTHON) -m pytest tests/ -x -q

test-verbose: ## Run tests with full output
	$(PYTHON) -m pytest tests/ -v

test-coverage: ## Run tests with coverage report
	$(PYTHON) -m pytest tests/ --cov=kindex --cov-report=term-missing -q

lint: ## Run basic checks
	$(PYTHON) -m py_compile src/kindex/cli.py
	$(PYTHON) -m py_compile src/kindex/store.py
	$(PYTHON) -m py_compile src/kindex/config.py
	$(PYTHON) -m py_compile src/kindex/extract.py
	$(PYTHON) -m py_compile src/kindex/ingest.py
	$(PYTHON) -m py_compile src/kindex/analytics.py
	$(PYTHON) -m py_compile src/kindex/reminders.py
	$(PYTHON) -m py_compile src/kindex/notify.py

check: lint test ## Lint + test combined

build-dist: ## Build source/wheel distributions
	@$(PYTHON) -c "import build" 2>/dev/null || (echo "Missing build module. Run: $(PYTHON) -m pip install build  (or: make dev)" && exit 1)
	$(PYTHON) -m build

verify-dist-install: build-dist ## Verify built wheel installs with MCP extra
	@test -f "$(DIST_WHEEL)" || (echo "Missing $(DIST_WHEEL)" && exit 1)
	@TMP_DIR=$$(mktemp -d); \
	echo "Installing $(DIST_WHEEL)[mcp] into $$TMP_DIR"; \
	$(PYTHON) -m pip install --quiet --no-cache-dir --target "$$TMP_DIR" "$(DIST_WHEEL)[mcp]"; \
	PYTHONPATH="$$TMP_DIR" $(PYTHON) -S -c "import kindex, kindex.mcp_server; print('verified', kindex.__version__)"

validate-mcp-registry: ## Validate server.json with mcp-publisher if installed
	@if command -v mcp-publisher >/dev/null 2>&1; then \
		mcp-publisher validate server.json; \
	else \
		echo "Skipping MCP Registry validation: mcp-publisher is not installed"; \
		echo "Install from https://github.com/modelcontextprotocol/registry/releases"; \
	fi

distribute: check verify-dist-install validate-mcp-registry ## Release preflight: tests, build, install, registry metadata validation

clean: ## Remove build artifacts
	rm -rf build/ dist/ *.egg-info src/*.egg-info .pytest_cache .coverage htmlcov/
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true

docs: ## Open landing page in browser
	open docs/index.html 2>/dev/null || xdg-open docs/index.html 2>/dev/null || echo "Open docs/index.html in your browser"

version: ## Show current version
	@$(PYTHON) -c "from kindex import __version__; print(__version__)"