Application: gvSIG desktop » gvSIG scripting

<?xml version="1.0"?>

<!--

Definitions of plugin persistence org.gvsig.scripting.app.mainplugin.

 -->

<definitions>

  <version>1.0.0</version>

  <classes>

    <class name="org.gvsig.scripting.app.mainplugin">

      <description>Persistence of scripting plugin</description>

      <fields>

        <field name="ComposerUseHisWindowManager" type="boolean" mandatory="true" defaultValue="true">

          <description>When true the composer use his window manager instead of the gvSIG Window manager.</description>

        </field>

      </fields>

    </class>

  </classes>

</definitions>

_Scripting=Scripting

_Show_scripting_launcher=Abrir lanzador de scripts

_Show_scripting_composer=Abrir editor de scripts

_Show_scripting_jython_console=Abrir consola Jython

User=Usuario

System=Sistema

Accept=Aceptar

Cancel=Cancelar

Apply=Aplicar

Retrieving_data=Recibiendo datos...

File=Fichero

New=Nuevo

Close_document=Cerrar documento

Close_all_documents=Cerrar todos los documentos

Run=Ejecutar

Save=Guardar

Close=Cerrar

Close_current_tab=Cerrar pesta\u00f1a actual

Open_edition_mode=Abrir modo edici\u00f3n

Run_selected_script=Ejecutar script seleccionado

Delete_selected_script=Borrar script seleccionado

Refresh_directories=Actualizar carpetas

Move_files=Mover ficheros

Set_file_preferences=Editar preferencias de fichero

Edit=Editar

Cut=Cortar

Copy=Copiar

Paste=Pegar

Select_all=Seleccionar todo

Tools=Herramientas

Launcher=Lanzador de scripts

Scripting_Launcher=Lanzador de scripts

Scripting_Composer=Editor de scripts

Jython_Console=Consola Jython

Import_JavaDoc=Importar JavaDoc

JavaDoc=Ayuda de Java (JavaDoc)

Remove_JavaDoc=Eliminar JavaDoc

Help_contents=Contenido de la ayuda

About_scripts_editor=Acerca del editor de scripts

Get_help=Ayuda

Help=Ayuda

_Package_script=Empaquetar script...

_Package_help=Empaquetar ayuda...

Problems=Errores

Console=Consola

Description=Descripci\u00f3n

Resource=Recurso

Location=Ubicaci\u00f3n

no_line=sin l\u00ednea

Line=L\u00ednea

Welcome_message=Bienvenido al entorno de scripting

Error_opening_in_edition_mode_title=Error al abrir fichero

Error_opening_in_edition_mode=No se pudo abrir el fichero en modo edici\u00f3n

New_Script=Nuevo elemento

New_Script_Description=Crea un nuevo script, di\u00e1logo, proyecto, directorio

Deleting_JavaDocs_successfully_title=Operaci\u00f3n realizada con \u00e9xito

Deleting_JavaDocs_successfully=Eliminaci\u00f3n de los JavaDocs exitosa

Import_JavaDoc_title=Importar JavaDocs desde los directorios de sistema al ScriptingFramework JavaDoc

Remove_JavaDoc_title=Eliminar JavaDocs del ScriptingFramework JavaDoc

projects_modified_title=Proyectos sin guardar

projects_modified=Algunos proyectos han sido modificados.\u00bfSalvar cambios?

project_modified=ha sido modificado.\u00bfSalvar cambios?

Delete_all_title=Borrar el documento

Delete_all_message=Esta acci\u00f3n elimina el documento o el directorio con todo su contenido. \u00bf Desea continuar ?

About_us_title=Informaci\u00f3n de todos los contribuidores al proyecto gvSIG

Success=Operaci\u00f3n realizada con \u00e9xito

Error=Error

Error_renaming=Inesperado error renombrando el fichero

Error_moving=Inesperado error moviendo el fichero

Error_help=Selecciona una ayuda

Rename_succesfully=Renombrado del fichero realizado con \u00e9xito

Select_first=Debe seleccionar un fichero primero

help_key=No hay ayuda para el texto

script_filesystem=script en el \u00e1rbol de directorio

Move=Mover

move_desc=Cambia la ubicaci\u00f3n del fichero seleccionado

Rename=Renombrar

rename_desc=Cambia el nombre y otras propiedades del fichero seleccionado

Moving_succesfully=Reubicaci\u00f3n del fichero realizado con \u00e9xito

Dialog=Di\u00e1logo

Code=C\u00f3digo

Properties=Propiedades

current_name=Nombre actual

new_name=Nuevo name

rename_name_title=Cambiar el nombre del fichero

more_properties=M\u00e1s propiedades

Javadoc_remove=Selecciona el JavaDoc a eliminar

no_Javadoc_remove=No hay JavaDoc para eliminar

Name=Nombre

Version=Versi\u00f3n

Created_by=Creado por

Description=Descripci\u00f3n

Type=Tipo

Language=Lenguaje

Author=Autor

Move_from=Mover desde

Move_to=Destino

Browse=Abrir

Import_from=Importar desde

Name_blank=El nombre no puede estar en blanco

Name_exists=Este nombre ya existe. Debe elegir otro

Import_success=Los JavaDocs se han importado satisfactoriamente

JavaDoc_Error=Selecciona JavaDoc a importar

go_to_line_Xhorizontal_ellipsisX=Ir a la l\u00ednea\u2026

find_Xhorizontal_ellipsisX=Buscar\u2026

replace_Xhorizontal_ellipsisX=Reemplazar\u2026

