FAQ

The place to search and report BUGS is at http://sourceforge.net/tracker/?group_id=85796&atid=577329

When reporting a bug, the following information must be given:

- System (e.g windows XP)
- Eclipse version (e.g. 3.5)
- Pydev version (e.g. 1.5.1)
- Pydev error log (if any): go to window > show view > other > PDE Runtime > Error log. (if you have the SDK installed, otherwise, you have to find the log file at your_workspace/.metadata/.log)
- Eclipse install location (e.g. D:\eclipse_3\352\eclipse)
- Project location where the bug appears (e.g. D:\eclipse\workspace\my project)
- What were you doing when the bug appeared

IMPORTANT: If you're having a bug where there's a halting condition, it's important to give the information on the available threads when that happens and whether there's actually a deadlock.

To get that info, start eclipse with the java executable (not javaw) and add the -Dcom.sun.management.jmxremote flag to vmargs (note that the sun java 1.6 should be used).

E.g.: d:\bin\eclipse_350\eclipse.exe -vm D:\bin\jdk_1_6_11\bin\java.exe -vmargs -Dcom.sun.management.jmxremote

Now, open up jconsole (e.g.: d:\bin\jdk_1_6_11\bin\jconsole.exe) and press 'detect deadlock' -- if a deadlock is found, paste the info on the deadlocked threads and that should be enough.

