Pillow/Makefile

128 lines
4.0 KiB
Makefile
Raw Normal View History

2020-12-30 13:25:34 +03:00
.DEFAULT_GOAL := help
2014-07-15 08:02:12 +04:00
2020-08-01 12:21:28 +03:00
.PHONY: clean
2014-06-27 23:07:53 +04:00
clean:
2019-09-26 15:12:28 +03:00
python3 setup.py clean
2017-12-30 23:11:26 +03:00
rm src/PIL/*.so || true
2014-07-09 21:13:02 +04:00
rm -r build || true
find . -name __pycache__ | xargs rm -r || true
2020-08-01 12:21:28 +03:00
.PHONY: coverage
2016-06-17 13:03:21 +03:00
coverage:
python3 -c "import pytest" > /dev/null 2>&1 || python3 -m pip install pytest
python3 -m pytest -qq
2014-06-27 23:07:53 +04:00
rm -r htmlcov || true
python3 -c "import coverage" > /dev/null 2>&1 || python3 -m pip install coverage
python3 -m coverage report
2014-06-27 23:07:53 +04:00
2020-08-01 12:21:28 +03:00
.PHONY: doc
.PHONY: html
doc html:
python3 -c "import PIL" > /dev/null 2>&1 || python3 -m pip install .
2014-07-15 08:02:12 +04:00
$(MAKE) -C docs html
2023-03-08 19:22:33 +03:00
.PHONY: htmlview
htmlview:
python3 -c "import PIL" > /dev/null 2>&1 || python3 -m pip install .
$(MAKE) -C docs htmlview
2020-08-01 12:21:28 +03:00
.PHONY: doccheck
doccheck:
$(MAKE) doc
2016-07-01 14:53:44 +03:00
# Don't make our tests rely on the links in the docs being up every single build.
2016-07-01 14:49:44 +03:00
# We don't control them. But do check, and update them to the target of their redirects.
2016-04-19 17:29:33 +03:00
$(MAKE) -C docs linkcheck || true
2020-08-01 12:21:28 +03:00
.PHONY: docserve
docserve:
cd docs/_build/html && python3 -m http.server 2> /dev/null&
2020-08-01 12:21:28 +03:00
.PHONY: help
help:
2016-09-24 04:49:32 +03:00
@echo "Welcome to Pillow development. Please use \`make <target>\` where <target> is one of"
@echo " clean remove build products"
@echo " coverage run coverage test (in progress)"
2022-02-19 17:47:59 +03:00
@echo " doc make HTML docs"
@echo " docserve run an HTTP server on the docs directory"
@echo " html to make standalone HTML files"
2023-03-08 19:22:33 +03:00
@echo " htmlview to open the index page built by the html target in your browser"
@echo " inplace make inplace extension"
@echo " install make and install"
@echo " install-coverage make and install with C coverage"
2021-01-01 15:32:46 +03:00
@echo " lint run the lint checks"
2022-02-19 17:47:59 +03:00
@echo " lint-fix run Black and isort to (mostly) fix lint issues"
@echo " release-test run code and package tests before release"
2022-02-19 17:47:59 +03:00
@echo " test run tests on installed Pillow"
2020-08-01 12:21:28 +03:00
.PHONY: inplace
inplace: clean
python3 -m pip install -e --global-option="build_ext" --global-option="--inplace" .
2020-08-01 12:21:28 +03:00
.PHONY: install
install:
python3 -m pip -v install .
2019-09-26 15:12:28 +03:00
python3 selftest.py
2020-08-01 12:21:28 +03:00
.PHONY: install-coverage
install-coverage:
CFLAGS="-coverage -Werror=implicit-function-declaration" python3 -m pip -v install --global-option="build_ext" .
2019-09-26 15:12:28 +03:00
python3 selftest.py
2020-08-01 12:21:28 +03:00
.PHONY: debug
debug:
# make a debug version if we don't have a -dbg python. Leaves in symbols
# for our stuff, kills optimization, and redirects to dev null so we
# see any build failures.
make clean > /dev/null
CFLAGS='-g -O0' python3 -m pip -v install --global-option="build_ext" . > /dev/null
2020-08-01 12:21:28 +03:00
.PHONY: release-test
release-test:
python3 -m pip install -e .[tests]
2019-09-26 15:12:28 +03:00
python3 selftest.py
python3 -m pytest Tests
python3 -m pip install .
2020-10-18 23:22:24 +03:00
-rm dist/*.egg
-rmdir dist
2019-09-26 15:12:28 +03:00
python3 -m pytest -qq
python3 -m check_manifest
2022-02-22 03:54:42 +03:00
python3 -m pyroma .
$(MAKE) readme
2020-08-01 12:21:28 +03:00
.PHONY: sdist
sdist:
python3 -m build --help > /dev/null 2>&1 || python3 -m pip install build
python3 -m build --sdist
python3 -m twine --help > /dev/null 2>&1 || python3 -m pip install twine
2022-05-17 22:47:01 +03:00
python3 -m twine check --strict dist/*
2020-08-01 12:21:28 +03:00
.PHONY: test
test:
python3 -c "import pytest" > /dev/null 2>&1 || python3 -m pip install pytest
2022-02-22 03:54:42 +03:00
python3 -m pytest -qq
2021-04-09 14:39:28 +03:00
.PHONY: valgrind
valgrind:
python3 -c "import pytest_valgrind" > /dev/null 2>&1 || python3 -m pip install pytest-valgrind
2021-04-09 14:39:28 +03:00
PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp --leak-check=no \
--log-file=/tmp/valgrind-output \
python3 -m pytest --no-memcheck -vv --valgrind --valgrind-log=/tmp/valgrind-output
2020-08-01 12:21:28 +03:00
.PHONY: readme
readme:
python3 -c "import markdown2" > /dev/null 2>&1 || python3 -m pip install markdown2
2022-02-22 03:54:42 +03:00
python3 -m markdown2 README.md > .long-description.html && open .long-description.html
2020-12-30 13:51:04 +03:00
.PHONY: lint
lint:
python3 -c "import tox" > /dev/null 2>&1 || python3 -m pip install tox
2022-02-22 03:54:42 +03:00
python3 -m tox -e lint
.PHONY: lint-fix
lint-fix:
python3 -c "import black" > /dev/null 2>&1 || python3 -m pip install black
python3 -c "import isort" > /dev/null 2>&1 || python3 -m pip install isort
2022-02-22 03:54:42 +03:00
python3 -m black --target-version py37 .
python3 -m isort .