chore: watch docs and template

huxuan · huxuan · commit 7ed6c0ae5a46 · 2024-07-10T09:58:09.000+08:00
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -69,7 +69,7 @@ jobs:
           git config --global user.name github-actions
           git config --global user.email github-actions@github.com
       - run: pipx install copier==9.3.1
-      - run: make consistency
+      - run: make template-build
       - run: git diff
       - run: git status --porcelain
       - run: test -z "$(git status --porcelain)"
diff --git a/.gitlab/workflows/ci.yml b/.gitlab/workflows/ci.yml
@@ -39,7 +39,7 @@ consistency:
     - git config --global user.name gitlab-ci
     - git config --global user.email gitlab-ci@gitlab.com
     - pipx install copier==9.3.1
-    - make consistency
+    - make template-build
     - git diff
     - git status --porcelain
     - test -z "$(git status --porcelain)"
diff --git a/Makefile b/Makefile
@@ -1,4 +1,4 @@
-.PHONY: clean deepclean install dev prerequisites mypy ruff ruff-format pyproject-fmt codespell lint pre-commit test-run test build publish doc-autobuild doc-build doc-coverage doc consistency
+.PHONY: clean deepclean install dev prerequisites mypy ruff ruff-format pyproject-fmt codespell lint pre-commit test-run test build publish doc-watch doc-build doc-coverage doc template-watch template-build
 
 ########################################################################################
 # Variables
@@ -65,6 +65,7 @@ else
 endif
 	pipx install --force pyproject-fmt==2.1.4
 	pipx install --force ruff==0.5.1
+	pipx install --force watchfiles==0.22.0
 
 ########################################################################################
 # Lint and pre-commit
@@ -128,15 +129,13 @@ publish:
 ########################################################################################
 
 # Generate documentation with auto build when changes happen.
-doc-autobuild:
-	pdm run python -m sphinx_autobuild docs $(PUBLIC_DIR) \
-		--watch README.md \
-		--watch src \
-		-a
+doc-watch:
+	pdm run python -m http.server --directory public &
+	watchfiles "make doc-build" docs src README.md
 
 # Build documentation only from src.
 doc-build:
-	pdm run python -m sphinx.cmd.build docs $(PUBLIC_DIR)
+	pdm run sphinx-build -a docs $(PUBLIC_DIR)
 
 # Generate html coverage reports with badge.
 doc-coverage: test-run
@@ -150,7 +149,10 @@ doc: doc-build mypy doc-coverage
 # Template
 ########################################################################################
 
-consistency:
+template-watch:
+	watchfiles "make template-build" template includes copier.yaml
+
+template-build:
 	find . -maxdepth 1 | grep -vE '(\.|\.git|template|includes|copier\.yaml|pdm\.lock)$$' | xargs -I {} rm -r {}
 	copier copy -r HEAD --data-file includes/copier-answers-sample.yml --data repo_platform=gitlab -f . .
 	rm -rf .copier-answers.yml
diff --git a/pdm.lock b/pdm.lock
diff --git a/pyproject.toml b/pyproject.toml
@@ -55,7 +55,6 @@ doc = [
     "mypy[reports]",
     "myst-parser",
     "pytest",
-    "sphinx-autobuild",
     "sphinx-click",
     "sphinx-design",
 ]
diff --git a/template/Makefile.jinja b/template/Makefile.jinja
@@ -1,6 +1,6 @@
 [% from pathjoin("includes", "variable.jinja") import page_url with context -%]
-.PHONY: clean deepclean install dev prerequisites mypy ruff ruff-format pyproject-fmt codespell lint pre-commit test-run test build publish doc-autobuild doc-build doc-coverage doc
-[%- if project_name == "Serious Scaffold Python" %] consistency[% endif %]
+.PHONY: clean deepclean install dev prerequisites mypy ruff ruff-format pyproject-fmt codespell lint pre-commit test-run test build publish doc-watch doc-build doc-coverage doc
+[%- if project_name == "Serious Scaffold Python" %] template-watch template-build[% endif %]
 
 ########################################################################################
 # Variables
