Built Using

For the Program:

• Python (Guido van Rossum et al.)
• wxWidgets (Julian Smart et al.)
• wxPython (Robin Dunn et al.)
• Scintilla (Neil Hodgson)

For the Documentation:

• docutils (David Goodger)
• Syntax-highlighted code blocks for docutils (On ASPN) (Kevin Schluff)
• Silver City (Brian Quinlan)

Icons from:

• Klassic New Crisp Icons (Asif Ali Rizwaan)
• Sparkling (Flow)
• Noia (Carles Carbonell Bernado)
• Nuvola (David Vignoni)
• (Some Icons Were Either Created or Edited by Daniel Pozmanter.)

Donate!

If you want to show support for DrPython, send a donation our way. A single dollar would be delicious and nutritious:

Donate to Daniel Pozmanter

Donate to North Star

Back to the Top.

Support

Found a bug? Want to see something change? Have a feature request? Stop by the DrPython Sourceforge Project Page. Post in the forum, or formally submit a bug/feature request. I highly recommend starting a discussion on possible features/changes. Part of the power of open source is the power of the users and developers to engage in discourse about a project, its design and its uses.

Bookmarks

Bookmarks are pretty straighforward: there are Bookmarks, and there are Bookmark Folders.

A Bookmark is either a file or directory. When it is selected from the menu, if it is a file, it is opened. If it is a directory, an Open Dialog in that directory pops up.

A Bookmark Folder may contain Bookmarks and/or Bookmark Folders.

You can only add a Bookmark Folder or Bookmark to a Bookmark Folder.

