src/stc/gen_iface.py

   1 #!/usr/bin/env python
   2 #----------------------------------------------------------------------------
   3 # Name:         gen_iface.py
   4 # Purpose:      Generate stc.h and stc.cpp from the info in Scintilla.iface
   5 #
   6 # Author:       Robin Dunn
   7 #
   8 # Created:      5-Sept-2000
   9 # RCS-ID:       $Id$
  10 # Copyright:    (c) 2000 by Total Control Software
  11 # Licence:      wxWindows licence
  12 #----------------------------------------------------------------------------
  13
  14
  15 import sys, string, re, os
  16 from fileinput import FileInput
  17
  18
  19 IFACE         = os.path.abspath('./scintilla/include/Scintilla.iface')
  20 H_TEMPLATE    = os.path.abspath('./stc.h.in')
  21 CPP_TEMPLATE  = os.path.abspath('./stc.cpp.in')
  22 H_DEST        = os.path.abspath('../../include/wx/stc/stc.h')
  23 CPP_DEST      = os.path.abspath('./stc.cpp')
  24 if len(sys.argv) > 1 and sys.argv[1] == '--wxpython':
  25     DOCSTR_DEST   = os.path.abspath('../../../wxPython/src/_stc_gendocs.i')
  26 else:
  27     DOCSTR_DEST   = '/dev/null'
  28
  29
  30 # Value prefixes to convert
  31 valPrefixes = [('SCI_', ''),
  32                ('SC_',  ''),
  33                ('SCN_', None),  # just toss these out...
  34                ('SCEN_', None),
  35                ('SC_EFF', None),
  36                ('SCE_', ''),
  37                ('SCLEX_', 'LEX_'),
  38                ('SCK_', 'KEY_'),
  39                ('SCFIND_', 'FIND_'),
  40                ('SCWS_', 'WS_'),
  41 ]
  42
  43 # Message function values that should have a CMD_ constant generated
  44 cmdValues = [ 2011,
  45               2013,
  46               (2176, 2180),
  47               (2300, 2349),
  48               (2390, 2393),
  49               (2395, 2396),
  50               2404,
  51               (2413, 2416),
  52               (2426, 2442),
  53               (2450, 2455),
  54               2518,
  55             ]
  56
  57
  58 # Should a funciton be also generated for the CMDs?
  59 FUNC_FOR_CMD = 1
  60
  61
  62 # Map some generic typenames to wx types, using return value syntax
  63 retTypeMap = {
  64     'position': 'int',
  65     'string':   'wxString',
  66     'colour':   'wxColour',
  67     }
  68
  69 # Map some generic typenames to wx types, using parameter syntax
  70 paramTypeMap = {
  71     'position': 'int',
  72     'string':   'const wxString&',
  73     'colour':   'const wxColour&',
  74     'keymod':   'int',
  75 }
  76
  77 # Map of method info that needs tweaked.  Either the name needs changed, or
  78 # the method definition/implementation.  Tuple items are:
  79 #
  80 #         1. New method name.  None to skip the method, 0 to leave the
  81 #            default name.
  82 #         2. Method definition for the .h file, 0 to leave alone
  83 #         3. Method implementation for the .cpp file, 0 to leave alone.
  84 #         4. tuple of Doc string lines, or 0 to leave alone.
  85 #
  86 methodOverrideMap = {
  87     'AddText' : (0,
  88                  'void %s(const wxString& text);',
  89
  90                  '''void %s(const wxString& text) {
  91                     const wxWX2MBbuf buf = wx2stc(text);
  92                     SendMsg(%s, wx2stclen(text, buf), (sptr_t)(const char*)buf);''',
  93                  0),
  94
  95     'AddStyledText' : (0,
  96                        'void %s(const wxMemoryBuffer& data);',
  97
  98                        '''void %s(const wxMemoryBuffer& data) {
  99                           SendMsg(%s, data.GetDataLen(), (sptr_t)data.GetData());''',
 100                        0),
 101
 102     'AppendText' : (0,
 103                  'void %s(const wxString& text);',
 104
 105                  '''void %s(const wxString& text) {
 106                     const wxWX2MBbuf buf = wx2stc(text);
 107                     SendMsg(%s, wx2stclen(text, buf), (sptr_t)(const char*)buf);''',
 108                  0),
 109
 110     'GetViewWS' : ( 'GetViewWhiteSpace', 0, 0, 0),
 111     'SetViewWS' : ( 'SetViewWhiteSpace', 0, 0, 0),
 112
 113     'GetCharAt' :
 114     ( 0, 0,
 115       '''int %s(int pos) const {
 116          return (unsigned char)SendMsg(%s, pos, 0);''',
 117       0),
 118
 119     'GetStyleAt' :
 120     ( 0, 0,
 121       '''int %s(int pos) const {
 122          return (unsigned char)SendMsg(%s, pos, 0);''',
 123       0),
 124
 125     'GetStyledText' :
 126     (0,
 127      'wxMemoryBuffer %s(int startPos, int endPos);',
 128
 129      '''wxMemoryBuffer %s(int startPos, int endPos) {
 130         wxMemoryBuffer buf;
 131         if (endPos < startPos) {
 132             int temp = startPos;
 133             startPos = endPos;
 134             endPos = temp;
 135         }
 136         int len = endPos - startPos;
 137         if (!len) return buf;
 138         TextRange tr;
 139         tr.lpstrText = (char*)buf.GetWriteBuf(len*2+1);
 140         tr.chrg.cpMin = startPos;
 141         tr.chrg.cpMax = endPos;
 142         len = SendMsg(%s, 0, (sptr_t)&tr);
 143         buf.UngetWriteBuf(len);
 144         return buf;''',
 145
 146      ('Retrieve a buffer of cells.',)),
 147
 148
 149     'PositionFromPoint' :
 150     (0,
 151      'int %s(wxPoint pt) const;',
 152
 153      '''int %s(wxPoint pt) const {
 154         return SendMsg(%s, pt.x, pt.y);''',
 155      0),
 156
 157     'GetCurLine' :
 158     (0,
 159      '#ifdef SWIG\n    wxString %s(int* OUTPUT);\n#else\n    wxString GetCurLine(int* linePos=NULL);\n#endif',
 160
 161         '''wxString %s(int* linePos) {
 162         int len = LineLength(GetCurrentLine());
 163         if (!len) {
 164             if (linePos)  *linePos = 0;
 165             return wxEmptyString;
 166         }
 167
 168         wxMemoryBuffer mbuf(len+1);
 169         char* buf = (char*)mbuf.GetWriteBuf(len+1);
 170
 171         int pos = SendMsg(%s, len+1, (sptr_t)buf);
 172         mbuf.UngetWriteBuf(len);
 173         mbuf.AppendByte(0);
 174         if (linePos)  *linePos = pos;
 175         return stc2wx(buf);''',
 176
 177      0),
 178
 179     'SetUsePalette' : (None, 0,0,0),
 180
 181     'MarkerSetFore' : ('MarkerSetForeground', 0, 0, 0),
 182     'MarkerSetBack' : ('MarkerSetBackground', 0, 0, 0),
 183
 184     'MarkerSymbolDefined' : ('GetMarkerSymbolDefined', 0, 0, 0),
 185
 186     'MarkerDefine' :
 187     (0,
 188      '''void %s(int markerNumber, int markerSymbol,
 189                 const wxColour& foreground = wxNullColour,
 190                 const wxColour& background = wxNullColour);''',
 191
 192      '''void %s(int markerNumber, int markerSymbol,
 193                 const wxColour& foreground,
 194                 const wxColour& background) {
 195
 196                 SendMsg(%s, markerNumber, markerSymbol);
 197                 if (foreground.IsOk())
 198                     MarkerSetForeground(markerNumber, foreground);
 199                 if (background.IsOk())
 200                     MarkerSetBackground(markerNumber, background);''',
 201
 202      ('Set the symbol used for a particular marker number,',
 203       'and optionally the fore and background colours.')),
 204
 205
 206     'MarkerDefinePixmap' :
 207     ('MarkerDefineBitmap',
 208      '''void %s(int markerNumber, const wxBitmap& bmp);''',
 209      '''void %s(int markerNumber, const wxBitmap& bmp) {
 210         // convert bmp to a xpm in a string
 211         wxMemoryOutputStream strm;
 212         wxImage img = bmp.ConvertToImage();
 213         if (img.HasAlpha())
 214             img.ConvertAlphaToMask();
 215         img.SaveFile(strm, wxBITMAP_TYPE_XPM);
 216         size_t len = strm.GetSize();
 217         char* buff = new char[len+1];
 218         strm.CopyTo(buff, len);
 219         buff[len] = 0;
 220         SendMsg(%s, markerNumber, (sptr_t)buff);
 221         delete [] buff;
 222         ''',
 223      ('Define a marker from a bitmap',)),
 224
 225
 226     'SetMarginTypeN' : ('SetMarginType', 0, 0, 0),
 227     'GetMarginTypeN' : ('GetMarginType', 0, 0, 0),
 228     'SetMarginWidthN' : ('SetMarginWidth', 0, 0, 0),
 229     'GetMarginWidthN' : ('GetMarginWidth', 0, 0, 0),
 230     'SetMarginMaskN' : ('SetMarginMask', 0, 0, 0),
 231     'GetMarginMaskN' : ('GetMarginMask', 0, 0, 0),
 232     'SetMarginSensitiveN' : ('SetMarginSensitive', 0, 0, 0),
 233     'GetMarginSensitiveN' : ('GetMarginSensitive', 0, 0, 0),
 234
 235     'MarginGetText' :
 236     (0,
 237     'wxString %s(int line) const;',
 238
 239      '''wxString %s(int line) const {
 240          long msg = %s;
 241          long len = SendMsg(msg, line, 0);
 242
 243          wxMemoryBuffer mbuf(len+1);
 244          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 245          SendMsg(msg, line, (sptr_t)buf);
 246          mbuf.UngetWriteBuf(len);
 247          mbuf.AppendByte(0);
 248          return stc2wx(buf);''',
 249      0),
 250
 251      'MarginGetStyles' :
 252      (0,
 253     'wxString %s(int line) const;',
 254
 255      '''wxString %s(int line) const {
 256          long msg = %s;
 257          long len = SendMsg(msg, line, 0);
 258
 259          wxMemoryBuffer mbuf(len+1);
 260          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 261          SendMsg(msg, line, (sptr_t)buf);
 262          mbuf.UngetWriteBuf(len);
 263          mbuf.AppendByte(0);
 264          return stc2wx(buf);''',
 265      0),
 266
 267     'SetAdditionalSelFore' : ('SetAdditionalSelForeground', 0, 0, 0),
 268     'SetAdditionalSelBack' : ('SetAdditionalSelBackground', 0, 0, 0),
 269     'SetAdditionalCaretFore' : ('SetAdditionalCaretForeground', 0, 0, 0),
 270     'GetAdditionalCaretFore' : ('GetAdditionalCaretForeground', 0, 0, 0),
 271
 272     'AnnotationGetText' :
 273     (0,
 274     'wxString %s(int line) const;',
 275
 276      '''wxString %s(int line) const {
 277          long msg = %s;
 278          long len = SendMsg(msg, line, 0);
 279
 280          wxMemoryBuffer mbuf(len+1);
 281          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 282          SendMsg(msg, line, (sptr_t)buf);
 283          mbuf.UngetWriteBuf(len);
 284          mbuf.AppendByte(0);
 285          return stc2wx(buf);''',
 286      0),
 287
 288     'AnnotationGetStyles' :
 289     (0,
 290     'wxString %s(int line) const;',
 291
 292      '''wxString %s(int line) const {
 293          long msg = %s;
 294          long len = SendMsg(msg, line, 0);
 295
 296          wxMemoryBuffer mbuf(len+1);
 297          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 298          SendMsg(msg, line, (sptr_t)buf);
 299          mbuf.UngetWriteBuf(len);
 300          mbuf.AppendByte(0);
 301          return stc2wx(buf);''',
 302      0),
 303
 304     'StyleGetFore' : ('StyleGetForeground', 0, 0, 0),
 305     'StyleGetBack' : ('StyleGetBackground', 0, 0, 0),
 306     'StyleSetFore' : ('StyleSetForeground', 0, 0, 0),
 307     'StyleSetBack' : ('StyleSetBackground', 0, 0, 0),
 308     'SetSelFore' : ('SetSelForeground', 0, 0, 0),
 309     'SetSelBack' : ('SetSelBackground', 0, 0, 0),
 310     'SetCaretFore' : ('SetCaretForeground', 0, 0, 0),
 311     'StyleGetFont' :
 312     ('StyleGetFaceName',
 313      'wxString %s(int style);',
 314       '''wxString %s(int style) {
 315          long msg = %s;
 316          long len = SendMsg(msg, style, 0);
 317          wxMemoryBuffer mbuf(len+1);
 318          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 319          SendMsg(msg, style, (sptr_t)buf);
 320          mbuf.UngetWriteBuf(len);
 321          mbuf.AppendByte(0);
 322          return stc2wx(buf);''',
 323          ('Get the font facename of a style',)),
 324     'StyleSetFont' : ('StyleSetFaceName', 0, 0, 0),
 325     'StyleSetCharacterSet' : (None, 0, 0, 0),
 326
 327     'AssignCmdKey' :
 328     ('CmdKeyAssign',
 329      'void %s(int key, int modifiers, int cmd);',
 330
 331      '''void %s(int key, int modifiers, int cmd) {
 332          SendMsg(%s, MAKELONG(key, modifiers), cmd);''',
 333      0),
 334
 335
 336     'ClearCmdKey' :
 337     ('CmdKeyClear',
 338      'void %s(int key, int modifiers);',
 339
 340      '''void %s(int key, int modifiers) {
 341          SendMsg(%s, MAKELONG(key, modifiers));''',
 342      0),
 343
 344     'ClearAllCmdKeys' : ('CmdKeyClearAll', 0, 0, 0),
 345
 346
 347     'SetStylingEx' :
 348     ('SetStyleBytes',
 349      'void %s(int length, char* styleBytes);',
 350
 351      '''void %s(int length, char* styleBytes) {
 352         SendMsg(%s, length, (sptr_t)styleBytes);''',
 353      0),
 354
 355
 356     'IndicSetAlpha' : ('IndicatorSetAlpha', 0, 0, 0),
 357     'IndicGetAlpha' : ('IndicatorGetAlpha', 0, 0, 0),
 358     'IndicSetStyle' : ('IndicatorSetStyle', 0, 0, 0),
 359     'IndicGetStyle' : ('IndicatorGetStyle', 0, 0, 0),
 360     'IndicSetFore' : ('IndicatorSetForeground', 0, 0, 0),
 361     'IndicGetFore' : ('IndicatorGetForeground', 0, 0, 0),
 362     'IndicSetUnder': ('IndicatorSetUnder', 0, 0, 0),
 363     'IndicGetUnder': ('IndicatorGetUnder', 0, 0, 0),
 364
 365     'SetWhitespaceFore' : ('SetWhitespaceForeground', 0, 0, 0),
 366     'SetWhitespaceBack' : ('SetWhitespaceBackground', 0, 0, 0),
 367
 368     'AutoCShow' : ('AutoCompShow', 0, 0, 0),
 369     'AutoCCancel' : ('AutoCompCancel', 0, 0, 0),
 370     'AutoCActive' : ('AutoCompActive', 0, 0, 0),
 371     'AutoCPosStart' : ('AutoCompPosStart', 0, 0, 0),
 372     'AutoCComplete' : ('AutoCompComplete', 0, 0, 0),
 373     'AutoCStops' : ('AutoCompStops', 0, 0, 0),
 374     'AutoCSetSeparator' : ('AutoCompSetSeparator', 0, 0, 0),
 375     'AutoCGetSeparator' : ('AutoCompGetSeparator', 0, 0, 0),
 376     'AutoCSelect' : ('AutoCompSelect', 0, 0, 0),
 377     'AutoCSetCancelAtStart' : ('AutoCompSetCancelAtStart', 0, 0, 0),
 378     'AutoCGetCancelAtStart' : ('AutoCompGetCancelAtStart', 0, 0, 0),
 379     'AutoCSetFillUps' : ('AutoCompSetFillUps', 0, 0, 0),
 380     'AutoCSetChooseSingle' : ('AutoCompSetChooseSingle', 0, 0, 0),
 381     'AutoCGetChooseSingle' : ('AutoCompGetChooseSingle', 0, 0, 0),
 382     'AutoCSetIgnoreCase' : ('AutoCompSetIgnoreCase', 0, 0, 0),
 383     'AutoCGetIgnoreCase' : ('AutoCompGetIgnoreCase', 0, 0, 0),
 384     'AutoCSetAutoHide' : ('AutoCompSetAutoHide', 0, 0, 0),
 385     'AutoCGetAutoHide' : ('AutoCompGetAutoHide', 0, 0, 0),
 386     'AutoCSetDropRestOfWord' : ('AutoCompSetDropRestOfWord', 0,0,0),
 387     'AutoCGetDropRestOfWord' : ('AutoCompGetDropRestOfWord', 0,0,0),
 388     'AutoCGetTypeSeparator' : ('AutoCompGetTypeSeparator', 0, 0, 0),
 389     'AutoCSetTypeSeparator' : ('AutoCompSetTypeSeparator', 0, 0, 0),
 390     'AutoCGetCurrent'       : ('AutoCompGetCurrent', 0, 0, 0),
 391     'AutoCGetCurrentText'   : (None, 0, 0, 0),
 392     'AutoCSetMaxWidth'      : ('AutoCompSetMaxWidth', 0, 0, 0),
 393     'AutoCGetMaxWidth'      : ('AutoCompGetMaxWidth', 0, 0, 0),
 394     'AutoCSetMaxHeight'     : ('AutoCompSetMaxHeight', 0, 0, 0),
 395     'AutoCGetMaxHeight'     : ('AutoCompGetMaxHeight', 0, 0, 0),
 396     'AutoCGetMaxHeight'     : ('AutoCompGetMaxHeight', 0, 0, 0),
 397
 398     'RegisterImage' :
 399     (0,
 400      '''void %s(int type, const wxBitmap& bmp);''',
 401      '''void %s(int type, const wxBitmap& bmp) {
 402         // convert bmp to a xpm in a string
 403         wxMemoryOutputStream strm;
 404         wxImage img = bmp.ConvertToImage();
 405         if (img.HasAlpha())
 406             img.ConvertAlphaToMask();
 407         img.SaveFile(strm, wxBITMAP_TYPE_XPM);
 408         size_t len = strm.GetSize();
 409         char* buff = new char[len+1];
 410         strm.CopyTo(buff, len);
 411         buff[len] = 0;
 412         SendMsg(%s, type, (sptr_t)buff);
 413         delete [] buff;
 414      ''',
 415      ('Register an image for use in autocompletion lists.',)),
 416
 417
 418     'ClearRegisteredImages' : (0, 0, 0,
 419                                ('Clear all the registered images.',)),
 420
 421
 422     'SetHScrollBar' : ('SetUseHorizontalScrollBar', 0, 0, 0),
 423     'GetHScrollBar' : ('GetUseHorizontalScrollBar', 0, 0, 0),
 424
 425     'SetVScrollBar' : ('SetUseVerticalScrollBar', 0, 0, 0),
 426     'GetVScrollBar' : ('GetUseVerticalScrollBar', 0, 0, 0),
 427
 428     'GetCaretFore' : ('GetCaretForeground', 0, 0, 0),
 429
 430     'GetUsePalette' : (None, 0, 0, 0),
 431
 432     'FindText' :
 433     (0,
 434      '''int %s(int minPos, int maxPos, const wxString& text, int flags=0);''',
 435
 436      '''int %s(int minPos, int maxPos,
 437                const wxString& text,
 438                int flags) {
 439             TextToFind  ft;
 440             ft.chrg.cpMin = minPos;
 441             ft.chrg.cpMax = maxPos;
 442             const wxWX2MBbuf buf = wx2stc(text);
 443             ft.lpstrText = (char*)(const char*)buf;
 444
 445             return SendMsg(%s, flags, (sptr_t)&ft);''',
 446      0),
 447
 448     'FormatRange' :
 449     (0,
 450      '''int %s(bool   doDraw,
 451                int    startPos,
 452                int    endPos,
 453                wxDC*  draw,
 454                wxDC*  target,
 455                wxRect renderRect,
 456                wxRect pageRect);''',
 457      ''' int %s(bool   doDraw,
 458                 int    startPos,
 459                 int    endPos,
 460                 wxDC*  draw,
 461                 wxDC*  target,
 462                 wxRect renderRect,
 463                 wxRect pageRect) {
 464              RangeToFormat fr;
 465
 466              if (endPos < startPos) {
 467                  int temp = startPos;
 468                  startPos = endPos;
 469                  endPos = temp;
 470              }
 471              fr.hdc = draw;
 472              fr.hdcTarget = target;
 473              fr.rc.top = renderRect.GetTop();
 474              fr.rc.left = renderRect.GetLeft();
 475              fr.rc.right = renderRect.GetRight();
 476              fr.rc.bottom = renderRect.GetBottom();
 477              fr.rcPage.top = pageRect.GetTop();
 478              fr.rcPage.left = pageRect.GetLeft();
 479              fr.rcPage.right = pageRect.GetRight();
 480              fr.rcPage.bottom = pageRect.GetBottom();
 481              fr.chrg.cpMin = startPos;
 482              fr.chrg.cpMax = endPos;
 483
 484              return SendMsg(%s, doDraw, (sptr_t)&fr);''',
 485      0),
 486
 487
 488     'GetLine' :
 489     (0,
 490      'wxString %s(int line) const;',
 491
 492      '''wxString %s(int line) const {
 493          int len = LineLength(line);
 494          if (!len) return wxEmptyString;
 495
 496          wxMemoryBuffer mbuf(len+1);
 497          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 498          SendMsg(%s, line, (sptr_t)buf);
 499          mbuf.UngetWriteBuf(len);
 500          mbuf.AppendByte(0);
 501          return stc2wx(buf);''',
 502
 503      ('Retrieve the contents of a line.',)),
 504
 505     'SetSel' : (None, 0,0,0), #'SetSelection', 0, 0, 0),
 506
 507     'GetSelText' :
 508     ('GetSelectedText',
 509      'wxString %s();',
 510
 511      '''wxString %s() {
 512          const int len = SendMsg(SCI_GETSELTEXT, 0, (sptr_t)0);
 513          if (!len) return wxEmptyString;
 514
 515          wxMemoryBuffer mbuf(len+2);
 516          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 517          SendMsg(%s, 0, (sptr_t)buf);
 518          mbuf.UngetWriteBuf(len);
 519          mbuf.AppendByte(0);
 520          return stc2wx(buf);''',
 521
 522      ('Retrieve the selected text.',)),
 523
 524
 525     'GetTextRange' :
 526     (0,
 527      'wxString %s(int startPos, int endPos);',
 528
 529      '''wxString %s(int startPos, int endPos) {
 530          if (endPos < startPos) {
 531              int temp = startPos;
 532              startPos = endPos;
 533              endPos = temp;
 534          }
 535          int   len  = endPos - startPos;
 536          if (!len) return wxEmptyString;
 537          wxMemoryBuffer mbuf(len+1);
 538          char* buf = (char*)mbuf.GetWriteBuf(len);
 539          TextRange tr;
 540          tr.lpstrText = buf;
 541          tr.chrg.cpMin = startPos;
 542          tr.chrg.cpMax = endPos;
 543          SendMsg(%s, 0, (sptr_t)&tr);
 544          mbuf.UngetWriteBuf(len);
 545          mbuf.AppendByte(0);
 546          return stc2wx(buf);''',
 547
 548      ('Retrieve a range of text.',)),
 549
 550     'PointXFromPosition' : (None, 0, 0, 0),
 551     'PointYFromPosition' : (None, 0, 0, 0),
 552
 553     'ScrollCaret' : ('EnsureCaretVisible', 0, 0, 0),
 554     'ReplaceSel' : ('ReplaceSelection', 0, 0, 0),
 555     'Null' : (None, 0, 0, 0),
 556
 557     'GetText' :
 558     (0,
 559      'wxString %s() const;',
 560
 561      '''wxString %s() const {
 562          int len  = GetTextLength();
 563          wxMemoryBuffer mbuf(len+1);   // leave room for the null...
 564          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 565          SendMsg(%s, len+1, (sptr_t)buf);
 566          mbuf.UngetWriteBuf(len);
 567          mbuf.AppendByte(0);
 568          return stc2wx(buf);''',
 569
 570      ('Retrieve all the text in the document.', )),
 571
 572     'GetDirectFunction' : (None, 0, 0, 0),
 573     'GetDirectPointer' : (None, 0, 0, 0),
 574
 575     'CallTipPosStart'   : ('CallTipPosAtStart', 0, 0, 0),
 576     'CallTipSetHlt'     : ('CallTipSetHighlight', 0, 0, 0),
 577     'CallTipSetBack'    : ('CallTipSetBackground', 0, 0, 0),
 578     'CallTipSetFore'    : ('CallTipSetForeground', 0, 0, 0),
 579     'CallTipSetForeHlt' : ('CallTipSetForegroundHighlight', 0, 0, 0),
 580
 581     'SetHotspotActiveFore' : ('SetHotspotActiveForeground', 0, 0, 0),
 582     'SetHotspotActiveBack' : ('SetHotspotActiveBackground', 0, 0, 0),
 583     'GetHotspotActiveFore' : ('GetHotspotActiveForeground', 0, 0, 0),
 584     'GetHotspotActiveBack' : ('GetHotspotActiveBackground', 0, 0, 0),
 585
 586     'GetCaretLineBack' : ('GetCaretLineBackground', 0, 0, 0),
 587     'SetCaretLineBack' : ('SetCaretLineBackground', 0, 0, 0),
 588
 589     'ReplaceTarget' :
 590     (0,
 591      'int %s(const wxString& text);',
 592
 593      '''
 594      int %s(const wxString& text) {
 595          const wxWX2MBbuf buf = wx2stc(text);
 596          return SendMsg(%s, wx2stclen(text, buf), (sptr_t)(const char*)buf);''',
 597      0),
 598
 599     'ReplaceTargetRE' :
 600     (0,
 601      'int %s(const wxString& text);',
 602
 603      '''
 604      int %s(const wxString& text) {
 605          const wxWX2MBbuf buf = wx2stc(text);
 606          return SendMsg(%s, wx2stclen(text, buf), (sptr_t)(const char*)buf);''',
 607      0),
 608
 609     'SearchInTarget' :
 610     (0,
 611      'int %s(const wxString& text);',
 612
 613      '''
 614      int %s(const wxString& text) {
 615          const wxWX2MBbuf buf = wx2stc(text);
 616          return SendMsg(%s, wx2stclen(text, buf), (sptr_t)(const char*)buf);''',
 617      0),
 618
 619     # not sure what to do about these yet
 620     'TargetAsUTF8' :       ( None, 0, 0, 0),
 621     'SetLengthForEncode' : ( None, 0, 0, 0),
 622     'EncodedFromUTF8' :    ( None, 0, 0, 0),
 623
 624
 625     'GetProperty' :
 626     (0,
 627      'wxString %s(const wxString& key);',
 628
 629      '''wxString %s(const wxString& key) {
 630          int len = SendMsg(SCI_GETPROPERTY, (sptr_t)(const char*)wx2stc(key), 0);
 631          if (!len) return wxEmptyString;
 632
 633          wxMemoryBuffer mbuf(len+1);
 634          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 635          SendMsg(%s, (uptr_t)(const char*)wx2stc(key), (sptr_t)buf);
 636          mbuf.UngetWriteBuf(len);
 637          mbuf.AppendByte(0);
 638          return stc2wx(buf);''',
 639      ("Retrieve a 'property' value previously set with SetProperty.",)),
 640
 641     'GetPropertyExpanded' :
 642     (0,
 643      'wxString %s(const wxString& key);',
 644
 645      '''wxString %s(const wxString& key) {
 646          int len = SendMsg(SCI_GETPROPERTYEXPANDED, (uptr_t)(const char*)wx2stc(key), 0);
 647          if (!len) return wxEmptyString;
 648
 649          wxMemoryBuffer mbuf(len+1);
 650          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 651          SendMsg(%s, (uptr_t)(const char*)wx2stc(key), (sptr_t)buf);
 652          mbuf.UngetWriteBuf(len);
 653          mbuf.AppendByte(0);
 654          return stc2wx(buf);''',
 655      ("Retrieve a 'property' value previously set with SetProperty,",
 656       "with '$()' variable replacement on returned buffer.")),
 657
 658     'GetPropertyInt'   : (0, 0, 0,
 659        ("Retrieve a 'property' value previously set with SetProperty,",
 660         "interpreted as an int AFTER any '$()' variable replacement.")),
 661
 662
 663     'GetDocPointer' :
 664     (0,
 665      'void* %s();',
 666      '''void* %s() {
 667          return (void*)SendMsg(%s);''',
 668      0),
 669
 670     'SetDocPointer' :
 671     (0,
 672      'void %s(void* docPointer);',
 673      '''void %s(void* docPointer) {
 674          SendMsg(%s, 0, (sptr_t)docPointer);''',
 675      0),
 676
 677     'CreateDocument' :
 678     (0,
 679      'void* %s();',
 680      '''void* %s() {
 681          return (void*)SendMsg(%s);''',
 682      0),
 683
 684     'AddRefDocument' :
 685     (0,
 686      'void %s(void* docPointer);',
 687      '''void %s(void* docPointer) {
 688          SendMsg(%s, 0, (sptr_t)docPointer);''',
 689      0),
 690
 691     'ReleaseDocument' :
 692     (0,
 693      'void %s(void* docPointer);',
 694      '''void %s(void* docPointer) {
 695          SendMsg(%s, 0, (sptr_t)docPointer);''',
 696      0),
 697
 698     'SetCodePage' :
 699     (0,
 700      0,
 701      '''void %s(int codePage) {
 702 #if wxUSE_UNICODE
 703     wxASSERT_MSG(codePage == wxSTC_CP_UTF8,
 704                  wxT("Only wxSTC_CP_UTF8 may be used when wxUSE_UNICODE is on."));
 705 #else
 706     wxASSERT_MSG(codePage != wxSTC_CP_UTF8,
 707                  wxT("wxSTC_CP_UTF8 may not be used when wxUSE_UNICODE is off."));
 708 #endif
 709     SendMsg(%s, codePage);''',
 710      ("Set the code page used to interpret the bytes of the document as characters.",) ),
 711
 712
 713     'GrabFocus' : (None, 0, 0, 0),
 714
 715     # Rename some that would otherwise hide the wxWindow methods
 716     'SetFocus'  : ('SetSTCFocus', 0, 0, 0),
 717     'GetFocus'  : ('GetSTCFocus', 0, 0, 0),
 718     'SetCursor' : ('SetSTCCursor', 0, 0, 0),
 719     'GetCursor' : ('GetSTCCursor', 0, 0, 0),
 720
 721     'LoadLexerLibrary' : (None, 0,0,0),
 722
 723     'SetPositionCache' : ('SetPositionCacheSize', 0, 0, 0),
 724     'GetPositionCache' : ('GetPositionCacheSize', 0, 0, 0),
 725
 726     'GetLexerLanguage' : (None, 0, 0, 0),
 727     'SetFontQuality' : (None, 0, 0, 0),
 728     'GetFontQuality' : (None, 0, 0, 0),
 729     'SetSelection' : (None, 0, 0, 0),
 730
 731     'GetCharacterPointer' : (0,
 732                              'const char* %s();',
 733                              'const char* %s() {\n'
 734                              '    return (const char*)SendMsg(%s, 0, 0);',
 735                              0),
 736
 737
 738     'GetWordChars' :
 739     (0,
 740      'wxString %s() const;',
 741
 742      '''wxString %s() const {
 743          int msg = %s;
 744          int len = SendMsg(msg, NULL);
 745          if (!len) return wxEmptyString;
 746
 747          wxMemoryBuffer mbuf(len+1);
 748          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 749          SendMsg(msg, (sptr_t)buf);
 750          mbuf.UngetWriteBuf(len);
 751          mbuf.AppendByte(0);
 752          return stc2wx(buf);''',
 753
 754      ('Get the set of characters making up words for when moving or selecting by word.',)),
 755
 756     'GetTag' :
 757     (0,
 758      'wxString %s(int tagNumber) const;',
 759
 760      '''wxString %s(int tagNumber) const {
 761          int msg = %s;
 762          int len = SendMsg(msg, tagNumber, NULL);
 763          if (!len) return wxEmptyString;
 764
 765          wxMemoryBuffer mbuf(len+1);
 766          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 767          SendMsg(msg, tagNumber, (sptr_t)buf);
 768          mbuf.UngetWriteBuf(len);
 769          mbuf.AppendByte(0);
 770          return stc2wx(buf);''',
 771      0),
 772
 773     'GetWhitespaceChars' :
 774     (0,
 775      'wxString %s() const;',
 776
 777      '''wxString %s() const {
 778          int msg = %s;
 779          int len = SendMsg(msg, NULL);
 780          if (!len) return wxEmptyString;
 781
 782          wxMemoryBuffer mbuf(len+1);
 783          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 784          SendMsg(msg, (sptr_t)buf);
 785          mbuf.UngetWriteBuf(len);
 786          mbuf.AppendByte(0);
 787          return stc2wx(buf);''',
 788      0),
 789
 790
 791     'GetPunctuationChars' :
 792     (0,
 793      'wxString %s() const;',
 794
 795      '''wxString %s() const {
 796          int msg = %s;
 797          int len = SendMsg(msg, NULL);
 798          if (!len) return wxEmptyString;
 799
 800          wxMemoryBuffer mbuf(len+1);
 801          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 802          SendMsg(msg, (sptr_t)buf);
 803          mbuf.UngetWriteBuf(len);
 804          mbuf.AppendByte(0);
 805          return stc2wx(buf);''',
 806      0),
 807
 808
 809     'PropertyNames' :
 810     (0,
 811      'wxString %s() const;',
 812
 813      '''wxString %s() const {
 814          int msg = %s;
 815          int len = SendMsg(msg, NULL);
 816          if (!len) return wxEmptyString;
 817
 818          wxMemoryBuffer mbuf(len+1);
 819          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 820          SendMsg(msg, (sptr_t)buf);
 821          mbuf.UngetWriteBuf(len);
 822          mbuf.AppendByte(0);
 823          return stc2wx(buf);''',
 824      0),
 825
 826
 827
 828     'DescribeProperty' :
 829     (0,
 830      'wxString %s(const wxString& name) const;',
 831
 832      '''wxString %s(const wxString& name) const {
 833          int msg = %s;
 834          int len = SendMsg(msg, (sptr_t)(const char*)wx2stc(name), NULL);
 835          if (!len) return wxEmptyString;
 836
 837          wxMemoryBuffer mbuf(len+1);
 838          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 839          SendMsg(msg, (sptr_t)(const char*)wx2stc(name), (sptr_t)buf);
 840          mbuf.UngetWriteBuf(len);
 841          mbuf.AppendByte(0);
 842          return stc2wx(buf);''',
 843      0),
 844
 845
 846
 847     'DescribeKeyWordSets' :
 848     (0,
 849      'wxString %s() const;',
 850
 851      '''wxString %s() const {
 852          int msg = %s;
 853          int len = SendMsg(msg, NULL);
 854          if (!len) return wxEmptyString;
 855
 856          wxMemoryBuffer mbuf(len+1);
 857          char* buf = (char*)mbuf.GetWriteBuf(len+1);
 858          SendMsg(msg, (sptr_t)buf);
 859          mbuf.UngetWriteBuf(len);
 860          mbuf.AppendByte(0);
 861          return stc2wx(buf);''',
 862      0),
 863
 864
 865
 866     '' : ('', 0, 0, 0),
 867
 868     }
 869
 870 # all Scintilla getters are transformed into const member of wxSTC class but
 871 # some non-getter methods are also logically const and this set contains their
 872 # names (notice that it's useless to include here methods manually overridden
 873 # above)
 874 constNonGetterMethods = (
 875     'LineFromPosition',
 876     'PositionFromLine',
 877     'LineLength',
 878     'CanPaste',
 879     'CanRedo',
 880     'CanUndo',
 881 )
 882
 883 #----------------------------------------------------------------------------
 884
 885 def processIface(iface, h_tmplt, cpp_tmplt, h_dest, cpp_dest, docstr_dest):
 886     curDocStrings = []
 887     values = []
 888     methods = []
 889     cmds = []
 890
 891     # parse iface file
 892     fi = FileInput(iface)
 893     for line in fi:
 894         line = line[:-1]
 895         if line[:2] == '##' or line == '':
 896             #curDocStrings = []
 897             continue
 898
 899         op = line[:4]
 900         if line[:2] == '# ':   # a doc string
 901             curDocStrings.append(line[2:])
 902
 903         elif op == 'val ':
 904             parseVal(line[4:], values, curDocStrings)
 905             curDocStrings = []
 906
 907         elif op == 'fun ' or op == 'set ' or op == 'get ':
 908             parseFun(line[4:], methods, curDocStrings, cmds, op == 'get ')
 909             curDocStrings = []
 910
 911         elif op == 'cat ':
 912             if line[4:].strip() == 'Deprecated':
 913                 break    # skip the rest of the file
 914
 915         elif op == 'evt ':
 916             pass
 917
 918         elif op == 'enu ':
 919             pass
 920
 921         elif op == 'lex ':
 922             pass
 923
 924         else:
 925             print('***** Unknown line type: %s' % line)
 926
 927
 928     # process templates
 929     data = {}
 930     data['VALUES'] = processVals(values)
 931     data['CMDS']   = processVals(cmds)
 932     defs, imps, docstrings = processMethods(methods)
 933     data['METHOD_DEFS'] = defs
 934     data['METHOD_IMPS'] = imps
 935
 936     # get template text
 937     h_text = open(h_tmplt).read()
 938     cpp_text = open(cpp_tmplt).read()
 939
 940     # do the substitutions
 941     h_text = h_text % data
 942     cpp_text = cpp_text % data
 943
 944     # write out destination files
 945     open(h_dest, 'w').write(h_text)
 946     open(cpp_dest, 'w').write(cpp_text)
 947     open(docstr_dest, 'w').write(docstrings)
 948
 949
 950
 951 def joinWithNewLines(values):
 952     return '\n'.join(values)
 953
 954 #----------------------------------------------------------------------------
 955
 956 def processVals(values):
 957     text = []
 958     for name, value, docs in values:
 959         if docs:
 960             text.append('')
 961             for x in docs:
 962                 text.append('// ' + x)
 963         text.append('#define %s %s' % (name, value))
 964     return joinWithNewLines(text)
 965
 966 #----------------------------------------------------------------------------
 967
 968 def processMethods(methods):
 969     defs = []
 970     imps = []
 971     dstr = []
 972
 973     for retType, name, number, param1, param2, docs, is_const in methods:
 974         retType = retTypeMap.get(retType, retType)
 975         params = makeParamString(param1, param2)
 976
 977         name, theDef, theImp, docs = checkMethodOverride(name, number, docs)
 978
 979         if name is None:
 980             continue
 981
 982         # Build docstrings
 983         st = 'DocStr(wxStyledTextCtrl::%s,\n' \
 984              '"%s", "");\n' % (name, joinWithNewLines(docs))
 985         dstr.append(st)
 986
 987         # Build the method definition for the .h file
 988         if docs:
 989             defs.append('')
 990             for x in docs:
 991                 defs.append('    // ' + x)
 992         if not theDef:
 993             theDef = '    %s %s(%s)' % (retType, name, params)
 994             if is_const:
 995                 theDef = theDef + ' const'
 996             theDef = theDef + ';'
 997         defs.append(theDef)
 998
 999         # Build the method implementation string
