Testing/de: Difference between revisions
No edit summary |
No edit summary |
||
(14 intermediate revisions by 4 users not shown) | |||
Line 10: | Line 10: | ||
{{TOCright}} |
{{TOCright}} |
||
<span id="Introduction"></span> |
|||
== Einführung == |
== Einführung == |
||
Der Arbeitsbereich [[Testing/de|Erprobung]] ist nicht wirklich ein Modellierungsarbeitsbereich, aber er enthält einen Satz von [[Python/de|Python]] Skripten, zum Durchzuführen verschiedener Tests an den Kernkomponenten von FreeCAD, um Probleme zu beheben. Siehe auch [[Debugging/de|Fehlerdiagnose]]. |
|||
Du kannst die Tests auf der Kommandozeile ausführen, indem du die Optionen {{incode|-t}} oder {{incode|--run-test}} verwendest. |
Du kannst die Tests auf der Kommandozeile ausführen, indem du die Optionen {{incode|-t}} oder {{incode|--run-test}} verwendest. |
||
Line 28: | Line 29: | ||
}} |
}} |
||
Wenn ein Test die Benutzerschnittstelle (GUI) nicht braucht, kann er auch im Konsolenmodus gestartet werden durch das zusätzliche Setzen der Option {{incode|-c}} oder {{incode|--console}}. Daraus resultiert eine erheblich kürzere Startzeit, da die GUI nicht geladen wird. Z.B.: |
|||
{{Code|code= |
|||
freecad -c -t TestPartDesignApp |
|||
}} |
|||
<span id="Test_menu"></span> |
|||
== Testmenü == |
== Testmenü == |
||
Jedes oberste Verzeichnis in FreeCAD sollte eine Datei mit den Tests haben, die für diesen speziellen Arbeitsbereich oder dieses Modul ausgeführt werden können. Die Datei beginnt normalerweise mit dem Wort {{incode|Test}}. |
Jedes oberste Verzeichnis in FreeCAD sollte eine Datei mit den Tests haben, die für diesen speziellen Arbeitsbereich oder dieses Modul ausgeführt werden können. Die Datei beginnt normalerweise mit dem Wort {{incode|Test}}. |
||
Um einen Test aus FreeCAD heraus auszuführen, wechsle in den Test Arbeitsbereich, dann {{MenuCommand |
Um einen Test aus FreeCAD heraus auszuführen, wechsle in den Test Arbeitsbereich, dann {{MenuCommand|Testbefehle → TestWerkzeugeGui → Selbsttest → Wähle Testbezeichnung}}, gib dann den Namen der Python Datei mit den Tests ein; z.B. für die [[Draft Workbench/de|Draft Arbeitsbereich]] wäre dies {{MenuCommand|TestEntwurf}}, dann drücke {{Button|Start}}. |
||
<span id="Test_functions"></span> |
|||
==Testfunktionen== |
==Testfunktionen== |
||
Line 42: | Line 51: | ||
Testfunktion hinzufügen |
Testfunktion hinzufügen |
||
<span id="BaseTests"></span> |
|||
=== Basistests === |
=== Basistests === |
||
Testfunktion hinzufügen |
Testfunktion hinzufügen |
||
<span id="UnitTests"></span> |
|||
=== EinheitTests === |
=== EinheitTests === |
||
Testfunktion hinzufügen |
Testfunktion hinzufügen |
||
<span id="Document"></span> |
|||
=== Dokument === |
=== Dokument === |
||
Line 78: | Line 90: | ||
Testfunktion hinzufügen |
Testfunktion hinzufügen |
||
<span id="TestCAMApp"></span> |
|||
=== TestPartApp === |
|||
===TestCAMApp=== |
|||
Path workbench test cases: |
Path workbench test cases: |
||
Line 103: | Line 116: | ||
* TestPathUtil: Test various functions available in the PathUtil module. |
* TestPathUtil: Test various functions available in the PathUtil module. |
||
* TestPathVcarve: Test general functionality of Vcarve operation. |
* TestPathVcarve: Test general functionality of Vcarve operation. |
||
* TestPathVoronoi: |
* TestPathVoronoi: |
||
<span id="Workbench"></span> |
|||
=== Arbeitsbereich === |
=== Arbeitsbereich === |
||
Testfunktion hinzufügen |
Testfunktion hinzufügen |
||
<span id="Menu"></span> |
|||
=== Menü === |
=== Menü === |
||
Testfunktion hinzufügen |
Testfunktion hinzufügen |
||
<div class="mw-translate-fuzzy"> |
|||
=== Menu.MenuDeleteCases === |
=== Menu.MenuDeleteCases === |
||
Testfunktion hinzufügen |
|||
</div> |
|||
Testfunktion hinzufügen |
Testfunktion hinzufügen |
||
<div class="mw-translate-fuzzy"> |
|||
=== Menu.MenuCreateCases === |
=== Menu.MenuCreateCases === |
||
Testfunktion hinzufügen |
|||
</div> |
|||
Testfunktion hinzufügen |
Testfunktion hinzufügen |
||
<span id="Scripting"></span> |
|||
==Skripten== |
==Skripten== |
||
{{Emphasis|Siehe auch:}} [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]]. |
{{Emphasis|Siehe auch:}} [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]]. |
||
===Get a list of all top-level test modules=== |
|||
{{Code|code= |
|||
FreeCAD.__unit_test__ |
|||
}} |
|||
Note that the test modules returned here depend on whether a GUI available or not. I.e. when executed in console mode, various tests ending in "Gui" are missing. |
|||
===Run specific tests=== |
|||
There are various ways of running tests using [https://docs.python.org/3/library/unittest.html Python's unittest library]. FreeCAD's test framework removes some of the boiler plate for the most common cases. |
|||
Run all tests defined in a Python module: |
|||
{{Code|code= |
|||
import Test, TestFemApp |
|||
Test.runTestsFromModule(TestFemApp) |
|||
}} |
|||
Run all tests defined in a Python class: |
|||
{{Code|code= |
|||
import Test, femtest.app.test_solver_calculix |
|||
Test.runTestsFromClass(femtest.app.test_solver_calculix.TestSolverCalculix) |
|||
}} |
|||
<span id="Example_1"></span> |
|||
===Beispiel 1=== |
===Beispiel 1=== |
||
Innerhalb der Python-Konsole von FreeCAD kann das folgende Code-Format benutzt werden, um eingebaute Tests auszuführen. Ersetze den roten "'''TestFem'''"-Text im folgenden Code mit dem gewünschten Namen des Testmoduls. |
|||
* |
* Benutze bspw. "'''TestPathApp'''", um alle Einheitentests für das Path-Arbeitsgebiet Einheitentest-Gerüst auszuführen. |
||
* Submodules are available using dot notation, like "'''TestPathApp.TestPathAdaptive'''" to only run the Adaptive unit tests within the greater Path workbench test framework. |
|||
* Untermodule sind über die Punktnotation verfügbar, wie "'''TestPathApp.TestPathAdaptive'''", um nur die adaptiven Einheitentestd innerhalb des größeren Path-Arbeitsgebiets-Test-Gerüsts auszuführen. |
|||
* Multiple test modules or submodules may be combined by adding another `'''suite.addTest(...)'''` method call just like the one in the code below, but with a different module or submodule reference. |
|||
* Mehrere Testmodule oder Untermodule können kombiniert werden durch hinzufügen eines weiteren `'''suite.addTest(...)'''`-Methoden-Aufrufs genau wie der im folgenden Code, aber mit einer anderen Modul- oder Untermodul-Referenz. |
|||
* Output for the code below will be in the Report View panel within the FreeCAD GUI. |
|||
* Die Ausgaben des folgenden Codes werden im Reportansichts-Paneel innerhalb der FreeCAD-GUI angezeigt. |
|||
* Code |
* Der Quell-Code wurde aus dem Beitrag des FreeCAD-Forum-Benutzers ''sgrogan'' kopiert, im [https://forum.freecadweb.org/viewtopic.php?style=3&p=153251#p153251 unit tests per python]-Thema, mit dortiger Nennung von Forum-Benutzer ''wmayer''. |
||
{{Code|code= |
{{Code|code= |
||
Line 148: | Line 184: | ||
}} |
}} |
||
<span id="Additional_Resources"></span> |
|||
== Zusätzliche Quellen == |
== Zusätzliche Quellen == |
||
<span id="Forum_Topics"></span> |
|||
===Forum |
===Forum-Themen=== |
||
* [https://forum.freecadweb.org/viewtopic.php?style=3&f=27&t=18379 Support for running specific unit tests with --run-test #331] |
* [https://forum.freecadweb.org/viewtopic.php?style=3&f=27&t=18379 Support for running specific unit tests with --run-test #331] (Unterstützung für die Ausführung bestimmter Einheitentests mit --run-test #331) |
||
Latest revision as of 10:47, 23 April 2024
Einführung
Der Arbeitsbereich Erprobung ist nicht wirklich ein Modellierungsarbeitsbereich, aber er enthält einen Satz von Python Skripten, zum Durchzuführen verschiedener Tests an den Kernkomponenten von FreeCAD, um Probleme zu beheben. Siehe auch Fehlerdiagnose.
Du kannst die Tests auf der Kommandozeile ausführen, indem du die Optionen -t
oder --run-test
verwendest.
Führe alle Tests durch:
freecad --run-test 0
Führe nur einen Teil des angegebenen Komponententests aus, z.B.:
freecad -t TestDraft
Wenn ein Test die Benutzerschnittstelle (GUI) nicht braucht, kann er auch im Konsolenmodus gestartet werden durch das zusätzliche Setzen der Option -c
oder --console
. Daraus resultiert eine erheblich kürzere Startzeit, da die GUI nicht geladen wird. Z.B.:
freecad -c -t TestPartDesignApp
Testmenü
Jedes oberste Verzeichnis in FreeCAD sollte eine Datei mit den Tests haben, die für diesen speziellen Arbeitsbereich oder dieses Modul ausgeführt werden können. Die Datei beginnt normalerweise mit dem Wort Test
.
Um einen Test aus FreeCAD heraus auszuführen, wechsle in den Test Arbeitsbereich, dann Testbefehle → TestWerkzeugeGui → Selbsttest → Wähle Testbezeichnung, gib dann den Namen der Python Datei mit den Tests ein; z.B. für die Draft Arbeitsbereich wäre dies TestEntwurf, dann drücke Start.
Testfunktionen
Dies ist die Liste der Testanwendungen ab 0.15 git 4207:
TestAPP.All
Testfunktion hinzufügen
Basistests
Testfunktion hinzufügen
EinheitTests
Testfunktion hinzufügen
Dokument
Testfunktion hinzufügen
UnicodeTests
Testfunktion hinzufügen
MeshTestsApp
Testfunktion hinzufügen
TestDraft
Testfunktion hinzufügen
TestSketcherApp
Testfunktion hinzufügen
TestPartApp
Testfunktion hinzufügen
TestPartDesignApp
Testfunktion hinzufügen
TestCAMApp
Path workbench test cases:
- depthTestCases:
- PathTestUtils:
- TestDressupDogbone: Test functionality of Dogbone dressup.
- TestHoldingTags: Test functionality of Holding Tags dressup.
- TestPathAdaptive: Test selection capability of Adaptive operation.
- TestPathCore: Test core functionality of Path workbench.
- TestPathDeburr: Test general functionality of Deburr operation.
- TestPathGeom: Test various functions available in the PathGeom module.
- TestPathHelix: Test general functionality of Helix operation.
- TestPathLog: Test various functions available in the PathLog debugging and feedback module.
- TestPathOpTools:
- TestPathPreferences: Test various functions available in the PathPreferences module.
- TestPathPropertyBag:
- TestPathSetupSheet:
- TestPathStock:
- TestPathThreadMilling:
- TestPathTool:
- TestPathToolBit:
- TestPathToolController:
- TestPathTooltable:
- TestPathUtil: Test various functions available in the PathUtil module.
- TestPathVcarve: Test general functionality of Vcarve operation.
- TestPathVoronoi:
Arbeitsbereich
Testfunktion hinzufügen
Menü
Testfunktion hinzufügen
Menu.MenuDeleteCases
Testfunktion hinzufügen
Menu.MenuCreateCases
Testfunktion hinzufügen
Skripten
Siehe auch: FreeCAD Grundlagen Skripten.
Get a list of all top-level test modules
FreeCAD.__unit_test__
Note that the test modules returned here depend on whether a GUI available or not. I.e. when executed in console mode, various tests ending in "Gui" are missing.
Run specific tests
There are various ways of running tests using Python's unittest library. FreeCAD's test framework removes some of the boiler plate for the most common cases.
Run all tests defined in a Python module:
import Test, TestFemApp
Test.runTestsFromModule(TestFemApp)
Run all tests defined in a Python class:
import Test, femtest.app.test_solver_calculix
Test.runTestsFromClass(femtest.app.test_solver_calculix.TestSolverCalculix)
Beispiel 1
Innerhalb der Python-Konsole von FreeCAD kann das folgende Code-Format benutzt werden, um eingebaute Tests auszuführen. Ersetze den roten "TestFem"-Text im folgenden Code mit dem gewünschten Namen des Testmoduls.
- Benutze bspw. "TestPathApp", um alle Einheitentests für das Path-Arbeitsgebiet Einheitentest-Gerüst auszuführen.
- Untermodule sind über die Punktnotation verfügbar, wie "TestPathApp.TestPathAdaptive", um nur die adaptiven Einheitentestd innerhalb des größeren Path-Arbeitsgebiets-Test-Gerüsts auszuführen.
- Mehrere Testmodule oder Untermodule können kombiniert werden durch hinzufügen eines weiteren `suite.addTest(...)`-Methoden-Aufrufs genau wie der im folgenden Code, aber mit einer anderen Modul- oder Untermodul-Referenz.
- Die Ausgaben des folgenden Codes werden im Reportansichts-Paneel innerhalb der FreeCAD-GUI angezeigt.
- Der Quell-Code wurde aus dem Beitrag des FreeCAD-Forum-Benutzers sgrogan kopiert, im unit tests per python-Thema, mit dortiger Nennung von Forum-Benutzer wmayer.
import unittest
suite = unittest.TestSuite()
suite.addTest(unittest.defaultTestLoader.loadTestsFromName("TestFem"))
r = unittest.TextTestRunner()
r.run(suite)
Zusätzliche Quellen
Forum-Themen
- Support for running specific unit tests with --run-test #331 (Unterstützung für die Ausführung bestimmter Einheitentests mit --run-test #331)
- Erste Schritte
- Installation: Herunterladen, Windows, Linux, Mac, Zusätzlicher Komponenten, Docker, AppImage, Ubuntu Snap
- Grundlagen: Über FreeCAD, Graphische Oberfläche, Mausbedienung, Auswahlmethoden, Objektname, Programmeinstellungen, Arbeitsbereiche, Dokumentstruktur, Objekteigenschaften, Hilf FreeCAD, Spende
- Hilfe: Tutorien, Video Tutorien
- Arbeitsbereiche: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework