Makefile

lab:
	jupyter lab

notebook:
	jupyter notebook

linkcheck:
	ruby ./extras/scripts/broken_links.rb

slides:
	jupyter nbconvert --to slides \
		--SlidesExporter.reveal_scroll=True \
		--post serve lecture_$(lec).ipynb

test:
	pytest

# overridden in update.sh
file := .

format:
	ruff format $(file)

# https://jupyterbook.org/en/stable/content/references.html#check-for-missing-references
site:
	jupyter-book build --all -W -n --keep-going .

setup:
	python -m venv .venv
	. .venv/bin/activate && \
	pip install \
		-r requirements.txt \
		-r extras/autograder/source/requirements.txt

update_packages:
	. .venv/bin/activate && \
	pip install --upgrade pip && \
	pip install --upgrade -r requirements.txt

	./extras/scripts/update_lectures.sh

	@echo "Please update homework notebooks separately, in python-public-policy-assignments"

# based on https://gradescope-autograders.readthedocs.io/en/latest/manual_docker/
autograde:
	mkdir -p ./extras/autograder/results ./extras/autograder/results

	docker run --rm \
		-v ./extras/autograder:/autograder \
		gradescope/autograder-base \
		/bin/bash -c "/autograder/source/setup.sh && /autograder/source/run_autograder"

	cat ./extras/autograder/results/results.json

build_autograder:
	# https://stackoverflow.com/a/17351814/358804
	git archive -o ./extras/autograder.zip HEAD:./extras/autograder/source

	@echo "Now upload extras/autograder.zip to Gradescope."

build_dir := _build

clean:
	rm -rf $(build_dir)

# https://github.com/jupyter-book/jupyter-book/issues/2271
# https://stackoverflow.com/a/1583282/358804
fix_double_escaping:
	find $(build_dir)/html -name '*.html' -print0 | xargs -0 sed -i 's/&/\&/g'