_Searching_autorun_scripts_Xhorizontal_ellipsisX=Buscando scripts de autoarranque...

_Starting_XnameX=Iniciando {0}...

_The_script_XscriptnameX_is_modified=El script "{0}" ha sido modificado.

_Save_changes_XquestionX=\u00bf Guardar cambios ?

_Do_you_want_to_save_changes_XquestionX=\u00bf Desea guardar los cambios ?

_notice=Aviso

_Initializing_the_scripting_plugin_Xhorizontal_ellipsisX=Inicializando el plugin de scripting...

_Waiting_to_terminate=Esperando que termine.

_Run_main_script=Ejecutar script principal

_Select_main_script=Seleccionar script pricipal

_Main_script_is_not_selected=No hay seleccionado un script como principal.

_The_selected_script_is_invalid=El script seleccionado no es valido.

_Do_you_want_to_select_one_and_execute_it=\u00bfDesea seleccionar uno y ejecutarlo ?

_Scripting=Scripting

_Show_scripting_launcher=Show scripting launcher

_Show_scripting_composer=Show scripting composer

_Show_scripting_jython_console=Show Jython console

User=User

System=System

Accept=Accept

Cancel=Cancel

Apply=Apply

Retrieving_data=Retrieving data...

File=File

New=New

Close_document=Close document

Close_all_documents=Cloase all documents

Run=Run

Save=Save

Close=Close

Close_current_tab=Close current tab

Open_edition_mode=Open edition mode

Run_selected_script=Run selected script

Delete_selected_script=Delete selected script

Refresh_directories=Refresh directories

Move_files=Move files

Set_file_preferences=Set file preferences

_Running_autorun_script_from_XnameX=Running autorun script from {0}

Edit=Edit

Cut=Cut

Copy=Copy

Paste=Paste

Select_all=Select all

Tools=Tools

Launcher=Scripting Launcher

Scripting_Launcher=Scripting Launcher

Scripting_Composer=Scripting Composer

Jython_Console=Jython console

Import_JavaDoc=Import JavaDoc

JavaDoc=Java Help (JavaDoc)

Remove_JavaDoc=Remove JavaDoc

Help_contents=Help contents

About_scripts_editor=About scripts editor

Get_help=Help

Help=Help

_Package_script=Package script...

_Package_help=Package help...

Problems=Errors

Console=Console

Description=Description

Resource=Resource

Location=Location

no_line=no line

Line=Line

Welcome_message=Welcome to the scripting framework

Error_opening_in_edition_mode_title=Error opening file in edition mode

Error_opening_in_edition_mode=The file can't be opened in edition mode

New_Script=New element

New_Script_Description=Create a new script, dialog, project, directory

Deleting_JavaDocs_successfully_title=Operation successful

Deleting_JavaDocs_successfully=Deleting JavaDocs successfully

Import_JavaDoc_title=Import JavaDocs from filesystem to ScriptingFramework JavaDoc

Remove_JavaDoc_title=Remove JavaDocs from ScriptingFramework JavaDoc

projects_modified_title=Projects without saving

projects_modified=Some projects have been modified. Save changes?

project_modified=has been modified. Save changes?

Delete_all_title=Delete document

Delete_all_message=This action removes the document or directory with all its content. Do you wish to continue ?

About_us_title=Information about all the gvSIG's contributors

Success=Operation done successfully

Error=Error

Error_renaming=Unexpected error renaming the file

Error_moving=Unexpected error moving the file

Error_help=Select help

Rename_succesfully=Renaming successfully

Select_first=Select a file first

help_key=There isn't any help to this text

script_filesystem=script filesystem

Move=Move

move_desc=Change location of selected file

Rename=Rename

rename_desc=Change the name and more properties of the selected file

Moving_succesfully=File moved succesfully

Dialog=Dialog

Code=Code

Properties=Properties

current_name=Current name

new_name=New name

rename_name_title=Change filename

more_properties=more properties

Javadoc_remove=Choose JavaDoc to delete

no_Javadoc_remove=There's no JavaDoc to delete

Name=Name

Version=Version

Created_by=Create by

Description=Description

Type=Type

Language=Language

Author=Author

Move_from=Move from

Move_to=Move to

Browse=Browse

Import_from=Import from

Name_blank=Name can't be blank

Name_exists=This name already exists. Choose another one

Import_success=JavaDocs imported successfully

JavaDoc_Error=Select JavaDoc to import

go_to_line_Xhorizontal_ellipsisX=Go To Line\u2026

find_Xhorizontal_ellipsisX=Find\u2026

replace_Xhorizontal_ellipsisX=Replace\u2026

_Searching_autorun_scripts_Xhorizontal_ellipsisX=Searching autorun scripts...

_Starting_XnameX=Starting {0}...

_The_script_XscriptnameX_is_modified=The script "{0}" has been modified.

_Save_changes_XquestionX=Save changes ?

_Do_you_want_to_save_changes_XquestionX=Do you want to save changes ?

_notice=Notice

_Initializing_the_scripting_plugin_Xhorizontal_ellipsisX=Initializing the scripting plugin...

_Waiting_to_terminate=Waiting to terminate.

_Run_main_script=Run main script

_Select_main_script=Select main script

_Main_script_is_not_selected=Main script is not selected.

_The_selected_script_is_invalid=The selected script is not valid.

_Do_you_want_to_select_one_and_execute_it=Do you want to select one and execute it?

----------------------------------------------

CHALKWORK BASIC

by Dave Shea

mezzoblue.com/icons/chalkwork/basic

----------------------------------------------

