FreeCAD / src /Mod /BIM /bimtests /TestArchBase.py

Upload folder using huggingface_hub

985c397 verified 9 months ago

5.14 kB

# SPDX-License-Identifier: LGPL-2.1-or-later

# ***************************************************************************
# *                                                                         *
# *   Copyright (c) 2025 Furgo                                              *
# *                                                                         *
# *   This file is part of FreeCAD.                                         *
# *                                                                         *
# *   FreeCAD is free software: you can redistribute it and/or modify it    *
# *   under the terms of the GNU Lesser General Public License as           *
# *   published by the Free Software Foundation, either version 2.1 of the  *
# *   License, or (at your option) any later version.                       *
# *                                                                         *
# *   FreeCAD is distributed in the hope that it will be useful, but        *
# *   WITHOUT ANY WARRANTY; without even the implied warranty of            *
# *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU      *
# *   Lesser General Public License for more details.                       *
# *                                                                         *
# *   You should have received a copy of the GNU Lesser General Public      *
# *   License along with FreeCAD. If not, see                               *
# *   <https://www.gnu.org/licenses/>.                                      *
# *                                                                         *
# ***************************************************************************

"""Defines the base class for Arch module unit tests."""

import unittest
import FreeCAD


class TestArchBase(unittest.TestCase):

    def setUp(self):
        """
        Set up a new, clean document for the test. Ensure test isolation by creating a
        uniquely-named document and cleaning up any potential leftovers from a previously failed
        run.
        """
        self.doc_name = self.__class__.__name__

        # Close any document of the same name that might have been left over from a crashed or
        # aborted test run. FreeCAD.getDocument() raises a NameError if the document is not found,
        # so we wrap this check in a try...except block.
        try:
            FreeCAD.getDocument(self.doc_name)
            # If getDocument() succeeds, the document exists and must be closed.
            FreeCAD.closeDocument(self.doc_name)
        except NameError:
            # This is the expected path on a clean run; do nothing.
            pass

        # Create a fresh document for the current test.
        self.document = FreeCAD.newDocument(self.doc_name)
        self.assertEqual(self.document.Name, self.doc_name)

    def tearDown(self):
        """Close the test document after all tests in the class are complete."""
        if hasattr(self, "document") and self.document:
            try:
                FreeCAD.closeDocument(self.document.Name)
            except Exception as e:
                FreeCAD.Console.PrintError(
                    f"Error during tearDown in {self.__class__.__name__}: {e}\n"
                )

    def printTestMessage(self, text, prepend_text="Test ", end="\n"):
        """Write messages to the console including the line ending.
        Messages will be prepended with "Test ", unless an empty string is
        passed as the prepend_text argument
        """
        FreeCAD.Console.PrintMessage(prepend_text + text + end)

    def assertDictContainsSubset(self, subset, main_dict):
        """Asserts that one dictionary's key-value pairs are contained within another.
        This method iterates through each key-value pair in the `subset`
        dictionary and verifies two conditions against the `main_dict`:
        1. The key exists in `main_dict`.
        2. The value associated with that key in `main_dict` is equal to the
           value in `subset`.
        Use Case:
        This assertion is more flexible than `assertDictEqual`. It is ideal for
        tests where a function or query returns a large dictionary of results,
        but the test's scope is only to validate a specific, known subset of
        those results. It allows the test to succeed even if `main_dict`
        contains extra, irrelevant keys, thus preventing test brittleness.
        Parameters
        ----------
        subset : dict
            The dictionary containing the expected key-value pairs that must
            be found.
        main_dict : dict
            The larger, actual dictionary returned by the code under test,
            which is checked for the presence of the subset.
        Example:
        >>> actual_results = {'Wall': 4, 'Structure': 2, 'Window': 1}
        >>> expected_subset = {'Wall': 4, 'Window': 1}
        >>> self.assertDictContainsSubset(expected_subset, actual_results)  # This will pass.
        """
        for key, value in subset.items():
            self.assertIn(key, main_dict)
            self.assertEqual(main_dict[key], value)

	# SPDX-License-Identifier: LGPL-2.1-or-later

	# ***************************************************************************
	# * *
	# * Copyright (c) 2025 Furgo *
	# * *
	# * This file is part of FreeCAD. *
	# * *
	# * FreeCAD is free software: you can redistribute it and/or modify it *
	# * under the terms of the GNU Lesser General Public License as *
	# * published by the Free Software Foundation, either version 2.1 of the *
	# * License, or (at your option) any later version. *
	# * *
	# * FreeCAD is distributed in the hope that it will be useful, but *
	# * WITHOUT ANY WARRANTY; without even the implied warranty of *
	# * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
	# * Lesser General Public License for more details. *
	# * *
	# * You should have received a copy of the GNU Lesser General Public *
	# * License along with FreeCAD. If not, see *
	# * <https://www.gnu.org/licenses/>. *
	# * *
	# ***************************************************************************

	"""Defines the base class for Arch module unit tests."""

	import unittest
	import FreeCAD


	class TestArchBase(unittest.TestCase):

	def setUp(self):
	"""
	Set up a new, clean document for the test. Ensure test isolation by creating a
	uniquely-named document and cleaning up any potential leftovers from a previously failed
	run.
	"""
	self.doc_name = self.__class__.__name__

	# Close any document of the same name that might have been left over from a crashed or
	# aborted test run. FreeCAD.getDocument() raises a NameError if the document is not found,
	# so we wrap this check in a try...except block.
	try:
	FreeCAD.getDocument(self.doc_name)
	# If getDocument() succeeds, the document exists and must be closed.
	FreeCAD.closeDocument(self.doc_name)
	except NameError:
	# This is the expected path on a clean run; do nothing.
	pass

	# Create a fresh document for the current test.
	self.document = FreeCAD.newDocument(self.doc_name)
	self.assertEqual(self.document.Name, self.doc_name)

	def tearDown(self):
	"""Close the test document after all tests in the class are complete."""
	if hasattr(self, "document") and self.document:
	try:
	FreeCAD.closeDocument(self.document.Name)
	except Exception as e:
	FreeCAD.Console.PrintError(
	f"Error during tearDown in {self.__class__.__name__}: {e}\n"
	)

	def printTestMessage(self, text, prepend_text="Test ", end="\n"):
	"""Write messages to the console including the line ending.

	Messages will be prepended with "Test ", unless an empty string is
	passed as the prepend_text argument
	"""
	FreeCAD.Console.PrintMessage(prepend_text + text + end)

	def assertDictContainsSubset(self, subset, main_dict):
	"""Asserts that one dictionary's key-value pairs are contained within another.

	This method iterates through each key-value pair in the `subset`
	dictionary and verifies two conditions against the `main_dict`:
	1. The key exists in `main_dict`.
	2. The value associated with that key in `main_dict` is equal to the
	value in `subset`.

	Use Case:
	This assertion is more flexible than `assertDictEqual`. It is ideal for
	tests where a function or query returns a large dictionary of results,
	but the test's scope is only to validate a specific, known subset of
	those results. It allows the test to succeed even if `main_dict`
	contains extra, irrelevant keys, thus preventing test brittleness.

	Parameters
	----------
	subset : dict
	The dictionary containing the expected key-value pairs that must
	be found.
	main_dict : dict
	The larger, actual dictionary returned by the code under test,
	which is checked for the presence of the subset.

	Example:
	>>> actual_results = {'Wall': 4, 'Structure': 2, 'Window': 1}
	>>> expected_subset = {'Wall': 4, 'Window': 1}
	>>> self.assertDictContainsSubset(expected_subset, actual_results) # This will pass.
	"""
	for key, value in subset.items():
	self.assertIn(key, main_dict)
	self.assertEqual(main_dict[key], value)