py2max/Makefile at main · shakfu/py2max · 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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
# Makefile for py2max project

.PHONY: help all build test test-verbose test-outputs coverage lint \
		typecheck qa docs docs-clean docs-serve docs-deploy install \
		dev clean reset ci format check-wheel publish-test publish \
		gallery single-file js2max js2max-check box-props

help: ## Show this help message
	@echo "Available commands:"
	@awk 'BEGIN {FS = ":.*##"; printf "\033[36m%-12s\033[0m %s\n", "Command", "Description"} /^[a-zA-Z_-]+:.*?##/ { printf "\033[36m%-12s\033[0m %s\n", $$1, $$2 }' $(MAKEFILE_LIST)

all: qa docs ## Run all checks and build everything

build: ## Build wheel
	@uv build

test: ## Run tests
	@uv run pytest

test-verbose: ## Run tests with verbose output
	@uv run pytest -v

test-outputs: ## Run tests writing all artifacts flat to build/test-outputs/
	@mkdir -p build
	@PY2MAX_TEST_OUTPUT_FLAT=1 uv run pytest

coverage: ## Generate coverage report
	@mkdir -p build
	@uv run pytest --cov-report html:build/coverage-html --cov=py2max tests

lint: ## Run code linting
	@uv run ruff check py2max --fix

format: ## Run code formatting
	@uv run ruff format py2max/

typecheck: ## Run type checking
	@uv run mypy py2max/

qa: lint test typecheck format

docs: ## Build documentation
	@uv run --group docs mkdocs build --strict

docs-clean: ## Clean documentation build
	@rm -rf site

docs-serve: ## Build and serve documentation locally (live reload)
	@uv run --group docs mkdocs serve

docs-deploy: ## Build and deploy docs to GitHub Pages (gh-pages branch)
	@uv run --group docs mkdocs gh-deploy --force

gallery: ## Regenerate graph-layout gallery images (docs/assets/imgs)
	@uv run --extra graph python scripts/gen_layout_gallery.py

single-file: ## Regenerate the single-file edition (scripts/py2max.py)
	@uv run python scripts/build_single_file.py
	@uv run pytest tests/test_single_file.py -q

install: ## Install package in development mode
	@uv sync

dev: install ## Set up development environment
	@echo "Development environment ready!"
	@echo "Activate with: source .venv/bin/activate"

clean: ## Clean build artifacts
	@rm -rf build/
	@rm -rf dist/
	@rm -rf *.egg-info/
	@rm -rf .pytest_cache/
	@rm -rf .mypy_cache/
	@rm -rf __pycache__/
	@find . -name "*.pyc" -delete
	@find . -name "__pycache__" -type d -exec rm -rf {} +
	@rm -rf site
	@rm -rf outputs/

reset: clean ## Reset development environment
	@rm -rf .venv

ci: ## Run CI-like checks locally
	@uv run pytest --cov=py2max
	@uv run mypy py2max
	@uv run ruff check py2max
	@uv run --group docs mkdocs build --strict

check-wheel: build ## Check wheel with twine
	@uv run twine check dist/*

publish-test: check-wheel ## Publish to PyPI Test
	@uv run twine upload --repository testpypi dist/*

publish: check-wheel ## Publish to PyPI
	@uv run twine upload dist/*

box-props: ## Regenerate the typed box-property vocabulary (py2max/core/props.py)
	@uv run python scripts/gen_box_props.py
	@uv run mypy py2max
	@uv run pytest tests/test_box_props.py -q

js2max: ## Build the Max-loadable js2max artifacts into js2max/max/ (needs bun)
	@uv run python scripts/gen_js2max_objects.py
	@cd js2max && bun install --silent && bun run build
	@uv run python scripts/gen_v8_harness.py

js2max-check: ## Typecheck, test and verify js2max is built (needs bun)
	@uv run python scripts/gen_js2max_objects.py --check
	@cd js2max && bun install --silent && bun run check
	@uv run python scripts/gen_v8_harness.py --check