# -*- coding: iso-8859-1 -*-
"""
    MoinMoin - HelpOn Action Macro

    PURPOSE:
        This action macro is used to get help on an other extensions

    CALLING SEQUENCE:
        http://WikiServer/WikiName?action=HelpOn

    PROCEDURE:
       You get a pull down list of available extensions and after selection 
       the help from inside of the routine is shown
       
       The extensions below the MoinMoin path are indicated by the prefix MM- 
       While the others are indicated by a W- in the list

       Please remove the version number from the filename.

    MODIFICATION HISTORY:
        @copyright: 2005 by Reimar Bauer (R.Bauer@fz-juelich.de)
        @license: GNU GPL, see COPYING for details.
        Version: 1.3.5-1
        
        1.3.5-2 bug fix if no routine desription is defined
                minor change from table output to preformatted text
                
        1.3.5-3 code refactored      
        1.3.5-4 PRE does not need an additional line break
    
"""

import string, codecs, os
from MoinMoin import config, wikiutil, wikiaction, user,  macro, action, parser
from MoinMoin.Page import Page
from MoinMoin.formatter.text_html import Formatter

def HelpOn_Extract_Help(module_path_name,module_name):
   file = codecs.open(module_path_name, 'r')
   lines = file.readlines()
   file.close()
   
   index=[]
   i = 0
   for line in lines:
       if line.strip() == '"""' :
           index.append(i)
       i+=1
   
   if len(index)  >= 2 :          
      txt = lines[(index[0])+1:index[1]]     
   else :
      txt = ["no help available for %(name)s" % {"name": module_name}]

   return (txt)

def HelpOn(request,pagename,module):

    request.formatter = Formatter(request)
    
    mod = module.split(':')
    module_type = mod[0]
    
    this_type= module_type.split('-')
    
    module_type = this_type[1]
    module_name = mod[1]
    
    if this_type[0] == 'MM' :
   
       module_path_name = "%(path)s/%(module_type)s/%(name)s.py" % {
            "module_type": module_type,
            "path" : request.cfg.moinmoin_dir,
            "name" : module_name }
       
    if this_type[0] == 'W' :      
       module_path_name = "%(path)s/plugin/%(module_type)s/%(name)s.py" % {
            "module_type": module_type,
            "path" : request.cfg.data_dir,
            "name" : module_name }
       
    info = HelpOn_Extract_Help(module_path_name,module)   
    html = "<PRE>%(txt)s</PRE>" % {
        "txt" : string.join(info)}
    
    request.http_headers()
    request.setContentLanguage(request.lang)
    wikiutil.send_title(request, pagename,
                        pagename=pagename)
    request.write(request.formatter.startContent("content"))
    
    request.write(html)
    request.write(request.formatter.endContent())
    wikiutil.send_footer(request, pagename)
    msg = None
    
    if msg:
        AttachFile.error_msg(pagename, request, msg)

    return()
 
    
def execute(pagename, request):

    _ = request.getText
    actname = __name__.split('.')[-1]
   
    thispage = Page(request,pagename)

    if request.form.has_key('button') and request.form.has_key('ticket'):
        # check whether this is a valid ticket request (make outside
        # attacks harder by requiring two full HTTP transactions)
       if not wikiutil.checkTicket(request.form['ticket'][0]) :
           return thispage.send_page(request,
                  msg = _('Please use the interactive user interface for HelpOn extensions!'))

       module = request.form.get('helpon', [u''])[0]
            
       return (HelpOn(request,pagename,module))
            
            
    html = []    
    for name in action.extension_actions :
        if not name in request.cfg.excluded_actions:
            html.append("<OPTION>MM-action:%(name)s</OPTION>" % { "name":name}) 
    for name in wikiaction.getPlugins(request)[1]: 
        html.append("<OPTION>W-action:%(name)s</OPTION>" % { "name":name}) 
        
    for name in macro.extension_macros :
        html.append("<OPTION>MM-macro:%(name)s</OPTION>" % { "name":name})  
            
    for name in wikiutil.wikiPlugins('macro', request.cfg):
        html.append("<OPTION>W-macro:%(name)s</OPTION>" % { "name":name})    
        
    for name in  parser.modules : 
        html.append("<OPTION>MM-parser:%(name)s</OPTION>" % { "name":name})  
             
    for name in wikiutil.wikiPlugins('parser', request.cfg):
        html.append("<OPTION>W-parser:%(name)s</OPTION>" % { "name":name})      

 
    formhtml = '''
<form method="post" action="">
<select name="helpon" size="1">
%(option)s
</select>
<input type="hidden" name="action" value="%(actname)s">
<input type="submit" name="button" value="%(button)s">
<input type="hidden" name="ticket" value="%(ticket)s">
<p>
</form>''' % {
    'actname': 'HelpOn',
    'ticket' : wikiutil.createTicket(),
    'option' : string.join(html),
    'button' : 'Help'}

    return thispage.send_page(request, msg=formhtml)