doc/doxygen/BuildPyExamplesFromCPP.py

   1 #!/usr/bin/env python
   2 # Copyright (C) 2007-2013  CEA/DEN, EDF R&D, OPEN CASCADE
   3 #
   4 # This library is free software; you can redistribute it and/or
   5 # modify it under the terms of the GNU Lesser General Public
   6 # License as published by the Free Software Foundation; either
   7 # version 2.1 of the License.
   8 #
   9 # This library is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12 # Lesser General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU Lesser General Public
  15 # License along with this library; if not, write to the Free Software
  16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  17 #
  18 # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  19 #
  20
  21 import sys
  22 import re
  23 import os
  24
  25 # :TRICKY:
  26 # In input file, contents delimited by two lines containing BEGIN_CPP_ONLY and
  27 # END_CPP_ONLY strings respectively, will only appear in C++ documentation.
  28 # The same rule applies for Python-specific contents.
  29
  30 def Cpp2Python(contents):
  31     cpp_only = False
  32     output = []
  33     for st in contents:
  34         if "BEGIN_CPP_ONLY" in st:
  35             cpp_only = True
  36         elif "END_CPP_ONLY" in st:
  37             cpp_only = False
  38         elif not cpp_only:
  39             st=st.replace("C++","Python")
  40             st=st.replace("Cxx","Py")
  41             st=st.replace("Cpp","Py")
  42             st=st.replace("cxx","py")
  43             st=st.replace("cpp","py")
  44             output.append(st)
  45             pass
  46         pass
  47
  48     return output
  49 #
  50 def discardPythonFrom(contents):
  51     python_only = False
  52     output = []
  53     for st in contents:
  54         if "BEGIN_PYTHON_ONLY" in st:
  55             python_only = True
  56         elif "END_PYTHON_ONLY" in st:
  57             python_only = False
  58         elif not python_only:
  59             output.append(st)
  60             pass
  61         pass
  62
  63     return output
  64     #
  65 #
  66
  67
  68 fCpp=file(sys.argv[1],"r")
  69 cppCont=fCpp.readlines() ; del fCpp
  70 pyCont=cppCont[:]
  71 pyCont=[elt.replace("medcouplingcppexamples","medcouplingpyexamples") for elt in pyCont]
  72 pyCont=Cpp2Python(pyCont)
  73
  74 cppCont=discardPythonFrom(cppCont) # remove Python-only contents from Cpp
  75
  76 outFileName=os.path.join(sys.argv[2],os.path.basename(sys.argv[1]))
  77
  78 f=file(os.path.splitext(outFileName)[0]+".dox","w")
  79 f.writelines(cppCont+pyCont) ; del f