Makefile

   1 # Copyright 2020-2021 Ian Jackson and contributors to Otter
   2 # SPDX-License-Identifier: AGPL-3.0-or-later
   3 # There is NO WARRANTY.
   4
   5 # make -j8
   6 # make -j8 release
   7 # make -j8 shapelib
   8
   9 SHELL=/bin/bash
  10 src=.
  11
  12 default: all check
  13 all: debug
  14 full-check: all check cargo-syntaxcheck-release shapelib doc-sphinx
  15 full-check: for-deploy release
  16 everything: debug doc release check bundled-sources
  17
  18 shapelib: templates/shapelib.html stamp/cargo.doc-otter-only
  19         @echo 'Shape library preview and docs can now be found here:'
  20         @echo '  file://$(PWD)/$<'
  21         @echo '  file://$(abspath $(TARGET_DIR)/doc/otter/shapelib_toml/index.html)'
  22
  23 MAKEFILE_DEP ?= Makefile
  24 MAKEFILE_FIND_X ?=
  25 # ^ set this to "x" to debug the $rsrcs rune
  26
  27 #---------- funky macros etc. ----------
  28
  29 cr = $(addprefix --,$(filter-out debug,$1))
  30 rsrcs = $(shell $(foreach x,$(MAKEFILE_FIND_X),set -$x;)\
  31     find -H $1 \( -name Cargo.toml -o -name Cargo.lock -o -name Cargo.lock.example -o -name \*.rs \) \! -path '*/build/*' )
  32 stamp=@mkdir -p stamp; touch $@
  33
  34 BUNDLED_SOURCES_LIT = README.md LICENCE
  35 BUNDLED_SOURCES_FILES = index.html $(BUNDLED_SOURCES_LIT)
  36 BUNDLED_SOURCES_LINKS += $(BUNDLED_SOURCES_LIT) otter/
  37 BUNDLED_SOURCES += $(BUNDLED_SOURCES_FILES)
  38
  39 #---------- programs and config variables ----------
  40
  41 CARGO ?= cargo
  42 TARGET_DIR ?= target
  43
  44 USVG_OPTIONS = "--sans-serif-family=DejaVu Sans"
  45
  46 WASM_BINDGEN = $(TARGET_DIR)/debug/wasm-bindgen
  47 WASM_BINDGEN_OPTIONS =                                          \
  48         --remove-name-section --remove-producers-section        \
  49         --typescript --no-modules                               \
  50
  51 BUNDLE_SOURCES ?= bundle-rust-sources
  52
  53 SPHINXBUILD   = sphinx-build
  54
  55 ifndef INKSCAPE_EXTENSIONS
  56 INKSCAPE ?= inkscape
  57 INKSCAPE_SDD_QUIETEN ?= 2>/dev/null
  58 # inkscape 0.92.4: --extension-directory works, no --system-data-directory
  59 # inkscape 1.0.2: --system-data-directory, no --extension-directory
  60 INKSCAPE_EXTENSIONS := $(shell set -e; { sdd=$$( $(INKSCAPE) --system-data-directory $(INKSCAPE_SDD_QUIETEN) ) && echo "$$sdd/extensions"; } || $(INKSCAPE) --extension-directory )
  61 endif
  62 RECOLOUR_SVG ?= ./run-inkscape-extension $(INKSCAPE_EXTENSIONS)/color_replace.py
  63
  64 DEPLOY_ARCH=x86_64-unknown-linux-musl
  65 DEPLOY_RELEASE=debug
  66 DEPLOY_TARGET_DIR=$(TARGET_DIR)/$(addsuffix /,$(DEPLOY_ARCH))$(DEPLOY_RELEASE)
  67 DEPLOYED_BRANCH=deployed
  68 PUBLISHED_BRANCH=published
  69
  70 #---------- nailing-cargo ----------
  71
  72 ifneq (,$(wildcard ../Cargo.nail))
  73
  74 NAILING_CARGO = nailing-cargo
  75 CARGO = $(NAILING_CARGO)
  76 BUILD_SUBDIR ?= ../Build
  77 TARGET_DIR = $(BUILD_SUBDIR)/$(notdir $(PWD))/target
  78
  79 NAILING_CARGO_JUST_RUN ?= $(NAILING_CARGO) --just-run -q ---
  80 BUNDLE_SOURCES_CMD ?= $(NAILING_CARGO) --- $(BUNDLE_SOURCES)
  81 USVG_CMD ?= $(NAILING_CARGO_JUST_RUN) $(USVG)
  82 WASM_BINDGEN_CLI_CARGO_OPTS ?= --subcommand-props=!manifest-path
  83
  84 clean-nailing:
  85         $(NAILING_CARGO_JUST_RUN) \
  86  sh -c 'cd "$1"; find -mindepth 1 -maxdepth 1 -print0 | xargs -0r rm -rf --' \
  87                 $(abspath $(BUILD_SUBDIR)/$(notdir $(PWD)))
  88
  89 else
  90 clean-nailing:
  91 endif # Cargo.nail
  92
  93 BUILD_SUBDIR ?= ../Build
  94 BUNDLE_SOURCES_CMD ?= $(BUNDLE_SOURCES)
  95 USVG_CMD ?= $(USVG)
  96
  97 WASM_PACKED=$(TARGET_DIR)/packed-wasm
  98
  99 #---------- local programs ----------
 100
 101 define lp
 102 stamp/cargo.$2: $(call rsrcs, ! -name \*.rs)
 103         $$(CARGO) build $(call cr,$3) -p $2
 104         $$(stamp)
 105 $1 := $(abspath $(TARGET_DIR)/$3/$4)
 106 endef
 107
 108 $(eval $(call lp,BUNDLE_SOURCES,bundle-sources,debug,bundle-rust-sources))
 109 $(eval $(call lp,USVG,usvg,release,usvg))
 110
 111 #---------- variables defining bits of source etc. ----------
 112
 113 PROGRAMS=daemon-otter otter
 114
 115 WASM_ASSETS := $(addprefix otter_wasm,.js _bg.wasm)
 116 WASM_OUTPUTS := $(addprefix otter_wasm,.d.ts)
 117
 118 TS_SRCS= script
 119 TS_SRC_FILES= \
 120         $(addprefix templates/,$(addsuffix .ts,$(TS_SRCS))) \
 121         webassembly-types/webassembly.d.ts \
 122         $(WASM_PACKED)/otter_wasm.d.ts
 123
 124 LITFILES= LICENCE AGPLv3
 125 TXTFILES= CC-BY-SA-3.0 CC-BY-SA-4.0
 126
 127 FILEASSETS = $(addprefix templates/, libre shapelib.html script.js \
 128                         $(LITFILES) $(TXTFILES)) \
 129                 $(wildcard templates/*.tera)
 130
 131 WASM := wasm32-unknown-unknown
 132 # ^ todo: Is this still right after
 133 #     Use correct ABI for wasm32 by default
 134 #     https://github.com/rust-lang/rust/pull/79998
 135 # ?  But maybe it doesn't matter since we're very conservative and
 136 # only pass JsValue and a few strings across the WASM ABI.
 137
 138 #---------- toplevel aggregate targets ----------
 139
 140 check: stamp/cargo.debug-check at wdt
 141         @echo 'Tests passed.'
 142
 143 full-check: stamp/cargo.release-check
 144 full-check: stamp/cargo.release-miri stamp/cargo.debug-miri
 145
 146 full-check:
 147         @echo 'Full tests passed.'
 148
 149 doc: cargo-doc doc-sphinx examples
 150
 151 debug release:: %: stamp/cargo.% assets libraries extra-%
 152
 153 cargo: cargo-debug cargo-wasm-release
 154
 155 cargo-debug cargo-release cargo-check cargo-doc \
 156 cargo-wasm-debug cargo-wasm-release:: \
 157 cargo-%: stamp/cargo.%
 158
 159 EXAMPLE_BUNDLES = test-bundle big-bundle
 160 EXAMPLE_BUNDLE_FILES = $(foreach f, $(EXAMPLE_BUNDLES), examples/$f.zip)
 161
 162 examples: $(EXAMPLE_BUNDLE_FILES)
 163 .PHONY: examples
 164
 165 cargo-wasm: cargo-wasm-release
 166
 167 wasm: stamp/wasm-bindgen
 168
 169 assets: js stamp/wasm-bindgen $(FILEASSETS)
 170
 171 js: templates/script.js
 172
 173 extra-debug:
 174 extra-release: bundled-sources
 175
 176 cargo-syntaxcheck: cargo-syntaxcheck-host cargo-syntaxcheck-wasm
 177 cargo-syntaxcheck-host:
 178         $(CARGO) check --workspace
 179 cargo-syntaxcheck-wasm:
 180         $(CARGO) check --target $(WASM) -p otter-wasm --release
 181 cargo-syntaxcheck-release:
 182         $(CARGO) check --workspace --release
 183
 184 #---------- cargo ----------
 185
 186 DR=debug release
 187 CARGOES=$(foreach t, wasm-,$(addprefix $t,check $(DR)))
 188
 189 $(addprefix stamp/cargo.,$(DR)):: \
 190 stamp/cargo.%: $(call rsrcs,. ! -path './wasm/*')
 191         $(CARGO) build --workspace $(call cr,$*) -p otter -p otter-daemon
 192         $(stamp)
 193
 194 $(TARGET_DIR)/debug/%: $(call rsrcs, ! -path './wasm/*')
 195         $(CARGO) build --workspace -p otter --bin $*
 196
 197 stamp/cargo.wasm-bindgen: $(call rsrcs, ! -name \*.rs)
 198         $(CARGO) $(WASM_BINDGEN_CLI_CARGO_OPTS) build --target-dir=target \
 199                 --manifest-path=$(abspath wasm/Cargo.toml) -p wasm-bindgen-cli
 200         $(stamp)
 201
 202 stamp/cargo.%-check: $(call rsrcs,.)
 203         $(CARGO) test --workspace $(call cr,$*)
 204         $(stamp)
 205
 206 stamp/cargo.%-miri: $(call rsrcs,.)
 207         $(CARGO) miri test --workspace $(call cr,$*)
 208         $(stamp)
 209
 210 stamp/cargo-at.debug: $(call rsrcs,.)
 211         $(CARGO) build --workspace $(call cr,$*) -p otter-api-tests
 212         $(stamp)
 213
 214 stamp/cargo-wdt.debug: $(call rsrcs,.)
 215         $(CARGO) build --workspace $(call cr,$*) -p otter-webdriver-tests
 216         $(stamp)
 217
 218 stamp/cargo.doc: $(call rsrcs,.)
 219         $(CARGO) doc $(CARGO_DOC_OPTS) --workspace 2>&1 |egrep -vf .cargo-doc-suppress-errors
 220         $(stamp)
 221
 222 stamp/cargo.doc-otter-only: $(call rsrcs,.)
 223         $(CARGO) doc $(CARGO_DOC_OPTS) --workspace -p otter --no-deps
 224         $(stamp)
 225
 226 $(addprefix stamp/cargo.wasm-,$(DR)):: \
 227 stamp/cargo.wasm-%: $(call rsrcs, base wasm Cargo.*)
 228         $(CARGO) build --target $(WASM) -p otter-wasm $(call cr,$*)
 229         $(stamp)
 230
 231 stamp/cargo.deploy-build: $(call rsrcs,.)
 232         $(CARGO) build --target $(DEPLOY_ARCH) $(call cr,$(DEPLOY_RELEASE)) -p otter -p otter-daemon
 233         $(stamp)
 234
 235 #---------- sphnix ----------
 236
 237 doc-sphinx:     docs/html/index.html \
 238                 $(foreach f, $(EXAMPLE_BUNDLES), docs/html/examples/$f.zip)
 239         @echo 'Documentation can now be found here:'
 240         @echo '  file://$(PWD)/$<'
 241
 242 docs/html/index.html: docs/conf.py $(wildcard docs/*.md docs/*.rst docs/*.png)
 243         $(SPHINXBUILD) -M html docs docs $(SPHINXOPTS)
 244
 245 docs/html/examples/%.zip: examples/%.zip
 246         mkdir -p docs/html/examples
 247         rm -f $@ && ln $< $@
 248
 249 #---------- wasm ----------
 250
 251 $(addprefix $(WASM_PACKED)/,$(WASM_ASSETS) $(WASM_OUTPUTS)): stamp/wasm-bindgen
 252 stamp/wasm-bindgen: stamp/cargo.wasm-bindgen stamp/cargo.wasm-release
 253         $(NAILING_CARGO_JUST_RUN) $(abspath $(WASM_BINDGEN)) \
 254                 $(WASM_BINDGEN_OPTIONS) --out-dir target/packed-wasm \
 255                 target/$(WASM)/release/otter_wasm.wasm
 256         $(stamp)
 257
 258 #---------- bundle-sources ----------
 259
 260 BUNDLED_SOURCES_DIRS += otter
 261
 262 bundled-sources:: $(addprefix bundled-sources/, $(BUNDLED_SOURCES_DIRS))
 263
 264 TARGET_BUNDLED=$(TARGET_DIR)/bundled-sources
 265
 266 $(TARGET_BUNDLED):
 267         $(NAILING_CARGO_JUST_RUN) mkdir -p $(abspath $@)
 268
 269 $(addprefix bundled-sources/, $(BUNDLED_SOURCES_DIRS)): \
 270 bundled-sources/%: stamp/cargo.bundle-sources $(TARGET_BUNDLED)
 271         set -e; d=$(abspath $(TARGET_BUNDLED)); \
 272         $(if $(filter-out otter,$*), cd ../$*;) \
 273         $(BUNDLE_SOURCES_CMD) --output $$d/$*
 274
 275 bundled-sources:: $(addprefix $(TARGET_BUNDLED)/, $(BUNDLED_SOURCES_FILES))
 276
 277 $(addprefix $(TARGET_BUNDLED)/, $(BUNDLED_SOURCES_LIT)): \
 278 $(TARGET_BUNDLED)/%: % $(TARGET_BUNDLED)
 279         $(NAILING_CARGO_JUST_RUN) cp $(abspath $(src))/$< $(abspath $@)
 280
 281 $(TARGET_BUNDLED)/index.html: bundled-sources-make-index \
 282                 $(MAKEFILE_DEP) $(TARGET_BUNDLED)
 283         $(NAILING_CARGO_JUST_RUN) sh -ec '                      \
 284                 cd $(abspath $(src)); mkdir -p $(dir $@);       \
 285                 ./$< >$@.tmp $(BUNDLED_SOURCES_LINKS);          \
 286                 mv -f $@.tmp $@;                                \
 287         '
 288
 289 bundled-sources::
 290         @echo Bundled sources.
 291
 292 #---------- svg processing ----------
 293
 294 LIBRARIES ?= $(basename $(wildcard library/*.toml))
 295 USVG_DEP = stamp/cargo.usvg
 296
 297 include $(addsuffix /files.make, $(LIBRARIES))
 298
 299 USVG_PROCESSOR = usvg-processor
 300 LIBRARY_PROCESS_SVG = ./$(USVG_PROCESSOR) $@ $(wordlist 1,2,$^) '$(USVG_CMD) $(USVG_OPTIONS)'
 301 $(LIBRARY_FILES): $(USVG_PROCESSOR) $(USVG_DEP) $(MAKEFILE_DEP)
 302
 303 # actual command for each of $(LIBRARY_FILES) is in one of the files.make
 304
 305 library/%/files.make: media-scraper library/%.toml
 306         ./$< --offline library/$*.toml
 307
 308 #---------- typescript ----------
 309
 310 templates/%.js: tsc-wrap tsconfig.json
 311         ./tsc-wrap $@ tsconfig.json $(filter %.ts,$^)
 312
 313 templates/script.js: $(TS_SRC_FILES) stamp/wasm-bindgen
 314
 315 #---------- other templates ----------
 316
 317 $(addprefix templates/,$(LITFILES)): templates/%: %
 318         cp $< $@.new && mv -f $@.new $@
 319
 320 $(addprefix templates/,$(TXTFILES)): templates/%: %.txt
 321         cp $< $@.new && mv -f $@.new $@
 322
 323 libraries: $(LIBRARY_FILES)
 324
 325 templates/shapelib.html: $(TARGET_DIR)/debug/otterlib $(LIBRARY_FILES)
 326         $(NAILING_CARGO_JUST_RUN) $(abspath $<) \
 327         --libs '$(addprefix $(PWD)/, $(addsuffix .toml, $(LIBRARIES)))' \
 328                 preview >$@.tmp && mv -f $@.tmp $@
 329
 330 #---------- examples ----------
 331
 332 EXAMPLE_BUNDLE_INPUT_DEPS := $(shell                                    \
 333         cd examples/test-bundle/ && find \! \( -name '*~' -o -name '.*' \) \
 334 )
 335
 336 examples/%.zip: $(MAKEFILE_DEP)
 337         set -e; rm -f $@.tmp; cd examples/$*/; \
 338         zip $(ZIPFLAGS) -DX ../$(notdir $@).tmp $(ZIP_INPUTS)
 339         mv -f $@.tmp $@
 340
 341 examples/test-bundle.zip: ZIP_INPUTS=$(EXAMPLE_BUNDLE_INPUT_DEPS)
 342 examples/test-bundle.zip: \
 343  $(addprefix examples/test-bundle/, $(EXAMPLE_BUNDLE_INPUT_DEPS))
 344
 345 examples/big-bundle.zip: examples/big-bundle/otter.toml
 346 examples/big-bundle.zip: ZIPFLAGS+= -0 -r -q
 347 examples/big-bundle.zip: ZIP_INPUTS=.
 348 examples/big-bundle/otter.toml: $(LIBRARY_FILES) $(MAKEFILE_DEP)
 349         rm -rf examples/big-bundle
 350         mkdir examples/big-bundle examples/big-bundle/library
 351         @set -e; echo 'MKDIR for $@'; \
 352         for l in $(LIBRARIES); do \
 353                 mkdir examples/big-bundle/$$l; \
 354                 perl -p \
 355  -e 'BEGIN { print "# -- AUTOGENERATED FROM COPY IN OTTER SOURCE --\n" }' \
 356  -e 'if (m/^\[scraper]/..0) { unless (m/^\[(?!scraper)/..0) { s/^/\#/ } }' \
 357  -e 's/(?<=\s)\w\S*(?=\s)/-/ if m/^files = """/..m/^"""/;' \
 358                         <$$l.toml >examples/big-bundle/$$l.toml; done
 359         @set -e; echo 'LN for $@'; \
 360         for e in $(LIBRARY_FILE_INPUTS); do \
 361                 ln $${e#*:} examples/big-bundle/$${e%%.usvg:*}.svg; done;
 362         @set -e; echo 'MV for $@'; \
 363         cd examples/big-bundle/library/; for x in '' .toml; do \
 364                 mv wikimedia$$x duped-example$$x; done
 365         @set -e; mkdir examples/big-bundle/specs/; \
 366         perl -pe <specs/demo.game.toml \
 367                 >examples/big-bundle/specs/Modded-spec.game.toml \
 368                 's/chess-b-/chess-purple-/; s/chess-w-/chess-yellow-/'
 369         @set -e; echo 'ECHO for $@'; \
 370         echo 'title = "Autogenerated test bundle - do not distribute"' \
 371                 >$@.tmp
 372         mv -f $@.tmp $@
 373
 374 #---------- webdriver tests (wdt) ----------
 375
 376 AT_TESTS := $(basename $(notdir $(wildcard apitest/at-*.rs)))
 377 WDT_TESTS := $(basename $(notdir $(wildcard wdriver/wdt-*.rs)))
 378
 379 WDT_LANDSCAPE_TESTS = wdt-altergame
 380
 381 at:     $(foreach f, $(AT_TESTS), stamp/$f.check)
 382
 383 wdt:    $(foreach f, $(WDT_TESTS), stamp/$f.check) \
 384         $(foreach f, $(WDT_LANDSCAPE_TESTS), stamp/$f.lcheck) \
 385
 386 RUNTEST_DEPS =  apitest/run1 stamp/cargo.debug $(FILEASSETS) \
 387                 $(wildcard specs/*.toml) examples/test-bundle.zip \
 388                 $(wildcard libraries/*.toml) $(LIBRARY_FILES)
 389
 390 AT_DEPS =       $(filter-out templates/script.js, $(RUNTEST_DEPS)) \
 391                 examples/big-bundle.zip \
 392                 stamp/cargo-at.debug
 393
 394 WDT_DEPS =      $(RUNTEST_DEPS) \
 395                 stamp/cargo-wdt.debug
 396
 397 AT_WDT_RUN = $(NAILING_CARGO_JUST_RUN) $(abspath $<)
 398
 399 AT_RUN = $(AT_WDT_RUN) apitest --test=$(basename $(notdir $@))
 400 WDT_RUN = $(AT_WDT_RUN) wdriver --test=$(basename $(notdir $@))
 401
 402 for-at:                 $(AT_DEPS)
 403 stamp/at-%.check:       $(AT_DEPS)
 404         $(AT_RUN)
 405         $(stamp)
 406
 407 for-wdt:                $(WDT_DEPS)
 408 stamp/wdt-%.check:      $(WDT_DEPS)
 409         $(WDT_RUN)
 410         $(stamp)
 411
 412 stamp/wdt-%.lcheck:     $(WDT_DEPS)
 413         $(WDT_RUN) --as-if=lwdt-$* --layout=Landscape
 414         $(stamp)
 415
 416 #---------- docs publication ----------
 417
 418 PUBLISH_USER=ianmdlvl@login.chiark.greenend.org.uk
 419 PUBLISH_DOC_SPHINX=$(PUBLISH_USER):public-html/otter/docs
 420
 421 publish: doc-sphinx
 422         rsync -r --delete-delay docs/html/. $(PUBLISH_DOC_SPHINX)/.
 423         git branch -f $(PUBLISHED_BRANCH)
 424
 425 #---------- deployment ----------
 426
 427 DEPLOY_USER=ian@login.chiark.greenend.org.uk
 428 DEPLOY_BASE=$(DEPLOY_USER):/volatile/Otter
 429 DEPLOY_FINISH=/home/Otter/etc/deploy-finish
 430
 431 for-deploy: stamp/cargo.deploy-build
 432 deploy: for-deploy bundled-sources assets libraries
 433         rsync -zv --progress $(addprefix $(DEPLOY_TARGET_DIR)/,$(PROGRAMS)) $(DEPLOY_BASE)/bin/
 434         rsync -zv --progress $(TARGET_DIR)/release/usvg $(DEPLOY_BASE)/libexec/
 435         rsync -rv --progress $(TARGET_DIR)/bundled-sources/. $(DEPLOY_BASE)/bundled-sources
 436         rsync -r README.md $(DEPLOY_BASE)/.
 437         rsync -r --delete --exclude=\*~ library specs $(DEPLOY_BASE)/.
 438         rsync -r $(FILEASSETS) $(addprefix $(WASM_PACKED)/, $(WASM_ASSETS)) \
 439                 $(DEPLOY_BASE)/assets/
 440         rsync -r nwtemplates/*.tera $(DEPLOY_BASE)/nwtemplates/
 441         ssh -o BatchMode=true $(DEPLOY_USER) $(DEPLOY_FINISH)
 442         git branch -f $(DEPLOYED_BRANCH)
 443         -git push origin main
 444         -git push chiark main
 445
 446 #$(DEPLOY_BASE)/bundled-sources
 447
 448 #---------- clean ----------
 449
 450 clean-for-retest:
 451         rm -f templates/script.js library/*/*.usvg stamp/*
 452         rm -rf $(LIBRARY_CLEAN)
 453         rm -rf examples/big-bundle examples/big-bundle.zip
 454         rm -f examples/test-bundle.zip
 455         find * \( -name '*~' -o -name '*.tmp' \) -print0 | xargs -0r rm --
 456
 457 clean: clean-nailing clean-for-retest
 458         rm -rf target
 459         $(NAILING_CARGO_JUST_RUN) rm -rf target