CHALKWORK COMMERCE

by Dave Shea

mezzoblue.com/icons/chalkwork/commerce

----------------------------------------------

CHALKWORK EDITING CONTROLS

by Dave Shea

mezzoblue.com/icons/chalkwork/editing-controls

----------------------------------------------

CHALKWORK INFORMATION MANAGEMENT

by Dave Shea

mezzoblue.com/icons/chalkwork/information-management

----------------------------------------------

CHALKWORK HTML (Free Version)

by Dave Shea

mezzoblue.com/icons/chalkwork/html

----------------------------------------------

Thanks for your interest in the Chalkwork Family. Please consider subscribing to the Chalkwork news feed, which will announce new releases in the family as well as inform existing users of updates if any occur.

	http://mezzoblue.com/icons/chalkwork/news.xml

- Dave Shea

  mezzoblue.com

  @mezzoblue on Twitter

LICENSE AGREEMENT

----------------------------------------------

By downloading this icon set, you agree to abide by the Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License under which these icons are being made available for non-commercial use.

	Applicable Creative Commons License: http://creativecommons.org/licenses/by-nc-sa/3.0/

	Attribution and additional license information: http://www.mezzoblue.com/icons/license/#license-cc

By purchasing a Chalkwork Commercial License, you agree to abide by the Chalkwork Royalty-Free Stock Icon License Agreement under which these icons are being made available for commercial use.

	Chalkwork Commercial License: http://www.mezzoblue.com/icons/license/#license-cc

This notice must be included any time these icons are redistributed.

----------------------------------------------

ICON FOLDER INDEX

----------------------------------------------

The icon files are broken down by file format. Due to some formats resulting in higher quality results, those are considered the preferred files and are located in the folder titled 'High Quality'. This package should contain the following folders in this hierarchy:

High Quality

    ICNS (Mac)

    ICO (Windows)

    PNG

    TIF

Lower Quality

    BMP

    GIF

Within each of the second-level folders, you'll find 102 further folders, one for each icon and its variations. Depending on the file format, you may find multiple sizes within these folders along with any icon variations that may exist. Please note that ICO and ICNS files contain all applicable sizes within a single file, and that ICNS files do not support the 24x24 icon size.

----------------------------------------------

CHALKWORK INFORMATION MANAGEMENT ICON INDEX

* indicates that variations of this icon are provided within this set

---------------------------------------------------------------------

Ad

	- Ad (Dollars) *

	- Ad (Euros) *

	- Ad (Pounds) *

Address Book *

Announcement *

API

Archive *

Attachment *

Authenticate

Blog *

Bookmark *

Briefcase *

Category *

Chart (Area) *

Chart (Bar) *

Chart (Pie) *

Collapse

Colour Palette *

Continue

Control Panel

Conversation *

Create

Dashboard *

Database *

Dictionary *

Document (Area Chart) *

Document (Bar Chart) *

Document (Blank) *

Document (Form) *

Document (Photo) *

Document (Pie Chart) *

Document (Secure) *

Document (Shred)

Documents (x2) *

Documents (x3) *

Download

Draw

Entry *

Excerpt *

Expand

Export

Fax *

File *

	- File (Closed)

	- File (Open)

Filter *

Flag *

Flag (Black) *

Flag (Blue) *

Flag (Brown) *

Flag (Green) *

Flag (Light Blue) *

Flag (Orange) *

Flag (Pink) *

Flag (Purple) *

Flag (Red) *

Flag (White) *

Flag (Yellow) *

Formatting

Hierarchy *

Import

Inbox *

Index *

List *

Log *

Map *

Mobile Phone *

Moderate

Module *

News *

Notes *

Notification *

Office *

Package *

Password

Phone *

	- Phone (Batphone) *

	- Phone (Office) *

Plugin *

Preview

Publish

Read More

Rebuild

Relationship (Data) *

Relationship (People) *

Rotate Left

Rotate Right

Schedule *

	- Schedule (Noun)

	- Schedule (Verb)

Script *

Security *

Sign In

Sign Out

Sort Down

Sort Up

Spam *

Statistics *

Status *

	- Status (Green)

	- Status (Off)

	- Status (On)

	- Status (Red)

	- Status (Yellow)

Support *

Sync

Template *

Ticket *

Time Zone *

Tools *

Trackback

View (Columns)

View (Lists)

View (Thumbnails)

Weather *

Write

This plugin provides support for scripting to gvSIG.

Among other things it contains:

- The gvSIG scripting engine

- The gvSIG script editor

- Script engines for:

   - Jython

   - Groovy

   - javascript

   - Renjin

- The script install module for the add-on manager.

- Utilities to generate packages of complements with our scripts.

- Python libraries as:

   - Six - Utilities for writing code that runs on Python 2 and 3

   - PyLint - Python source code analyzer

   - Pygments - syntax highlighting package

   - CSSUtils - CSS Cascading Style Sheets library

   - Docutils - Python Documentation Utilities

   - geopy - client for several popular geocoding web services

   - PyInliner - CSS-to-inline-styles conversion tool for HTML

   - Statistics - functions for calculating statistics of data

   - Cartodb - simple CartoDB client to perform requests against the CartoDB API

- Java libraries to use from scripting as:

   - Abeille forms deseigner

   - jOpenDocument

   - JNumeric

   - CSSBox

This plugin can be configured to be preinstalled automatically, allowing 

"Script" type plugins to be installed during the application installation process. 

To do this, the following entries must be added to the "packages.properties" 

