Makefile

# Apple developer certificate for re-signing
IDENTITY := $(shell security find-identity -v -p codesigning | head -n 1 | python3 -c 'import sys; print(sys.stdin.read().split("\"")[1])' 2>/dev/null)

# Change this to the location of the proto-dump executable
PROTOC=/opt/homebrew/bin/protoc

# Location of the Numbers application
NUMBERS="/Applications/Numbers Creator Studio.app"

# Xcode version of Python that includes LLDB package
LLDB_PYTHON_PATH := ${shell lldb --python-path}

PACKAGE=numbers-parser
package_c := $(subst -,_,$(PACKAGE))

.PHONY: clean veryclean test coverage profile dist upload docs

TTY_GREEN  := $(shell tput setaf 2)
TTY_RESET  := $(shell tput init)
TTY_RED    := $(shell tput setaf 1)
info_message = echo "$(TTY_GREEN)Bootstrap: $(1)$(TTY_RESET)"
error_message = echo "$(TTY_RED)Bootstrap: $(1)$(TTY_RESET)"

all:
	@echo "make targets:"
	@echo "    test       - run pytest with all tests"
	@echo "    readme     - rebuild README.md from source"
	@echo "    docs       - rebuild markdown and HTML docs from source"
	@echo "    profile    - run pytest and generate a profile graph"
	@echo "    dist       - build distributions"
	@echo "    upload     - upload package to PyPI"
	@echo "    clean      - delete temporary files for test, coverage, etc."
	@echo "    veryclean  - delete all auto-generated files (requires new bootstrap)"
	@echo "    bootstrap  - rebuild all auto-generated files for new Numbers version"

dist: readme
	-rm -rf dist
	uv build

upload:
	-rm -rf dist
	tox
	uv build
	uv publish

