ifctester - move build-ids-docs target to ifctester Makefile

Andrej730 · Andrej730 · commit bcf6f6197d6e · 2026-03-20T15:43:13.000+05:00
Also added a note why it lives in test folder and added it's output to gitignore.
diff --git a/.gitignore b/.gitignore
@@ -5,6 +5,8 @@
 /_installed-vs*-x*/
 /build/
 /src/examples/build/
+# ifctester docs output
+/src/ifctester/test/build/
 
 # output directories
 /cmake/out/
diff --git a/src/ifcopenshell-python/Makefile b/src/ifcopenshell-python/Makefile
@@ -79,10 +79,6 @@ test-parallel:
 test-mathutils:
 	pytest -p no:pytest-blender test/util/test_shape_builder.py
 
-.PHONY: build-ids-docs
-build-ids-docs:
-	mkdir -p test/build
-	cd test && python ids_doc_generator.py
 
 .PHONY: qa
 qa:
diff --git a/src/ifctester/Makefile b/src/ifctester/Makefile
@@ -96,3 +96,8 @@ webapp-prepare: webapp-build
 .PHONY: test
 test:
 	pytest -p no:pytest-blender test
+
+.PHONY: build-ids-docs
+build-ids-docs:
+	mkdir -p test/build
+	cd test && python ids_doc_generator.py
diff --git a/src/ifctester/test/ids_doc_generator.py b/src/ifctester/test/ids_doc_generator.py
@@ -16,6 +16,16 @@
 # You should have received a copy of the GNU Lesser General Public License
 # along with IfcTester.  If not, see <http://www.gnu.org/licenses/>.
 
+"""
+Documentation generator for IfcTester IDS facets and test cases.
+
+This is not a test file. It lives in the test/ directory because it reuses
+test cases from test_facet.py and test_ids.py to generate example IFC files,
+IDS files, and Markdown documentation into test/build/.
+
+Run via: make build-ids-docs (from src/ifctester/)
+"""
+
 import functools
 import os
 import re