of gvspks::

    installers=scripts

    installer.scripts.initializer=org.gvsig.scripting.app.extension.ScriptsInstallerInitializer

    installer.scripts.package.code=org.gvsig.scripting.app.mainplugin

    installer.scripts.factory.name=Script

    installer.scripts.libs=lib

If the "installers" entry already exists, add "scripts" to the end separating 

it with a space.

# -*- coding: utf-8 -*-

#

# File: commonsdialog.py

#

# Copyright (c) 2011 by Model Driven Development sl and Antonio Carrasco Valero

#

# GNU General Public License (GPL)

#

# This program is free software; you can redistribute it and/or

# modify it under the terms of the GNU General Public License

# as published by the Free Software Foundation; either version 2

# of the License, or (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA

# 02110-1301, USA.

#

#

__author__ = """Antonio Carrasco Valero

Model Driven Development sl and Antonio Carrasco Valero

<carrasco@modeldd.org>

Victor Acevedo Royer <vacevedo@gvsig.com> <vacevedor@gmail.com>

"""

__docformat__ = 'plaintext'

from javax.swing import JFileChooser

from javax.swing.filechooser import FileNameExtensionFilter

#from org.gvsig.app import ApplicationLocator      

from org.gvsig.andami.ui.mdiFrame import DefaultThreadSafeDialogs

#====================================

# SWING

#

#messageType options

FORBIDEN = 0

IDEA= 1

WARNING= 2

QUESTION= 3

#

#Confirmdialog optionType Options

YES_NO = 0

YES_NO_CANCEL = 1

ACEPT_CANCEL = 2

#filechooser options

OPEN_FILE = 0

OPEN_DIRECTORY = 1

SAVE_FILE = 2

#filechooser selectionMode

FILES_ONLY = JFileChooser.FILES_ONLY

DIRECTORIES_ONLY = JFileChooser.DIRECTORIES_ONLY

def msgbox(message, title="", messageType=IDEA):

    """Shows a message dialog with ok button only

    :param message: text to present in the dialog

    :param title: title of the dialog

    :param messageType: type of icon to use.

    """

    DefaultThreadSafeDialogs().messageDialog(message, title, messageType)

def inputbox(message, title="", messageType=IDEA, initialValue=""):

    """

    Shows a input dialog.

    :param message: text to present in the dialog

    :param title: title of the dialog

    :messageType: type of icon to use

    :initialValue: Initial value of the inputbox  

    """

    return DefaultThreadSafeDialogs().inputDialog(message, title, 

        messageType, initialValue) 

def confirmDialog(message, title="", optionType=YES_NO, messageType=IDEA):

    """

    Create a message dialog with options button

    :param message: text to present in the dialog

    :param title: title of the dialog

    :optionType: bottons to show

    :param messageType: type of icon to use.    

    """

    #0: yes/no option

    #1: yes/no/cancelar

    #2: accept/cancel

    return DefaultThreadSafeDialogs().confirmDialog(message, title, 

        optionType, messageType) 

def filechooser(option, title="", initialPath=None, 

        multiselection=False, filter = None, fileHidingEnabled=True):

    """

    Allows configuration parameters to filechooser dialogs

    :int option: file chooser selection mode. Allowed values:

        OPEN_FILE, OPEN_DIRECTORY, SAVE_FILE

    :String title: Window title

    :String initialPath: Initial path to the directory to open in the dialog

    :boolean multiselection: Allow select more than one object.

    :String[] filter: list of acepted extension files ("jpg", "png", "gif")

    :boolean fileHidingEnabled: True if hidden files are not displayed

    """ 

    #

    #Values for open files dialog

    dialogType = JFileChooser.OPEN_DIALOG

    selectionMode = FILES_ONLY

    if option == SAVE_FILE:

        dialogType = JFileChooser.SAVE_DIALOG

    elif option == OPEN_DIRECTORY:

        selectionMode = DIRECTORIES_ONLY

    initialPath = getJavaFile(initialPath)

    if filter:

        filter = FileNameExtensionFilter("Files", filter)

    return DefaultThreadSafeDialogs().showChooserDialog(

            title,

            dialogType,

            selectionMode,

            multiselection,

            initialPath,

            filter,

            fileHidingEnabled)

def openFileDialog(title='', initialPath=None):

    """

    Shows a window dialog to choose one file. 

    :param title: Window title. Default ''

    :type title: string

    :param initialPath: Initial path to open in window dialog

    :type initialPath: string

    """

    return DefaultThreadSafeDialogs().showOpenFileDialog(

        title, 

        getJavaFile(initialPath))

def openFolderDialog(title='', initialPath=None):

    """

    Shows a window dialog to choose one folder. 

    :param title: Window title. Default ''

    :type title: string

    :param initialPath: Initial path to open in window dialog

    :type initialPath: string

    """    

    return DefaultThreadSafeDialogs().showOpenDirectoryDialog(

        title, 

        getJavaFile(initialPath))

def saveFileDialog(title='', initialPath=None):

    """

    Shows a window dialog to choose one file. 

    :param title: Window title. Default ''

    :type title: string

    :param initialPath: Initial path to open in window dialog

    :type initialPath: string

    """    

    return DefaultThreadSafeDialogs().showSaveFileDialog(

        title, 

        getJavaFile(initialPath)

    )

