Testing/de: Difference between revisions

From FreeCAD Documentation
(Created page with "* [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 bestimmte...")
No edit summary
 
(9 intermediate revisions by 3 users not shown)
Line 10: Line 10:
{{TOCright}}
{{TOCright}}


<span id="Introduction"></span>
== Einführung ==
== Einführung ==


Die [[Test Framework Workbench/de|Erprobung]] ist nicht wirklich eine Modellierungsarbeitsbereich, aber sie enthält einen Satz von [[Python/de|Python]] Skripten, um verschiedene Tests an den Kernkomponenten von FreeCAD durchzuführen, um Probleme zu beheben. Siehe auch [[Debugging/de|Fehlerdiagnose]].
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/de|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/de|TestEntwurf}}, dann drücke {{Button|Start}}.
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ü ===


Line 121: Line 136:
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===


Line 143: Line 184:
}}
}}


<span id="Additional_Resources"></span>
== Zusätzliche Quellen ==
== Zusätzliche Quellen ==


<span id="Forum_Topics"></span>
===Forum-Themen===
===Forum-Themen===



Latest revision as of 10:47, 23 April 2024

Erprobung Arbeitsbereichssymbol

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