ó
¿œ^c@sº
dZd
dl
Z
d
dlZd
dlZd
dlZd
dlZd
dlmZmZ
d„Zddd„ƒYZ	ddd„ƒYZ
d	e	e
fd
„ƒYZde	f
d„ƒYZd
e	e
fd„ƒYZ
dd„
Zejejdg
ffZejejejejejejejejejejejejejejej ej!ej"ej#ej$dg
fffffffffffffffffej%dfffZ&dS(süSimple code to extract class & function docstrings from a module.

This code is used as an example in the library reference manual in the
section on using the parser module.  Refer to the manual for a thorough
discussion of the operation of this code.
iÿÿÿÿN(tListTypet	TupleTypec
CsVt|ƒ
j
ƒ}
tjjtjj|ƒ
d
ƒ
}tj|
ƒ
}t|j	ƒ|ƒS(s‡Retrieve information from the parse tree of a source file.

    fileName
        Name of the file to read Python source code from.
    i(
topentreadtostpathtbasenametsplitexttparsertsuitet
ModuleInfottotuple(tfileNametsourceRtast((s+/usr/lib64/python2.7/Demo/parser/example.pytget_docss
"

t
SuiteInfoBasecBsVeZ
dZdZdd
„
Zd„Zd„Zd„Zd„Z	d„Z
d„ZRS(	tcCs,i|_i|_
|
r(|j|
ƒ

ndS(
N(t_class_infot_function_infot
_extract_info(tselfttree((s+/usr/lib64/python2.7/Demo/parser/example.pyt__init__!s
	
	

cCs
t|
ƒ
d
kr2t
td|
dƒ\}}nt
t|
dƒ\}}|rgt|dƒ
|_nx¨|
dD]œ}t
t|ƒ\}}|rr|d}|dtjkrÔ|d
d}t|ƒ
|j	|<q
|dtj
kr
|d
d}t|ƒ
|j|<q
qrqrWdS(Nii
it	docstringtcompoundi(
tlentmatchtDOCSTRING_STMT_PATTERNtevalt
_docstringtCOMPOUND_STMT_PATTERNtsymboltfuncdeftFunctionInfoRtclassdeft	ClassInfoR(RRtfoundtvarstnodetcstmttname((s+/usr/lib64/python2.7/Demo/parser/example.pyR's
 











c


Cs|jS(
N(
R(
R((s+/usr/lib64/python2.7/Demo/parser/example.pyt
get_docstring;s
c


Cs|jS(
N(
t_name(
R((s+/usr/lib64/python2.7/Demo/parser/example.pytget_name>s
c


Cs
|jj
ƒS(
N(Rtkeys(
R((s+/usr/lib64/python2.7/Demo/parser/example.pytget_class_namesAs
cCs|j|
S(
N(
R(RR)((s+/usr/lib64/python2.7/Demo/parser/example.pytget_class_infoDs
cCs/y|j|
SWnt
k
r*


|j|
SXdS(
N(RtKeyErrorR(RR)((s+/usr/lib64/python2.7/Demo/parser/example.pyt__getitem__Gs




N(t__name__t
__module__RR+tNoneRRR*R,R.R/R1(((s+/usr/lib64/python2.7/Demo/parser/example.pyRs

					t
SuiteFuncInfoc
BseZ
d„Zd
„ZRS(c


Cs
|jj
ƒS(
N(RR-(
R((s+/usr/lib64/python2.7/Demo/parser/example.pytget_function_namesQs
cCs|j|
S(
N(
R(RR)((s+/usr/lib64/python2.7/Demo/parser/example.pytget_function_infoTs
(R2R3R6R7(((s+/usr/lib64/python2.7/Demo/parser/example.pyR5Ns	R"cBseZ
d
d„
ZRS(cCs5|
d
d|_t
j||
r*|
dp-dƒ
dS(Nii
iÿÿÿÿ(R+RRR4(RR((s+/usr/lib64/python2.7/Demo/parser/example.pyRYs

N(R2R3R4R(((s+/usr/lib64/python2.7/Demo/parser/example.pyR"Xs
R$cBs&eZ
dd„
Zd
„Zd„ZRS(cCs5|
d
d|_t
j||
r*|
dp-dƒ
dS(Nii
iÿÿÿÿ(R+RRR4(RR((s+/usr/lib64/python2.7/Demo/parser/example.pyR_s

c


Cs
|jj
ƒS(
N(RR-(
R((s+/usr/lib64/python2.7/Demo/parser/example.pytget_method_namescs
cCs|j|
S(
N(
R(RR)((s+/usr/lib64/python2.7/Demo/parser/example.pytget_method_infofs
N(R2R3R4RR8R9(((s+/usr/lib64/python2.7/Demo/parser/example.pyR$^s
	R
cBseZ
ddd
„ZRS(s<string>cCsU||_t
j||
ƒ
|
rQtt|
d
ƒ\}}|rQ|d|_qQndS(Ni
R(R+RRRRR(RRR)R%R&((s+/usr/lib64/python2.7/Demo/parser/example.pyRks
	




N(R2R3R4R(((s+/usr/lib64/python2.7/Demo/parser/example.pyR
js
cCsÒ|dkri}nt
|ƒ
tkr?|
||d
<d|fSt
|ƒ
tk	ra||
k|fSt|
ƒ
t|ƒ
krƒd
|fSxBtd||
ƒD].\}}
t||
|ƒ\}}|s–Pq–q–W||fS(saMatch `data' to `pattern', with variable extraction.

    pattern
        Pattern to match against, possibly containing variables.

    data
        Data to be checked and against which variables are extracted.

    vars
        Dictionary of variables which have already been found.  If not
        provided, an empty dictionary is created.

    The `pattern' value may contain variables of the form ['varname'] which
    are allowed to match anything.  The value that is matched is returned as
    part of a dictionary which maps 'varname' to the matched value.  'varname'
    is not required to be a string object, but using strings makes patterns
    and the code which uses them more readable.

    This function returns two values: a boolean indicating whether a match
    was found and a dictionary mapping variable names to their associated
    values.
    ii
N(R4ttypeRR
RtmapR(tpatterntdataR&tsame((s+/usr/lib64/python2.7/Demo/parser/example.pyRts
	













RRR((('t__doc__RRR ttokenttypesRR
RRR5R"R$R
R4Rtstmtt
compound_stmtRtsimple_stmtt
small_stmtt	expr_stmtttestlistttesttand_testtnot_testt
comparisontexprtxor_exprtand_exprt
shift_exprt
arith_exprttermtfactortpowertatomtSTRINGtNEWLINER(((s+/usr/lib64/python2.7/Demo/parser/example.pyt<module>sF



	1

+
	

















?