def getJavaFile(path):

    """Returns a java File using parameter path.

    If path doesn't exists looks for user home folder and if can not find it, 

    returns path will be gvSIG instance directory.

    """

    #

    #Needs because DefaultThreadSafeDialogs files methods use a java File 

    #instance as initialPath parameter

    #

    import os

    import java.io.File as JFile  

    if path:

        path = os.path.normpath(path)

        if os.path.exists(path):

            return JFile(path)

    if os.environ.has_key('HOME'):

        return JFile(os.environ.get('HOME', os.getcwd()))

    if os.path.exists(os.path.expanduser("~")):

        return JFile(os.path.expanduser("~"))

    return JFile(os.getcwd())

from console import main

main()

"""Provides a variety of introspective-type support functions for

things like call tips and command auto completion.

NOTE: this file is a modification of Patrick O'Brien's version 1.62

"""

#from __future__ import nested_scopes

__author__ = "Patrick K. O'Brien <pobrien@orbtech.com>"

__cvsid__ = "$Id: introspect.py 5910 2006-06-20 10:03:31Z jmvivo $"

__revision__ = "$Revision: 5910 $"[11:-2]

import cStringIO

import inspect

import sys

import tokenize

import types

try:

    True

except NameError:

    True = 1==1

    False = 1==0

def getAutoCompleteList(command='', locals=None, includeMagic=1, 

                        includeSingle=1, includeDouble=1):

    """Return list of auto-completion options for command.

    The list of options will be based on the locals namespace."""

    attributes = []

    # Get the proper chunk of code from the command.

    root = getRoot(command, terminator='.')

    try:

        if locals is not None:

            object = eval(root, locals)

        else:

            object = eval(root)

    except:

        pass

    else:

        attributes = getAttributeNames(object, includeMagic, 

                                       includeSingle, includeDouble)

    return attributes

def getAttributeNames(object, includeMagic=1, includeSingle=1,

                      includeDouble=1):

    """Return list of unique attributes, including inherited, for object."""

    attributes = []

    dict = {}

    if not hasattrAlwaysReturnsTrue(object):

        # Add some attributes that don't always get picked up.  If

        # they don't apply, they'll get filtered out at the end.

        attributes += ['__bases__', '__class__', '__dict__', '__name__', 

                       'func_closure', 'func_code', 'func_defaults', 

                       'func_dict', 'func_doc', 'func_globals', 'func_name']

    if includeMagic:

        try: attributes += object._getAttributeNames()

        except: pass

    # Get all attribute names.

    attrdict = getAllAttributeNames(object)

    for attrlist in attrdict.values():

        attributes += attrlist

    # Remove duplicates from the attribute list.

    for item in attributes:

        dict[item] = None

    attributes = dict.keys()

    attributes.sort(lambda x, y: cmp(x.upper(), y.upper()))

    if not includeSingle:

        attributes = filter(lambda item: item[0]!='_' \

                            or item[1]=='_', attributes)

    if not includeDouble:

        attributes = filter(lambda item: item[:2]!='__', attributes)

    # Make sure we haven't picked up any bogus attributes somehow.

    attributes = [attribute for attribute in attributes \

                  if hasattr(object, attribute)]

    return attributes

def hasattrAlwaysReturnsTrue(object):

    return hasattr(object, 'bogu5_123_aTTri8ute')

def getAllAttributeNames(object):

    """Return dict of all attributes, including inherited, for an object.

    Recursively walk through a class and all base classes.

    """

    #print "getAllAttributeNames  1",repr(object), repr(str(object))

    attrdict = {}  # (object, technique, count): [list of attributes]

    # !!!

    # Do Not use hasattr() as a test anywhere in this function,

    # because it is unreliable with remote objects: xmlrpc, soap, etc.

    # They always return true for hasattr().

    # !!!

    #print "getAllAttributeNames  2"

    try:

        # Yes, this can fail if object is an instance of a class with

        # __str__ (or __repr__) having a bug or raising an

        # exception. :-(

        key = str(object)

    except:

        key = 'anonymous'

    # Wake up sleepy objects - a hack for ZODB objects in "ghost" state.

    #print "getAllAttributeNames  3"

    wakeupcall = dir(object)

    #print "getAllAttributeNames  4"

    del wakeupcall

    # Get attributes available through the normal convention.

    #print "getAllAttributeNames  5"

    attributes = dir(object)

    attrdict[(key, 'dir', len(attributes))] = attributes

    #print "getAllAttributeNames  6"

    # Get attributes from the object's dictionary, if it has one.

    try:

        attributes = object.__dict__.keys()

        attributes.sort()

    except:  # Must catch all because object might have __getattr__.

        pass

    else:

        attrdict[(key, '__dict__', len(attributes))] = attributes

    # For a class instance, get the attributes for the class.

    #print "getAllAttributeNames  7"

    try:

        klass = object.__class__

    except:  # Must catch all because object might have __getattr__.

        pass

    else:

        if klass is object or klass is type:

            # Break a circular reference. This happens with extension

            # classes.

            pass

        else:

            attrdict.update(getAllAttributeNames(klass))

    #print "getAllAttributeNames  8"

    # Also get attributes from any and all parent classes.

    try:

        bases = object.__bases__

    except:  # Must catch all because object might have __getattr__.

        pass

    else:

        if isinstance(bases, types.TupleType):

            for base in bases:

                if type(base) is types.TypeType:

                    # Break a circular reference. Happens in Python 2.2.

                    pass

                else:

                    attrdict.update(getAllAttributeNames(base))

    #print "getAllAttributeNames  attrdict=",repr(attrdict)

    return attrdict