If no deadlock is found, the bug should have the info on all the threads running attached to it (below are instructions on how to get that info -- as it's too troublesome to pass every thread in jconsole copying it).

If you're on windows, press Ctrl+Break to get a list of all the running threads (which should be attached to the bug). Note that you may have to increase the buffer of the console to get all info (so, in the console open the properties menu -- Alt+Space -- select the 'properties' and in 'screen buffer size: height' raise it to something as 9999 -- and only then press Ctrl+Break)

On Linux (and other unix variants) that info is gotten with kill pid --QUIT

NOTE: the Users Forum may be used for some doubts, but if you have a bug, that's not the place to go (even though, it might be useful searching it to see if what you have is not really a bug or if someone has already asked about it).

Return to top

How do I Report a Feature Request?

Do it here (feature tracker at sourceforge)

Return to top

I have some doubt I couldn't find in the FAQ, what do I do?

You can check the Users Forum for some doubts, but please, try to find what you're looking for in the homepage first.

Return to top

Can I have Eclipse installed anywhere to use Pydev?

Yes (note that some previous versions had a bug in which it didn't work if the Eclipse installation had spaces in the path).

Return to top

How do I get started with Pydev?

Check the getting started manual at: http://pydev.org/manual_101_root.html

Also, there are some videos available at: http://www.youtube.com/user/pydev which may help you in getting started.

Return to top

How do I configure my PYTHONPATH?

Please refer to the Getting Started Guide at http://pydev.org/manual_101_root.html for up-to-date information on how to correctly install and configure your PYTHONPATH.

Return to top

When I do a code-completion, Pydev hangs, what can I do?

Pydev does most of its things in the java side, but some information can only be gotten from the python side (mainly builtins), so, in order to get that info, pydev creates a shell and communicates with it through sockets.

The main problems when that happens are:

1. There's a firewall blocking the communication to the shell

2. In Linux, some kernels do not allow ipv4 utilization, which may make Pydev fail.

To enable it, do: echo 0 > /proc/sys/net/ipv6/bindv6only

3. The timeout to connect is too smal.

It depends upon the "Timeout to connect to shell" in the code-completion preferences (window > preferences > Pydev > Code completion)

If nothing works, please report a bug (also, check if there is anything on the error log (window > show view > PDE Runtime > Error log) and on the eclipse '.log', which is located at the .metadata folder of the workspace location.

Return to top

Why raw_input() / input() does not work correctly in pydev?

The eclipse console is not an exact copy of a shell... one of the changes is that when you press <ENTER> in a shell, it may give you a \r, \n or \r\n as an end-line char, depending on your platform. Python does not expect this -- from the docs it says that it will remove the last \n (checked in version 2.4), but, in some platforms that will leave a \r there. This means that the raw_input() should usually be used as raw_input().replace('\r', ''), and input() should be changed for: eval(raw_input().replace('\r', '')).

Return to top

My todo-tasks are not showing, is there something wrong?

Check the tasks page for info on tasks.

Return to top

Some keybindings Ctrl+[0-9] don't work under Ubuntu. What can I do about it?

That's a known bug in Eclipse. You can see more details on and vote for it if you want it fixed at: https://bugs.eclipse.org/bugs/show_bug.cgi?id=179628

And details at the pydev bugtracker: https://sourceforge.net/tracker/index.php?func=detail&aid=1595998&group_id=85796&atid=577329

Basically, Ctrl+[0-9] does not work if a Ctrl+Shift+[0-9] is also set.

The proposed workaround until this is fixed is using Ctrl+/ and Ctrl+\ for comment/uncomment -- which are set by default, and changing Ctrl+Shift+4 to Ctrl+6 -- or removing it altogether if you don't use it.

Return to top

Variables view doesn't show letters in GNU/Linux (while debugging)

Aparently, this bug is related only to GNOME (and no fix is provided for it).

The good news is there is a work around. In gnome font prefs, set your DPI to less that 76. it works on the fly.

This bug is closed in the pydev bugtracker, but the bug was added on other places such as gnome and eclipse. The pydev bug that points to those (and where this thread took place is HERE )

Return to top

I have a library installed and Pydev does not find it

Well, problems have been reported on Mac and Linux, and the main reason seems to be symlinks. Pydev will only find extensions that are 'really' below the python install directory. This happens because the 'less common denominator', which in this case is windows, does not have symlinks. A workaround to this problem includes manually adding the given folder installation to the pythonpath or changing the installation of the package to be under the site-packages folder.

Return to top

What is that 'Forced builtin libs' in the Python Interpreters preferences?

Well, some libraries once installed do not really show in code completion because they do not have a corresponding module (such as __builtin__ and datetime) or they do have a corresponding module but it cannot be really used in code completion because most of its information is only gotten at runtime (such as sys and os), so, in order for code completion to get its information, you have to manually add it to those libs (and by doing so, its information is gotten with a python shell).

Return to top

How do I configure a python shell for experimenting with Python?

Pydev has an interactive console you can use. See: manual_adv_interactive_console.html

Return to top

The Pydev builder is taking too much of my time, what can I do about it?

Well, if you have PyLint active, you can disable it, as it is the process that takes most time when building.
Another alternative is disabling the builder altogether. To do it you can go to window > preferences > pydev > builder and disable it.
NOTE: Disabling the builders may have many side-effects, such as code completion not working, pylint, tasks, etc. So, if you really want it, you can disable it, but do it with care.

Return to top

Why the Pydev properties do not show?

Probably you are in the JAVA package explorer or something similar. You have to use the default navigator so that it shows its properties.
Also note that you have to open a python file with Pydev in the project before it appears in the properties too (the project python nature appears only after you do that).

Return to top

Why nothing shows in the Pydev Package Explorer?

Usually this means that you have some misconfiguration in the Pydev Package Explorer working set selection or filters.

Note: you can access the Pydev Package Explorer menu, with ctrl+F10 or by clicking in in the triangle that's upside down in the Pydev Package Explorer.

The usual checks are:

1. In the Pydev Package Explorer menu, the top level elements is pointing to working sets?

If you don't have a working set and selected to show working sets, no elements are shown.

If no elements are contained, in your working set, no elements will be shown.

2. In the Pydev Package Explorer menu, customize view, the content has both, Pydev Navigator Content and Resources checked?

3. In the Pydev Package Explorer menu, customize view, is it possible that the filters selected are hiding all your elements?

If all of these are correct, please ask in the users forum, as it could be a bug (please check your error log and if there's something there, add it to your post -- see: How do I Report a Bug? for details on getting the error log)

Return to top

I can see no new Python project, how am I supposed to use Pydev?

UPDATE: As of version 0.9.8.6, a new 'Pydev Project' was introduced, so, you can already use the 'new Pydev project' (but the way described below will still work).

Well, you basically have to do a simple project and use create simple file / folder to create python modules.

You may also have to associate the *.py with the Pydev editor (even though that is probably automatic).
Anyway, if you need it, go to window > preferences > workbench > file associations and associate *.py with Pydev.

p.s. Don't forget to put it into both of your PYTHONPATHs (enviroment and in the project properties).

Return to top

How do I run a module from within eclipse using Pydev (either Python or Jython)?

To do that, the easiest way is going to the Run menu (Run > Run As > Python or Jython). If it is not available in your current eclipse perspective, you can enable it by going to window > customize perspective > commands and checking the "Lauch" item (in this way, you can go only with the keyboard).

Another way to run a module is right clicking the module in the navigator and choosing python > run (when a .py file is selected).

Return to top

How do I know which is the command-line and PYTHONPATH used to make a python or jython run?

If you are in doubt what is actually being passed to the run, you can go to the run menu (Run > Run...) and on the given run (python or jython), click on 'See resulting command-line for the given parameters' and check the command-line, as well as the PYTHONPATH that will be used for the run.

Return to top

Code completion is not working correctly for some library

Well, code completion works by default by analyzing the source code, but, sometimes, most information is only really available at runtime (the os module and wxPython are good examples here). So, you can specify that you want to treat those as builtin libraries. For that, go to the python interpreters and add it as a 'forced builtin lib'. More information may be found at the faq:

'What is that 'Forced builtin libs' in the Python Interpreters preferences?'

Return to top

I can't make builtins.xxx = something while debugging

The problem is that pydev passes a dict as the __builtins__ module to execfile while debugging (so, regular attribute access is not available on that object).

Simply use:
import __builtin__
__builtin__.xxx = something

It's basically the same thing, but works when debugging.

Return to top

PyLint is not working, what should I do?

1. make sure that PyLint is correctly installed in your site-packages (try running it at least once on a command-line to make sure your installation is correct).

2. Check if your project and your pythonpath are correctly configured -- pylint is only passed in files in the pythonpath for a project, so if any of those are not well configured, pylint won't work correctly.

3. If your installation is all ok, try reading the Pylint provided page to see if it is corretly configured in the eclipse side.

4. If everything fails, you can ask in the forum or submit a bug report for it (don't forget to add the following information: pylint installation path, pylint version and the other information requested on the 'How do I Report a BUG?' faq.

Return to top

I have a CORBA program and I cannot debug its methods, what can I do?

Thanks for Petru Lauric for the following explanation:

The ORB I use (omniORB) creates its own worker threads inside the python world, whenever a python function is called via CORBA. These threads are not created by using the 'threading' module so the pydev debugger's trace function is not automatically set for the ORB worker threads.

The solution is to explicitly set the trace function for the ORB threads.

1) Open folder [eclipse sdk path]\plugins\org.python.pydev.debug_0.9.8.4\pysrc(or similar)

2) Remove file pydevd.pyc, make a backup copy of file pydevd.py and make this change to the PyDB::run() method from file pydevd.py:

...
if globals is None:
...
globals = m.__dict__

#
# Hack: keep a reference to the pydev debugger's
# trace function in a global variable. This can
# be used by the debugged script to set up the
# trace function for the ORB worker threads.
#
globals['pydev_hook'] = self.trace_dispatch

#
...

3) Make changes similar to those below to your python app.

Note 1: the "pydev_hook" global variable will *only* exist in the global namespace of the "main" module of your app (the script launched by pydev when you debug your app). Feel free to pass it as an argument to functions from other modules, if that's where you need to use it.

Note 2: the trace function for the ORB worker threads MUST be set before the ORB creates the first worker thread.

a) import this undocumented ORB function
from omniORB import addWThreadHook
b)add this function

