magdev
de4a14da36
Closes the testing-strategy row of PLAN.md §13 v0.2.0 and parks the
two remaining items with rationales.
Shipped:
- framework/qml/tests/{CMakeLists.txt, main.cpp, tst_smoke.qml}
Qt Quick Test scaffold: QUICK_TEST_MAIN bootstrap + one smoke test
proving the harness loads. New tests land as tst_<feature>.qml in
the same dir; qmltestrunner auto-discovers them. Built only when
-DBUILD_TESTING=ON (production AppImages stay clean).
- skeleton + example/todo Makefiles: `make qmltest` target invokes
the configure → build → ctest dance. `make quality` now depends
on qmltest.
- .gitea/workflows/ci.yml: `QML unit tests` step after qmllint in
the Quality job. Out-of-tree build dir (build-tests) so the
CTest run doesn't pollute the cached release build.
Verified locally: configure + build + ctest pass, both smoke
assertions pass, runs in 0.5s.
Closed in PLAN.md §13 v0.2.0 with rationale (no code change):
- Build-time Symfony cache warmup → moved to v0.3.0. The obvious
approach (cache:warmup at build, copy at first launch) doesn't
save any time because Symfony bakes absolute kernel.project_dir
into the compiled cache, and the AppImage's FUSE mount path
changes every launch — every cached path is stale on launch N+1.
Doing it properly requires virtualising getProjectDir(), symlink
fix-up, multi-app namespacing — its own minor's worth of design.
- ReactiveObject cursor pagination → closed N/A. ReactiveObject
already has pending / invoke() / Idempotency-Key correlation /
version-gap detection at parity with ReactiveListModel; the only
feature it lacks is *pagination*, which is meaningless for a
single-entity model.
That fully closes the v0.2.0 plan as documented. Remaining v0.2.0
items in PLAN.md §13 are the audit-ends already shipped earlier in
the cycle (interfaces / BridgeOp / BridgeBundleInfo / Maker DRY /
--with-dto / port negotiation / pre-migration backup / bridge:export
/ periodic auto-update / native-dialogs doc / event maker /
read-model maker / qmltestrunner) plus the two parked items
documented above. Ready to tag when the user gives the word.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
97 lines
3.7 KiB
Makefile
97 lines
3.7 KiB
Makefile
# php-qml — Todo example app — Make targets.
|
|
|
|
.DEFAULT_GOAL := help
|
|
|
|
SYMFONY_DIR := symfony
|
|
QML_SRC_DIR := qml
|
|
BUILD_DIR := build/qml
|
|
QT_BIN := $(BUILD_DIR)/todo
|
|
|
|
.PHONY: help
|
|
help: ## Show available targets
|
|
@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf " %-12s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
|
|
|
|
.PHONY: install
|
|
install: ## Install Composer dependencies for the Symfony app
|
|
cd $(SYMFONY_DIR) && composer install
|
|
|
|
.PHONY: build
|
|
build: ## Build the Qt host
|
|
cmake -S $(QML_SRC_DIR) -B $(BUILD_DIR) -DCMAKE_BUILD_TYPE=Debug
|
|
cmake --build $(BUILD_DIR) --parallel
|
|
|
|
.PHONY: dev
|
|
dev: build ## Run the todo app in dev mode (FrankenPHP --watch + Qt host)
|
|
./scripts/dev.sh
|
|
|
|
.PHONY: doctor
|
|
doctor: ## Run bridge:doctor inside the Symfony app
|
|
cd $(SYMFONY_DIR) && bin/console bridge:doctor
|
|
|
|
.PHONY: doctor-connect
|
|
doctor-connect: ## Run bridge:doctor with backend connectivity probe
|
|
cd $(SYMFONY_DIR) && bin/console bridge:doctor --connect
|
|
|
|
.PHONY: clean
|
|
clean: ## Remove build artefacts
|
|
rm -rf $(BUILD_DIR)
|
|
|
|
.PHONY: integration
|
|
integration: ## Run the bridge-integration test (FrankenPHP boot + HTTP/SSE round-trip + crash-recover)
|
|
./tests/integration.sh
|
|
|
|
.PHONY: integration-bundled
|
|
integration-bundled: build staging-symfony ## Bundled-mode integration test (faked AppImage layout, no .AppImage build needed)
|
|
./tests/bundled-supervisor.sh
|
|
|
|
.PHONY: perf
|
|
perf: ## Run the AppImage perf smoke test (PLAN.md §11 budgets)
|
|
./tests/perfsmoke.sh build/Todo-x86_64.AppImage
|
|
|
|
.PHONY: staging-symfony
|
|
staging-symfony: ## Stage a --no-dev composer copy of symfony for AppImage / bundled-mode tests
|
|
# Composer install --no-dev in a staging copy of symfony so the
|
|
# dev tree (with maker-bundle etc.) is left untouched.
|
|
rm -rf build/staging-symfony
|
|
rsync -a --delete \
|
|
--exclude='vendor/' \
|
|
--exclude='var/cache/' --exclude='var/log/' \
|
|
$(SYMFONY_DIR)/ build/staging-symfony/
|
|
# Rewrite the path repo to absolute so composer can find the bundle
|
|
# from the staging dir, AND flip symlink:true → false so composer copies
|
|
# the bundle into vendor/ — symlinks would survive the rsync into the
|
|
# AppDir but their targets wouldn't exist on the user's machine.
|
|
BUNDLE_ABS="$$(cd $(SYMFONY_DIR)/../../../framework/php && pwd)"; \
|
|
sed -i "s|\"../../../framework/php\"|\"$$BUNDLE_ABS\"|" build/staging-symfony/composer.json
|
|
sed -i 's|"symlink": true|"symlink": false|' build/staging-symfony/composer.json
|
|
rm -f build/staging-symfony/composer.lock
|
|
cd build/staging-symfony && composer install --no-dev --no-interaction --classmap-authoritative
|
|
|
|
.PHONY: appimage
|
|
appimage: build staging-symfony ## Package as a single-file Linux AppImage at build/Todo-x86_64.AppImage
|
|
../../packaging/linux/build-appimage.sh \
|
|
--app-name todo \
|
|
--host-binary $(QT_BIN) \
|
|
--symfony-dir build/staging-symfony \
|
|
--frankenphp $${FRANKENPHP:-frankenphp} \
|
|
--caddyfile Caddyfile \
|
|
--desktop packaging/todo.desktop \
|
|
--icon packaging/todo.png \
|
|
--output build/Todo-x86_64.AppImage \
|
|
$${APPIMAGE_UPDATE_INFO:+--update-info "$$APPIMAGE_UPDATE_INFO"}
|
|
@echo
|
|
@echo "AppImage built. Test with: ./build/Todo-x86_64.AppImage"
|
|
|
|
.PHONY: quality
|
|
quality: build qmltest ## Run PHPStan, php-cs-fixer (check), PHPUnit, qmllint, qmltest, integration (dev + bundled)
|
|
cd ../../framework/php && composer quality
|
|
cmake --build $(BUILD_DIR) --target all_qmllint
|
|
./tests/integration.sh
|
|
$(MAKE) integration-bundled
|
|
|
|
.PHONY: qmltest
|
|
qmltest: ## Run QML unit tests (Qt::QuickTest via qmltestrunner)
|
|
cmake -S ../../framework/qml -B ../../framework/qml/build-tests -DBUILD_TESTING=ON
|
|
cmake --build ../../framework/qml/build-tests --target qml_unit_tests --parallel
|
|
ctest --test-dir ../../framework/qml/build-tests --output-on-failure -R qml_unit_tests
|