Table of Contents

Eric3 Source Documentation: eric3 |
--- | ---
### README for the scripting support of the eric3 IDE eric3 provides some scripting capability using Python as its scripting language (what a surprise). At startup time eric3 looks for a script called "startup.py" in two places. To make script programming easier, some internal objects and methods are exposed via the global context. #### Startup scripts At startup time eric3 looks for a script called "startup.py" in two places. First a global startup script is looked for in the Scripting directory of the eric3 installation directory. This file is run for every user. Thereafter eric3 looks for a per user startup script in the users configuration directory (e.g. $HOME/.eric3). #### Global context To make script programming a little bit easier, access to the most important internal objects and methods are provided via the global context. These are: Eric a reference to the UserInterface object, i.e. the main window. ViewManager a reference to the ViewManager object, which is responsible for the management of the various editor windows. Project a reference to the Project object, which handles all project related actions. DebugServer a reference to the DebugServer object, which handles the communication with the remote DebugClient. Wizards a reference to the Wizards object, which manages all installed wizards. ConfigDir a string containing the per user configuration directory (e.g. $HOME/.eric3). InstallDir a string containing the eric3 installation directory. ScriptsMenu a reference to the scripts menu object. This can be used to add scripts to this menu. ScriptsToolbar a reference to the scripts toolbar object. This can be used to add scripts to this toolbar. installScript a global method to attach a previously created script to a menu and/or a toolbar. The signature is "installScript(script, menubar = None, toolbar = None)". Script is a reference to a script object, menubar is a reference to the menu the script is to be added to and toolbar is a reference to the toolbat the script is to be added to. removeScript a global method to remove a previously created script. The signature is "removeScript(script)". Script is a reference to the script object to be removed. createScript a global method to create a new script object. The signature is "createScript(name, code)". Name is a string containing the name of the script and code is a string containing the Python code for the script. createDocument a global method to create a new document. The signature is "createDocument()". This new document is made the active window. A reference can be obtained by calling ViewManager.activeWindow(). All scripts have full access to the public methods of these internal objects. For a detailed description of this API please see the eric3 API documentation by opening "Documentation/Source/index.html" in the eric3 installation directory. #### Examples For examples see "Examples/Scripting" in the eric3 installation directory. #### Bugs and other reports Please send bug reports, feature requests or contributions to eric bugs address. <eric-bugs@die-offenbachs.de>

Table of Contents

This document was automatically generated by HappyDoc version 2.1