home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / fnb101.zip / Lib / site-packages / Fnorb / compiler / IDLCompiler.py < prev    next >
Text File  |  1999-06-28  |  6KB  |  168 lines
  1. #!/usr/bin/env python
  2. #############################################################################
  3. # Copyright (C) DSTC Pty Ltd (ACN 052 372 577) 1997, 1998, 1999
  4. # All Rights Reserved.
  5. #
  6. # The software contained on this media is the property of the DSTC Pty
  7. # Ltd.  Use of this software is strictly in accordance with the
  8. # license agreement in the accompanying LICENSE.HTML file.  If your
  9. # distribution of this software does not contain a LICENSE.HTML file
  10. # then you have no rights to use this software in any manner and
  11. # should contact DSTC at the address below to determine an appropriate
  12. # licensing arrangement.
  13. # 
  14. #      DSTC Pty Ltd
  15. #      Level 7, GP South
  16. #      Staff House Road
  17. #      University of Queensland
  18. #      St Lucia, 4072
  19. #      Australia
  20. #      Tel: +61 7 3365 4310
  21. #      Fax: +61 7 3365 4311
  22. #      Email: enquiries@dstc.edu.au
  23. # 
  24. # This software is being provided "AS IS" without warranty of any
  25. # kind.  In no event shall DSTC Pty Ltd be liable for damage of any
  26. # kind arising out of or in connection with the use or performance of
  27. # this software.
  28. #
  29. # Project:      Fnorb
  30. # File:         $Source: /units/arch/src/Fnorb/compiler/RCS/IDLCompiler.py,v $
  31. # Version:      @(#)$RCSfile: IDLCompiler.py,v $ $Revision: 1.7 $
  32. #
  33. #############################################################################
  34. """ The back-end of an IDL compiler for Fnorb! """
  35.  
  36.  
  37. # Standard/built-in modules.
  38. import os
  39.  
  40. # Fnorb modules.
  41. from Fnorb.orb import CORBA
  42.  
  43. # Compiler modules.
  44. import SkelGenerator, StubGenerator
  45.  
  46.  
  47. class Context:
  48.     """ Context specifying the locations of generated files and packages. """
  49.  
  50.     def __init__(self, directory, package, globals):
  51.         """ Constructor.
  52.  
  53.         'directory' is the directory in which to put all of the files and
  54.                 packages generated by the compiler.
  55.  
  56.         'package'   is the name of the package under 'directory' in which to
  57.                 put all of the packages generated by the compiler (this
  58.             parameter must be an instance of the 'Util.PackageName'
  59.             class).
  60.  
  61.         'globals'   is the base name of the sub-packages under 'package' in
  62.                 which to put the stubs and skeletons generated for global
  63.             scope IDL definitions.
  64.  
  65.         """
  66.         self._directory = directory
  67.         self._package = package
  68.     self._globals = globals
  69.  
  70.     return
  71.  
  72.     def create_package_path(self, package):
  73.     """ Create the full pathname of the specified package. """
  74.  
  75.     # Create a valid filename relative to the context's target directory.
  76.     return os.path.join(self._directory, package.join('/'))
  77.  
  78.     def create_import_statement(self, package):
  79.     """ Create a statement to import the specified package.
  80.  
  81.     N.B This method will work for both PackageName instances AND
  82.         --- stringified package names!
  83.  
  84.     """
  85.     if len(self._package) == 0:
  86.         statement = 'import %s' % package
  87.  
  88.     else:
  89.         statement = 'from %s import %s' % (self._package, package)
  90.  
  91.     return statement
  92.     
  93.     #########################################################################
  94.     # Accessors.
  95.     #########################################################################
  96.  
  97.     def directory(self):
  98.     return self._directory
  99.  
  100.     def package(self):
  101.     return self._package
  102.  
  103.     def globals(self):
  104.     return self._globals
  105.  
  106.  
  107. class IDLCompiler:
  108.     """ The back-end of an IDL compiler for Fnorb! """
  109.  
  110.     def compile(self, context, ifr_objects):
  111.     """ Generate code for a list of IR objects.
  112.  
  113.     'context'     is the compilation context giving the directory and 
  114.                       package names in which to put the files and packages
  115.                       generated by the compiler.
  116.     
  117.         'ifr_objects' is a list containing the object references of the IFR
  118.                       objects that we want to generate Python code for.
  119.  
  120.         """
  121.     # Create the stub and skeleton code generators to do the work!
  122.     stub_gen = StubGenerator.StubGenerator()
  123.     skel_gen = SkelGenerator.SkelGenerator()
  124.  
  125.     # If there are global scope definitions that are not modules then we
  126.     # create Python stub and skeleton packages to put them in.
  127.     if self.__have_global_defs(ifr_objects):
  128.         globals     = context.globals()
  129.         global_stub = stub_gen._create_package(context, globals)
  130.         global_skel = skel_gen._create_package(context, globals + '_skel')
  131.  
  132.         # Generate Python for each IFR object.
  133.         for ifr_object in ifr_objects:
  134.         stub_gen.generate(context, global_stub, ifr_object, 0)
  135.         skel_gen.generate(context, global_skel, ifr_object, 0)
  136.  
  137.         # End of the packages.
  138.         stub_gen._end_package(global_stub, 0)
  139.         skel_gen._end_package(global_skel, 0)
  140.  
  141.         global_stub.close()
  142.         global_skel.close()
  143.  
  144.     # Otherwise, there is at least some semblance of order, and there are
  145.     # no global scope definitions other than modules ;^)
  146.     else:
  147.         # Generate Python for each IFR object.
  148.         for ifr_object in ifr_objects:
  149.         stub_gen.generate(context, None, ifr_object, 0)
  150.         skel_gen.generate(context, None, ifr_object, 0)
  151.  
  152.     return
  153.  
  154.     #########################################################################
  155.     # Internal interface.
  156.     #########################################################################
  157.  
  158.     def __have_global_defs(self, ifr_objects):
  159.     """ Are any of the IFR objects NOT module definitions? """
  160.  
  161.     for ifr_object in ifr_objects:
  162.         if ifr_object._get_def_kind() != CORBA.dk_Module:
  163.         return 1
  164.  
  165.     return 0
  166.  
  167. #############################################################################
  168.