How do I Report a BUG?

The place to search and report BUGS is at

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
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 flag to vmargs (note that the sun java 1.6 should be used).

For example: D:\bin\eclipse_350\eclipse.exe -vm D:\bin\jdk_1_6_11\bin\java.exe -vmargs

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 (in the console open the properties menu (Alt + Space), select the 'properties', and in 'screen buffer size: height' raise it to something as high as 9999, and then press Ctrl + Break).

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).

How do I Report a Feature Request?

Report a feature request to feature tracker at sourceforge.

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.

How do I get started with PyDev?

Check the getting started manual at: PyDev Getting Started

Also, there are some videos available at: which may help you in getting started.

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).

How do I import existing projects/sources into PyDev?

If the project was already in Eclipse (i.e.: has the .project and .pydevproject files), use File > Import > Existing Projects into Workspace.

If the project never had the .project nor .pydevproject files, there are 2 choices:

Option 1:

Go through the File > New > PyDev Project wizard and select as the directory the directory with your sources.

Option 2:

Create the .project and .pydevproject files from the template below and use File > Import > Existing Projects into Workspace to import it. Note that this option is more a reference for people that want to automate creating multiple projects at once.

The .project  file contents (must replace the MyProject with the project name):



The .pydevproject  file contents (must replace the path (/MyProject/src) with the actual folders to be in the PYTHONPATH):

<?eclipse-pydev version="1.0"?>
    <pydev_property name="org.python.pydev.PYTHON_PROJECT_INTERPRETER">Default</pydev_property>
    <pydev_property name="org.python.pydev.PYTHON_PROJECT_VERSION">python 2.7</pydev_property>
    <pydev_variables_property name="org.python.pydev.PROJECT_VARIABLE_SUBSTITUTION">
    <pydev_pathproperty name="org.python.pydev.PROJECT_SOURCE_PATH">

How do I import existing projects/sources for a Django project into PyDev?

Follow the same steps in the FAQ above to import a PyDev project, then right click the project > PyDev > Set as Django project and add 2 String substitution variables (on right click project > properties > PyDev PYTHONPATH)

DJANGO_MANAGE_LOCATION - the relative path to For example: src/my_project/
DJANGO_SETTINGS_MODULE, - the name of the settings module. For example: my_project.settings


If the .pydevproject file was created, those values could already be added to it in the entry org.python.pydev.PROJECT_VARIABLE_SUBSTITUTION:

<pydev_variables_property name="org.python.pydev.PROJECT_VARIABLE_SUBSTITUTION">

How do I configure my PYTHONPATH?

Please refer to the Getting Started Guide at PyDev Getting Started for up-to-date information on how to correctly install and configure your PYTHONPATH.

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). In order to get that info, PyDev creates a shell and communicates with it through sockets.

The main problems when that happens are:

  • There's a firewall blocking the communication to the shell
    • To enable it, execute: echo 0 > /proc/sys/net/ipv6/bindv6only
  • The timeout to connect is too small.
    • This 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.

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', '')).

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

Check the tasks page for info on tasks.

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:

And details at the PyDev bugtracker:

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 Ctr l +/ 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.

I have a library installed and PyDev does not find it

Problems have been reported on iOS platforms 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.

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

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). 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).

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

PyDev has an interactive console you can use. See: PyDev Interactive Console.

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.

Disabling the builders may have many side-effects, such as code completion not working, pylint, tasks, etc. If you really want it, you can disable it, but do it with care.

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).

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.

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?
  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? (in the top of this FAQ) for details on getting the error log).

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

UPDATE: As of version, 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.

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

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

Go 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 "Launch" 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).

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.

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?'

I can't make = 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).

Use this:

import _builtin_ = something

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

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. 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 correctly 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.

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.
  2. Remove the file called pydevd.pyc, make a backup copy of file, and make this change to the PyDB::run() method from file

    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.

    1. Import this undocumented ORB function

      from omniORB import addWThreadHook
    2. Add this function:

      def dbg_trace(flag=0, wt=None):
      """This function is called whenever the ORB creates a worker thread (e.g. 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
    3. Finally, make these changes:

      # check if pydev_hook is defined
      hook = pydev_hook
      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.

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: PyDev Keybindings for up-to-date info on the most useful keybindings provided by PyDev and Eclipse.

How do I uninstall PyDev

To uninstall, 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.

Related Links