@@ -67,6 +67,7 @@ else
 endif
 	pipx install --force pyproject-fmt==2.1.4
 	pipx install --force ruff==0.5.1
+	pipx install --force watchfiles==0.22.0
 
 ########################################################################################
 # Lint and pre-commit
@@ -130,15 +131,13 @@ publish:
 ########################################################################################
 
 # Generate documentation with auto build when changes happen.
-doc-autobuild:
-	pdm run python -m sphinx_autobuild docs $(PUBLIC_DIR) \
-		--watch README.md \
-		--watch src \
-		-a
+doc-watch:
+	pdm run python -m http.server --directory public &
+	watchfiles "make doc-build" docs src README.md
 
 # Build documentation only from src.
 doc-build:
-	pdm run python -m sphinx.cmd.build docs $(PUBLIC_DIR)
+	pdm run sphinx-build -a docs $(PUBLIC_DIR)
 
 # Generate html coverage reports with badge.
 doc-coverage: test-run
@@ -153,7 +152,10 @@ doc: doc-build mypy doc-coverage
 # Template
 ########################################################################################
 
-consistency:
+template-watch:
+	watchfiles "make template-build" template includes copier.yaml
+
+template-build:
 	find . -maxdepth 1 | grep -vE '(\.|\.git|template|includes|copier\.yaml|pdm\.lock)$$' | xargs -I {} rm -r {}
 	copier copy -r HEAD --data-file includes/copier-answers-sample.yml --data repo_platform=gitlab -f . .
 	rm -rf .copier-answers.yml
diff --git a/template/[% if repo_platform == 'github' %].github[% endif %]/workflows/ci.yml.jinja b/template/[% if repo_platform == 'github' %].github[% endif %]/workflows/ci.yml.jinja
@@ -97,7 +97,7 @@ jobs:
           git config --global user.name github-actions
           git config --global user.email github-actions@github.com
       - run: pipx install copier==9.3.1
-      - run: make consistency
+      - run: make template-build
       - run: git diff
       - run: git status --porcelain
       - run: test -z "$(git status --porcelain)"
diff --git a/template/[% if repo_platform == 'gitlab' or repo_platform == 'gitlab-self-managed' %].gitlab[% endif %]/workflows/ci.yml.jinja b/template/[% if repo_platform == 'gitlab' or repo_platform == 'gitlab-self-managed' %].gitlab[% endif %]/workflows/ci.yml.jinja
@@ -51,7 +51,7 @@ consistency:
     - git config --global user.name gitlab-ci
     - git config --global user.email gitlab-ci@gitlab.com
     - pipx install copier==9.3.1
-    - make consistency
+    - make template-build
     - git diff
     - git status --porcelain
     - test -z "$(git status --porcelain)"
diff --git a/template/pyproject.toml.jinja b/template/pyproject.toml.jinja
@@ -94,7 +94,6 @@ doc = [
     "mypy[reports]",
     "myst-parser",
     "pytest",
-    "sphinx-autobuild",
     "sphinx-click",
     "sphinx-design",
 ]

Original file line number	Diff line number	Diff line change
`@@ -55,7 +55,6 @@ doc = [`
`55`	`55`	`"mypy[reports]",`
`56`	`56`	`"myst-parser",`
`57`	`57`	`"pytest",`
`58`		`- "sphinx-autobuild",`
`59`	`58`	`"sphinx-click",`
`60`	`59`	`"sphinx-design",`
`61`	`60`	`]`
Original file line number	Diff line number	Diff line change
`@@ -94,7 +94,6 @@ doc = [`
`94`	`94`	`"mypy[reports]",`
`95`	`95`	`"myst-parser",`
`96`	`96`	`"pytest",`
`97`		`- "sphinx-autobuild",`
`98`	`97`	`"sphinx-click",`
`99`	`98`	`"sphinx-design",`
`100`	`99`	`]`