gnatstudio/examples/python/methods.py

## This script adds a contextual menu when you click on an Ada tagged
## type or C++ class (or an instance of these).
## The submenu will list all the primitive operations (aka methods) of
## that object, and clicking on any of these will jump to the body of
## that operation.
## Worth noting in this example is the way the list of methods is
## computed only once, and then stored in the context for later
## reuse.
## Also worth noting is how a dynamic contextual menu is created, and
## can be set up to properly handle overloaded submenu entries, as might
## happen when several methods have the same name.

import GPS

class Methods_Contextual (GPS.Contextual):
  def __init__ (self):
     GPS.Contextual.__init__ (self, "Methods")
     self.create_dynamic (on_activate = self.on_activate,
                          label       = "References/Methods of %e",
                          filter      = self.filter,
                          factory     = self.factory)

  def filter (self, context):
     ## Store the methods in the context, so that we do not have to
     ## recompute them if the menu is selected, and so that we can
     ## handle overriden methods as well
     if isinstance (context, GPS.EntityContext) and context.entity():
        context.methods_list = context.entity().methods()
        context.methods_list.sort()
        return context.methods_list != []
     else:
        return False

  def factory (self, context):
     return [m.name() for m in context.methods_list]

  def on_activate (self, context, choice, choice_index):
     decl = context.methods_list [choice_index].body()
     buffer = GPS.EditorBuffer.get (decl.file())
     buffer.current_view().goto \
        (GPS.EditorLocation (buffer, decl.line(), decl.column()))

Methods_Contextual()