def getCallTip(command='', locals=None):

    """For a command, return a tuple of object name, argspec, tip text.

    The call tip information will be based on the locals namespace."""

    calltip = ('', '', '')  # object name, argspec, tip text.

    # Get the proper chunk of code from the command.

    root = getRoot(command, terminator='(')

    try:

        if locals is not None:

            object = eval(root, locals)

        else:

            object = eval(root)

    except:

        return calltip

    name = ''

    object, dropSelf = getBaseObject(object)

    try:

        name = object.__name__

    except AttributeError:

        pass

    tip1 = ''

    argspec = ''

    if inspect.isbuiltin(object):

        # Builtin functions don't have an argspec that we can get.

        pass

    elif inspect.isfunction(object):

        # tip1 is a string like: "getCallTip(command='', locals=None)"

        argspec = apply(inspect.formatargspec, inspect.getargspec(object))

        if dropSelf:

            # The first parameter to a method is a reference to an

            # instance, usually coded as "self", and is usually passed

            # automatically by Python; therefore we want to drop it.

            temp = argspec.split(',')

            if len(temp) == 1:  # No other arguments.

                argspec = '()'

            else:  # Drop the first argument.

                argspec = '(' + ','.join(temp[1:]).lstrip()

        tip1 = name + argspec

    doc = ''

    if callable(object):

        doc = inspect.getdoc(object)

    if doc:

        # tip2 is the first separated line of the docstring, like:

        # "Return call tip text for a command."

        # tip3 is the rest of the docstring, like:

        # "The call tip information will be based on ... <snip>

        firstline = doc.split('\n')[0].lstrip()

        if tip1 == firstline:

            tip1 = ''

        else:

            tip1 += '\n\n'

        docpieces = doc.split('\n\n')

        tip2 = docpieces[0]

        tip3 = '\n\n'.join(docpieces[1:])

        tip = '%s%s\n\n%s' % (tip1, tip2, tip3)

    else:

        tip = tip1

    calltip = (name, argspec[1:-1], tip.strip())

    return calltip

def getRoot(command, terminator=None):

    """Return the rightmost root portion of an arbitrary Python command.

    Return only the root portion that can be eval()'d without side

    effects.  The command would normally terminate with a '(' or

    '.'. The terminator and anything after the terminator will be

    dropped."""

    command = command.split('\n')[-1]

    if command.startswith(sys.ps2):

        command = command[len(sys.ps2):]

    command = command.lstrip()

    command = rtrimTerminus(command, terminator)

    tokens = getTokens(command)

    if not tokens:

        return ''

    if tokens[-1][0] is tokenize.ENDMARKER:

        # Remove the end marker.

        del tokens[-1]

    if not tokens:

        return ''

    if terminator == '.' and \

           (tokens[-1][1] <> '.' or tokens[-1][0] is not tokenize.OP):

        # Trap decimals in numbers, versus the dot operator.

        return ''

    else:

        # Strip off the terminator.

        if terminator and command.endswith(terminator):

            size = 0 - len(terminator)

            command = command[:size]

    command = command.rstrip()

    tokens = getTokens(command)

    tokens.reverse()

    line = ''

    start = None

    prefix = ''

    laststring = '.'

    emptyTypes = ('[]', '()', '{}')

    for token in tokens:

        tokentype = token[0]

        tokenstring = token[1]

        line = token[4]

        if tokentype is tokenize.ENDMARKER:

            continue

        if tokentype in (tokenize.NAME, tokenize.STRING, tokenize.NUMBER) \

        and laststring != '.':

            # We've reached something that's not part of the root.

            if prefix and line[token[3][1]] != ' ':

                # If it doesn't have a space after it, remove the prefix.

                prefix = ''

            break

        if tokentype in (tokenize.NAME, tokenize.STRING, tokenize.NUMBER) \

        or (tokentype is tokenize.OP and tokenstring == '.'):

            if prefix:

                # The prefix isn't valid because it comes after a dot.

                prefix = ''

                break

            else:

                # start represents the last known good point in the line.

                start = token[2][1]

        elif len(tokenstring) == 1 and tokenstring in ('[({])}'):

            # Remember, we're working backwords.

            # So prefix += tokenstring would be wrong.

            if prefix in emptyTypes and tokenstring in ('[({'):

                # We've already got an empty type identified so now we

                # are in a nested situation and we can break out with

                # what we've got.

                break

            else:

                prefix = tokenstring + prefix

        else:

            # We've reached something that's not part of the root.

            break

        laststring = tokenstring

    if start is None:

        start = len(line)

    root = line[start:]

    if prefix in emptyTypes:

        # Empty types are safe to be eval()'d and introspected.

        root = prefix + root

    return root    

class _EaterTokens:

  def __init__(self,tokens):

    self.tokens = tokens

  def __call__(self,*args):

    self.tokens.append(args)

def getTokens(command):

    """Return list of token tuples for command."""

    command = str(command)  # In case the command is unicode, which fails.

    f = cStringIO.StringIO(command)

    # tokens is a list of token tuples, each looking like: 

    # (type, string, (srow, scol), (erow, ecol), line)

    tokens = []

    # Can't use list comprehension:

    #   tokens = [token for token in tokenize.generate_tokens(f.readline)]

    # because of need to append as much as possible before TokenError.

    try:

##        This code wasn't backward compatible with Python 2.1.3.

##

##        for token in tokenize.generate_tokens(f.readline):

##            tokens.append(token)

        # This works with Python 2.1.3 (with nested_scopes).

##        def eater(*args):

##            tokens.append(args)

##        tokenize.tokenize_loop(f.readline, eater)

        eater = _EaterTokens(tokens) #Con una lambda no se lo come 

        tokenize.tokenize_loop(f.readline, eater)

    except tokenize.TokenError:

        # This is due to a premature EOF, which we expect since we are

        # feeding in fragments of Python code.

        pass

    return tokens    

