Difference between revisions of "Testing"
Renatorivo (talk | contribs) (languages it) |
(Marked this version for translation) |
||
(29 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
− | + | <languages/> | |
− | + | <translate> | |
+ | <!--T:20--> | ||
+ | {{docnav | ||
+ | |[[Debugging|Debugging]] | ||
+ | |[[Continuous Integration|Continuous Integration]] | ||
+ | }} | ||
− | + | </translate> | |
+ | [[Image:Workbench_Test.svg|64px]] | ||
+ | <translate> | ||
− | + | == Introduction == <!--T:2--> | |
+ | </translate> | ||
+ | {{TOCright}} | ||
+ | <translate> | ||
+ | |||
+ | <!--T:1--> | ||
+ | The [[Test Framework Workbench|Test Framework Workbench]] is not really a modelling workbench, but it contains a set of [[Python|Python]] scripts to perform different tests on the core components of FreeCAD, in order to debug problems. See also [[debugging|debugging]]. | ||
+ | |||
+ | <!--T:25--> | ||
+ | You can run the tests from the command line. | ||
+ | |||
+ | <!--T:26--> | ||
+ | Run all tests: | ||
+ | |||
+ | </translate> | ||
+ | {{Code|code= | ||
+ | freecad --run-test 0 | ||
+ | }} | ||
+ | <translate> | ||
+ | |||
+ | <!--T:27--> | ||
+ | Run only some the specified unit test, for example: | ||
+ | |||
+ | </translate> | ||
+ | {{Code|code= | ||
+ | freecad --run-test TestDraft | ||
+ | }} | ||
+ | <translate> | ||
+ | |||
+ | == Test menu == <!--T:29--> | ||
+ | |||
+ | <!--T:30--> | ||
+ | Each top level directory in FreeCAD should have a file with the tests that can be run for that particular workbench or module. The file usually starts with the word {{incode|Test}}. | ||
+ | |||
+ | <!--T:31--> | ||
+ | To run a test from within FreeCAD, switch to the Test Workbench, then {{MenuCommand|Test commands → TestToolsGui → Self test → Select test name}}, then enter the name of the Python file with the tests; for example, for the [[Draft Workbench|Draft Workbench]], this would be {{MenuCommand|TestDraft}}, then press {{Button|Start}}. | ||
+ | |||
+ | == Test functions == <!--T:19--> | ||
+ | This is the list of test apps as of 0.15 git 4207: | ||
+ | |||
+ | === TestAPP.All === <!--T:3--> | ||
+ | Add test function | ||
+ | |||
+ | === BaseTests === <!--T:5--> | ||
+ | Add test function | ||
+ | |||
+ | === UnitTests === <!--T:6--> | ||
+ | Add test function | ||
+ | |||
+ | === Document === <!--T:7--> | ||
+ | Add test function | ||
+ | |||
+ | === UnicodeTests === <!--T:8--> | ||
+ | Add test function | ||
+ | |||
+ | === MeshTestsApp === <!--T:9--> | ||
+ | Add test function | ||
+ | |||
+ | === TestDraft === <!--T:28--> | ||
+ | Add test function | ||
+ | |||
+ | === TestSketcherApp === <!--T:10--> | ||
+ | Add test function | ||
+ | |||
+ | === TestPartApp === <!--T:11--> | ||
+ | Add test function | ||
+ | |||
+ | === TestPartDesignApp === <!--T:12--> | ||
+ | Add test function | ||
+ | |||
+ | === Workbench === <!--T:13--> | ||
+ | Add test function | ||
+ | |||
+ | === Menu === <!--T:14--> | ||
+ | Add test function | ||
+ | |||
+ | === Menu.MenuDeleteCases === <!--T:15--> | ||
+ | Add test function | ||
+ | |||
+ | === Menu.MenuCreateCases === <!--T:16--> | ||
+ | Add test function | ||
+ | |||
+ | <!--T:17--> | ||
+ | {{docnav | ||
+ | |[[Debugging|Debugging]] | ||
+ | |[[Continuous Integration|Continuous Integration]] | ||
+ | }} | ||
+ | |||
+ | <!--T:21--> | ||
+ | {{Userdocnavi}} | ||
+ | |||
+ | <!--T:22--> | ||
[[Category:Developer Documentation]] | [[Category:Developer Documentation]] | ||
+ | |||
+ | <!--T:23--> | ||
+ | [[Category:Test Framework]] | ||
+ | |||
+ | <!--T:24--> | ||
+ | [[Category:Workbenches]] | ||
+ | [[Category:Testing]] | ||
+ | </translate> |
Revision as of 10:58, 29 October 2019
Introduction
The Test Framework Workbench is not really a modelling workbench, but it contains a set of Python scripts to perform different tests on the core components of FreeCAD, in order to debug problems. See also debugging.
You can run the tests from the command line.
Run all tests:
freecad --run-test 0
Run only some the specified unit test, for example:
freecad --run-test TestDraft
Each top level directory in FreeCAD should have a file with the tests that can be run for that particular workbench or module. The file usually starts with the word Test
.
To run a test from within FreeCAD, switch to the Test Workbench, then Test commands → TestToolsGui → Self test → Select test name, then enter the name of the Python file with the tests; for example, for the Draft Workbench, this would be TestDraft, then press Start.
Test functions
This is the list of test apps as of 0.15 git 4207:
TestAPP.All
Add test function
BaseTests
Add test function
UnitTests
Add test function
Document
Add test function
UnicodeTests
Add test function
MeshTestsApp
Add test function
TestDraft
Add test function
TestSketcherApp
Add test function
TestPartApp
Add test function
TestPartDesignApp
Add test function
Workbench
Add test function
Menu
Add test function
Menu.MenuDeleteCases
Add test function
Menu.MenuCreateCases
Add test function

- Installation: Linux/Unix, Windows, Mac; Getting started
- Basics: About FreeCAD, Workbenches, Preferences, Document structure, Interface Customization, Properties, Mouse Model; Tutorials
- Workbenches: Std Base; Arch, Draft, FEM, Image, Inspection, Mesh, OpenSCAD, Part, PartDesign, Path, Plot, Points, Raytracing, Reverse Engineering, Robot, Ship, Sketcher, Spreadsheet, Start, Surface workbench, TechDraw, Test Framework, Web
- Scripting: Introduction to Python, FreeCAD scripting tutorial, FreeCAD Scripting Basics, How to install macros, Gui Command, Units Modules: Builtin modules, Workbench creation, Installing more workbenches Meshes: Mesh Scripting, Mesh Module Parts: The Part Module, Topological data scripting, PythonOCC, Mesh to Part Coin scenegraph: The Coin/Inventor scenegraph, Pivy Qt interface: PySide, Using the FreeCAD GUI, Dialog creation Parametric objects: Scripted objects Other: Code snippets, Line drawing function, Embedding FreeCAD, FreeCAD vector math library, Power users hub, Python, Macros, FreeCAD Scripting Basics, Topological data scripting