Makefile

###############################################################################
# Common make values.
lib    := parllama
run    := uv run
python := $(run) python
ruff   := $(run) ruff
pyright := $(run) pyright
twine  := $(run) twine
build  := $(python) -m build

export UV_LINK_MODE=copy
export PIPENV_VERBOSITY=-1
##############################################################################
# Run the app.
.PHONY: run
run:	        # Run the app
	$(run) $(lib)

.PHONY: app_help
app_help:	        # Show app help
	$(run) $(lib) --help

.PHONY: restore_defaults
restore_defaults:	        # Restore application default settings
	$(run) $(lib) --restore-defaults

.PHONY: clear_cache
clear_cache:	        # Clear application cache
	$(run) $(lib) --clear-cache

.PHONY: dev
dev:	        # Run in dev mode
	$(run) textual run --dev $(lib).app:ParLlamaApp

.PHONY: keys
keys:	        # Run in keyboard input tester
	$(run) textual keys

.PHONY: borders
borders:	        # Run border sample display
	$(run) textual borders

.PHONY: colors
colors:	        # Run color sample display
	$(run) textual colors

.PHONY: wsl-dev
wsl-dev:	        # Run in dev mode
	$(run) textual run --dev $(lib).app:ParLlamaApp -u "http://$(shell hostname).local:11434"

.PHONY: wsl-run
wsl-run:	        # Run in dev mode
	$(python) -m $(lib) -u "http://$(shell hostname).local:11434"

.PHONY: chat_dev
chat_dev:	        # Run in dev mode
	$(run) textual run --dev $(lib).app:ParLlamaApp -s chat

.PHONY: debug
debug:	        # Run in debug mode
	TEXTUAL=devtools make

.PHONY: console
console:	        # Run textual dev console
	$(run) textual console

.PHONY: test
test:	        # Run textual dev console
	$(python) -m unittest discover -s tests


##############################################################################
.PHONY: uv-lock
uv-lock:
	uv lock

.PHONY: uv-sync
uv-sync:
	uv sync

.PHONY: setup
setup: uv-lock uv-sync	        # use this for first time run

.PHONY: resetup
resetup: remove-venv setup			# Recreate the virtual environment from scratch

.PHONY: remove-venv
remove-venv:			# Remove the virtual environment
	rm -rf .venv

.PHONY: depsupdate
depsupdate:			# Update all dependencies
	uv sync -U

.PHONY: depsshow
depsshow:			# Show the dependency graph
	uv tree

.PHONY: shell
shell:			# Start shell inside of .venv
	$(run) bash
##############################################################################
# Checking/testing/linting/etc.
.PHONY: format
format:                         # Reformat the code with ruff.
	$(ruff) format src/$(lib)

.PHONY: lint
lint:                           # Run ruff lint over the library
	$(ruff) check src/$(lib) --fix

.PHONY: lint-unsafe
lint-unsafe:                           # Run ruff lint over the library
	$(ruff) check src/$(lib) --fix --unsafe-fixes


.PHONY: typecheck
typecheck:			# Perform static type checks with pyright
	$(pyright)

.PHONY: typecheck-stats
typecheck-stats:			# Perform static type checks with pyright and print stats
	$(pyright) --stats

.PHONY: checkall
checkall: typecheck lint 	        # Check all the things

.PHONY: pre-commit	        # run pre-commit checks on all files
pre-commit:
	pre-commit run --all-files

.PHONY: pre-commit-update	        # run pre-commit and update hooks
pre-commit-update:
	pre-commit autoupdate

##############################################################################
# Package/publish.
.PHONY: package
package:			# Package the library
	$(build) -w

.PHONY: spackage
spackage:			# Create a source package for the library
	$(build) -s

.PHONY: packagecheck
packagecheck: clean package spackage		# Check the packaging.
	$(twine) check dist/*

.PHONY: testdist
testdist: packagecheck		# Perform a test distribution
	$(twine) upload --repository testpypi dist/*
	#$(twine) upload --skip-existing --repository testpypi dist/*

.PHONY: dist
dist: packagecheck		# Upload to pypi
	$(twine) upload --skip-existing dist/*

##############################################################################
# Utility.

.PHONY: get-venv-name
get-venv-name:
	$(run) which python

.PHONY: repl
repl:				# Start a Python REPL
	$(python)

.PHONY: clean
clean:				# Clean the build directories
	rm -rf build dist $(lib).egg-info

.PHONY: help
help:				# Display this help
	@grep -Eh "^[a-z]+:.+# " $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.+# "}; {printf "%-20s %s\n", $$1, $$2}'

##############################################################################
# Housekeeping tasks.
.PHONY: housekeeping
housekeeping:			# Perform some git housekeeping
	git fsck
	git gc --aggressive
	git remote update --prune

### Makefile ends here