DOCS_SOURCES = $(shell find docs -name \*.rst) \
			   docs/conf.py \
			   src/$(package_c)/*.py \
			   docs/build/_static/custom.css

docs: docs/build/index.html

docs/build/_static/custom.css: docs/custom.css
	mkdir -p docs/build/_static
	cp $< $@

docs/build/index.html: $(DOCS_SOURCES)
	@mkdir -p docs/build
	uv sync --group docs
	uv run sphinx-build -q -b html -t HtmlDocs docs docs/build
	uv run sphinx-build -q -b markdown -t MarkdownDocs docs docs/build docs/index.rst

readme:
	@mkdir -p docs/build
	uv sync --group docs
	uv run sphinx-build -q -b markdown -t MarkdownDocs docs docs/build docs/index.rst
	cp docs/build/index.md README.md

profile:
	@for sub_test in tables borders styles; do \
		test_name="test_profiling_$$sub_test"; \
		heat_graph="prof/$$test_name.svg"; \
		echo "======== Profile run: test_profiling_$$sub_test"; \
		uv run pytest --profile-svg -q --experimental --no-cov tests/test_large.py -k "$$test_name"; \
		mv prof/combined.svg "$$heat_graph"; \
		echo ">>>>>>>> Saved to $$heat_graph"; \
	done


test:
	uv run pytest -n logical

BOOTSTRAP_FILES = src/protos/TNArchives.proto \
				  src/$(package_c)/generated/TNArchives_pb2.py \
				  src/$(package_c)/generated/__init__.py \
				  src/$(package_c)/generated/mapping.py \
				  src/$(package_c)/generated/functionmap.py \
				  src/$(package_c)/generated/fontmap.py \
				  src/$(package_c)/generated/__init__.py
				  

bootstrap: check_identity $(BOOTSTRAP_FILES)

check_identity::
	@if [ "$(IDENTITY)" == "" ]; then \
		$(call error_message,"failure: no code signing identity found"); \
		exit 1; \
	fi

ENTITLEMENTS = src/build/entitlements.xml
TMP_NUMBERS_APP = /tmp/Numbers.unsigned.app

$(TMP_NUMBERS_APP): $(ENTITLEMENTS)
	@$(call info_message,"creating local copy of Numbers.app")
	@mkdir -p .bootstrap
	@rm -rf $@
	@cp -R $(NUMBERS) $@
	@$(call info_message,"re-signing local Numbers.app")
	@xattr -cr $@
	@codesign --remove-signature $@
	@codesign --entitlements $(ENTITLEMENTS) --sign "${IDENTITY}" $@
	@$(call info_message,"checking signatures of local Numbers.app")
	@codesign --verify $@

.bootstrap/mapping.json: $(TMP_NUMBERS_APP)
	@$(call info_message,"dumping protobuf IDs using lldb")
	@mkdir -p .bootstrap
	@PYTHONPATH=${LLDB_PYTHON_PATH}:src xcrun python3 \
		src/build/extract_mapping.py \
		$(TMP_NUMBERS_APP)/Contents/MacOS/Numbers $@

.bootstrap/mapping.py: .bootstrap/mapping.json
	@$(call info_message,"creating Python mapping of Protobuf IDs")
	@mkdir -p $(dir $@)
	uv run python3 src/build/generate_mapping.py $< $@

src/$(package_c)/generated/functionmap.py: .bootstrap/functionmap.py
	@mkdir -p $(dir $@)
	@cp $< $@

src/$(package_c)/generated/fontmap.py: .bootstrap/fontmap.py
	@mkdir -p $(dir $@)
	@cp $< $@

TST_TABLES=$(NUMBERS)/Contents/Frameworks/TSTables.framework/Versions/A/TSTables
.bootstrap/functionmap.py:
	@$(call info_message,"extracting function names from Numbers")
	@mkdir -p .bootstrap
	uv run python3 src/build/extract_functions.py $(TST_TABLES) $@ >/dev/null

.bootstrap/fontmap.py:
	@$(call info_message,"Bootstrap: generating font name map")
	@mkdir -p .bootstrap
	@uv sync --group bootstrap
	uv run python3 src/build/generate_fontmap.py $@

.bootstrap/protos/TNArchives.proto:
	@$(call info_message,"Bootstrap: extracting protobufs from Numbers")
	uv run python3 src/build/protodump.py $(NUMBERS) .bootstrap/protos
	uv run python3 src/build/rename_proto_files.py .bootstrap/protos

src/$(package_c)/generated/mapping.py: .bootstrap/mapping.py
	@cp $< $@

src/$(package_c)/generated/TNArchives_pb2.py: .bootstrap/protos/TNArchives.proto
	@$(call info_message,"Bootstrap: compiling Python packages from protobufs")
	@mkdir -p src/$(package_c)/generated
	@for proto in .bootstrap/protos/*.proto; do \
	    $(PROTOC) -I=.bootstrap/protos --proto_path .bootstrap/protos --python_out=src/$(package_c)/generated $$proto; \
	done

src/protos/TNArchives.proto: .bootstrap/protos/TNArchives.proto
	@$(call info_message,"Bootstrap: creating git-tracked copies of protos")
	@mkdir -p src/protos
	@for proto in .bootstrap/protos/*.proto; do \
		cp $$proto src/protos; \
	done

src/$(package_c)/generated/__init__.py: src/$(package_c)/generated/TNArchives_pb2.py
	@$(call info_message,"Bootstrap: patching paths in generated protobuf files")
	uv run python3 src/build/replace_paths.py src/$(package_c)/generated/T*.py
	@touch $@

veryclean:
	make clean
	rm -rf .bootstrap
	rm -f src/$(package_c)/generated/__init__.py
	rm -f src/$(package_c)/generated/mapping.py
	rm -f src/$(package_c)/generated/*_pb2.py
	rm -rf $(TMP_NUMBERS_APP)

clean:
	rm -rf src/$(package_c).egg-info
	rm -rf coverage_html_report
	rm -rf dist
	rm -rf docs/build
	rm -rf .tox
	rm -rf .pytest_cache