create-context-graph/Makefile at main · render-examples/create-context-graph · 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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
# Create Context Graph — Development Makefile

.PHONY: install test test-slow test-matrix smoke-test lint build publish-pypi publish-npm \
        docs docs-build docs-serve scaffold clean help

## Setup

install:  ## Install dev dependencies
	uv venv && uv pip install -e ".[dev]"

install-all:  ## Install all optional dependencies (dev + generate + connectors)
	uv venv && uv pip install -e ".[all,dev]"

## Testing

test:  ## Run fast tests (602 tests, no Neo4j or API keys required)
	uv run pytest tests/ -v --tb=short

test-slow:  ## Run full test suite including matrix + perf tests (800 tests)
	uv run pytest tests/ -v --tb=short --slow

test-matrix:  ## Run domain x framework matrix only (176 combos)
	uv run pytest tests/test_matrix.py -v --tb=short --slow

test-coverage:  ## Run tests with coverage report
	uv run pytest tests/ -v --cov=create_context_graph --cov-report=html

smoke-test:  ## E2E smoke test: scaffold, start, and chat for 3 key frameworks (requires Neo4j + API keys)
	@echo "Running smoke tests for pydanticai, google-adk, and strands..."
	uv run python scripts/e2e_smoke_test.py --domain financial-services --framework pydanticai --quick
	uv run python scripts/e2e_smoke_test.py --domain real-estate --framework google-adk --quick
	uv run python scripts/e2e_smoke_test.py --domain trip-planning --framework strands --quick

## Linting

lint:  ## Run ruff linter
	uv run ruff check src/ tests/

lint-fix:  ## Auto-fix lint issues
	uv run ruff check src/ tests/ --fix

## Build & Publish

build:  ## Build Python package (sdist + wheel)
	uv build

publish-pypi: build  ## Publish to PyPI
	uv publish

publish-npm:  ## Publish npm wrapper to npmjs
	cd npm-wrapper && npm publish --access public

## Documentation

docs:  ## Start Docusaurus dev server
	cd docs && npm run start

docs-build:  ## Build Docusaurus site
	cd docs && npm install && npm run build

docs-serve:  ## Serve built docs locally
	cd docs && npm run serve

docs-install:  ## Install docs dependencies
	cd docs && npm install

## Scaffold Testing

scaffold:  ## Scaffold a test project (healthcare/pydanticai)
	uv run create-context-graph /tmp/test-scaffold \
		--domain healthcare --framework pydanticai --demo-data \
		--output-dir /tmp/test-scaffold

scaffold-clean:  ## Remove test scaffold
	rm -rf /tmp/test-scaffold

## Data

regenerate-fixtures:  ## Regenerate all 22 fixture files with Claude API (requires ANTHROPIC_API_KEY)
	uv run python scripts/regenerate_fixtures.py

## Cleanup

clean:  ## Remove build artifacts, caches, and temp files
	rm -rf dist/ build/ *.egg-info
	rm -rf .pytest_cache .ruff_cache htmlcov .coverage
	rm -rf docs/build docs/.docusaurus
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true

## Help

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

.DEFAULT_GOAL := help