Makefile

# Python binary
PYTHON := python$(VERSION)

# Poetry
POETRY := poetry

PROJECT_DIR := newtype
SRC := src
EXTENSIONS := extensions

# Docker
DOCKER_DEMO_IMAGE := python-newtype-demo
DOCKERFILE_DEMO_PATH := tests/Dockerfile

DOCKER_TESTS_MULVER_IMAGE := python-newtype-test-mul-vers
DOCKERFILE_TESTS_MULVER_PATH := tests/Dockerfile-test-mul-vers
DOCKER_TAG := latest

# Files and directories
SO_FILES := newtypemethod.cpython-*-linux-gnu.so newtypeinit.cpython-*-linux-gnu.so $(PROJECT_DIR)/$(EXTENSIONS)/newtypemethod.cpython-*-linux-gnu.so $(PROJECT_DIR)/$(EXTENSIONS)/newtypeinit.cpython-*-linux-gnu.so
PYD_FILES := newtypemethod.*-*.pyd newtypeinit.*-*.pyd $(PROJECT_DIR)/$(EXTENSIONS)/newtypemethod.*-*.pyd $(PROJECT_DIR)/$(EXTENSIONS)/newtypeinit.*-*.pyd
BUILD_DIR := build
PYTEST_FLAGS := -s -vv

.PHONY: all clean build test test-all test-debug test-custom test-free test-slots test-init test-leak install lint format check venv-poetry clean-deps docker-build docker-run docker-clean docker-demo dist-contents check-version

# Default target
all: clean build test format check venv-poetry clean-deps

# Docker targets
docker-demo-build:
	docker build -t $(DOCKER_DEMO_IMAGE):$(DOCKER_TAG) -f $(DOCKERFILE_DEMO_PATH) .

docker-demo-run:
	docker run --rm $(DOCKER_DEMO_IMAGE):$(DOCKER_TAG)

docker-demo-clean:
	docker rmi $(DOCKER_DEMO_IMAGE):$(DOCKER_TAG)

# Run complete Docker demo cycle: build, run, clean
docker-demo: docker-demo-build docker-demo-run docker-demo-clean

docker-test-mulvers-build:
	docker build -t $(DOCKER_TESTS_MULVER_IMAGE):$(DOCKER_TAG) --progress=plain -f $(DOCKERFILE_TESTS_MULVER_PATH) .

docker-test-mulvers-run:
	docker run --rm $(DOCKER_TESTS_MULVER_IMAGE):$(DOCKER_TAG)

docker-test-mulvers-clean:
	docker rmi $(DOCKER_TESTS_MULVER_IMAGE):$(DOCKER_TAG)

# Run complete Docker demo cycle: build, run, clean
docker-test-mulvers: docker-test-mulvers-build docker-test-mulvers-run docker-test-mulvers-clean

# Distribution targets
dist-contents: build
	tar -tzf dist/python_newtype_dev-*.tar.gz

# Check code quality
check:
	ruff check . --fix
	find . -wholename "./newtype/extensions/*.c" -exec cppcheck {} +

# Format code
format:
	ruff format .
	find . -name "*.c" -exec clang-format -i {} +

# Clean build artifacts
clean:
	rm -fr dist
	rm -f $(SO_FILES)
	rm -f $(PYD_FILES)
	rm -rf $(BUILD_DIR)
	find . -type d -name "__pycache__" -exec rm -rf {} +
	find . -type f -name "*.pyc" -delete

clean-venv:
	rm -fr .venv$(VERSION)
	python$(VERSION) -m venv .venv$(VERSION)

clean-deps:
	pip freeze | xargs pip uninstall -y

# Build extensions
build: clean
	$(POETRY) build

update-docs-deps:
	poetry lock && poetry export -f requirements.txt --output requirements-docs.txt --with docs

# Build with debug printing enabled
build-debug: clean
	export __PYNT_DEBUG__="true" && $(POETRY) build && unset __PYNT_DEBUG__

# Install dependencies
install: build
	$(PYTHON) -m pip install dist/python_newtype-0.1.*-*.whl

# Run all tests
test:
	$(PYTHON) -m pytest . $(PYTEST_FLAGS)

# Run all tests with debug build
test-debug: build-debug
	$(PYTHON) -m pytest . $(PYTEST_FLAGS)

