- M=csXdZ hdd<dd<dd<dd<d d <d d <d d<dddk Z Cdk Z Ddk l Z Edk lZlZFdklZGdklZHdkTNdeefdYZdS(s/Information gatherer for source code modules. s$RCSfile: moduleinfo.py,v $s module_names?$Id: moduleinfo.py,v 1.3 2002/08/04 12:06:50 doughellmann Exp $srcs_ids Doug Hellmann screators UNSPECIFIEDsprojectsSun, 11-Nov-2001 10:52:52 ESTscreateds$Author: doughellmann $sauthors$Revision: 1.3 $sversions$Date: 2002/08/04 12:06:50 $sdates is0.0N(s ClassInfo(s SuiteFuncInfos FunctionInfo(s SuiteInfoBase(s ImportInfo(s*s ModuleInfocsNdZSUdehhdZeideiidZdZ"dZ &dZ *dZ -d Z 6d Z RS( szInformation gatherer for source code modules. Extract information about a source module from its parse tree. sc sUijtiiddkd|ld|md|nd|od|pd|r||_ st i |||||td|ud|v|oSzt t|d \}}{|o||d |_n|i||_ntiid Sd S( s$Initialize the info extractor. Parameters: tree -- parse tree from which to extract information name -- name of the module fileName -- name of the file containing the module commentInfo -- comments extracted from the file s ModuleInfos__init__sparentstreesnamesfileNames commentInfosdefaultConfigValuesis docstringN(s happydoclibsTRACEsintosparentstreesnamesfileNames commentInfosdefaultConfigValuessselfs _filenames SuiteInfoBases__init__smatchsDOCSTRING_STMT_PATTERNsfoundsvarss _docstrings_extractImportedModuless _import_infosoutof( sselfsparentstreesnamesfileNames commentInfosdefaultConfigValuessvarssfound((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys__init__Us&           s^#\s*HappyDoc:(.+)$c s{e|idi}|id}d}x|D]}}|i }| oPn|ddjoPn||}|o d||i df}nqFWhe d<eid <eid <eid <}h}y|||UWn=eiid eieiid nX|ii|dSdS(sLook into the module source file and extract HappyDoc configuration values. Variables can be embedded in the first comment block of the module. srts sis#s%s %sisstringsurlquotes urlquote_pluss urlencodes. --- Parser Config Value Extraction Error --- s.-------------------------------------------- N(sopensselfs _filenamesreadsbodyssplitslinessconfig_statementslsstripsmatchConfigValuesmatchsgroupsstringsurllibsquotes quote_pluss urlencodesglobal_namespaceslocal_namespacessyssstderrswrites tracebacks print_excs_configuration_valuessupdate( sselfsmatchConfigValuesbodyslinesslslocal_namespacesconfig_statementsglobal_namespacesmatch((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys_extractConfigurationValuess0    $ 6  csed}tititidgftidfff}t} x|dD]} t || d|\}}|o|d} | dtijo| d}|dtijo|ddjox| dD]}y,|dtijo|d}nWntj o nX|dtijoK|d}td|}di|}| i|nqWn|dtijo|dd jot| d}y,|dtijo|d}nWntj o nXt|}y| i|} Wntj og} nX| d } x|D ]} |dtijo| i||dny|dti"jo| i|d nK|dt#td d jo*t|d} | i|| nqWnnnq\W| SdS(sReturns modules imported by code in tree. Scan the parse tree for import statements and return the names of all modules imported. is import_stmtsisdbgsimportics |dS(Ni(sx(sx((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pysssfromis*simport_as_namei'N(%sdbgssymbolsstmts simple_stmts small_stmtstokensNEWLINEsIMPORT_STMT_WITH_LIST_PATTERNs ImportInfosimported_modulesstreessubtreesmatchsfoundsvarss import_stmtsfirstsNAMEs import_modulesdotted_as_namesAttributeErrors dotted_namesmodule_name_partssmapsjoins module_names addImportsxsparseTreeToStringsimportedSymbolss symbol_lists ValueErrorsnamessnsSTARsgetattrs import_name(sselfstreesnamessvarssfoundsIMPORT_STMT_WITH_LIST_PATTERNsdbgs module_namesmodule_name_partssimported_moduless import_stmts symbol_lists import_namessubtreesnsxs import_modulesfirst((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys_extractImportedModuless` 3     (    (    +cs"#$|iiSdS(s6Return the names of classes defined within the module.N(sselfs _class_infoskeys(sself((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys getClassNames"scs&'(|i|SdS(s0Return a ClassInfo object for the class by name.N(sselfs _class_infosname(sselfsname((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys getClassInfo&scs*+fSdS(N((sself((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys getCommentKey*scs-./|iiSdS(s-Returns a list of which symbols are imported.N(sselfs _import_infositems(sself((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys getImportData-scso679|i}:|djo?<|i}=|o?|i}nB|i}nD|SdS(sGReturn the name to use as a target for a reference such as a hyperlink.s__init__N(sselfsgetNames target_names getParentsparentsgetReferenceTargetName(sselfs target_namesparent((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pysgetReferenceTargetName6s (s__doc__sNones__init__srescompiles IGNORECASEsmatchs_extractConfigurationValuess_extractImportedModuless getClassNamess getClassInfos getCommentKeys getImportDatasgetReferenceTargetName(((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys ModuleInfoNs 4!1 h    (s__doc__s __rcs_info__ssplits __version__spprintsresstringssyss tracebacksurllibs happydoclibshappydoclib.parseinfo.classinfos ClassInfos"happydoclib.parseinfo.functioninfos SuiteFuncInfos FunctionInfoshappydoclib.parseinfo.suites SuiteInfoBaseshappydoclib.parseinfo.importss ImportInfoshappydoclib.parseinfo.utilss ModuleInfo(s FunctionInfos SuiteFuncInfosstrings ImportInfos tracebackspprints __rcs_info__ssyssres SuiteInfoBasesurllibs ModuleInfos __version__s happydoclibs ClassInfo((s^/home/dhellmann/Personal/Devel/HappyDoc/dist/HappyDoc-r2_1/happydoclib/parseinfo/moduleinfo.pys?s$ Q