longeron/Makefile at main · sanbales/longeron · 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
.PHONY: check test lint format typecheck parsers demo docs sync-labextension

# Equivalent pixi tasks exist (pixi run check|test|parsers|...): same
# commands in a locked env, with antlr+JDK provided by conda-forge.

VENV ?= .venv/bin

check: lint typecheck test test-vendor  ## lint + mypy + tests

test:
	$(VENV)/pytest -q

test-vendor:  ## vendored ipyelk test suite (incl. ported F1-F6 fixes)
	$(VENV)/pytest -c pyproject.toml -q vendor/ipyelk/tests

coverage:
	$(VENV)/pytest -q --cov=longeron --cov-report=term-missing:skip-covered

lint:
	$(VENV)/ruff format --check src tests examples scripts notebooks docs
	$(VENV)/ruff check src tests examples scripts notebooks docs

format:
	$(VENV)/ruff format src tests examples scripts notebooks docs
	$(VENV)/ruff check --fix src tests examples scripts notebooks docs

typecheck:
	$(VENV)/mypy

parsers:  ## regenerate ANTLR parsers from grammars/*.g4 (needs Java)
	$(VENV)/python scripts/generate_parsers.py

stdlib:  ## rebuild the prebuilt standard-library JSON
	$(VENV)/python scripts/vendor_stdlib.py --prebuilt-only

demo:
	$(VENV)/python examples/demo.py

docs:  ## build the documentation site (needs the [docs] extra; pixi: `pixi run docs`)
	$(VENV)/sphinx-build -W -b html docs build/docs

hooks:  ## enable the repo git hooks (auto-strips staged notebook outputs; blocks >5MB blobs)
	git config core.hooksPath scripts/git-hooks

sync-labextension:  ## sync the repo labextension builds (vendored jupyter-elk + the longeron launcher tile) into every pixi env (JupyterLab serves the env COPY, not the repo build)
	@sync() { src="$$1"; rel="$$2"; \
	for root in .pixi/envs/*/share/jupyter/labextensions; do \
		[ -d "$$root" ] || continue; \
		dst="$$root/$$rel"; \
		if [ -d "$$dst" ]; then diff -rq "$$src" "$$dst" >/dev/null 2>&1 || echo "WARNING: $$dst was serving a STALE build (differs from the repo build); syncing"; fi; \
		mkdir -p "$$dst"; \
		rsync -a --delete "$$src/" "$$dst/"; \
	done; }; \
	sync "vendor/ipyelk/src/_d/share/jupyter/labextensions/@jupyrdf/jupyter-elk" "@jupyrdf/jupyter-elk"; \
	sync "npm/_d/share/jupyter/labextensions/longeron" "longeron"