CPYTHON_CURRENT_COMMIT := afa24d52b821c2020e0966f96a6205bca7db85e9

LANGUAGE := fr

BRANCH := 3.11

EXCLUDED := \

whatsnew/2.?.po \

whatsnew/3.[0-8].po \

c-api/ \

distutils/ \

install/ \

library/2to3.po \

library/distutils.po \

library/imp.po \

library/tkinter.tix.po \

library/test.po \

library/aifc.po \

library/asynchat.po \

library/asyncore.po \

library/audioop.po \

library/cgi.po \

library/cgitb.po \

library/chunk.po \

library/crypt.po \

library/imghdr.po \

library/msilib.po \

library/nntplib.po \

library/nis.po \

library/ossaudiodev.po \

library/pipes.po \

library/smtpd.po \

library/sndhdr.po \

library/spwd.po \

library/sunau.po \

library/telnetlib.po \

library/uu.po \

library/xdrlib.po

UPSTREAM := https://github.com/python/cpython

PYTHON := $(shell which python3)

MODE := html

POSPELL_TMP_DIR := .pospell/

JOBS := auto

SPHINXERRORHANDLING = -W

ifeq '$(findstring ;,$(PATH))' ';'

detected_OS := Windows

detected_OS := $(shell uname 2>/dev/null || echo Unknown)

detected_OS := $(patsubst CYGWIN%,Cygwin,$(detected_OS))

detected_OS := $(patsubst MSYS%,MSYS,$(detected_OS))

detected_OS := $(patsubst MINGW%,MSYS,$(detected_OS))

ifeq ($(detected_OS),Darwin) # Mac OS X

CP_CMD := gcp # accessible with `brew install coreutils` or `brew upgrade coreutils`

else

CP_CMD := cp

.PHONY: all

all: ensure_build_prerequisites

git -C venv/cpython checkout $(CPYTHON_CURRENT_COMMIT) || (git -C venv/cpython fetch && git -C venv/cpython checkout $(CPYTHON_CURRENT_COMMIT))

mkdir -p locales/$(LANGUAGE)/LC_MESSAGES/

$(CP_CMD) -u --parents *.po */*.po locales/$(LANGUAGE)/LC_MESSAGES/

$(MAKE) -C venv/cpython/Doc/ \

JOBS='$(JOBS)' \

SPHINXOPTS='-D locale_dirs=$(abspath locales) \

-D language=$(LANGUAGE) \

-D gettext_compact=0 \

-D latex_engine=xelatex \

-D latex_elements.inputenc= \

-D latex_elements.fontenc=' \

SPHINXERRORHANDLING=$(SPHINXERRORHANDLING) \

$(MODE)

@echo "Build success, open file://$(abspath venv/cpython/)/Doc/build/html/index.html or run 'make htmlview' to see them."

venv/cpython/.git/HEAD:

git clone https://github.com/python/cpython venv/cpython

.PHONY: ensure_test_prerequisites

ensure_test_prerequisites:

@if ! (hunspell -v >/dev/null 2>&1); then \

echo "You're missing dependencies please install: hunspell and the fr-toutesvariantes dictionary."; \

echo "The dictionary is available here http://grammalecte.net:8080/dir?ci=tip&name=gc_lang/fr/oxt/Dictionnaires/dictionaries"; \

echo "and also included in the hunspell-fr-comprehensive Debian package."; \

exit 1; \

fi

@if ! (pospell --help >/dev/null 2>&1 && potodo --help >/dev/null 2>&1); then \

echo "You're missing dependencies please install:"; \

echo ""; \

echo " python -m pip install -r requirements.txt"; \

exit 1; \

fi

.PHONY: ensure_build_prerequisites

ensure_build_prerequisites: venv/cpython/.git/HEAD

@if ! (blurb help >/dev/null 2>&1 && sphinx-build --version >/dev/null 2>&1); then \

git -C venv/cpython/ checkout $(BRANCH); \

echo "You're missing dependencies please install:"; \

echo ""; \

echo " python -m pip install -r venv/cpython/Doc/requirements.txt"; \

exit 1; \

fi

.PHONY: htmlview

htmlview: MODE=htmlview

htmlview: all

.PHONY: todo

todo: ensure_test_prerequisites

potodo --api-url 'https://git.afpy.org/api/v1/repos/AFPy/python-docs-fr/issues?state=open&type=issues' --exclude venv .venv $(EXCLUDED)

.PHONY: wrap

wrap: ensure_test_prerequisites

@echo "Re wrapping modified files"

powrap -m

SRCS = $(shell git diff --name-only --diff-filter=d $(BRANCH) | grep '.po$$')

DESTS = $(addprefix $(POSPELL_TMP_DIR)/,$(addsuffix .out,$(SRCS)))

.PHONY: spell

spell: ensure_test_prerequisites $(DESTS)

.PHONY: line-length

line-length:

@echo Checking line length...

@if [ -n "$(SRCS)" ]; then python .scripts/line-length.py $(SRCS); fi

.PHONY: sphinx-lint

sphinx-lint: ensure_test_prerequisites

@echo Checking reStructuredText syntax...

@if [ -n "$(SRCS)" ]; then sphinx-lint --enable all --disable line-too-long $(SRCS); fi

$(POSPELL_TMP_DIR)/%.po.out: %.po dict

@echo "Pospell checking $<..."

@mkdir -p $(@D)

pospell -p dict -l fr_FR $< && touch $@

.PHONY: fuzzy

fuzzy: ensure_test_prerequisites

potodo --only-fuzzy --api-url 'https://git.afpy.org/api/v1/repos/AFPy/python-docs-fr/issues?state=open&type=issues' --exclude venv .venv $(EXCLUDED)

.PHONY: check-headers

check-headers:

@echo Checking po headers...

@sh .scripts/check-headers.sh $(SRCS)

.PHONY: syntax

syntax:

@msgcat *.po */*.po > /dev/null

.PHONY: verifs

verifs: spell syntax line-length check-headers sphinx-lint

.PHONY: clean

clean:

@echo "Cleaning *.mo and $(POSPELL_TMP_DIR)"

rm -fr $(POSPELL_TMP_DIR) locales/$(LANGUAGE)/LC_MESSAGES/

find -name '*.mo' -delete

@echo "Cleaning build directory"

$(MAKE) -C venv/cpython/Doc/ clean

.PHONY: diff

diff:

@echo "Files changed between $(BRANCH) and HEAD:"

@echo $(shell git diff --name-only --diff-filter=d $(BRANCH))

print-%:

@echo $($*)