To move a Bookmark or a Bookmark Folder (and all it's contents):

1. Single click on the item you want to move.
2. Drag it to the item you want it to go immediately after.
3. Dragging it to the any item in a folder will cause it to be added directly after that item.
4. Dragging it to a folder will cause it to be the first item in that folder.

Back to the Top

Check Syntax

Runs the python built in 'compile', then tabnanny, on the current file. Reports syntax and indentation errors.

Note that this only checks the syntax for the current file.

Encoding Support

The following only applies if your version of wxPython was built with unicode support:

If you want to use a non ascii encoding (like latin-1 or unicode (utf8)), you need to set some preferences first. (In the event of a bad encoding, drpython will warn you via standard output (if the problem is in the file dialog or prompt), or via a dialog (if the problem occurs while saving or opening a file).

DrPython, by default, checks for unicode when opening/saving files, and in the Prompt.

If you want to use a specific encoding, you have two options.

1. You can set the default encoding via Preferences. This is the encoding used by default when opening/saving files, and the encoding used in the prompt and file dialog.
2. For Opening and Saving files, if you use the special python comment:

(As detailed in the Python Tutorial).

DrPython will try the encoding 'xyz' for the file first.

DrPython, when getting text to open/save will go through the following steps:

1. Check for a special comment (coding) (if Auto Detect is enabled).
2. Check for Unicode (if Auto Detect is enabled)
3. Check for default encoding (if Default Encoding is enabled)
4. If no check passes, ensure the text is ascii.

To disable default encoding, leave it blank.

Back to the Top

Find/Replace

This is a rather standard/straightforward dialog. However there are some things that stick out.

Right clicking on the text field will yield a pop up menu. You can insert tab/newline/carriage returns, perform clipboard operations, or clear the text.

You can also access Find/Replace History via the combobox.

Back to the Top

Find and Complete

This is a user initiated version of auto complete. DrPython will search the current file for possible completions to the word you are currently typing. It will display these results in a small window. Navigate by using the up and down arrows, or to go faster, page up and page down to go faster, or home and end to skip to the start and end of the list.

Hitting Enter or Tab will complete the current word with the selection.

Context Sensitive: Find And Complete stops at the following characters (in addition to whitespace):

( ) < > [ ] { }

This means:

searching at dog(tre will yield tree, treat. However:

searching at dog( will yield dog(threat, dogs.

Note: Find And Complete is case sensitive.

Back to the Top

Go To Block / Class / Def

A few notes. In the code:

'if True:' is the start of the block; 'print "Hello again"' is the end.

Comments '#' are ignored. For explicitly (joined with a backslash) and implicitly joined lines, every line after the first is ignored.

Goto Traceback

Double clicking a traceback entry in the prompt (the File line in the example below):

Traceback (most recent call last):
File "/home/user/Desktop/test.py", line 6, in ?
  wd
NameError: name 'wd' is not defined

will tell DrPython to open '/home/user/Desktop/test.py' and go to line 6.

Back to the Top

Indentation and Tabs

The "Use Tabs" option under "Document" in preferences tells DrPython whether to use tabs (default) or spaces for autoindentation. "Tab Width" under "General" is how many spaces DrPython should consider a "Tab" to be.

To see what characters the current document uses for indentation, check the statusbar.

The "Whitespace" menu has entries that allow you to set indentation to tabs or spaces. Setting the indentation for the document to tabs, for example, will replace a set number of spaces with tabs. This operation takes place at the beginning of each line.

Some programmers prefer (and/or were taught) to use tabs ('t') to indent blocks of code. Some use spaces instead.

The whitespace menu lets you easily switch the type of indentation used in the current file to the type you prefer to work with.

Note: The ClassBrowser only works properly if the current file is using the same type of indentation (tab character or spaces) as is set as the default for DrPython in prefs. DrPython will automatically check for this when you open the Class Browser. To fix a mixed file, use the "Whitespace" menu under "Edit".

NOTE: If the line endings are mixed, DrPython will not be able to properly fix the indentation. Always set the line endings before setting the indentation type.

Back to the Top

Shortcuts

You can set shortcuts by selecting "Customize Shortcuts" from the Options menu.

Ignore Keys ignores the modifier keys listed. Only modifier keys are valid. This is primarily for operating systems such as Linux, where the "Meta" key is set to "Num Lock" by default, and hence may always be on.

Note: You can set shortcuts for DrScript menu items. If you have not, or the shortcuts file is somehow out of sync with the actual number of DrScripts, DrPython will simply load the correct DrScripts, with no default shortcuts. DrScript Shortcuts are stored separately from DrPython Shortcuts.

If your shortcuts are not working, use "get key" on a shortcut to see if a modifier key is constantly present. On Linux, "Meta" may be present. If this is the case, use "Ignore Keys" to set "Meta" as a key to ignore.

For a given shortcut, simply click the "Get Key" Button, and press the keys you wish. It will print the modifiers detected, and the keycode. When you are done, hit "Close", and the keystring will be next to the shortcut.

Select "Update" to start using the key now. Select "Save" to have DrPython remember the changes.

Note: The Tab and Enter keys are used for code related to indentation in the document, and Enter + the arrow keys are used behaviour specific to the prompt. Setting these keys in the shortcuts may cause DrPython to behave incorrectly.

Note: On some platforms some keys may not register, and thus cannot be used as shortcuts.

Note: There seems to be a bug where shift + backspace inserts the backspace character. To work around this, "Delete Back Not Line" is assigned to shift + backspace. If you want to insert the backspace character, just set "Delete Back Not Line" to None. If you want to use shift + backspace for something else, just set it to None, and you should be set.

The defaults are:

Back to the Top

Line Endings

Windows mode can make linux hiccup. So Unix Mode is the default (Windows seems to be fine with it.)

Note: Setting the Line Endings in Preferences does not affect the current open file!

Back to the Top

Menu And Focus (Toggling)

Some menu items act on the Text Control currently with focus. Toggle Whitespace Visible is one such item.

If the focus is on the File text control, then selecting this menu item will cause the whitespace to either become visible or invisible in that control.

If the focus is on the prompt, then the whitespace will be toggled in the prompt.

Back to the Top

Open Imported Module

DrPython only shows modules which exist. These are either in the current module search path for Python, or in the same directory as the current document.

Some modules do not exist as files. The integral modules sys and time are two examples. These will not show up in the list of imported modules, even if they are imported in the current document.

If you type, the typed text is used as a filter for the matching modules. (Use backspace to backtrack). Only matches that contain the typed text will be shown. (Case insensitive.)

Back to the Top

Pop Up Menu

The Pop Up Menu is the menu that pops up when you right click on the Document, or the Prompt. You can customize this menu to handle DrPython functions, DrScripts, or plugins.

Note that each item on the Pop Up Menu must have a distinct name for everything to work properly.

Back to the Top

Rectangular Selection

To activate this feature, use Alt on Windows, Shift + Alt on Linux. (If neither works, try Ctrl).

In Find: rectangular selection ignores line endings, and does not support the 'Whole Word' flag. It searches line by line.

In Replace: the above applies. Also, 'Prompt On Replace' is not supported.

Back to the Top

Regular Expressions

It is best to consult the python documentation (Under Modules, "re").

In short, Regular Expressions provide a fast and powerful method for matching patterns of text. These can be quite useful in programs you write, or simply to find and/or replace text in a given file.

Back to the Top

Running a Python Program

Open a file, click run, and you are set to go. If your program takes arguments, select "Set Arguments" from the menu or toolbar.

Note the right field in the status bar tells you if the program is running. Also note that the "End" button is enabled, and "Run", "Set Arguments", and "Python Debugger" are disabled.

When the program has ended, the right status bar field goes blank, "End" is disabled, and "Run", "Set Arguments", and "Python Debugger" are enabled.

Back to the Top

Shell Commands

To add a shell command, go to the DrScript menu, under Add Script, and select "Shell Command".

Back to the Top

Source Browser

The source browser displays classes, defs, imports, and labels. Double Clicking (Or, Optionally, Right Clicking) an item will set the Document to the line number of that item.

Separators (Labels) can be added manually #---YourLabelHere or via the Insert Seperators Dialog.

Back to the Top

Source Browser Go To

A very quick and simple way to move around in a large document. If you type, the typed text is used as a filter for the matching classes, defs, and imports. (Use backspace to backtrack). Only matches that contain the typed text will be shown. (Case insensitive.)

The typed text is echoed in the top text control. The next two text controls shows the line number of the selected item, as well as the class or function the item is defined in. (The filename is used if no class or function is found).

Back to the Top

Status Bar

Back to the Top

Tool Bar

A few notes on customizing the toolbar.

1. When selecting a particular icon for a toolbar item, select the toolbar item from the left list ("Current List"), then click the "Change" button for the icon size you want.
2. If you specify an icon, this will be loaded instead of the default, and instead of any icon file loaded.
3. If you select an icon that is a different size than the selected size (16x16, 24x24), the toolbar will not display correctly.

Back to the Top

Tracebacks

Tracebacks are the output the python interpreter produces for an unhandled exception. This output:

Traceback (most recent call last):
  File "/mnt/win_e/docs/prog/drpython/drpython-3.1.2/drpython.py", line 1840, in OnGoTo
    v = int(v) - 1
ValueError: invalid literal for int(): line number

is produced if you type "line number" into the Goto dialog.

Now, DrPython handles this exception. However DrPython displays tracebacks in its error dialogs (if there are any) for the purposes of transparency. This way, if there is a bug it is easier to report it, and if you are working on a DrScript or a Plugin, this makes it easier to figure out what is going on.

Back to the Top

View In Panel

View In Panel lets you view any open document (including the current one) in any side panel.

There are two notes.

1. Only STC shortcuts work in these panels. (The exception is if the split view is of the current document).
2. If you view document 1 in document 2, then close document 1, you need to close the panel in document 2 manually.

Back to the Top