Home       Trees       Indices       Help   
pyraf
Package pyraf :: Module cl2py
[hide private]
[frames] | no frames]

Module cl2py

source code

cl2py.py: Translate IRAF CL program to Python

$Id: cl2py.py 1244 2010-07-26 18:43:58Z sontag $

R. White, 1999 December 20

Classes [hide private]
  Container
Simple container class (no methods) for holding picklable objects
  Pycode
Container for Python CL translation
  FindLineNumber
Helper class to find first line number in an AST
  ErrorTracker
Mixin class that does error tracking during AST traversal
  ExtractProcInfo
Extract name and args from procedure statement
  Variable
Container for properties of a variable
  ExtractDeclInfo
Extract list of variable definitions from parameter block
  VarList
Scan tree and get info on procedure, parameters, and local variables
  TypeCheck
Determine types of all expressions
  BlockInfo
Helper class to store block structure info for GOTO analysis
  GoToAnalyze
AST traversal for CL GOTO analysis
  CheckArgList
Check task argument list for errors
  Tree2Python
Functions [hide private]
 
cl2py(filename=None, string=None, parlist=None, parfile='', mode='proc', local_vars_dict=None, local_vars_list=None, usecache=1)
Read CL program from file and return pycode object with Python equivalent		 source code
 
checkCache(filename, pycode)
Returns true if pycode is up-to-date		 source code
 
_checkVars(vars, parlist, parfile)
Check variable list for consistency with the given parlist		 source code
 
_funcName(requireType, exprType) source code
 
_arithType(node1, node2) source code
 
_numberType(node) source code
 
_getCLVarType(name)
Returns CL parameter data type if this is a CL variable, "unknown" if not		 source code
 
_convFunc(var, value) source code
Variables [hide private]
  _parser = None
  _longTypeName = {'b': 'bool', 'd': 'double', 'f': 'file', 'gcu...
  _SpecialArgs = {'taskObj': None}
  _typeDict = {'bool': 'bool', 'char': 'string', 'double': 'floa...
  _rfuncDict = {'bool': {'bool': None, 'float': 'iraf.boolean', ...
  _numberTypes = ['float', 'int', 'unknown']
  _CLVarDict = {}
  _translateList = {'!': 'not ', '//': ' + ', ';': '', '{': '', ...
  _taskList = {'_allocate': 'clAllocate', '_curpack': 'curpack',...
  _functionList = {'abs': 'iraf.absvalue', 'int': 'iraf.integer'...
  _functionType = {'_curpack': 'string', 'abs': 'float', 'access...
  _LogOpDict = {'&&': ' and ', '||': ' or '}
  _RedirDict = {'<': 'Stdin', '>': 'Stdout', '>&': 'Stderr', '>>...
  _bothSpaceList = {'*': 1, '+': 1, '-': 1, '/': 1, '//': 1, '='...
  _trailSpaceList = {',': 1, 'IF': 1, 'REDIR': 1, 'WHILE': 1}
  _stringTypes = {'char': 1, 'file': 1, 'gcur': 1, 'imcur': 1, '...
  __package__ = 'pyraf'

Imports: cStringIO, os, sys, GenericASTTraversal, AST, Token, clscan, clparse, codeCache, Verbose, basicpar, minmatch, irafutils, irafpar, pyrafglobals


Function Details [hide private]

cl2py(filename=None, string=None, parlist=None, parfile='', mode='proc', local_vars_dict=None, local_vars_list=None, usecache=1)

source code  
Read CL program from file and return pycode object with Python equivalent

filename: Name of the CL source file or a filehandle from which the
        source code can be read.
string: String containing the source code.  Either filename or string must be
        specified; if both are specified, only filename is used
parlist: IrafParList object with list of parameters (which may have already
        been defined from a .par file)
parfile: Name of the .par file used to define parlist.  parlist may be
        defined even if parfile is null, but a null parfile is interpreted
        to mean that the parameter definitions in the CL script should
        override the parlist.  If parfile is not null, it is an error if
        the CL script parameters conflict with the parlist.
mode: Mode of translation.  Default "proc" creates a procedure script
        (which defines a Python function.)  Normally CL scripts will be
        translated using this default.  If mode is "single" then the
        necessary environment is assumed to be set and the Python
        code simply gets executed directly.  This is used in the
        CL compatibility mode and other places where a single line of
        CL must be executed.
        Mode also determines whether parameter sets are saved in calls
        to CL tasks.  In "single" mode parameters do get saved; in
        "proc" mode they do not get saved.  This is intended to be
        consistent with the behavior of the IRAF CL, where parameter
        changes in scripts are not preserved.
local_vars_dict, local_vars_list: Initial definitions of local variables.
        May be modified by declarations in the CL code.  This is used only for
        "single" mode to allow definitions to persist across statements.
usecache: Set to false value to omit use of code cache for either saving
        or retrieving code.  This is useful mainly for compiler testing.

_getCLVarType(name)

source code 

Returns CL parameter data type if this is a CL variable, "unknown" if not

Note that this can be incorrect about the data type for CL variables that are masked by package level variables. Too bad, that is just too ugly to be believed anyway. Don't do that.


Variables Details [hide private]

_longTypeName

Value:
{'b': 'bool',
 'd': 'double',
 'f': 'file',
 'gcur': 'gcur',
 'i': 'int',
 'imcur': 'imcur',
 'pset': 'pset',
 'r': 'real',
...

_typeDict

Value:
{'bool': 'bool',
 'char': 'string',
 'double': 'float',
 'file': 'string',
 'gcur': 'string',
 'imcur': 'string',
 'int': 'int',
 'pset': 'unknown',
...

_rfuncDict

Value:
{'bool': {'bool': None,
          'float': 'iraf.boolean',
          'indef': None,
          'int': 'iraf.boolean',
          'string': 'iraf.boolean',
          'unknown': 'iraf.boolean'},
 'float': {'bool': 'float',
           'float': None,
...

_translateList

Value:
{'!': 'not ', '//': ' + ', ';': '', '{': '', '}': ''}

_taskList

Value:
{'_allocate': 'clAllocate',
 '_curpack': 'curpack',
 '_deallocate': 'clDeallocate',
 '_devstatus': 'clDevstatus',
 'print': 'clPrint'}

_functionList

Value:
{'abs': 'iraf.absvalue',
 'int': 'iraf.integer',
 'max': 'iraf.maximum',
 'min': 'iraf.minimum',
 'str': 'str'}

_functionType

Value:
{'_curpack': 'string',
 'abs': 'float',
 'access': 'bool',
 'atan2': 'float',
 'cos': 'float',
 'defpac': 'bool',
 'defpar': 'bool',
 'deftask': 'bool',
...

_RedirDict

Value:
{'<': 'Stdin',
 '>': 'Stdout',
 '>&': 'Stderr',
 '>>': 'StdoutAppend',
 '>>&': 'StderrAppend'}

_bothSpaceList

Value:
{'*': 1,
 '+': 1,
 '-': 1,
 '/': 1,
 '//': 1,
 '=': 1,
 'ASSIGNOP': 1,
 'COMPOP': 1}

_stringTypes

Value:
{'char': 1,
 'file': 1,
 'gcur': 1,
 'imcur': 1,
 'pset': 1,
 'string': 1,
 'struct': 1,
 'ukey': 1}

   Home       Trees       Indices       Help   
pyraf
Generated by Epydoc 3.0.1 on Thu Jan 13 11:20:56 2011 http://epydoc.sourceforge.net