How do I Report a BUG?

Well, if you don't find anything that helps you, please check if it is a known BUG, if it is not, please, report it.
The place to search and report BUGS is here
When reporting a bug, don't forget to give the following information:

- System (e.g windows XP)
- Eclipse version (e.g. 3.0.1)
- PyDev version (e.g. 0.9.2)
- PyDev error log (if any): go to window->show view->other->PDE Runtime->Error log.

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

- How do I configure my PYTHONPATH?

There are 3 places where you have to go to configure the PYTHONPATH, and by doing so, PyLint, code completion, running and others should use this configuration.

1.Go to window->preferences->pydev->Python Interpreters and set the python interpreter location.



2.In the navigator, right click on the project root and choose 'properties'.

In PyDev PYTHONPATH, you have to set your source folders (where your sources are within the project) and the external source folders (folders that are not within your eclipse environment).



3.Also in the project properties, you have to choose the project references, so that your current projects gets those projects configurations in the PYTHONPATH.





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

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

Well, for that, you have to configure an external tool. Go to the menu->Run->External Tools and configure the location, working dir and don't forget to put the -i argument so that you enter in interactive mode!

The picture below shows what I mean...



Now, the only thing missing is running it! And don't forget to add a keybinding to rerun the last executed external tool, so that you don't have to go through the menu every time!

Why don't I get some simple text completion in PyDev?

We do not provide text completion ourselves in the plugin, as other plugins already provide this. A good suggestion is using the lunar eclipse editor-enhancements plugin. It does not only provide text completion, but other very useful enhancements.

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

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

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

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

How do I run a module from within eclipse using PyDev?

To do that, the easiest way is going to the Run menu (Run->Run As->Python). 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).

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

Keybindings from Pydev
Code Completion Ctrl+Space
Template Completion Ctrl+Space
Content Assistant Ctrl+1
Navigate Up Ctrl+Shift+Up
Navigate Down Ctrl+Shift+Down
Comment Ctrl+3
UnComment Ctrl+Shift+3
Make block comment Ctrl+4
Go To Definition F3
Collapse All Ctrl+9
UnCollapse All Ctrl+0
Format Code Ctrl+Shift+F
Sort imports alphabetically (or selection) Ctrl+Shift+O
Refactor: Rename Shift+Alt+R
Refactor:Extract Local Variable Shift+Alt+L
Refactor:Extract Method Shift+Alt+M
Refactor:Inline Local Variable Shift+Alt+I
Some useful Eclipse provided keybindings
Run last lauch Ctrl+F11 (see how to customize perspective)
Debug last lauch F11 (see how to customize perspective)


Many of them can be customized in the Keybindings menu (window->preferences->workbench->keys).