quicknxs/Makefile at next · bvacaliuc/quicknxs · GitHub

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
63
64
65
66
67
68
69
70
71
72
.PHONY: gui install test test-core test-gui test-db lint clean reduce-headless strace strace-full strace-reduce

gui: install
	pixi run python scripts/quicknxs

install:
	pixi install

test: install
	pixi run test

test-core: install
	pixi run test-core

test-gui: install
	pixi run test-gui

test-db: install
	pixi run test-db

lint: install
	pixi run ruff check quicknxs/

clean:
	rm -rf __pycache__ .pytest_cache *.egg-info

reduce-headless: install
	pixi run python scripts/reduce_headless.py

# Diagnostic targets for memory fault analysis.
# Usage:
#   make strace          - trace memory-related syscalls in the GUI app
#   make strace-reduce   - trace memory-related syscalls in headless reduction
#   make strace-full     - trace all syscalls (large output)
#
# Output files are written to strace.<PID> (one per process).
# The Python application PID is typically the highest-numbered PID file.
# After a crash (exit 137 = OOM kill), examine the Python process log:
#   ls -la strace.*                       # find the files
#   tail -100 strace.<highest_pid>        # see last syscalls before kill
#   grep -c 'mmap\|brk' strace.<pid>      # count memory allocations

STRACE_MEMORY_TRACE = -e trace=memory,signal,process
STRACE_OPTS = -f -ff -o strace -t -T

strace: install
	rm -f strace.*
	strace $(STRACE_OPTS) $(STRACE_MEMORY_TRACE) pixi run python scripts/quicknxs; \
	echo ""; \
	echo "=== strace complete (exit $$?) ==="; \
	echo "Output files:"; \
	ls -lhS strace.* 2>/dev/null || echo "  (no output files found)"; \
	echo ""; \
	echo "To analyze: tail -100 strace.<PID>"

strace-reduce: install
	rm -f strace.*
	strace $(STRACE_OPTS) $(STRACE_MEMORY_TRACE) pixi run python scripts/reduce_headless.py; \
	echo ""; \
	echo "=== strace complete (exit $$?) ==="; \
	echo "Output files:"; \
	ls -lhS strace.* 2>/dev/null || echo "  (no output files found)"; \
	echo ""; \
	echo "To analyze: tail -100 strace.<PID>"

strace-full: install
	rm -f strace.*
	strace $(STRACE_OPTS) pixi run python scripts/quicknxs; \
	echo ""; \
	echo "=== strace complete (exit $$?) ==="; \
	echo "Output files:"; \
	ls -lhS strace.* 2>/dev/null || echo "  (no output files found)"