# Run specific test suites
test-custom:
	$(PYTHON) -m pytest tests/test_custom_type.py $(PYTEST_FLAGS)

test-free:
	$(PYTHON) -m pytest tests/test_freestanding.py $(PYTEST_FLAGS)

test-slots:
	$(PYTHON) -m pytest tests/test_slots.py $(PYTEST_FLAGS)

test-init:
	$(PYTHON) -m pytest tests/test_newtype_init.py $(PYTEST_FLAGS)

test-str:
	$(PYTHON) -m pytest tests/test_newtype_str.py $(PYTEST_FLAGS)

test-async:
	$(PYTHON) -m pytest tests/test_async.py $(PYTEST_FLAGS)

test-enums:
	$(PYTHON) -m pytest tests/test_newtype_enums.py $(PYTEST_FLAGS)

# Run memory leak tests
test-leak:
	$(PYTHON) -m pytest --enable-leak-tracking -W error tests/test_newtype_init.py $(PYTEST_FLAGS)

# Run a specific test file (usage: make test-file FILE=test_newtype.py)
test-file:
	$(PYTHON) -m pytest $(FILE) $(PYTEST_FLAGS)

test-e2e:
	bash tests/build_test_pyvers_docker_images.sh

# Development workflow targets
dev: clean build test

dev-debug: clean build-debug test

install-poetry:
	$(PYTHON) -m pip install poetry

install-dev-deps: install-poetry venv-poetry
	poetry lock
	poetry install --no-interaction --no-root

venv-poetry:
	poetry config virtualenvs.in-project true

install-test: install-dev-deps dev

list-packaged: build
	tar -tf $(shell ls -1 dist/*.tar.gz | sort -V | tail -n 1)
	unzip -l dist/python_newtype-0.1.*-*.whl

# Version verification
check-version:
	@echo "Checking version consistency..."
	@DIST_FILE=$$(ls dist/python_newtype-*.tar.gz | sort -V | tail -n1); \
	if [ ! -f "$$DIST_FILE" ]; then \
		echo "Error: No distribution package found in dist/"; \
		exit 1; \
	fi; \
	DIST_BASE=$$(basename "$$DIST_FILE" .tar.gz); \
	DIST_VERSION=$$(tar -xOf "$$DIST_FILE" "$$DIST_BASE/newtype/__init__.py" | grep "__version__" | cut -d'"' -f2); \
	GIT_VERSION=$$(git describe --tags --abbrev=0 | sed 's/^v//'); \
	if [ -z "$$DIST_VERSION" ] || [ -z "$$GIT_VERSION" ]; then \
		echo "Error: Could not extract version information"; \
		exit 1; \
	fi; \
	if [ "$$DIST_VERSION" != "$$GIT_VERSION" ]; then \
		echo "Version mismatch:"; \
		echo "  Distribution version: $$DIST_VERSION"; \
		echo "  Git tag version: $$GIT_VERSION"; \
		exit 1; \
	else \
		echo "Version consistency check passed (version: $$DIST_VERSION)"; \
	fi

# Help target
help:
	@echo "Available targets:"
	@echo "  all          - Clean, build, and run tests (default)"
	@echo "  clean        - Remove build artifacts and cache files"
	@echo "  build        - Build C extensions"
	@echo "  build-debug  - Build C extensions with debug printing"
	@echo "  install      - Install project dependencies"
	@echo "  test         - Run all tests"
	@echo "  test-debug   - Run all tests with debug build"
	@echo "  test-custom  - Run custom type tests"
	@echo "  test-free    - Run freestanding tests"
	@echo "  test-slots   - Run slots tests"
	@echo "  test-init    - Run initialization tests"
	@echo "  test-str     - Run string type tests"
	@echo "  test-async   - Run async tests"
	@echo "  test-leak    - Run memory leak tests"
	@echo "  test-file    - Run a specific test file (usage: make test-file FILE=test_newtype.py)"
	@echo "  dev          - Development workflow: clean, build, test"
	@echo "  dev-debug    - Development workflow with debug: clean, build-debug, test"
	@echo "  format    	  - Format all codes"
	@echo "  clean-deps   - Uninstall all dependencies in the Virtual Environment"