def dbg_trace(flag=0, wt=None):
"""This function is called whenever the ORB creates a worker thread (i.e. when a client calls a CORBA interface of the engine). The ORB worker threads are not created with the functions from the 'threading' module so, if we want to debug them with pydev, we need to "manually" set the trace function for them."""
if flag == 0: # WTHREAD_CREATED
sys.settrace(pydev_trace_func)

c) finally, make these changes

try:
# check if pydev_hook is defined
hook = pydev_hook
except:
hook = None
if hook is not None:
# keep a copy of the pydev_hook in a global
# variable, so that dbg_trace() can find it later
# on
global pydev_trace_func
pydev_trace_func = pydev_hook

# NOTE: the ORB will call dbg_trace each time it
# creates a worker thread. The function below
# MUST be used *before* the ORB creates the first
# worker thread.
addWThreadHook(dbg_trace)

I hope this helps.

Regards,
Petru Lauric

Return to top

OK, I know that many features are available, but I just don't know how can I access them through my keyboard!!

Please refer to: http://pydev.org/manual_adv_keybindings.html for up-to-date info on the most useful keybindings provided by Pydev and Eclipse.

Return to top

How do I uninstall Pydev

To uninstall you should either go on and remove the org.python.pydev* from eclipse/plugins and eclipse/features or you can go to help > software updates > manage configuration, choose the Pydev plugin and disable it (after that, to completely remove it, you must restart Eclipse and only then select it for uninstall). Note that this process is the same for any Eclipse plugin.

Return to top

How do I Report a BUG?

How do I Report a Feature Request?

I have some doubt I couldn't find in the FAQ, what do I do?

Can I have Eclipse installed anywhere to use Pydev?

How do I get started with Pydev?

How do I configure my PYTHONPATH?

When I do a code-completion, Pydev hangs, what can I do?

Why raw_input() / input() does not work correctly in pydev?

My todo-tasks are not showing, is there something wrong?

Some keybindings Ctrl+[0-9] don't work under Ubuntu. What can I do about it?

Variables view doesn't show letters in GNU/Linux (while debugging)

I have a library installed and Pydev does not find it

What is that 'Forced builtin libs' in the Python Interpreters preferences?

How do I configure a python shell for experimenting with Python?

The Pydev builder is taking too much of my time, what can I do about it?

Why the Pydev properties do not show?

Why nothing shows in the Pydev Package Explorer?

I can see no new Python project, how am I supposed to use Pydev?

How do I run a module from within eclipse using Pydev (either Python or Jython)?

How do I know which is the command-line and PYTHONPATH used to make a python or jython run?

Code completion is not working correctly for some library

I can't make __builtins__.xxx = something while debugging

PyLint is not working, what should I do?

I have a CORBA program and I cannot debug its methods, what can I do?

OK, I know that many features are available, but I just don't know how can I access them through my keyboard!!

How do I uninstall Pydev

I can't make builtins.xxx = something while debugging