1000         if docs:
1001             imps.append('')
1002             for x in docs:
1003                 imps.append('// ' + x)
1004         if not theImp:
1005             theImp = '%s wxStyledTextCtrl::%s(%s)' % (retType, name, params)
1006             if is_const:
1007                 theImp = theImp + ' const'
1008             theImp = theImp + '\n{\n    '
1009             if retType == 'wxColour':
1010                 theImp = theImp + 'long c = '
1011             elif retType != 'void':
1012                 theImp = theImp + 'return '
1013             theImp = theImp + 'SendMsg(%s, %s, %s)' % (number,
1014                                                        makeArgString(param1),
1015                                                        makeArgString(param2))
1016             if retType == 'bool':
1017                 theImp = theImp + ' != 0'
1018             if retType == 'wxColour':
1019                 theImp = theImp + ';\n    return wxColourFromLong(c)'
1020
1021             theImp = theImp + ';\n}'
1022         imps.append(theImp)
1023
1024
1025     return joinWithNewLines(defs), joinWithNewLines(imps), joinWithNewLines(dstr)
1026
1027
1028 #----------------------------------------------------------------------------
1029
1030 def checkMethodOverride(name, number, docs):
1031     theDef = theImp = None
1032     if name in methodOverrideMap:
1033         item = methodOverrideMap[name]
1034
1035         try:
1036             if item[0] != 0:
1037                 name = item[0]
1038             if item[1] != 0:
1039                 theDef = '    ' + (item[1] % name)
1040             if item[2] != 0:
1041                 theImp = item[2] % ('wxStyledTextCtrl::'+name, number) + '\n}'
1042             if item[3] != 0:
1043                 docs = item[3]
1044         except:
1045             print("************* " + name)
1046             raise
1047
1048     return name, theDef, theImp, docs
1049
1050 #----------------------------------------------------------------------------
1051
1052 def makeArgString(param):
1053     if not param:
1054         return '0'
1055
1056     typ, name = param
1057
1058     if typ == 'string':
1059         return '(sptr_t)(const char*)wx2stc(%s)' % name
1060     if typ == 'colour':
1061         return 'wxColourAsLong(%s)' % name
1062
1063     return name
1064
1065 #----------------------------------------------------------------------------
1066
1067 def makeParamString(param1, param2):
1068     def doOne(param):
1069         if param:
1070             aType = paramTypeMap.get(param[0], param[0])
1071             return aType + ' ' + param[1]
1072         else:
1073             return ''
1074
1075     st = doOne(param1)
1076     if st and param2:
1077         st = st + ', '
1078     st = st + doOne(param2)
1079     return st
1080
1081
1082 #----------------------------------------------------------------------------
1083
1084 def parseVal(line, values, docs):
1085     name, val = line.split('=')
1086
1087     # remove prefixes such as SCI, etc.
1088     for old, new in valPrefixes:
1089         lo = len(old)
1090         if name[:lo] == old:
1091             if new is None:
1092                 return
1093             name = new + name[lo:]
1094
1095     # add it to the list
1096     values.append( ('wxSTC_' + name, val, docs) )
1097
1098 #----------------------------------------------------------------------------
1099
1100 funregex = re.compile(r'\s*([a-zA-Z0-9_]+)'  # <ws>return type
1101                       '\s+([a-zA-Z0-9_]+)='  # <ws>name=
1102                       '([0-9]+)'             # number
1103                       '\(([ a-zA-Z0-9_]*),'  # (param,
1104                       '([ a-zA-Z0-9_]*),*\)')  # param)
1105
1106 def parseFun(line, methods, docs, values, is_const):
1107     def parseParam(param):
1108         param = param.strip()
1109         if param == '':
1110             param = None
1111         else:
1112             param = tuple(param.split())
1113         return param
1114
1115     mo = funregex.match(line)
1116     if mo is None:
1117         print("***** Line doesn't match! : %s" % line)
1118
1119     retType, name, number, param1, param2 = mo.groups()
1120
1121     param1 = parseParam(param1)
1122     param2 = parseParam(param2)
1123
1124     # Special case.  For the key command functions we want a value defined too
1125     num = int(number)
1126     for v in cmdValues:
1127         if (type(v) == type(()) and v[0] <= num <= v[1]) or v == num:
1128             parseVal('CMD_%s=%s' % (name.upper(), number), values, docs)
1129
1130             # if we are not also doing a function for CMD values, then
1131             # just return, otherwise fall through to the append blow.
1132             if not FUNC_FOR_CMD:
1133                 return
1134
1135     methods.append( (retType, name, number, param1, param2, tuple(docs),
1136                      is_const or name in constNonGetterMethods) )
1137
1138
1139 #----------------------------------------------------------------------------
1140
1141
1142 def main(args):
1143     # TODO: parse command line args to replace default input/output files???
1144
1145     if not os.path.exists(IFACE):
1146         print('Please run this script from src/stc subdirectory.')
1147         sys.exit(1)
1148
1149     # Now just do it
1150     processIface(IFACE, H_TEMPLATE, CPP_TEMPLATE, H_DEST, CPP_DEST, DOCSTR_DEST)
1151
1152
1153
1154 if __name__ == '__main__':
1155     main(sys.argv)
1156
1157 #----------------------------------------------------------------------------
1158