Makefile

# Django Endless Pagination Makefile.

# Define these variables based on the system Python versions.
PYTHON ?= python3

VENV = .venv
WITH_VENV = ./tests/with_venv.sh $(VENV)
MANAGE = $(PYTHON) ./tests/manage.py
LINTER = flake8 --show-source el_pagination/ tests/
DOC_INDEX = doc/_build/html/index.html

.PHONY: all clean cleanall check develop help install lint doc opendoc release server shell source test

all: develop

# Virtual environment
$(VENV)/bin/activate: tests/develop.py tests/requirements.pip
	@$(PYTHON) tests/develop.py
	@touch $(VENV)/bin/activate
	$(VENV)/bin/pip install --upgrade pip setuptools wheel
	$(VENV)/bin/pip install -r tests/requirements.pip

develop: $(VENV)/bin/activate
	$(VENV)/bin/pip install -e .

# Documentation
$(DOC_INDEX): $(wildcard doc/*.rst)
	@$(WITH_VENV) make -C doc html

doc: develop $(DOC_INDEX)

clean:
	pip uninstall django-el-pagination -y || true
	rm -rf .coverage build/ dist/ doc/_build MANIFEST *.egg-info
	find . -name '*.pyc' -delete
	find . -name '__pycache__' -type d -delete

cleanall: clean
	rm -rf $(VENV)

check: test lint

install:
	pip install --force-reinstall -e .

lint: develop
	@$(WITH_VENV) $(LINTER)

black: develop
	@echo "***  Black - Reformat pycode ***"
	@echo ""
	@$(WITH_VENV) black el_pagination/ tests/

black_diff: develop
	@echo "*** Black - Show pycode diff ***"
	@echo ""
	black --diff --check --color el_pagination/ tests/

pylint: develop
	@echo "Running pylint"
	pylint --rcfile=.pylintrc el_pagination/ tests/
	@echo "Finish pylint"

opendoc: doc
	@firefox $(DOC_INDEX)

server: develop
	@$(WITH_VENV) $(MANAGE) runserver 0.0.0.0:8000

shell: develop
	@$(WITH_VENV) $(MANAGE) shell

source:
	$(PYTHON) setup.py sdist

test: develop
	@$(WITH_VENV) $(MANAGE) test

build-dist: clean develop
	@echo "Installing build dependencies..."
	$(VENV)/bin/pip install build twine
	@echo "Building distribution..."
	$(VENV)/bin/python -m build

check-dist: build-dist
	@echo "Checking distribution..."
	$(VENV)/bin/twine check dist/*

upload-dist: check-dist
	@echo "Uploading to PyPI..."
	$(VENV)/bin/twine upload dist/*

release: clean develop
	@echo "Starting release process..."
	@if [ -z "$$SKIP_CONFIRMATION" ]; then \
		read -p "Are you sure you want to release to PyPI? [y/N] " confirm; \
		if [ "$$confirm" != "y" ]; then \
			echo "Release cancelled."; \
			exit 1; \
		fi \
	fi
	$(MAKE) build-dist
	$(MAKE) check-dist
	@echo "Ready to upload to PyPI..."
	@if [ -z "$$SKIP_CONFIRMATION" ]; then \
		read -p "Proceed with upload? [y/N] " confirm; \
		if [ "$$confirm" != "y" ]; then \
			echo "Upload cancelled."; \
			exit 1; \
		fi \
	fi
	$(MAKE) upload-dist
	@echo "Release completed successfully!"


help:
	@echo 'Django Endless Pagination - Available commands:'
	@echo
	@echo 'Development:'
	@echo '  make          - Set up development environment'
	@echo '  make install  - Install package locally'
	@echo '  make server   - Run development server'
	@echo '  make shell    - Enter Django shell'
	@echo
	@echo 'Testing:'
	@echo '  make test     - Run tests'
	@echo '  make lint     - Run code linting'
	@echo '  make check    - Run tests and linting'
	@echo
	@echo 'Documentation:'
	@echo '  make doc      - Build documentation'
	@echo '  make opendoc  - Build and open documentation'
	@echo
	@echo 'Cleaning:'
	@echo '  make clean    - Remove build artifacts'
	@echo '  make cleanall - Remove all generated files including venv'
	@echo
	@echo 'Distribution:'
	@echo '  make source   - Create source package'
	@echo '  make release  - Upload to PyPI'
	@echo
	@echo 'Environment Variables:'
	@echo '  USE_SELENIUM=1    - Include integration tests'
	@echo '  SHOW_BROWSER=1    - Show browser during Selenium tests'
	@echo