def rtrimTerminus(command, terminator=None):

    """Return command minus anything that follows the final terminator."""

    if terminator:

        pieces = command.split(terminator)

        if len(pieces) > 1:

            command = terminator.join(pieces[:-1]) + terminator

    return command

def getBaseObject(object):

    """Return base object and dropSelf indicator for an object."""

    if inspect.isbuiltin(object):

        # Builtin functions don't have an argspec that we can get.

        dropSelf = 0

    elif inspect.ismethod(object):

        # Get the function from the object otherwise

        # inspect.getargspec() complains that the object isn't a

        # Python function.

        try:

            if object.im_self is None:

                # This is an unbound method so we do not drop self

                # from the argspec, since an instance must be passed

                # as the first arg.

                dropSelf = 0

            else:

                dropSelf = 1

            object = object.im_func

        except AttributeError:

            dropSelf = 0

    elif inspect.isclass(object):

        # Get the __init__ method function for the class.

        constructor = getConstructor(object)

        if constructor is not None:

            object = constructor

            dropSelf = 1

        else:

            dropSelf = 0

    elif callable(object):

        # Get the __call__ method instead.

        try:

            call_method = object.__call__.im_func

            if call_method.__name__ == '__call__':

                # unbound jython method end up here, example: string.index(

                dropSelf = 0

            else:

                object = call_method

                dropSelf = 1

        except AttributeError:

            # unbound python methods end up here

            dropSelf = 0

    else:

        dropSelf = 0

    return object, dropSelf

def getConstructor(object):

    """Return constructor for class object, or None if there isn't one."""

    try:

        return object.__init__.im_func

    except AttributeError:

        for base in object.__bases__:

            constructor = getConstructor(base)

            if constructor is not None:

                return constructor

    return None

==========================

Known problems

==========================

You must use the keyboard not the mouse to select methods.  (Due to focus problems.)

python.security.respectJavaAccessibility must be set to true in Jython's registry

You can't insert '(' and ')' in the middle of a line

Method popup displays names multiple times for overloaded methods

Method popup gets abandoned with too many backspaces.  (Use <ESC> to make it go away)

Builtin types don't work, like they do in PyCrust.  This is because they have a null __doc__ string in Jython.

Static methods and properties don't seem to work correctly.

<CTRL>+D (or <CRTL>+Z) to exit is not implemented

History doesn't quite work correctly

$Id: problems.txt 5782 2006-06-12 07:56:49Z jmvivo $

import unittest

import introspect

class IntrospectTestCase(unittest.TestCase):

    def testUnboundMethod(self):

        import string

        method = 'string.index('

        (name, argspec, tip) = introspect.getCallTip(method, locals())

        self.assertEquals('index', name)

        self.assertEquals('s, *args', argspec)

        self.assertEquals('index(s, *args)\n\nindex(s, sub [,start [,end]]) -> int\n\nLike find but raises ValueError when the substring is not found.', tip)

    def testBuiltinFunction(self):

        method = 'len('

        print introspect.getCallTip(method, locals())

        (name, argspec, tip) = introspect.getCallTip(method, locals())

        self.assertEquals('len', name)

        # next 2 assertions fail in Jython!

        self.assertEquals('len(object) -> integer', argspec)

        self.assertEquals('len(object) -> integer\n\nReturn the number of items of a sequence or mapping', tip)

if __name__ == '__main__':

    unittest.main()

from java.awt import Color, Dimension

from javax.swing import JWindow, JTextArea, JScrollPane

__author__ = "Don Coleman <dcoleman@chariotsolutions.com>"

__cvsid__ = "$Id: tip.py 5782 2006-06-12 07:56:49Z jmvivo $"

class Tip(JWindow):

    """

    Window which provides the user with information about the method

    For Python, this shows arguments, and the documention

    For Java, this shows the signature(s) and return type

    """

    # TODO handle java methods with many overload more gracefully

    MAX_HEIGHT = 300

    MAX_WIDTH = 400

    def __init__(self, frame):

        JWindow.__init__(self, frame)

        #self.size = (300,150)

        self.textarea = JTextArea()

        # TODO put this color with all the other colors

        self.textarea.setBackground(Color(225,255,255))

        self.textarea.setEditable(0)

        self.jscrollpane = JScrollPane(self.textarea)

        self.getContentPane().add(self.jscrollpane)

    def setText(self, tip):

        self.textarea.setText(tip)

        self.textarea.setCaretPosition(0)

        #print >> sys.stderr, self.textarea.getPreferredScrollableViewportSize()

        self.setSize(self.getPreferredSize())

    def getPreferredSize(self):

        # need to add a magic amount to the size to avoid scrollbars

        # I'm sure there's a better way to do this

        MAGIC = 20

        size = self.textarea.getPreferredScrollableViewportSize()

        height = size.height + MAGIC

        width = size.width + MAGIC

        if height > Tip.MAX_HEIGHT:

            height = Tip.MAX_HEIGHT

        if width > Tip.MAX_WIDTH:

            width = Tip.MAX_WIDTH

        return Dimension(width, height)

"""Disassembler of Python byte code into mnemonics."""

import sys

import types

__all__ = ["dis","disassemble","distb","disco","opname","cmp_op",

           "hasconst","hasname","hasjrel","hasjabs","haslocal",

           "hascompare", "hasfree"]

