convert/convert_python.py

   1 # -*- coding: utf-8 -*-
   2 #            CONFIGURATION MANAGEMENT OF EDF VERSION
   3 # ======================================================================
   4 # COPYRIGHT (C) 1991 - 2002  EDF R&D                  WWW.CODE-ASTER.ORG
   5 # THIS PROGRAM IS FREE SOFTWARE; YOU CAN REDISTRIBUTE IT AND/OR MODIFY
   6 # IT UNDER THE TERMS OF THE GNU GENERAL PUBLIC LICENSE AS PUBLISHED BY
   7 # THE FREE SOFTWARE FOUNDATION; EITHER VERSION 2 OF THE LICENSE, OR
   8 # (AT YOUR OPTION) ANY LATER VERSION.
   9 #
  10 # THIS PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT
  11 # WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF
  12 # MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SEE THE GNU
  13 # GENERAL PUBLIC LICENSE FOR MORE DETAILS.
  14 #
  15 # YOU SHOULD HAVE RECEIVED A COPY OF THE GNU GENERAL PUBLIC LICENSE
  16 # ALONG WITH THIS PROGRAM; IF NOT, WRITE TO EDF R&D CODE_ASTER,
  17 #    1 AVENUE DU GENERAL DE GAULLE, 92141 CLAMART CEDEX, FRANCE.
  18 #
  19 #
  20 # ======================================================================
  21 """
  22     Ce module contient le plugin convertisseur de fichier
  23     au format python pour EFICAS.
  24
  25     Un plugin convertisseur doit fournir deux attributs de classe :
  26     extensions et formats et deux méthodes : readfile,convert.
  27
  28     L'attribut de classe extensions est une liste d'extensions
  29     de fichiers préconisées pour ce type de format. Cette information
  30     est seulement indicative.
  31
  32     L'attribut de classe formats est une liste de formats de sortie
  33     supportés par le convertisseur. Les formats possibles sont :
  34     eval, dict ou exec.
  35     Le format eval est un texte source Python qui peut etre evalué. Le
  36     résultat de l'évaluation est un objet Python quelconque.
  37     Le format dict est un dictionnaire Python.
  38     Le format exec est un texte source Python qui peut etre executé.
  39
  40     La méthode readfile a pour fonction de lire un fichier dont le
  41     nom est passé en argument de la fonction.
  42        - convertisseur.readfile(nom_fichier)
  43
  44     La méthode convert a pour fonction de convertir le fichier
  45     préalablement lu dans un objet du format passé en argument.
  46        - objet=convertisseur.convert(outformat)
  47
  48     Ce convertisseur supporte le format de sortie exec
  49
  50 """
  51 import sys,string,traceback
  52
  53 import parseur_python
  54 from Noyau import N_CR
  55
  56 def entryPoint():
  57    """
  58        Retourne les informations nécessaires pour le chargeur de plugins
  59        Ces informations sont retournées dans un dictionnaire
  60    """
  61    return {
  62         # Le nom du plugin
  63           'name' : 'python',
  64         # La factory pour créer une instance du plugin
  65           'factory' : PythonParser,
  66           }
  67
  68
  69 class PythonParser:
  70    """
  71        Ce convertisseur lit un fichier au format python avec la
  72        methode readfile : convertisseur.readfile(nom_fichier)
  73        et retourne le texte au format outformat avec la
  74        methode convertisseur.convert(outformat)
  75
  76        Ses caractéristiques principales sont exposées dans 2 attributs
  77        de classe :
  78           - extensions : qui donne une liste d'extensions de fichier préconisées
  79           - formats : qui donne une liste de formats de sortie supportés
  80    """
  81    # Les extensions de fichier préconisées
  82    extensions=('.py',)
  83    # Les formats de sortie supportés (eval dict ou exec)
  84    # Le format exec est du python executable (commande exec) converti avec PARSEUR_PYTHON
  85    # Le format execnoparseur est du python executable (commande exec) non converti
  86    formats=('exec','execnoparseur')
  87
  88    def __init__(self,cr=None):
  89       # Si l'objet compte-rendu n'est pas fourni, on utilise le
  90       # compte-rendu standard
  91       self.text=''
  92       if cr :
  93          self.cr=cr
  94       else:
  95          self.cr=N_CR.CR(debut='CR convertisseur format python',
  96                          fin='fin CR format python')
  97
  98    def readfile(self,filename):
  99       self.filename=filename
 100       try:
 101          self.text=open(filename).read()
 102       except:
 103          self.cr.fatal("Impossible ouvrir fichier %s" % filename)
 104          return
 105
 106    def convert(self,outformat,appli=None):
 107       if outformat == 'exec':
 108          try:
 109             return parseur_python.PARSEUR_PYTHON(self.text).get_texte(appli)
 110          except:
 111             # Erreur lors de la conversion
 112             l=traceback.format_exception(sys.exc_info()[0],sys.exc_info()[1],
 113                                          sys.exc_info()[2])
 114             self.cr.exception("Impossible de convertir le fichier python qui doit contenir des erreurs.\n"
 115                                "On retourne le fichier non converti. Prévenir la maintenance.\n\n" + string.join(l))
 116             # On retourne néanmoins le source initial non converti (au cas où)
 117             return self.text
 118       elif outformat == 'execnoparseur':
 119          return self.text
 120       else:
 121          raise "Format de sortie : %s, non supporté"
 122          return None
 123
 124