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
|
.DEFAULT_GOAL := help
ifeq ($(QTILE_CI_PYTHON),)
UV_PYTHON_ARG =
else
UV_PYTHON_ARG = --python=$(QTILE_CI_PYTHON)
endif
ifeq ($(QTILE_CI_BACKEND),)
PYTEST_BACKEND_ARG =
else
PYTEST_BACKEND_ARG = --backend=$(QTILE_CI_BACKEND)
endif
TEST_RUNNER = python3 -m pytest
ifeq ($(GITHUB_ACTIONS),true)
TEST_RUNNER = coverage run -m pytest
endif
.PHONY: help
help: ## Show this help
@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "\033[1m%-15s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
.PHONY: deps
deps: ## Install all of qtile's dependencies.
uv sync $(UV_PYTHON_ARG) --all-extras
.PHONY: check
check: deps ## Run the test suite on the latest python
uv run ./libqtile/backend/wayland/cffi/build.py
uv run $(UV_PYTHON_ARG) $(TEST_RUNNER) $(PYTEST_BACKEND_ARG)
.PHONY: docs
docs: deps ## Run the sphinx build for the html docs.
uv run $(MAKE) -C docs html
.PHONY: check-packaging
check-packaging: ## Check that the packaging is sane
uv run $(UV_PYTHON_ARG) check-manifest
uv run $(UV_PYTHON_ARG) python3 -m build --sdist .
uv run $(UV_PYTHON_ARG) twine check dist/*
.PHONY: lint
lint: ## Check the source code
pre-commit run -a
.PHONY: clean
clean: ## Clean generated files
-rm -rf dist qtile.egg-info docs/_build build/ .mypy_cache/ .pytest_cache/ .eggs/
.PHONY: update-flake
update-flake: ## Update the Nix flake.lock file, requires Nix installed with flake support, see: https://nixos.wiki/wiki/Flakes
nix flake update
.PHONY: build-wayland
build-wayland: ## Build wayland backend
@python libqtile/backend/wayland/cffi/build.py
.PHONY: build-wayland-debug
build-wayland-debug: ## Build wayland backend with debug symbols
@echo "Building wayland backend with debug symbols."
@python libqtile/backend/wayland/cffi/build.py --debug
.PHONY: build-wayland-asan
build-wayland-asan: ## Build wayland backend with address sanitisation support.
@echo "Building wayland backend with address sanitisation support."
@echo "When starting qtile, you'll need to set 'LD_PRELOAD=$(gcc -print-file-name=libasan.so)' first."
@python libqtile/backend/wayland/cffi/build.py --asan
|
