blob: 57bbcb76474817a751e01eaa6c70b9ef909cf248 (
plain) (
blame)
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
|
PREFIX ?= $(HOME)/.local/bin
# Auto-detect docc binary: prefer standalone, fall back to xcrun
DOCC := $(shell which docc 2>/dev/null || echo "xcrun docc")
# Derive the build triple from the bin path (e.g., arm64-apple-macosx)
BUILD_DIR := $(shell swift build -c debug --show-bin-path 2>/dev/null)
TRIPLE := $(notdir $(patsubst %/,%,$(dir $(BUILD_DIR))))
MODULE_DIR := .build/$(TRIPLE)/debug/Modules
SYMBOL_GRAPH_DIR := .build/$(TRIPLE)/symbolgraph
.DEFAULT_GOAL := all
all: run
run:
swift run -c debug
build:
swift build -c debug
release:
swift build -c release
install: release
install -d $(PREFIX)
install ".build/release/bar" "$(PREFIX)/bar"
uninstall:
rm -f "$(PREFIX)/bar"
clean:
rm -rf .build .docc-build docs
# Build the project and generate symbol graphs (prerequisite for docc targets)
# Uses -minimum-access-level internal to capture doc-commented types even when they aren't public
symbol-graphs: build
mkdir -p $(SYMBOL_GRAPH_DIR)
xcrun swift-symbolgraph-extract \
-module-name bar \
-target $(TRIPLE)26.0 \
-sdk $(shell xcrun --show-sdk-path 2>/dev/null) \
-minimum-access-level internal \
-I $(MODULE_DIR) \
-output-dir $(SYMBOL_GRAPH_DIR)
preview-docs: symbol-graphs
$(DOCC) preview Sources/bar/bar.docc \
--additional-symbol-graph-dir $(SYMBOL_GRAPH_DIR) \
--output-dir .docc-build
generate-docs: symbol-graphs
$(DOCC) convert Sources/bar/bar.docc \
--additional-symbol-graph-dir $(SYMBOL_GRAPH_DIR) \
--transform-for-static-hosting \
--hosting-base-path bar \
--output-path ./docs \
--source-service github \
--source-service-base-url https://github.com/paninihouse/bar/blob/master \
--checkout-path ~/Developer/paninihouse/tools/bar/
.PHONY: all run build release install uninstall clean symbol-graphs preview-docs generate-docs
|