def dis(x=None):

    """Disassemble classes, methods, functions, or code.

    With no argument, disassemble the last traceback.

    """

    if not x:

        distb()

        return

    if type(x) is types.InstanceType:

        x = x.__class__

    if hasattr(x, 'im_func'):

        x = x.im_func

    if hasattr(x, 'func_code'):

        x = x.func_code

    if hasattr(x, '__dict__'):

        items = x.__dict__.items()

        items.sort()

        for name, x1 in items:

            if type(x1) in (types.MethodType,

                            types.FunctionType,

                            types.CodeType):

                print "Disassembly of %s:" % name

                try:

                    dis(x1)

                except TypeError, msg:

                    print "Sorry:", msg

                print

    elif hasattr(x, 'co_code'):

        disassemble(x)

    else:

        raise TypeError, \

              "don't know how to disassemble %s objects" % \

              type(x).__name__

def distb(tb=None):

    """Disassemble a traceback (default: last traceback)."""

    if not tb:

        try:

            tb = sys.last_traceback

        except AttributeError:

            raise RuntimeError, "no last traceback to disassemble"

        while tb.tb_next: tb = tb.tb_next

    disassemble(tb.tb_frame.f_code, tb.tb_lasti)

def disassemble(co, lasti=-1):

    """Disassemble a code object."""

    code = co.co_code

    labels = findlabels(code)

    n = len(code)

    i = 0

    extended_arg = 0

    free = None

    while i < n:

        c = code[i]

        op = ord(c)

        if op == SET_LINENO and i > 0: print # Extra blank line

        if i == lasti: print '-->',

        else: print '   ',

        if i in labels: print '>>',

        else: print '  ',

        print `i`.rjust(4),

        print opname[op].ljust(20),

        i = i+1

        if op >= HAVE_ARGUMENT:

            oparg = ord(code[i]) + ord(code[i+1])*256 + extended_arg

            extended_arg = 0

            i = i+2

            if op == EXTENDED_ARG:

                extended_arg = oparg*65536L

            print `oparg`.rjust(5),

            if op in hasconst:

                print '(' + `co.co_consts[oparg]` + ')',

            elif op in hasname:

                print '(' + co.co_names[oparg] + ')',

            elif op in hasjrel:

                print '(to ' + `i + oparg` + ')',

            elif op in haslocal:

                print '(' + co.co_varnames[oparg] + ')',

            elif op in hascompare:

                print '(' + cmp_op[oparg] + ')',

            elif op in hasfree:

                if free is None:

                    free = co.co_cellvars + co.co_freevars

                print '(' + free[oparg] + ')',

        print

disco = disassemble                     # XXX For backwards compatibility

def findlabels(code):

    """Detect all offsets in a byte code which are jump targets.

    Return the list of offsets.

    """

    labels = []

    n = len(code)

    i = 0

    while i < n:

        c = code[i]

        op = ord(c)

        i = i+1

        if op >= HAVE_ARGUMENT:

            oparg = ord(code[i]) + ord(code[i+1])*256

            i = i+2

            label = -1

            if op in hasjrel:

                label = i+oparg

            elif op in hasjabs:

                label = oparg

            if label >= 0:

                if label not in labels:

                    labels.append(label)

    return labels

cmp_op = ('<', '<=', '==', '!=', '>', '>=', 'in', 'not in', 'is',

        'is not', 'exception match', 'BAD')

hasconst = []

hasname = []

hasjrel = []

hasjabs = []

haslocal = []

hascompare = []

hasfree = []

opname = [''] * 256

for op in range(256): opname[op] = '<' + `op` + '>'

def def_op(name, op):

    opname[op] = name

def name_op(name, op):

    opname[op] = name

    hasname.append(op)

def jrel_op(name, op):

    opname[op] = name

    hasjrel.append(op)

def jabs_op(name, op):

    opname[op] = name

    hasjabs.append(op)

# Instruction opcodes for compiled code

def_op('STOP_CODE', 0)

def_op('POP_TOP', 1)

def_op('ROT_TWO', 2)

def_op('ROT_THREE', 3)

def_op('DUP_TOP', 4)

def_op('ROT_FOUR', 5)

def_op('UNARY_POSITIVE', 10)

def_op('UNARY_NEGATIVE', 11)

def_op('UNARY_NOT', 12)

def_op('UNARY_CONVERT', 13)

def_op('UNARY_INVERT', 15)

def_op('BINARY_POWER', 19)

def_op('BINARY_MULTIPLY', 20)

def_op('BINARY_DIVIDE', 21)

def_op('BINARY_MODULO', 22)

def_op('BINARY_ADD', 23)

def_op('BINARY_SUBTRACT', 24)

def_op('BINARY_SUBSCR', 25)

def_op('BINARY_FLOOR_DIVIDE', 26)

def_op('BINARY_TRUE_DIVIDE', 27)

def_op('INPLACE_FLOOR_DIVIDE', 28)

def_op('INPLACE_TRUE_DIVIDE', 29)

def_op('SLICE+0', 30)

def_op('SLICE+1', 31)

def_op('SLICE+2', 32)

def_op('SLICE+3', 33)

def_op('STORE_SLICE+0', 40)

def_op('STORE_SLICE+1', 41)

def_op('STORE_SLICE+2', 42)

def_op('STORE_SLICE+3', 43)

def_op('DELETE_SLICE+0', 50)

def_op('DELETE_SLICE+1', 51)

def_op('DELETE_SLICE+2', 52)

def_op('DELETE_SLICE+3', 53)

def_op('INPLACE_ADD', 55)

def_op('INPLACE_SUBTRACT', 56)

def_op('INPLACE_MULTIPLY', 57)