Debugging in FreeCAD - Revision history

Ruslan at 17:55, 10 November 2018

2018-11-10T17:55:59Z

← Older revision		Revision as of 17:55, 10 November 2018
Line 56:		Line 56:

	= Comments =		= Comments =
	Thank you to user Kunda1 from FreeCAD forum for the instructions how to fix debugger ~~crash~~.		Thank you to user Kunda1 from [https://forum.freecadweb.org/viewtopic.php?f=8&t=32093 FreeCAD forum] for the instructions how to fix debugger.

Ruslan at 17:54, 10 November 2018

2018-11-10T17:54:29Z

← Older revision		Revision as of 17:54, 10 November 2018
Line 54:		Line 54:

	# When you finish debugging, detach the debugger: Go to menu ''File''->''Detach''.		# When you finish debugging, detach the debugger: Go to menu ''File''->''Detach''.

			= Comments =
			Thank you to user Kunda1 from FreeCAD forum for the instructions how to fix debugger crash.

Ruslan: /* Check system stability */

2018-11-10T17:52:12Z

Check system stability

← Older revision		Revision as of 17:52, 10 November 2018
Line 4:		Line 4:
	In some Linux systems the debugger will crash. The problem is caused by in expat library. This is happens for example on Ubuntu 18.04. To find out, if our system has this problem, run two python lines below. If Freecad crashes, we need to fix our system first.		In some Linux systems the debugger will crash. The problem is caused by in expat library. This is happens for example on Ubuntu 18.04. To find out, if our system has this problem, run two python lines below. If Freecad crashes, we need to fix our system first.

	# Launch ~~Freecad~~		# Launch FreeCAD
	# Normally, the python console is hidden. To show the console, go to Menu ''View''->''Panels''->''Python console''.		# Normally, the python console is hidden. To show the console, go to Menu ''View''->''Panels''->''Python console''.
	# Now ran these lines below		# Now ran these lines below

Ruslan: /* Install and the debugger */

2018-11-10T17:50:45Z

Install and the debugger

← Older revision		Revision as of 17:50, 10 November 2018
Line 21:		Line 21:

	=Install and the debugger=		=Install and the debugger=
	We need a python debugger ''~~winpdb~~''. If you did not installed before, install it with:		We need a python debugger ''Winpdb''. If you did not installed before, install it with:
	sudo apt-get install winpdb		sudo apt-get install winpdb

	Now lets setup the debugger.		Now lets setup the debugger.

	# Start ''~~winpdb~~''.		# Start ''Winpdb''.
	# Set the debugger password to "test": Go to menu ''File''->''Password" and set the password.		# Set the debugger password to "test": Go to menu ''File''->''Password" and set the password.

	Now we will run a test python script in FreeCAD step by step.		Now we will run a test python script in FreeCAD step by step.

	# ~~Open an [[File:debug-freecad-example.py]]~~ from [https://www.freecadweb.org/wiki/index.php?title=Debugging]		# Create a test script like from [https://www.freecadweb.org/wiki/index.php?title=Debugging]:

			<pre>
			import rpdb2
			rpdb2.start_embedded_debugger("test")
			import FreeCAD
			import Part
			import Draft
			print "hello"
			print "hello"
			import Draft
			points=[FreeCAD.Vector(-3.0,-1.0,0.0),FreeCAD.Vector(-2.0,0.0,0.0)]
			Draft.makeWire(points,closed=False,face=False,support=None)
			</pre>

			# Open this script in FreeCAD and run it. FreeCAD will freeze, because the script line
			rpdb2.start_embedded_debugger("test")
			waits until you attach the debugger.
			# Attach the debugger. In Winpdb go to menu ''File''->''Attach''. Winpdb will show you a window with your script or multiple script. Select your script and click ''OK''.

			Now you can execute the script line by line by clicking the "next"-Button from the Winpdb-Toolbar. Run all the lines. In the tab "Locals" you can see the values of the local variables.

			# When you finish debugging, detach the debugger: Go to menu ''File''->''Detach''.

Ruslan: /* Install and the debugger */

2018-11-10T17:37:36Z

Install and the debugger

← Older revision		Revision as of 17:37, 10 November 2018
Line 30:		Line 30:

	Now we will run a test python script in FreeCAD step by step.		Now we will run a test python script in FreeCAD step by step.

			# Open an [[File:debug-freecad-example.py]] from [https://www.freecadweb.org/wiki/index.php?title=Debugging]

Ruslan: Add instructions how to debug FreeCAD scripts

2018-11-10T17:34:44Z

Add instructions how to debug FreeCAD scripts

New page

How to setup a system to debug FreeCAD python scripts.

=Check system stability=
In some Linux systems the debugger will crash. The problem is caused by in expat library. This is happens for example on Ubuntu 18.04. To find out, if our system has this problem, run two python lines below. If Freecad crashes, we need to fix our system first.

# Launch Freecad
# Normally, the python console is hidden. To show the console, go to Menu ''View''->''Panels''->''Python console''.
# Now ran these lines below
from xml.dom import minidom
minidom.parseString("<test></test>")
If FreeCAD crashes you need to fix it. We follow the instructions on [https://forum.freecadweb.org/viewtopic.php?t=29913]. They suggest to downgrade the libexpat file:

For Ubuntu download Ubuntu 16.04 versions of libexpat1_2.1.0 from [https://pkgs.org/download/libexpat1]. These is usually
libexpat1_2.1.0-7ubuntu0.16.04.3_amd64.deb (or libexpat1_2.1.0-7ubuntu0.16.04.3_i386.deb for 32 bit system)

Than go to your Download directory and install it with

sudo dpkg -i libexpat1_2.1.0-7ubuntu0.16.04.3_amd64.deb

Try again. If freecad does not crash, the debugger will probably work.

=Install and the debugger=
We need a python debugger ''winpdb''. If you did not installed before, install it with:
sudo apt-get install winpdb

Now lets setup the debugger.

# Start ''winpdb''.
# Set the debugger password to "test": Go to menu ''File''->''Password" and set the password.

Now we will run a test python script in FreeCAD step by step.