yϻe@ < /^$ɍw /];ugOU*y T0)c ͜/7v[q/bɕ7 7_ފ-D)K bOY<2]^;K[N+oGЖes_tmTx 슿ڻo l)\XS' 6?ꊣ~,~$hx(r*
_Ǵ*7I>x=^xqʯi uGu@tk}|m̨ 2[ .;leS{'c" }C2<x@ ^BcWMz;JuۡR5 oiZ.p-{ਲ਼/b8@M~x
{ 0ܷo#Y ]3ӁK{EH| I [{`@e p'@UG6c5Oν)O2 wO}| p6> 7O1[vl#; \ ; =y1*w꾗sԓl2T;'B $2-&pb!ASBӮ#[*c*sK&Nns5)?WB&Hq2n5T_ hݦ喉S%얰4 uCG4i5m
t:1M+{M> BĪ֝ϴkDf8s:u|Q}'[>Pd
NM(eT,V|jQ*]+[H}q:LUND61ͶeV[bND a N{v"pn3 k5oJ8p\Xi;>zSly.8f~nE>IVƊ5t,qBUf u\qg=|MSԟ㭯=#"nV^B_X4o?:! 5.|b7,1
h3>ݎ0Zl!u/IF,Gv;lD>ꭣ壜ꁕҩNZY5ĩYQeVP;o/4^6Ɣ1iӦs4̞=)%Dpi:u`]wm
P2 tLsL94^W 6 _*ֵYαpK?yT@UJOytĬc1 EǴ1:5Qsx!<FFG V ]ILrnƛ7#ܐŘ
ƀ
&UEZ\
u֑8,]gYgtΚ,h, E&E?ן~Ջ]~,
_v"4UUq Anf̜ čoߌͿgOej<@J 16CϏclxVRyFX|$߸ØȋM_B_Ηm辕ؒ- %+S2A+kUFEݶVOȉvcٷh(Lki3>e+6*?p&oO-3,~ڽ =!D|ɞcGz9 {v}wLeӱˮs4Le_~6@gG'>_5M < 61i tvsLt̘ӱˌ>3g`1gs t̜>30mttG9͘31 g7}ߌ6sv)el> aF7q!LUGQOwDxQ
Kl vEy
\?nO>]%w/_p8 ^ 4a \zfyPi_Hs{. o9ȯ.ŅYh9]nY=~mI'>`v0r陨Tz>nUL
.J #@, }㬻gÕoBIn9\q1/{#~r [eڠch$*?p6I _o Yu!E+n3}~_?}tpS?ǍzDkհYtjkfm /a7]uO6mғgⓘ"&Zuت=s8fiUUط˲rq>1"X,VAkVdz,VV
mdvZZ2A#ݚegmۜZ'Uٍ eLd/[ΪGܵQ خdoy8b
lݺkVvmL7`{wG4ǣ-TVڤ(Y i
T1A\fv4lje!c+<@ wɷaF]~YFEb|l{>oe'!1~UL-Kdxpw`R Eˑ`p'+'?* |ߺSrɺ@bvJM]P]pT s btZZ|!D!Zde]v Bs*.kVV k~ڵ|"۴jٲj(>2ۢ0 [lAgg'."ޮg=z5bTx>ضm6oIXwdU| /TURͨV@( +I_S_=ӥ)I\fw,qA 9v3yAW,`u3aOo]Ey˪uo'<,$ L|MU4ݞV)Nq
K &թZUjQci/^ՖXuZl_&E*/n= ᮸?/^Emx0<<*k۪WJRmeiY,nU9-%+;n&YfUn-癈vBֽ(;z^;/^6n'*cU8f
NABeT2DK)o-l|^bTuϏ%uM+kl=Z]ZS./{p~1*춸na/22a$<hվ8
gvĞmuM&0
+) SZJxZ UQ7Yv:-諵YŦˋR9qQ]7 ܌i-8YԳ ݸPQh(s*R+Lƥfx͎ղ䑓НbbZZڎpݲתD;DSY[ȍIؽ;czhe)ߎɶ,e8IJ& +V~"sOnV I`2+,ιyX61pz'ݴNڕ)_T|iЅhbV ;F^nSMVxQh1:@wcywjZ) '}$vƅM%U;4kߍt3̥bS^ωۑÊKE*+z[* a;䟵UVmwX{+|62+8^]'B7fӗlQw?`E) ۩ HQ]5Il5^nl]coiQZ>qn& 5vKEH%a: SNiiN*Nm8ubVcNߢUwK&u$ IDAToK*n]X%UVᔗn>TܖZڽzzvks}(e+Sl=1.NnpZ`)vc)Lj*-LxF[bEƌ:MNr;L~Ti= L&qيPuOt%RjNfQY ےnbLY#vH1dbO x *f.X⮅V)/wc
wn2M6>;3g!EhfL"Lܘħ(XujLQZ9入lmQk2 ]ZnWfuLEaU魾řZl1(&v#m/zk,OTݷ몗'^fl
TDN6I:YʝĞXc+eKz3N&Qh"L>)*f<ݸQ٭ho7 ʋDv=[3TֲcRy7~ i&D[P'K v W$L[W˙VFv Zܬeƿ=vrijΎw'04U^{k֬-ºuZ wy8S ajw ?O˯P*AA- P]" ZlāO W) VҪ%%AAD됭[%JK%' ZY Y%{L)~}8"|,ftQlUt? OW csC襻o.>rKo rp=|+CwOis&ӽ Ѱ dAApk^R1&NR _^t%|z J*
?.,a\+]B< OJjűGw4d .1ˣ x/ErtN?Ea<
(}lo1ݱҽ Ѱ dAApo(w883Q#ؾ{ŭ V59{ #~<9 <~ ieԟf~s>"ەW.yh#68{qA}' lƯ/[W;oa, j穞T=JZ,'[$$qn1t_˃ܻ* Z,* q C5ks",:j ]W.{9
$=~wǰlEZnIfQ? ̗de5r|pݛۗa~u[ ./t_ 0om.3b*<ӽ u|<7/|tA ta:,J [N=ڱ췕#Xv N]+V 6p|+F
ͿA[ Ʊr[x&@|>t,
[=*}I\XㄓG j֬ڶnJׁK߸sM
]?sݍVo1qioF%M Ћ pN! ;_=Д0A tAGM6:բ^8W=yƪ(
(=q~N W7}A`p 7y { a
WvL^TNGǩŃkn.
zAM cqՊ^6c- i8t1ѵbFT8c:˸y$ ѥ=}˸;ۿmDf~ ?k.&áXa!pF x0|xk#NCQ So;HVp[k嫊Ev]}s; '7AD7{|VW0 w㎻7rCy]p:w/GJ.x /tU0OVО}ȟ7b Un5%;ǚk7"| xQ'1,FCǼE*W!|u ?
7yP&e*38-_lw| 3.] :蠃:h!xdR>|Spc7A( |lW8
wr sWENM
(8
" Ny )[eʭҬ.|?:*r j.1w |c/ p N ˤ$ܖeFS|/ޏc ÏvY#
W&LiE tA <4u gu! #XyAIJN,8x?} A|4(
q b5 *LibA19"D)A|Y^ZD@AL
x@ EAAPr$JAAD{mHBAAW.=Osl}eAAT; {rL)LO.9R btt:|> :;;b2xrEl rG `Z< MU=AAA cL S ݂JAADS(%qJAA4な(JE7AAD㎃u8RH ݯ dvDx
?_H$WHV""a'MG2rADš ]vpص0jvEe 1~ %lSd`zRU.|cISY#_[! Nү&O#ҥA\AӃ; 't va8nݺ]xA S< OCTh~H,CܟC,˖*C,ȦW!Uq3#ڸ?\y^tS3%NѬ\b1KtI~#:{ڇyQ0Ƴ,
w`~ +|'Kn>\BH#gp}RW4icnV @Twߍks-ZN8 {,>CUUgM@]4ŪPEK- շЀB\%;r+`$l- jmNH-D'O?Cɹ=n#f!r:Ʈ4Dwc_ Eall ƿa5 ,; ]
uG?^GsƻvlWKw@juCEc mus8Ƭd=5i: {S+BALX t CÕ@(-6թ MJCZZI{LDo+-g]Q,ٲWH VuE*|ZWt$] nKVO]t5~WHL$*Qi|pI 2c
RK@AE^}lҥ,Ͳ9s_fV`v|_x< 0<_~a<D:̀0KsWÇ|O!^x3oJ?|o>SI_;o>~ = 2w0y!f>AA1FFF؋/^~eo۷~?vy k{|͙3r9vײk)^{-cSOřg |#mNe.A`xIXZ@!0qXXU2AA`tt:|> :;;f+XUO;?225Gq`ppk֬c
bDqbݓo
Bc@;＋ٳfW_1PնOAAanUUtX,4QԒ*]@}ߎ1AAGS*3iX*XԏZ@GA
K)R (- z]m3(~EQO!( E^ʑLK25=ڼt3c1ERGa3坥i U[9E_OfmELڷ 濓Ng+?oCoZaU? P+a˻oH!<$PHj|8[#uY&aA1YwQ~u_8#dT 7J4#}ޗZ\I " O DtR5gN!F/$!
7#2,E-K~o&P܈_Z6MFD$dpUiZΞ 8!0hW/_/~濓N쿹kv{qUkC@<럛ö~bn`Lߨ]/$\aHc BTe0 ͩ}*-|f6VD$ǑIqE"4DgCX8Lǔ=>`cT.K @JaA+F t!ũDW4 l I AVijzo{' C/rFOj% !{~I CKK{jd7D8Рn}__z $
E} 3,X"4~'h\Vqu{ CӚ_ CpI C)v)$Џ)}Y0Ⱥi- NSwlߚە?WشV~5YB(=H.4TL" BEP5-_Mz%JW0?zf~s
R.C/EKPBցWO ÄݝmFgĉ.sau&Ծ`R]{0UB Uf q4
WҭRvK q^tsj)П( +2x8Tuk^ĺW7궕 i0Y{^H -6juHo:3}%/ߘ|tǐ1v}]{ؕË(mxkwo#qkڱf?s߯ZDܡ>}[\{!rK@t˺w +iE &WIKJb锌4c ,; &Ie_Kj3{גg'*i8RۚED JٟVXIo4$j!S随.BkQqíJۏ o ʿ\DuKcֶ>k9&m1V~zB@bv_t!#X {D, [K-C0Ae"( VL$Ji=+E Q!~WsZihџ~O79~kek .>SLdѯQ-C*&0*$_ ֈ5a *$ɓ8*ahE[mhoFXн ., n_wj?ܶs- "p0|.Ok ZKf矹}s.֏Zڱo?Qp|{.*cH ˟-Uƭ7'}P H&,Lgy͙3^2g<3 Җt7*~|8mϯ{3?0u#imF8t 708Jzq*ĿMe40kaqpo[LK_wu7gM紴 V-Bٰ_7a?PwS? [ƻq:T?mcâ_g珩wUeۡ~R]
ou\ *sª9
S>Uh*+_ p*.ۯE?6;c;vzk;{7٫^. ۰a=d=8[~^{lΜ9ga?яC?d ~'|2ziطO4L)GL`of} -ʟf` D k 3::+W3/JƎNoxeG1b֬=8>l<8kœO>YLi
GXQ(5L"^5܁HSz6a~uL uO'_b҆s] }i6$KRy,DYJ]Qd%G8p& $Z[VΘH z > h' % Q+U hnN&QJR pxK
}lnw$ld"J{2\Nɒ?'?::||`>M~KZcԮ :Q[K=>^RC: m-jA,O &Y ?wE*OUkuM "ט7˧u}Y=#~+X>&yi v ։Rn|N*R4[g@@@@Z"bme5PjvWv D -Qi` @Y*~8[}a1;̧!@
`~MqJ?#\n.T~pkU>]O^/8[RmM=e ӿg"
r -?=^@eL֏o}+ ne62탛a~ (z5kؚ5kؖ-[9s/;C+:=\gj__VWo6 g~{
~O{|+~s;ߴn:\V{#s*<5_7ϾYXWVK?tzzש|-_wsqJKCfo_=u7t\hfV)[.ҏӦojkh_wJ h####;`>{؎ ﰷxMꫯ 6lbO== c=֯n^c<"3g۲e [f
{ }QvZm۶DX)&F/7
:+W- 58K"Ee]FK^ʦɓqJ?#{W(5nˮ|5 zDP˷Mnl IDAT}qM?t~vԩjY:E4M!)*Jm }Q裏2~D安D?}Xm5>`>zBڑ2d~Wo.]{?ʏMwM wS/lJ/T&/DSW➏\D'{~, L/ L%BCl%:ՃޠB퉵pV}mf$+~a% PѕvwF^
Q!e ?PCC.cj jWyr/zbcԖǐkb hs2㔿ou2a'8&:} snX 5} #H^/fY6e/m6E
7&ܵgٍvC g܄:bע]_2.JF|=izg[)\ SsJ]CڗOw
q~&
ݔo7l<8ׯ֭[u)r/bݦnD@A,C{j.l&vof8%AS}RpKAsmx<铜$KʯE )`novetEeTy h.b) %> R ([JIAA)N 01xHAA+Ju
ѧ;a,y ܺGrEѬ @
}W#EyG$= -LDd~MSKzNsg!Q&d硝sjLdI\LS{tf >m&^Ĕf>ￏbh@0Y k{ '+iFiF/F)hvR5\Hű3tI#T[#-x>?tOjR&K-=ClM܄/d١tO }nj 1$u3OW4k/l">|;KN0Y g] LzqN5V m 29b\/TpjV ]}`CreePI2v~9c[~H_7GvkX~=6l 8Ơj6*I,'%5Y ]{L_yk=F+VNnMC
zhSeTagײuW zzDoOSwHۼ۬r@n)|N[ F?w^P:P]6A q/l d>fw:r7
&+6} ү)h)zb'?`Yۿq>|bU|H]M ;Vtm[2>? =ӗXyKa|%1Q+qꊢU
1UG]h` d4j`Y-R|
Qw fjy[mj4-N_u`DYZM˟x c~;MI_#ԣji
_˖V! /V(P_--Y[2}X 8*2c
ZX4}~([F->4ؤڲYa ,$Xf*)|Z^j!^O\Ѫ5~
F ^
'Vv)Y?1Ԯ)j}jm*_Ĕ1Nc`lΜ9lt pڸ ,g!YF|ouq§H(q' SΧ]}us\*䔿npo*e ᰖiS?] ~s.}ݦu␏-mT6jg7~wigR&چF&:Bnnۼr|ɿF1awq{{vxvoW_}0\`=a{
' {q~vngٜ9sB;ә c H_|1ziطFK&d T?'`UZP|bʕ8CT*AUUJ*ޱ""0::Yf 8f(.;yvvjR<:4\h" O $L9AJG4C}VL2$%꾷ס>}p)AAAJ#xfvuWnJAADK/{AADÔJ%}wQ /X,X,all6QJ h'}OAALaJ vLdE8"7=`ĝeD >G @%[e
+LL-. ̔+ (iܭT b* RƘxKi0y XRqѽZ@o S"ɮÒĝXܲnZdf d' )'LE,vH>Βz g u`:Í[Sk[w(o$X@YA>ʝ sD/ qgٍe! 5BO/ (]= ِ<Jb wA@L|
0S@ @ ?n$YEH(T+1 .2kU0A11ގ`` H3M<㯡esY҇z9l_ p(Cz .1,=ui [c/ B$*'
vv=O ݆p,5z6u @+n3i78vli vit9|>Ėkg ' tY- Viq ĉZ@s [ ?$ u*sC F3c W..l<&@V%4 KO
KP>MlVEq}> /_.resy6QLÚN.AAB6UP-F Pz/
j?Ƅ($HAĤDѮLi3HqH_ث~ ڋ0ƀf a{oI)&tR@i?Wn/eQ Յ^Fn) qHޛR`` ں ;V A1ᨪ;wC& Pb }`CQH܉ث }PY7M/ξOA _|smAdYZ{l0
`7 }\g Ƅn(t*h,_Gsw}n)˴ 9q?"ul^WcIӚo2Am,gH1 ec?,x^/$*n E B - iϧ%ET Sa<@u & JOOc+%Kp׃O#tľFjǒU
Z1$#BC l b3::+Wc RUUQ*x{Nj((K(f͚ƚͣc|rr-[bϷE,7-)RPa n -; JI]AAZ7iWbh=Oj3듓-"{]tKS] >RC@AAL4$AA1a)% CVR b"f?IAA톺"@ $v(HrDj[M P(CVKM%
vHA|0)%+idiwvE6' hWl: Zg,
$´%;}3z(Ě@AmLW5+D
W*:(P bKny3Y 3%jV4
|TDwyֻJJl~9?W$?poX%q ZT,naw
}P A2 mt| Ry2tX7S}pP6HVDЗ6u4rOn0UҀ|$C>'-Ym〮hE0l/?jlӁ=m̻2X7
J#\
ltAA+uP|Fwi| C=J\77z9 B)đՅHW)ȼJ\ѯE`(L:]Q<e5Pt)zD57Cr]ѬBY}
o%+H !ḷ AD{`sݴ-rUmXz] `YnaAw#!
bI_Y"KA ]&6Nc>[}Jo'Lfy v%KW}0w&?_Ɛ"
,!< quGMl̥@B.QW "UcJ]" <փnI߲ZFM7HASZʝ*E2
,!ڶ,TtU RSHDQuWObU_2ɦ; !~ បiNo Ь~ݱ\LEEDyI@)c8NZ)W D^4if2
YA9p<{}^c꾽2v No?
]~vY+& д4-E-nob%I
ssX:GmT܀zm9jӫ-zk.w~IO- ^a* MJRPlMWp)"mjkzA[2
#X12 4+W)I}~>=Q\3[YeT\0*krU5JWrk롦/[IbF^ծ{Yq:" Bi3U1~j^ `4%R#W/?>xHJAq\~erˤR{C˙%+r]+FN,,=]A#75Q]%JG(49k\Gj}6+,q*ydꒉ]"b'JQQ:co$ M6S/%)LAGTB%k~Z''+J UROz),Hum˯/uTҘjvmiܪY枸Q>ޗÍ~yAF U~NTZ_YRZFuOBUO{|(VBuaNh6(;ex۶ХSL]s/mҊkcm;RzЗ| x|{( (NIIv,2@:pGꞍQ7!vOх]wT~C_F
5
c0Jl}yy!7tr0HU>ڗu@q z5%xW*~SFVe5n v &ʊߤCVp_zO^_| ڪ/ۏ_ GOiRlaWVttY ʈSǃ
ίGkZ f+
wmؚڽ $ )1]}4[;ޗ>ѥnKuav,8ݕTnڥ/|*^zu].ď'W] n[ڰJRfEؿ)Mr-yW9W(y+=1]}B^^UOvq~tvjۃv\G"+\F @1LI7o̙7 ҈~L3 _lKg126qSY|uCƘɚ FEEE?=2MSVjԪΟWT***Rǎ =2}Q^ŋ%q} UeC>{HPo>9ZC ~^<G 48}߂&[YI7W*j$ tR 49B) R ܜ'Vx N"`nS eLӔjjiZe-?ZKe50 f)J1BƇyxWo ZT --Dgv⥟ҒeOWU1~j^`4bVQ1 &tmﾓaHE9::U+GkVκIn]T\\[;ZmNRlΤt4M%P8 5 |u={(\nruuv9ה &~nZKa_'za2]˫1F_֗+6 `\SZT-҈
7:P3, 4泡הKdWP P = R J B) yI( @`1M<^Oje4\|mkoU \ZS|L[O PZxY- OIDAThiji6ӽ1J:ǥj!eϤioe#VհV 2M=Q hALӬe(MW8L(SlFLWz77o`+XkahO*ոۺjHҥ0<:>o7v VK^ߘh OSؤJ=~ fn }c5454(Z/4M= xsK 4+)`o Ѐ R J B) R P
B) `)o hLs' { 4QB) <J +##C~N>sΩP6mڨM6rqq<==VZqT Z:rvޭ$ 9rD'O.///yxxSNj۶$IϟWAArssu}7̔.+$$D}B0
ڱc>CmڴInnn
ј1cs^bJJJ G={V#Gرc*: @s i0F3gb
YF={Tdd.\(zݺuk[{ք $I|6oެ^zIo~)SՕ L4yӧOkԩ0`JKKK;vPTT]iu]v
կ_?M>]YYY Jrb-[L
RRRxbq f}||d}Wruuw߭˗ŋ
LSRR#Gzgt-4ر}Y߿_ TppRSSi
M J5oc4J}jȑ:uꔦNJ hɡ4>>^g vm-"|}}g UVoZ @+ ʮtÆ
z{H˸h
Q]R ݮ)OS.]ZliQff&- )OO>6gZeZm^iii_~լYh% .=:r7YF~~~ڷo_(EDDHN8_W?~]+fڴiڿO+ h ^SllZnmz>N>m:?ObIR뫒VN_V >
qFM8[,jӦk_J |Ay @p,
ۧ^zn{ŢB͙3G ւ $I{ｧ4yzzjyjժ5{s)11Qٳgk6[N?\C Y!SzQׯ^;i&=iӦ:ϟ5k4MOij
5URR#FwUnokС:r:vhO_| uܹ^e<#uII ||իemY֭$i *..[oU}suuٳgi)
4+khptt,a)##C})Y3, 9rDWR"eddp )i
;w[ObkC;w
6T>))exyy)55U/^,j߿Nݢ' )Bi@@ :T/^X>j-qtI3F۷oku*ՊǍk͚5|;wN/ yB J[@``RRRgt}i'|PmݺU^^^ھ}OӤILyyyi:srssu뭷?Wǎ sNmڴIsՒ%KC6_nnN8R e giD?w
4i lN]\\ ^ HgϞZn-r ajQ0d
QFfŋT~>x ǫ膪?N h eהJ=ܣW_a*(..NC wMk h`et2dշo]) }駴 dמRIڵV\G yDYYY-bN>H%&&ӓ Yȑ#u)\\\ZTe={V3g xZ @x.7:U4tPJ9v옆 )S跿- Ş̴iӴdz}e
{ h
U1ctwjĉڰa^~eyxx477h֬Y , Z @#3MҌN
[*I~~~JJJw߭AiѢEi
նm[Sׇ֭ `l|}}[^4c "
nE 4!
45B) T8 @SRR 4R 4)N IhB) <J P
&G( A- iC$L 䡔`
fJ B) R 1UўP
&G( @)-% Ƀcsɜ M0A...2 Cǎ $ ;vLVUΝӻﾫN:qD Zf J]\\sk?x` -[?}o,X ''k999iѢE E J[&MRu9qD" @K-a't wT7G F-4**Jڵ+ܶm[p nPL0AKKK 6 ۷ 6ho^۷= i?W~~s nreff*33SYYY:w~bAԾ}{U ^^^~ :tH_~kyxxCҥ䤇 ~XE999***҅ tYeggoٳg={j
u뭷r XV%''kӦM裏G
ҠA4ydۻ$PԦM*)##C))):p-[W1b " ٗ_~7xCkO~5J߿M۫ e/3Fҥ>3رCcG 9-[hٲe:uꔢnݺ5tppP``5o;wꩧRϞ=+ݝ H,z-),,LӰaZ)q0+((Hև ~H h$v)xbcco>O M:UTRR.]ʸ
3: V^^Zl W:u&NbZ
@s
/^Ըq奷~ڱE[6mhڵrvv֤IdZi- 1Ξ=[Zb,
W9JHHЏ? Z H)ݶm6nܨÇ7k.KKKeX4MYVQkU߾}`Z
թ{XO\/^sܹ6nH ht՚:uj{35.o]ʏʕ+i5 vf5ϟׁV
fggW_i:u =͛7G'OVAAVXP?աCuVrvv̙3պuk_RbbfΜkԩѣGm7xCyyyU^^^*+,,LoTXX6mz /BuU=z_+44Tu-MBBBt1M6Mfŋɓ'Hyyyzg {rt6_:ufΜ3f̙3[nEꫯh9 NUy y>}Z a߿|M8p {Qa駟ֺu딙@IҤI4sLQ\\^>$sիW+CYYY {R
[F۶m_z7uy(33S_ ;VtСJ7[tqQ!T}wر7kT lյާ% < ///EGG+''G+VPնm[IS6u/)%%آikO>-Z uTt+**JӟC&66V[lQZZ$iϞ=^ P__6Siiug+;;[*,,>JMM՝wI hP@ر^6 CSLѴi$I}Qll Pgz뭷4}tJNNիuEmYGֺuTPPڵKG{'4 E!!!Z| Qu>H Z
WeC777S-Zm4_72_^+V?BBBOj pS***ٳg֭[_sώa2Ma*,,GE1j^x͛7OR ;vΜ9SҖd۶mոqh vVPUV)&&זL+VT
MJ%?Ə _*--a+DǏׄ МB$-^XNNN!iII~ߪCZh 9RŢwyG/~Q硖EFF oi{ JK3<;ڵ J9v옆 " ]VZ 4P*IZ|ϟPǫUFII^yӲe! hPZ9kcرڷoݫ@m߾z64m6
4H~>S ; XkڵzWh"hƍFmذAzuݝ ءԞe^[ ,PBBNMҴh"jʕz{ｗ p0 pj͚5
SN4rHiРArtlPIIۧ ;vhƍĉsN
nPZ/^_|Qז-[4c ;vL 5p@SݻwW۶m봝8qB)))t}<+Wj
; f J@gi߾}Zn ;'NSN𐫫tImڴ$H:{uiG{V5{lcǎ m Bi:v_sVU|Μ9leee
***RaaVծ];uA...rss<== 988ԘVVkUX,ڵvQ h488X.\(ܹsg[=zД)SZf( @QZZ$M«qM:ݎ}_Skkj5=ɺmZef%3g u|n/K*{XkNҞvR v?Geݡ|[
5E6/V>4-ixC}ZڬlU}4d/bUa{DW
5`k۬IU@S hWͿ. /#눙 IENDB` graphviz-0.14.2/docs/_static/rank_same.svg 0000666 0000000 0000000 00000006277 13737227654 017225 0 ustar root root
graphviz-0.14.2/docs/_static/round-table.svg 0000666 0000000 0000000 00000004433 13737227654 017471 0 ustar root root
graphviz-0.14.2/docs/_static/structs.svg 0000666 0000000 0000000 00000010453 13737227654 016763 0 ustar root root
graphviz-0.14.2/docs/_static/structs_revisited.svg 0000666 0000000 0000000 00000007653 13737227654 021051 0 ustar root root
graphviz-0.14.2/docs/_static/traffic_lights.svg 0000666 0000000 0000000 00000024024 13737227654 020243 0 ustar root root
graphviz-0.14.2/docs/_static/unix.svg 0000666 0000000 0000000 00000071677 13737227654 016256 0 ustar root root
graphviz-0.14.2/docs/api.rst 0000666 0000000 0000000 00000003755 13737227654 014417 0 ustar root root .. _api:
API Reference
=============
.. autosummary::
:nosignatures:
~graphviz.Graph
~graphviz.Digraph
~graphviz.Source
graphviz.render
graphviz.pipe
graphviz.view
.. note::
The two main classes :class:`.Graph` and :class:`.Digraph` (for creating
`undirected` vs. `directed` graphs) have exactly the same API.
Their division reflects the fact that both graph types cannot be mixed.
Graph
-----
.. autoclass:: graphviz.Graph
:members:
source,
node, edge, edges, attr, subgraph,
format, engine, encoding,
clear, copy, pipe, save, render, view,
directed
Digraph
-------
.. autoclass:: graphviz.Digraph
:members:
source,
node, edge, edges, attr, subgraph,
format, engine, encoding,
clear, copy, pipe, save, render, view,
directed
Source
------
.. autoclass:: graphviz.Source
:members:
format, engine, encoding,
copy, pipe, save, render, view,
from_file, source
Low-level functions
-------------------
The functions in this section are provided to work directly with existing
files and strings instead of using the object-oriented DOT creation methods
documented above.
.. autofunction:: graphviz.render
.. autofunction:: graphviz.pipe
.. autofunction:: graphviz.view
Other
-----
.. autodata:: graphviz.ExecutableNotFound
:annotation:
.. autodata:: graphviz.RequiredArgumentError
:annotation:
.. autofunction:: graphviz.version
.. autofunction:: graphviz.escape
.. autofunction:: graphviz.nohtml
Manually maintained whitelists (see https://graphviz.gitlab.io/_pages/pdf/dot.1.pdf,
http://www.graphviz.org/doc/info/output.html, and ``dot -T:`` output):
.. autodata:: graphviz.ENGINES
:annotation:
.. autodata:: graphviz.FORMATS
:annotation:
.. autodata:: graphviz.RENDERERS
:annotation:
.. autodata:: graphviz.FORMATTERS
:annotation:
graphviz-0.14.2/docs/changelog.rst 0000666 0000000 0000000 00000000057 13737227654 015565 0 ustar root root .. _changelog:
.. include:: ../CHANGES.txt
graphviz-0.14.2/docs/conf.py 0000666 0000000 0000000 00000013470 13737375464 014411 0 ustar root root # -*- coding: utf-8 -*-
#
# Configuration file for the Sphinx documentation builder.
#
# This file does only contain a selection of the most common options. For a
# full list see the documentation:
# http://www.sphinx-doc.org/en/master/config
# -- Path setup --------------------------------------------------------------
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
#
import os
import sys
sys.path.insert(0, os.path.abspath(os.pardir))
import graphviz
# -- Project information -----------------------------------------------------
project = 'graphviz'
copyright = '2013-2020, Sebastian Bank'
author = 'Sebastian Bank'
# The short X.Y version
version = '0.14.2'
# The full version, including alpha/beta/rc tags
release = version
# -- General configuration ---------------------------------------------------
# If your documentation needs a minimal Sphinx version, state it here.
#
# needs_sphinx = '1.0'
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.autosummary',
'sphinx.ext.intersphinx',
'sphinx.ext.napoleon',
'sphinx.ext.viewcode',
]
# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']
# The suffix(es) of source filenames.
# You can specify multiple suffix as a list of string:
#
# source_suffix = ['.rst', '.md']
source_suffix = '.rst'
# The master toctree document.
master_doc = 'index'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
#
# This is also used if you do content translation via gettext catalogs.
# Usually you set "language" from the command line for these cases.
language = None
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This pattern also affects html_static_path and html_extra_path .
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
# The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx'
# -- Options for HTML output -------------------------------------------------
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
#
on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
if not on_rtd:
import sphinx_rtd_theme
html_theme = 'sphinx_rtd_theme'
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
# Theme options are theme-specific and customize the look and feel of a theme
# further. For a list of options available for each theme, see the
# documentation.
#
# html_theme_options = {}
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']
# Custom sidebar templates, must be a dictionary that maps document names
# to template names.
#
# The default sidebars (for documents that don't match any pattern) are
# defined by theme itself. Builtin themes are using these templates by
# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
# 'searchbox.html']``.
#
# html_sidebars = {}
# -- Options for HTMLHelp output ---------------------------------------------
# Output file base name for HTML help builder.
htmlhelp_basename = 'graphvizdoc'
# -- Options for LaTeX output ------------------------------------------------
latex_elements = {
# The paper size ('letterpaper' or 'a4paper').
#
# 'papersize': 'letterpaper',
# The font size ('10pt', '11pt' or '12pt').
#
# 'pointsize': '10pt',
# Additional stuff for the LaTeX preamble.
#
# 'preamble': '',
# Latex figure (float) alignment
#
# 'figure_align': 'htbp',
}
# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title,
# author, documentclass [howto, manual, or own class]).
latex_documents = [
(master_doc, 'graphviz.tex', 'graphviz Documentation',
'Sebastian Bank', 'manual'),
]
# -- Options for manual page output ------------------------------------------
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
(master_doc, 'graphviz', 'graphviz Documentation',
[author], 1)
]
# -- Options for Texinfo output ----------------------------------------------
# Grouping the document tree into Texinfo files. List of tuples
# (source start file, target name, title, author,
# dir menu entry, description, category)
texinfo_documents = [
(master_doc, 'graphviz', 'graphviz Documentation',
author, 'graphviz', 'One line description of project.',
'Miscellaneous'),
]
# -- Extension configuration -------------------------------------------------
# -- Options for intersphinx extension ---------------------------------------
# Example configuration for intersphinx: refer to the Python standard library.
intersphinx_mapping = {
'py': ('https://docs.python.org/2', None),
'py3': ('https://docs.python.org/3', None),
}
# monkey patch, see https://github.com/sphinx-doc/sphinx/issues/2044
from sphinx.ext.autodoc import ClassLevelDocumenter, InstanceAttributeDocumenter
def add_directive_header(self, sig):
ClassLevelDocumenter.add_directive_header(self, sig)
InstanceAttributeDocumenter.add_directive_header = add_directive_header
graphviz-0.14.2/docs/examples.rst 0000666 0000000 0000000 00000005125 13737227654 015455 0 ustar root root .. _examples:
Examples
========
The following code examples are included in the ``examples/`` directory of the
`source repository/distribution`__. Most of them recreate examples from the
`graphviz.org gallery`__ or the `graphviz.org documentation`__.
.. __: https://github.com/xflr6/graphviz/tree/master/examples/
.. __: http://www.graphviz.org/gallery/
.. __: http://www.graphviz.org/documentation/
hello.py
--------
.. literalinclude:: ../examples/hello.py
:lines: 2-
.. image:: _static/hello.svg
:align: center
process.py
----------
.. literalinclude:: ../examples/process.py
:lines: 2-
.. image:: _static/process.svg
:align: center
fsm.py
------
.. literalinclude:: ../examples/fsm.py
:lines: 2-
.. image:: _static/fsm.svg
:align: center
.. _cluster.py:
cluster.py
----------
.. literalinclude:: ../examples/cluster.py
:lines: 2-
.. image:: _static/cluster.svg
:align: center
er.py
-----
.. literalinclude:: ../examples/er.py
:lines: 2-
.. image:: _static/er.svg
:align: center
unix.py
-------
.. literalinclude:: ../examples/unix.py
:lines: 2-
.. image:: _static/unix.svg
:align: center
structs.py
----------
.. literalinclude:: ../examples/structs.py
:lines: 2-
.. image:: _static/structs.svg
:align: center
structs_revisited.py
--------------------
.. literalinclude:: ../examples/structs_revisited.py
:lines: 2-
.. image:: _static/structs_revisited.svg
:align: center
.. _btree.py:
btree.py
--------
.. literalinclude:: ../examples/btree.py
:lines: 2-
.. image:: _static/btree.svg
:align: center
traffic_lights.py
-----------------
.. literalinclude:: ../examples/traffic_lights.py
:lines: 2-
.. image:: _static/traffic_lights.svg
:align: center
fdpclust.py
-----------
.. literalinclude:: ../examples/fdpclust.py
:lines: 2-
.. image:: _static/fdpclust.svg
:align: center
cluster_edge.py
---------------
.. literalinclude:: ../examples/cluster_edge.py
:lines: 2-
.. image:: _static/cluster_edge.svg
:align: center
g_c_n.py
--------
.. literalinclude:: ../examples/g_c_n.py
:lines: 2-
.. image:: _static/g_c_n.svg
:align: center
angles.py
---------
.. literalinclude:: ../examples/angles.py
:lines: 2-
.. image:: _static/angles.svg
:align: center
.. _rank_same.py:
rank_same.py
------------
.. literalinclude:: ../examples/rank_same.py
:lines: 2-
.. image:: _static/rank_same.svg
:align: center
graphviz-0.14.2/docs/index.rst 0000666 0000000 0000000 00000000727 13737227654 014751 0 ustar root root .. graphviz documentation master file
.. include:: ../README.rst
User Guide
==========
.. toctree::
:maxdepth: 2
manual
Examples
========
.. toctree::
:maxdepth: 2
examples
Notebooks
=========
.. toctree::
:maxdepth: 2
notebooks
API Reference
=============
.. toctree::
:maxdepth: 2
api
Project Info
============
.. toctree::
:maxdepth: 2
changelog
license
graphviz-0.14.2/docs/license.rst 0000666 0000000 0000000 00000000101 13737227654 015246 0 ustar root root .. _license:
License
=======
.. include:: ../LICENSE.txt
graphviz-0.14.2/docs/manual.rst 0000666 0000000 0000000 00000045423 13737375420 015114 0 ustar root root .. _manual:
User Guide
==========
Installation
------------
:mod:`graphviz` provides a simple pure-Python interface for the Graphviz_
graph-drawing software. It runs under Python 2.7 and 3.5+. To install it
with pip_ run the following:
.. code:: bash
$ pip install graphviz
For a system-wide install, this typically requires administrator access. For an
isolated install, you can run the same inside a virtualenv_ or a
:mod:`py3:venv` (Python 3 only).
The only dependency is a working installation of Graphviz (`download page`_).
After installing Graphviz, make sure that its ``bin/`` subdirectory containing
the layout commands for rendering graph descriptions (``dot``, ``circo``,
``neato``, etc.) is on your systems' path: On the command-line, ``dot -V``
should print the version of your Graphiz installation.
Basic usage
-----------
The :mod:`graphviz` module provides two classes: :class:`.Graph` and
:class:`.Digraph`. They create graph descriptions in the DOT_ language for
undirected and directed graphs respectively. They have the same
:ref:`API `.
Create a graph by instantiating a new :class:`.Graph` or
:class:`.Digraph` object:
.. code:: python
>>> from graphviz import Digraph
>>> dot = Digraph(comment='The Round Table')
>>> dot #doctest: +ELLIPSIS
Their constructors allow to set the graph's :attr:`~.Graph.name`, the
:attr:`~.Graph.filename` for the DOT source and the rendered graph, a
:attr:`~.Graph.comment` for the first source code line, etc.
Add nodes and edges to the graph object using its :meth:`~.Graph.node` and
:meth:`~.Graph.edge`- or :meth:`~.Graph.edges`-methods:
.. code:: python
>>> dot.node('A', 'King Arthur')
>>> dot.node('B', 'Sir Bedevere the Wise')
>>> dot.node('L', 'Sir Lancelot the Brave')
>>> dot.edges(['AB', 'AL'])
>>> dot.edge('B', 'L', constraint='false')
The :meth:`~.Graph.node`-method takes a ``name`` identifier as first argument
and an optional ``label``. The :meth:`~.Graph.edge`-method takes the names of
start node and end node, while :meth:`~.Graph.edges` takes an iterable of
name pairs. Keyword arguments are turned into (node and edge) attributes (see
`Graphviz docs `_ on available attributes).
Check the generated source code:
.. code:: python
>>> print(dot.source) # doctest: +NORMALIZE_WHITESPACE
// The Round Table
digraph {
A [label="King Arthur"]
B [label="Sir Bedevere the Wise"]
L [label="Sir Lancelot the Brave"]
A -> B
A -> L
B -> L [constraint=false]
}
Use the :meth:`~.Graph.render`-method to save the source code and render it with the
default layout program (``dot``, see below for using `other layout commands
`_).
.. code:: python
>>> dot.render('test-output/round-table.gv', view=True) # doctest: +SKIP
'test-output/round-table.gv.pdf'
.. image:: _static/round-table.svg
:align: center
Passing ``view=True`` will automatically open the resulting (PDF, PNG, SVG,
etc.) file with your system's default viewer application for the file type.
Formats
-------
To use a different `output file format`_ than the default PDF, use the
:attr:`~.Graph.format` argument when creating your :class:`.Graph` or
:class:`.Digraph` object:
.. code:: python
>>> from graphviz import Graph
>>> g = Graph(format='png')
You can also change the :attr:`~.Graph.format` attribute on an existing graph
object:
.. code:: python
>>> dot.format = 'svg'
>>> dot.render() # doctest: +SKIP
'test-output/round-table.gv.svg'
Piped output
------------
To directly access the results from the Graphviz rendering command (e.g.
``dot``) as binary data string from within Python instead of writing to a file,
use the :meth:`~.Graph.pipe`-method of your :class:`.Graph` or
:class:`.Digraph` object:
.. code:: python
>>> h = Graph('hello', format='svg')
>>> h.edge('Hello', 'World')
>>> print(h.pipe().decode('utf-8')) # doctest: +NORMALIZE_WHITESPACE +ELLIPSIS
Note that :meth:`~.Graph.pipe` returns the raw ``stdout`` from the rendering
command (``str`` on Python 2, ``bytes`` on Python 3): When piping into
plain-text formats like ``'svg'`` or ``'plain'``, you usually want to decode
the return value as shown above.
.. note::
The output for :meth:`~.Graph.pipe` is buffered in memory, so do not use
this method if the data size is large.
Jupyter notebooks
-----------------
:class:`.Graph` and :class:`.Digraph` objects have a
:meth:`~.Graph._repr_svg_`-method so they can be rendered and displayed
directly inside a `Jupyter notebook`_. For an example, check the
``examples/notebook.ipynb`` file in the
`source repository/distribution `_ (or the same rendered
within nbviewer_).
This also allows direct displaying within the `Jupyter Qt Console`_ (e.g.
`the one `_ inside `Spyder IDE`_):
.. image:: _static/qtconsole.png
:align: center
Styling
-------
Use the :attr:`~.Graph.graph_attr`, :attr:`~.Graph.node_attr`, and
:attr:`~.Graph.edge_attr` arguments to change the default appearance_ of your
graph, nodes, and edges.
.. code:: python
>>> ps = Digraph(name='pet-shop', node_attr={'shape': 'plaintext'})
>>> ps.node('parrot')
>>> ps.node('dead')
>>> ps.edge('parrot', 'dead')
After creation, they can be edited on the graph object:
.. code:: python
>>> ps.graph_attr['rankdir'] = 'LR'
>>> ps.edge_attr.update(arrowhead='vee', arrowsize='2')
>>> print(ps.source) # doctest: +NORMALIZE_WHITESPACE
digraph "pet-shop" {
graph [rankdir=LR]
node [shape=plaintext]
edge [arrowhead=vee arrowsize=2]
parrot
dead
parrot -> dead
}
.. image:: _static/pet-shop.svg
:align: center
.. _attributes:
Attributes
----------
To directly add attritbute statements (affecting all following graph, node, or
edge items within the same (sub-)graph), use the :meth:`~.Graph.attr`-method
with the target as first argument:
.. code:: python
>>> ni = Graph('ni')
>>> ni.attr('node', shape='rarrow')
>>> ni.node('1', 'Ni!')
>>> ni.node('2', 'Ni!')
>>> ni.node('3', 'Ni!', shape='egg')
>>> ni.attr('node', shape='star')
>>> ni.node('4', 'Ni!')
>>> ni.node('5', 'Ni!')
By omitting its first argument, you can use it to set arbitrary attributes as
key-value pairs targeting the current (sub-)graph (e.g. for ``rankdir``,
``label``, or setting ``rank='same'`` within a subgraph context,
:ref:`example `):
.. code:: python
>>> ni.attr(rankdir='LR')
>>> ni.edges(['12', '23', '34', '45'])
>>> print(ni.source) # doctest: +NORMALIZE_WHITESPACE
graph ni {
node [shape=rarrow]
1 [label="Ni!"]
2 [label="Ni!"]
3 [label="Ni!" shape=egg]
node [shape=star]
4 [label="Ni!"]
5 [label="Ni!"]
rankdir=LR
1 -- 2
2 -- 3
3 -- 4
4 -- 5
}
.. image:: _static/ni.svg
:align: center
.. _ports:
Node ports & compass
--------------------
The :meth:`~.Graph.edge`- and :meth:`~.Graph.edges`-methods use the
colon-separated format ``node[:port[:compass]]`` for ``tail`` and ``head``
nodes. This allows to specify an optional node ``port`` plus an optional
``compass`` point the edge should aim at for the given tail or head node
(:ref:`example `).
As colons are used to indicate ``port`` and ``compass``, node names with
literal colon(s) (``:``) are not supported. Note that there is no such
restriction for the ``label`` argument, so you can work around by choosing a
colon-free ``name`` together with the wanted ``label``:
.. code:: python
>>> cpp = Digraph('C++')
>>> cpp.node('A', 'std::string')
>>> cpp.node('B', '"spam"')
>>> cpp.edge('A', 'B')
>>> print(cpp.source) # doctest: +NORMALIZE_WHITESPACE
digraph "C++" {
A [label="std::string"]
B [label="\"spam\""]
A -> B
}
Backslash escapes
-----------------
The Graphviz layout engine supports a number of
`escape sequences `_ such as ``\n``, ``\l``, ``\r`` (for multi-line
labels: centered, left-justified, right-justified) and ``\N``, ``\G``, ``\L``
(expanded to the current node name, graph name, object label). To be able to
use them from this library (e.g. for labels), strings with backslashes are
passed on as is. This means that literal backslashes need to be escaped
(doubled) by the user. As the backslash is also special in Python string
literals, a second level of doubling is needed (e.g. ``label='\\\\'``). This
kind of doubling can be avoided by using `raw string literals`_ (``r'...'``)
instead (same solution as proposed for the stdlib :mod:`re` module):
.. code:: python
>>> e = Digraph()
>>> e.node('backslash', label=r'\\')
>>> e.node('multi_line', label=r'centered\nleft\lright\r')
>>> print(e.source) # doctest: +NORMALIZE_WHITESPACE
digraph {
backslash [label="\\"]
multi_line [label="centered\nleft\lright\r"]
}
.. image:: _static/escapes.svg
:align: center
To disable any special character meaning in a string (e.g. from user input to
be rendered literally), use the :func:`.escape` function (cf. the
:func:`re.escape` function):
.. code:: python
>>> from graphviz import escape
>>> bs = Digraph()
>>> bs.node(escape('\\'))
>>> print(bs.source) # doctest: +NORMALIZE_WHITESPACE
digraph {
"\\"
}
.. note::
To prevent breaking the internal quoting mechanism, the special meaning of
``\"`` as a backslash-escaped quote has been disabled since version
``0.14``. E.g. both ``label='"'`` and ``label='\\"'`` now produce the same
DOT source ``[label="\""]`` (a label that renders as a literal quote).
Quoting and HTML-like labels
----------------------------
The graph-building methods of :class:`.Graph` and :class:`.Digraph` objects
automatically take care of quoting (and escaping quotes)
`where needed `_ (whitespace, keywords, double quotes, etc.):
.. code:: python
>>> q = Digraph()
>>> q.edge('spam', 'eggs eggs')
>>> q.edge('node', '"here\'s a quote"')
>>> print(q.source) # doctest: +NORMALIZE_WHITESPACE
digraph {
spam -> "eggs eggs"
"node" -> "\"here's a quote\""
}
If a string starts with ``'<'`` and ends with ``'>'``, it is passed on as is,
without quoting/escaping: The content between the angle brackets is treated by
the engine as special **HTML string** that can be used for `HTML-like labels`_:
.. code:: python
>>> h = Graph('html_table')
>>> h.node('tab', label='''<
...
... | left |
... right |
...
...
>''')
.. image:: _static/html_table.svg
:align: center
For strings that should literally begin with ``'<'`` and end with ``'>'``, use
the :func:`.nohtml` function to disable the special meaning of angled
parenthesis and apply normal quoting/escaping (before ``0.8.2``, the only
workaround was to add leading or trailing space, e.g. ``label=' <>'``):
.. code:: python
>>> from graphviz import nohtml
>>> d = Digraph(format='svg')
>>> d.node('diamond', label=nohtml('<>'))
>>> print(d.source) # doctest: +NORMALIZE_WHITESPACE
digraph {
diamond [label="<>"]
}
.. image:: _static/diamond.svg
:align: center
.. _subgraphs:
Subgraphs & clusters
--------------------
:class:`.Graph` and :class:`.Digraph` objects have a
:meth:`~.Graph.subgraph`-method for adding a subgraph to an instance.
There are two ways to use it: Either with a ready-made graph object of the same
kind as the only argument (whose content is added as a subgraph) or omitting
the ``graph`` argument (returning a context manager for defining the subgraph
content more elegantly within a ``with``-block).
First usage option, with ``graph`` as the only argument:
.. code:: python
>>> p = Graph(name='parent')
>>> p.edge('spam', 'eggs')
>>> c = Graph(name='child', node_attr={'shape': 'box'})
>>> c.edge('foo', 'bar')
>>> p.subgraph(c)
Second usage, with a ``with``-block (omitting the ``graph`` argument):
.. code:: python
>>> p = Graph(name='parent')
>>> p.edge('spam', 'eggs')
>>> with p.subgraph(name='child', node_attr={'shape': 'box'}) as c:
... c.edge('foo', 'bar')
Both produce the same result:
.. code:: python
>>> print(p.source) # doctest: +NORMALIZE_WHITESPACE
graph parent {
spam -- eggs
subgraph child {
node [shape=box]
foo -- bar
}
}
.. note::
If the ``name`` of a subgraph begins with ``'cluster'`` (all lowercase) the
layout engine will treat it as a special cluster subgraph
(:ref:`example `). Also see the `Subgraphs and Clusters`
section of `the DOT language documentation `_.
Engines
-------
To use a different layout command than the default ``dot`` when rendering your
graph, use the :attr:`~.Graph.engine` argument when creating your graph.
.. code:: python
>>> g = Graph(engine='neato')
You can also change the :attr:`~.Graph.engine` attribute of an existing
instance:
.. code:: python
>>> dot.engine = 'circo'
Custom DOT statements
---------------------
To add arbitrary statements to the created DOT_ source, use the
:attr:`~.Graph.body` attribute of the :class:`.Graph` or :class:`.Digraph`
object. It holds the verbatim list of lines to be written to the source file.
Use its ``append()``- or ``extend()``-method:
.. code:: python
>>> rt = Digraph(comment='The Round Table')
>>> rt.body.append('\t"King Arthur" -> {\n\t\t"Sir Bedevere", "Sir Lancelot"\n\t}')
>>> rt.edge('Sir Bedevere', 'Sir Lancelot', constraint='false')
>>> print(rt.source) # doctest: +NORMALIZE_WHITESPACE
// The Round Table
digraph {
"King Arthur" -> {
"Sir Bedevere", "Sir Lancelot"
}
"Sir Bedevere" -> "Sir Lancelot" [constraint=false]
}
Note that you might need to correctly quote/escape identifiers and strings
containing whitespace or other special characters when using this method.
Using raw DOT
-------------
To render a ready-made DOT source code string (instead of assembling one with
the higher-level interface of :class:`.Graph` or :class:`.Digraph`), create a
:class:`.Source` object holding your DOT string:
.. code:: python
>>> from graphviz import Source
>>> src = Source('digraph "the holy hand grenade" { rankdir=LR; 1 -> 2 -> 3 -> lob }')
>>> src #doctest: +ELLIPSIS
Use the :meth:`~.Source.render`-method to save and render it:
.. code:: python
>>> src.render('test-output/holy-grenade.gv', view=True) # doctest: +SKIP
'test-output/holy-grenade.gv.pdf'
.. image:: _static/holy-grenade.svg
:align: center
Apart from the missing editing methods, :class:`.Source` objects are the same
as the higher-level graph objects (:meth:`~.Source.pipe`-method,
:attr:`~.Source.format`, :attr:`~.Source.engine`, Jupyter notebook repr, etc.),
see above.
Existing files
--------------
To directly render an existing DOT source file (e.g. created with other tools),
you can use the :func:`graphviz.render` function.
.. code:: python
>>> from graphviz import render
>>> render('dot', 'png', 'test-output/holy-grenade.gv') # doctest: +SKIP
'test-output/holy-grenade.gv.png'
To directly display the graph of an existing DOT source file inside a
Jupyter `notebook `_ or `Qt Console `_,
you can use the :meth:`.Source.from_file`-classmethod (alternate constructor):
.. image:: _static/qtconsole-source.png
:align: center
Note that if you call :meth:`~.Source.render` or :meth:`~.Source.view` on the
returned :class:`.Source` object, it will still :meth:`~.Source.save` as usual
(i.e. write the content read into :attr:`~.Source.source` back into the file).
You can use :func:`graphviz.render` and :func:`graphiz.view` to directly work
on files in case you need to avoid this round-trip.
Integration with viewers
------------------------
On platforms such as Windows, viewer programs opened by rendering with
``view=True`` or the :meth:`~.Graph.view`-method might lock the (PDF, PNG,
etc.) file for as long as the viewer is open (blocking re-rendering it with a
``Permission denied`` error). You can use the :func:`~tempfile.mktemp` function
from the stdlib :mod:`tempfile` module to render to a different file for each
invocation to avoid needing to close the viewer window each time within such an
incremental workflow (and also preserve its intermediate steps):
.. code:: python
>>> import tempfile
>>> g = Graph()
>>> g.node('spam')
>>> g.view(tempfile.mktemp('.gv')) # doctest: +SKIP
'C:\\Users\\User\\AppData\\Local\\Temp\\tmp3aoie8d0.gv.pdf'
>>> g.view(tempfile.mktemp('.gv')) # doctest: +SKIP
'C:\\Users\\User\\AppData\\Local\\Temp\\tmphh4ig7a_.gv.pdf'
Other options are viewers that `support live updates`_ or using the Jupyter
`notebook `_ or `Qt Console `_ to
display the current version of the rendered graph in repeated add/render/view
cycles.
.. _pip: https://pip.readthedocs.io
.. _virtualenv: https://virtualenv.pypa.io
.. _Graphviz: https://www.graphviz.org
.. _download page: https://www.graphviz.org/download/
.. _DOT: https://www.graphviz.org/doc/info/lang.html
.. _output file format: https://www.graphviz.org/doc/info/output.html
.. _appearance: https://www.graphviz.org/doc/info/attrs.html
.. _escString: https://www.graphviz.org/doc/info/attrs.html#k:escString
.. _raw string literals: https://docs.python.org/3/reference/lexical_analysis.html#string-and-bytes-literals
.. _HTML-like labels: https://graphviz.gitlab.io/_pages/doc/info/shapes.html#html
.. _Jupyter notebook: https://jupyter.org
.. _notebook.ipynb: https://github.com/xflr6/graphviz/blob/master/examples/notebook.ipynb
.. _nbviewer: https://nbviewer.jupyter.org/github/xflr6/graphviz/blob/master/examples/notebook.ipynb
.. _Jupyter Qt Console: https://qtconsole.readthedocs.io
.. _spyderconsole: https://docs.spyder-ide.org/ipythonconsole.html
.. _Spyder IDE: https://github.com/spyder-ide/spyder
.. _support live updates: https://superuser.com/questions/599442/pdf-viewer-that-handles-live-updating-of-pdf-doesnt-lock-the-file
graphviz-0.14.2/docs/notebooks.rst 0000666 0000000 0000000 00000001057 13737227654 015642 0 ustar root root .. _notebooks:
Notebooks
=========
- Render gallery examples with logging: notebook.ipynb_
- Engine comparison: graphviz-engines.ipynb_
- Verify escaping and quoting: graphviz-escapes.ipynb_
.. _notebook.ipynb: https://nbviewer.jupyter.org/github/xflr6/graphviz/blob/master/examples/notebook.ipynb
.. _graphviz-engines.ipynb: https://nbviewer.jupyter.org/github/xflr6/graphviz/blob/master/examples/graphviz-engines.ipynb
.. _graphviz-escapes.ipynb: https://nbviewer.jupyter.org/github/xflr6/graphviz/blob/master/examples/graphviz-escapes.ipynb graphviz-0.14.2/docs/pet-shop.png 0000666 0000000 0000000 00000003461 13737227654 015353 0 ustar root root PNG
IHDR ; i~* bKGD IDATxMh[w23 ]ⲕv!(TЅ"T7FK5.JpU "(.. j]hBI|wq;Id=3s9ofU!"cl%0*8,I0&$ c8,I0&$ c8,I0&$ c8,I0&$be
8,Mׯ_ Dgg'.\/_]+033 ĶmpI{ʘV<$W( ؿ?B6 fcy4
Dϟcxx}}}w .s4.|wif >ԩSغu+nܸE+-oaa я֙T*Ec/--ѡCHUU4'K-b[5h4a!"f IQ ]IQ:x xr4j72,6,N~!MUUܼyׯ_/pd@Dx ~<|us (ADDe 2MdT>
8NqR~TH=eY1pѻs{.
%2 HUURoN۷ w0(L _qhbb. |:m@^`D8d۶*""0H$4ͲadY{b pUXc+1ޗ(*m^J?k]ai8{߰q>"b1@D*χj?*>H pp`'NJbF=Ak%^4b`Ku4N8Ao߾y=F(Q,&< ds5PR[ \< T j~Wʳmm((#`ΝB8|04Og=wJUmd2nPCCCx^~#GpPaǷbS 8p KKKE41\t ===>W6ñv =ѣGݐtttŋ8{,ls_uww7B ?6 +c ibnn o>\r###T4KX^^vDZk.+bpX
y?+fl-8,I0&$ c8,I0&$ c8,I0&$ c8,I0&IE0WJv& IENDB` graphviz-0.14.2/docs/round-table.png 0000666 0000000 0000000 00000035460 13737227654 016034 0 ustar root root PNG
IHDR c bKGD IDATx{Two \pQ ** T"jEe{9=}g=}}nZ[[]iXE[PV$@-&!p H2gg&"!B; BB!P@!nB@Zh4h4hiiA[[Z[[u: 48nnn \\\WWWH$H$xzz2B :UUUDUUP[[ BRZBVCv6X7 xyy&M)S0ydbDԋ܌7o ***PQQ\*tuu ?\]]OOO~G
H$~~vvv0AR05477ojPThnnFASS_B b1 "$$9s&܆%X
BPXX\᧟~O?* +MP J>>>D/EcP(娬DEE nOwHR̜9f9s 0888MT 2 c駟 (,,D{{;Ə 9s`֬Y AXXfΜ@/ Jף%%%(..[NR쌈DEE!::9sa2&P@`.\@ff&233T*#::L>]pmc ?3rssǵkנh%K ..K,YQ
BISS;ٳP*%Kxb,]f͂ .^"ddd 33/^D]] |}}j*d2\
BHQ@ TWW8q.\ H8d2a٣4PcqΟ?SNŋC\\ z!իWcڵXr%]/Z'NӧԄ+WG Ebb"ƍ't(T bWѣG ɰi&^18s >S9sx#""B@ z Nݻq%DEEa֭xG0a#VhhhÇ~cٲex嗱zj:CHj)BHNNFhh(֭[###غu+#Ȅ s!//Ν3d2_1
BLddd ::6mߏb8qqqqBF(>> |
nܸh<裸{qEC#P@sd2-[___O?EhhСA6{l|ͅD"%Ka(JC#fP@̛77oqi b8w N> ɓ'@t: abb"tR"lժU(((رQ,B*@,V#++ ă>(tH ?~ ?8.]/BD IGffMv®]cJ% ]VP$!!U"tH
2&Gmm-~̛7oH!> ϟ 8j۶m?Z636n8"GEEŋ(//s='t8N11>k+W j Jn不#**=TVV"00 p=y$֮]kt_`i&//{/b˖-BCȰ2ܾ}>a`7- >c~P W_}T +W OVc߾}C`"##/jjjaESx
ؼy`1(J۷7ovnzɓ'!vZTVV{y]">j*
2 uVs-j۶mî]{nTC\۶mc3=b5K .[lAdd$za'!62FT*6n8_|0nS+))aw8L&3yVVc1\ $~Ta̓Y~~>c{2 sseee|>s2(vBm
v# \vmPb jkk-t 3pSLZ}uV $$7}ɓXxqmۆ6;.{XgO)իW1|Ab dQ 3bbb JW_
oBDȘсy!66 :ASZZ
gggHn[ ۂw(**B^^ b2lS #G[ V /jtxS,T x2DFF֭[!SO Ҁ >|XrQPZZLZ7 }^y|g jA cO?z [lo-t8rAoq]믿RqOo&oߎݻw : BA 1mxgqF6D
رcRRR~AԋQ@ƼO= 駟bٲeBDpY< > ˗/8"BEȘrJ{+3Ν;BEIee%x Z
/ש8 T ѣGqa!$$;wF:42DT*?b̙ p >|Ǐ:4Blb Dkk+}vm۶K P* @$_?GGGC#ĦP@uuu{6m/PC#P\\wy$K:4Bl}}]aѢExꩧn:`j5K :t=f͚_|?8F!V8{, :cǎ 裏bprr8B mmmHKKqI㡇 O>˗ IZ_ҥKpqqU ɰzj^aԩS8y$Ξ=6,Y7o#<D"t8T 2@JN©SSLL /_%K`
pqq:QE˸p.\ `ʕ|-thT 2ڐg"##7n܀,XKbС(ոz*pE\r]]];w. ..N2@ dŋDFF1ydDEE!::QQQ 3kc
c r EEEz*rssqUTWW sA\\ .]ŋ= BT 24
]f+--c nnn9s&f͚3g",, 3f@PPШ;EjQQQR㧟~͛7qMhZ!$$| WWWC'd̠555᧟~BQQpQARA !J?Wz֢uuusJ%*** QYY
֯_XapsstY@ 0ưw^˘5k < ܺu r r J]]]4oooA"nnnpuuD"X̏{{{ @gg't: iZ
F?j\Q b>>> \iӦ֭[شi~g;Մ*B3<3g^o^c @Th4PhjjVFASS;z ycc#H$2 w |OOOoooרU صkv
L{Ǫq !C
Bt lݺ8x >Cŋ㏣
ǚ5k1~͑h4lݺ Xf
|q /FAA~@&!)) ---BEȘD- llڴ j } ~aCIG EX`!2P !äӟh"̘1T `Æ
(,,T*}݇7|BEȘA- Rlׯ_`wI )c?_ 8tO.tXzԂ@baϞ=DWW^ ;vPq"/"rssֆ۷O@ d(
d2ر/"0k,۷#)) P*BEȨE}qhQwHB 2 /^/;+;$!CZ$\EJ={PaB! Ԃ@ uvv3}T
6C2Ȩ0oS1{RwHBZىW瞣@@" VDDD?:,BF,*#Bkbǎ xMmHXX}vW:$BZy!PUU=V[bڵ}ج8 >> >o߆H$[o%@ZM|2_l ">>>8x R#...]pw2TBP *
6l=ʹ?"ѸSL1 /_ chjj8ZBZo:sEqq1u_$#awy!//h]wpp[( *M8p znbԩS 2BW^^ |A(J7V:t {1"#b +++;ى;w 99y"dh :t
lq uV !ƨ111(**2jn5eggcɒ% !+== +V@OiʂX, 1F-DPӟp ۸8444 Sd .J^to1 QbD0ϟo stt䏸چ#4BRputtqخ.EffpFYt fBCCCA,C׃1pd2<X` W\ӧBD"wkE0~x"&c#Z^FNC[[Z[[M>Q 7fsvvƸq y do! 0qDP*P*sjjjT*QWW:hhh7W;::B"nnnF+F:3vrr2@
Ϝ*ã S|,sE תaZ[[%3V_H$tjioooL~~~ ,}u (JTWWCP`/WruuZ[[1eL<|H$pvvV @Spww7^O-2\>hooGKKKMMMh4/JFAGGG7(7p{yyaĉ1>>>:b
]+** !q Ν;P*Fï≠ jð2P(%*n L2R Ȁ(
TVVB.ۨsDMM
qwwٜ`?Cswwk,@SSS uuuP*hoo L4 U%
c@h4(--5*Gee%a'Nȯ,N[ 5 ը2jQ(;w#q!((/R)R)N`
TDH555(++sW TVVo d ??? ">'TWWwk
Q{yy剠 bԩ1c$K47p"44SNH1
^[n ~:
QQQ.D"Hn_Zpp0Rsю_sܹs1o<̛7aaa{a|q?'''̘1è [\oc bAAA|;w.1mڴCs6] ڵk "h4b_FN .TVVIƍΆ[1w\DDD << su fr
\QVV.cΜ9|q/%Z[[
\~ D"9s y!22χС[dSBYYrrrpdgg#?? :s̡ "nݺettrz̘1111#22IGG dgg֭[ôia3uwFF6Caa!
PWW̟? ,@ll,bbb0}tC V z!--
.]BNN#&&E@@!gEVV_ QQQXp!xbm%FK.!--
?j IDAT???<e !|Wވŋ pZ@矑4ddd SNŋ
}ܹ fdT˗q5B||͠HKKCJJ
RSSЀ$$$`Ŋ 1pmoӧ D$$$KRǑ 8::bXf
"!z=]4 ;v 8q"˗uyV ?_
V ?0֭[ɓ',ZZZѣo҂8lٲ#v =z 1.]WWW $%%aƍ'ZK/16n8OLb*0{{{vZ? Vrrrؚ5k 2e
{뭷؝;wQ ~`7ofNNNlW^a555V
fo2777v5cBHt:~Z]vM谺)--eׯg"w}㬳S3jkko&M\\\ث4
^;{뭷Xsss n;wd;w:
KNNf2LPHX&[_/q9ۙZ:$ob1={6;~!Ym4b ya4jiia.b^^^O?z^ rJ&ً/jkkbIII KJJbLR1ӳ&X|ݻwP[~ P-1v=\nqBavNOO6 ' e{8r>wn&J%$$0GG> ! }1X֯_oS *jЦ;ޭ npҥK,((M>ݼya-~Seeeۛ-_VxK;!Nͽ>XMe#@PTfP.SRR^.3 [
^goc zZ-Z%''3Vۧ~ΎokCrOwkh8rhQ__-Z&O~ÙXXXgCdq+^~~~ Ws^
2LT*KJJI
od,==}JŒKJJNt!s͘R,}-;wH")))>}^pCjjM&fy;űw^d
wa &H$bƍc7ndNb =?2{{{k0B t+LT*w^~;wۅi ܶ#ɺ[oMΚ4
YKۻ)!w3Xזe˖c}7әF R /yVV7qJg#R(L&s[I&$>fÍњpKV;w4z Yk>#3BtGyNtsN ;w`zݍ۸U*#V!lٲ2^\`ppp` ;{gم XWWx]]],""m߾}cl!WZ5
Mtnl=d|HÝ=}=}7{mJbSLxۧμؾ}<())1%99opϭ=mb8
+Kip;{
oz2?Sv>3kϒk6jnc>_4^ Ř $V!TUU1X222z \`pttd /{WngΜaLT pploihfee #3v0
kRܽϚ\mkk}6i$ݾen
e{5_O
P(Ν;L&3ژ +ScχΣpGEmzzzasmciI_s؆P{f0r)--e O[ħOf F}8\lF aVّ7FcZV,o"Fc VM=RRRba6nI||;>"""^>\a{-^4XN_s`'kc ӷf~=W06kk vܹnu[7o26ϗp ~\rO+`nmz}otN0++rGCy[3$$nrvzzū--?w>ҴHhB
bovv{pR)۵k{Yhh0,IJ`Mܶ]ҟ/MDZ6p4`@Ϳw[O6wc8Lsa Xyyy~gPo\^Oaћp;/nx}Ӎt M{\xoӰ\ۚȚ3/C͟!tĴ@c n/^df7zS=)ooo?7WJKKM-
Zp)L,m;kmc>w1}?2ŝ'4mGC6h\A6XJbsa=UÛL$1777OtwEܺu+w]7/n{Fئ5ܶcz;))|di
Oי=a[2y/盛Psb
f߷?3ۛݸqcȂ/-))gp1%qn۸{5r~IJJ6 \Õ0\KMY`ͼ]`y<;/s6wb~~ū-gw܆?XFa˖-c3f`MMMVcX 8::׳:nCC2e
[f
kiihN\av\ wik n\sñ&Ns2wl%Õ{n{n
kK7{-#b1L+Wȑ#Xb!6_EBBp%̘1êt: z)Z
H$}oYY-Z ?~ ~~~ 2Llܸ˗/ѣGaooov8;Kpttɓ'n:Z
*Z[[,`BH 9rtɱ8 :t6msq |2j5Νcǎyڊ 2 =+ 3'a8p swwgR 8p !(**bVb"رCk֭[ o_5!DG aR ? >|تq, z'pM\[lADDN>=H5
!3 <<
x"XL{Aff&4
裏_~,&Bƺo˗7nj\
{QXX3f`X` 8@ &.\~;"33Gnn.,Y"thŋ ~ѣGq5̞=>(.]$th ---ؿ?j*xyyʕ+Oo\ {1&L^zscBFJ{=6k,w}СC͖t:石X>~BѠ ӓ9;; ^ ֪ŁG -#'|'N д\ pz=Ν;/hllDll, ~a$&&"((h0fCȨ܌SN!%%ONҥKalذnnnB8(p|嗸pzjb 8q"&L@MC
hhh@MM
P(PSS_]]
Vˏd6sO2 b[Q\۷o ɓ'????>WЍc hhh@}}=J%QSS;w
J: wfs;;*V#j(J9rԠ۸\`X4>wssD"!H
wwwxxx+ۛjhZ
FF
tttMŅO\B5Wč =`pGvF;qtt#La~0dQ^Z&Rjd6Go 3:3c $POP*JYWWgvf_tqq w=pH$ppp3ƍX 777Dn}c-} ,u: 4q4Qjсv kjjBWWqk4j-i#12"477םsn|!?ۿ;'''8::
1}n7 n7}܌N j|!JBss34M9ͭ e/ì?z掦ۙjZ~2Z[[m#q+28EiIK$0yzz-(GEt9!ݵmmh4Z
^ommmF;_nmΞSQftG\K7H$Fyg|ZY|!HL+B!P9F!n@ BH7T B!1B! &pi5 IENDB` graphviz-0.14.2/examples/ 0000777 0000000 0000000 00000000000 13737401626 013761 5 ustar root root graphviz-0.14.2/examples/angles.py 0000666 0000000 0000000 00000002225 13737227654 015614 0 ustar root root #!/usr/bin/env python
# angles.py - http://www.graphviz.org/Gallery/gradient/angles.html
from graphviz import Digraph
g = Digraph('G', filename='angles.gv')
g.attr(bgcolor='blue')
with g.subgraph(name='cluster_1') as c:
c.attr(fontcolor='white')
c.attr('node', shape='circle', style='filled', fillcolor='white:black',
gradientangle='360', label='n9:360', fontcolor='black')
c.node('n9')
for i, a in zip(range(8, 0, -1), range(360 - 45, -1, -45)):
c.attr('node', gradientangle='%d' % a, label='n%d:%d' % (i, a))
c.node('n%d' % i)
c.attr(label='Linear Angle Variations (white to black gradient)')
with g.subgraph(name='cluster_2') as c:
c.attr(fontcolor='white')
c.attr('node', shape='circle', style='radial', fillcolor='white:black',
gradientangle='360', label='n18:360', fontcolor='black')
c.node('n18')
for i, a in zip(range(17, 9, -1), range(360 - 45, -1, -45)):
c.attr('node', gradientangle='%d' % a, label='n%d:%d' % (i, a))
c.node('n%d' % i)
c.attr(label='Radial Angle Variations (white to black gradient)')
g.edge('n5', 'n14')
g.view()
graphviz-0.14.2/examples/btree.py 0000666 0000000 0000000 00000001623 13737227654 015445 0 ustar root root #!/usr/bin/env python
# btree.py - http://www.graphviz.org/pdf/dotguide.pdf Figure 13
from graphviz import Digraph, nohtml
g = Digraph('g', filename='btree.gv',
node_attr={'shape': 'record', 'height': '.1'})
g.node('node0', nohtml(' | G|'))
g.node('node1', nohtml(' | E|'))
g.node('node2', nohtml(' | B|'))
g.node('node3', nohtml(' | F|'))
g.node('node4', nohtml(' | R|'))
g.node('node5', nohtml(' | H|'))
g.node('node6', nohtml(' | Y|'))
g.node('node7', nohtml(' | A|'))
g.node('node8', nohtml(' | C|'))
g.edge('node0:f2', 'node4:f1')
g.edge('node0:f0', 'node1:f1')
g.edge('node1:f0', 'node2:f1')
g.edge('node1:f2', 'node3:f1')
g.edge('node2:f2', 'node8:f1')
g.edge('node2:f0', 'node7:f1')
g.edge('node4:f2', 'node6:f1')
g.edge('node4:f0', 'node5:f1')
g.view()
graphviz-0.14.2/examples/cluster.py 0000666 0000000 0000000 00000001677 13737227654 016036 0 ustar root root #!/usr/bin/env python
# cluster.py - http://www.graphviz.org/content/cluster
from graphviz import Digraph
g = Digraph('G', filename='cluster.gv')
# NOTE: the subgraph name needs to begin with 'cluster' (all lowercase)
# so that Graphviz recognizes it as a special cluster subgraph
with g.subgraph(name='cluster_0') as c:
c.attr(style='filled', color='lightgrey')
c.node_attr.update(style='filled', color='white')
c.edges([('a0', 'a1'), ('a1', 'a2'), ('a2', 'a3')])
c.attr(label='process #1')
with g.subgraph(name='cluster_1') as c:
c.attr(color='blue')
c.node_attr['style'] = 'filled'
c.edges([('b0', 'b1'), ('b1', 'b2'), ('b2', 'b3')])
c.attr(label='process #2')
g.edge('start', 'a0')
g.edge('start', 'b0')
g.edge('a1', 'b3')
g.edge('b2', 'a3')
g.edge('a3', 'a0')
g.edge('a3', 'end')
g.edge('b3', 'end')
g.node('start', shape='Mdiamond')
g.node('end', shape='Msquare')
g.view()
graphviz-0.14.2/examples/cluster_edge.py 0000666 0000000 0000000 00000001016 13737227654 017005 0 ustar root root #!/usr/bin/env python
# cluster_edge.py - http://www.graphviz.org/pdf/dotguide.pdf Figure 20
from graphviz import Digraph
g = Digraph('G', filename='cluster_edge.gv')
g.attr(compound='true')
with g.subgraph(name='cluster0') as c:
c.edges(['ab', 'ac', 'bd', 'cd'])
with g.subgraph(name='cluster1') as c:
c.edges(['eg', 'ef'])
g.edge('b', 'f', lhead='cluster1')
g.edge('d', 'e')
g.edge('c', 'g', ltail='cluster0', lhead='cluster1')
g.edge('c', 'e', ltail='cluster0')
g.edge('d', 'h')
g.view()
graphviz-0.14.2/examples/er.py 0000666 0000000 0000000 00000002114 13737227654 014746 0 ustar root root #!/usr/bin/env python
# er.py - http://www.graphviz.org/content/ER
from graphviz import Graph
e = Graph('ER', filename='er.gv', engine='neato')
e.attr('node', shape='box')
e.node('course')
e.node('institute')
e.node('student')
e.attr('node', shape='ellipse')
e.node('name0', label='name')
e.node('name1', label='name')
e.node('name2', label='name')
e.node('code')
e.node('grade')
e.node('number')
e.attr('node', shape='diamond', style='filled', color='lightgrey')
e.node('C-I')
e.node('S-C')
e.node('S-I')
e.edge('name0', 'course')
e.edge('code', 'course')
e.edge('course', 'C-I', label='n', len='1.00')
e.edge('C-I', 'institute', label='1', len='1.00')
e.edge('institute', 'name1')
e.edge('institute', 'S-I', label='1', len='1.00')
e.edge('S-I', 'student', label='n', len='1.00')
e.edge('student', 'grade')
e.edge('student', 'name2')
e.edge('student', 'number')
e.edge('student', 'S-C', label='m', len='1.00')
e.edge('S-C', 'course', label='n', len='1.00')
e.attr(label=r'\n\nEntity Relation Diagram\ndrawn by NEATO')
e.attr(fontsize='20')
e.view()
graphviz-0.14.2/examples/fdpclust.py 0000666 0000000 0000000 00000000725 13737227654 016172 0 ustar root root #!/usr/bin/env python
# fdpclust.py - http://www.graphviz.org/content/fdpclust
from graphviz import Graph
g = Graph('G', filename='fdpclust.gv', engine='fdp')
g.node('e')
with g.subgraph(name='clusterA') as a:
a.edge('a', 'b')
with a.subgraph(name='clusterC') as c:
c.edge('C', 'D')
with g.subgraph(name='clusterB') as b:
b.edge('d', 'f')
g.edge('d', 'D')
g.edge('e', 'clusterB')
g.edge('clusterC', 'clusterB')
g.view()
graphviz-0.14.2/examples/fsm.py 0000666 0000000 0000000 00000001564 13737227654 015135 0 ustar root root #!/usr/bin/env python
# fsm.py - http://www.graphviz.org/content/fsm
from graphviz import Digraph
f = Digraph('finite_state_machine', filename='fsm.gv')
f.attr(rankdir='LR', size='8,5')
f.attr('node', shape='doublecircle')
f.node('LR_0')
f.node('LR_3')
f.node('LR_4')
f.node('LR_8')
f.attr('node', shape='circle')
f.edge('LR_0', 'LR_2', label='SS(B)')
f.edge('LR_0', 'LR_1', label='SS(S)')
f.edge('LR_1', 'LR_3', label='S($end)')
f.edge('LR_2', 'LR_6', label='SS(b)')
f.edge('LR_2', 'LR_5', label='SS(a)')
f.edge('LR_2', 'LR_4', label='S(A)')
f.edge('LR_5', 'LR_7', label='S(b)')
f.edge('LR_5', 'LR_5', label='S(a)')
f.edge('LR_6', 'LR_6', label='S(b)')
f.edge('LR_6', 'LR_5', label='S(a)')
f.edge('LR_7', 'LR_8', label='S(b)')
f.edge('LR_7', 'LR_5', label='S(a)')
f.edge('LR_8', 'LR_6', label='S(b)')
f.edge('LR_8', 'LR_5', label='S(a)')
f.view()
graphviz-0.14.2/examples/graphviz-engines.ipynb 0000666 0000000 0000000 00000063550 13737227654 020324 0 ustar root root {
"cells": [
{
"cell_type": "code",
"execution_count": 1,
"metadata": {
"scrolled": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"circo\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"dot\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"fdp\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"neato\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"osage\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"patchwork\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"sfdp\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"twopi\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n"
]
}
],
"source": [
"from IPython.display import display\n",
"\n",
"import graphviz\n",
"\n",
"dot = graphviz.Digraph()\n",
"dot.edges(['AB', 'BC', 'AC'])\n",
"\n",
"for engine in sorted(graphviz.ENGINES):\n",
" print(engine)\n",
" dot.engine = engine\n",
" display(dot)\n",
" print()"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.7.4"
}
},
"nbformat": 4,
"nbformat_minor": 2
}
graphviz-0.14.2/examples/graphviz-escapes.ipynb 0000666 0000000 0000000 00000032057 13737227654 020315 0 ustar root root {
"cells": [
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
"%cd -q ..\n",
"\n",
"import graphviz\n",
"\n",
"def make_graph(node_label=None, graph_name=None, **node_kwargs):\n",
" result = graphviz.Digraph(name=graph_name)\n",
" result.node('A', label=node_label, **node_kwargs)\n",
" print(result)\n",
" return result"
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"digraph {\n",
"\tA [label=\"\\\"\"]\n",
"}\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 2,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"make_graph(node_label='\"')"
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"digraph {\n",
"\tA [label=\"\\\\\"]\n",
"}\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 3,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"make_graph(node_label=r'\\\\')"
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"digraph {\n",
"\tA [label=\"\\\\\\\"\"]\n",
"}\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 4,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"make_graph(node_label=r'\\\\\"')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"https://www.graphviz.org/doc/info/attrs.html#k:escString"
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"digraph {\n",
"\tA [label=\"node: \\N\"]\n",
"}\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 5,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"make_graph(node_label=r'node: \\N')"
]
},
{
"cell_type": "code",
"execution_count": 6,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"digraph spam {\n",
"\tA [label=\"graph: \\G\"]\n",
"}\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 6,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"make_graph(node_label=r'graph: \\G', graph_name='spam')"
]
},
{
"cell_type": "code",
"execution_count": 7,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"digraph {\n",
"\tA [label=spam URL=\"https://example.org/\\L\"]\n",
"}\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 7,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"make_graph(node_label='spam', URL=r'https://example.org/\\L')"
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"digraph {\n",
"\tA [label=\"centered\\nleft\\lright\\r\"]\n",
"}\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 8,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"make_graph(node_label=r'centered\\nleft\\lright\\r')"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.8.2"
}
},
"nbformat": 4,
"nbformat_minor": 2
}
graphviz-0.14.2/examples/g_c_n.py 0000666 0000000 0000000 00000001002 13737227654 015400 0 ustar root root #!/usr/bin/env python
# http://www.graphviz.org/Gallery/gradient/g_c_n.html
from graphviz import Graph
g = Graph('G', filename='g_c_n.gv')
g.attr(bgcolor='purple:pink', label='agraph', fontcolor='white')
with g.subgraph(name='cluster1') as c:
c.attr(fillcolor='blue:cyan', label='acluster', fontcolor='white',
style='filled', gradientangle='270')
c.attr('node', shape='box', fillcolor='red:yellow',
style='filled', gradientangle='90')
c.node('anode')
g.view()
graphviz-0.14.2/examples/hello.py 0000666 0000000 0000000 00000000274 13737227654 015450 0 ustar root root #!/usr/bin/env python
# hello.py - http://www.graphviz.org/content/hello
from graphviz import Digraph
g = Digraph('G', filename='hello.gv')
g.edge('Hello', 'World')
g.view()
graphviz-0.14.2/examples/notebook.ipynb 0000666 0000000 0000000 00000076271 13737366202 016661 0 ustar root root {
"cells": [
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
"import logging\n",
"\n",
"logging.basicConfig(format='[%(levelname)s@%(name)s] %(message)s', level=logging.DEBUG)"
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[DEBUG@graphviz.backend] run ['dot', '-Tsvg']\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 2,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"from graphviz import Digraph\n",
"\n",
"dot = Digraph(comment='The Round Table')\n",
"\n",
"dot.node('A', 'King Arthur')\n",
"dot.node('B', 'Sir Bedevere the Wise')\n",
"dot.node('L', 'Sir Lancelot the Brave')\n",
"\n",
"dot.edges(['AB', 'AL'])\n",
"dot.edge('B', 'L', constraint='false')\n",
"\n",
"dot"
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[DEBUG@graphviz.backend] run ['dot', '-Tsvg']\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 3,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"from graphviz import Source\n",
"\n",
"src = Source('digraph \"the holy hand grenade\" { rankdir=LR; 1 -> 2 -> 3 -> lob }')\n",
"src"
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[DEBUG@graphviz.backend] run ['dot', '-Tsvg']\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 4,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# http://www.graphviz.org/content/fsm\n",
"\n",
"from graphviz import Digraph\n",
"\n",
"f = Digraph('finite_state_machine', filename='fsm.gv')\n",
"f.attr(rankdir='LR', size='8,5')\n",
"\n",
"f.attr('node', shape='doublecircle')\n",
"f.node('LR_0')\n",
"f.node('LR_3')\n",
"f.node('LR_4')\n",
"f.node('LR_8')\n",
"\n",
"f.attr('node', shape='circle')\n",
"f.edge('LR_0', 'LR_2', label='SS(B)')\n",
"f.edge('LR_0', 'LR_1', label='SS(S)')\n",
"f.edge('LR_1', 'LR_3', label='S($end)')\n",
"f.edge('LR_2', 'LR_6', label='SS(b)')\n",
"f.edge('LR_2', 'LR_5', label='SS(a)')\n",
"f.edge('LR_2', 'LR_4', label='S(A)')\n",
"f.edge('LR_5', 'LR_7', label='S(b)')\n",
"f.edge('LR_5', 'LR_5', label='S(a)')\n",
"f.edge('LR_6', 'LR_6', label='S(b)')\n",
"f.edge('LR_6', 'LR_5', label='S(a)')\n",
"f.edge('LR_7', 'LR_8', label='S(b)')\n",
"f.edge('LR_7', 'LR_5', label='S(a)')\n",
"f.edge('LR_8', 'LR_6', label='S(b)')\n",
"f.edge('LR_8', 'LR_5', label='S(a)')\n",
"\n",
"f"
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"[DEBUG@graphviz.backend] run ['dot', '-Tsvg']\n"
]
},
{
"data": {
"image/svg+xml": [
"\r\n",
"\r\n",
"\r\n",
"\r\n",
"\r\n"
],
"text/plain": [
""
]
},
"execution_count": 5,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# http://www.graphviz.org/pdf/dotguide.pdf Figure 20\n",
"\n",
"from graphviz import Digraph\n",
"\n",
"g = Digraph('G', filename='cluster_edge.gv')\n",
"g.attr(compound='true')\n",
"\n",
"with g.subgraph(name='cluster0') as c:\n",
" c.edges(['ab', 'ac', 'bd', 'cd'])\n",
"\n",
"with g.subgraph(name='cluster1') as c:\n",
" c.edges(['eg', 'ef'])\n",
"\n",
"g.edge('b', 'f', lhead='cluster1')\n",
"g.edge('d', 'e')\n",
"g.edge('c', 'g', ltail='cluster0', lhead='cluster1')\n",
"g.edge('c', 'e', ltail='cluster0')\n",
"g.edge('d', 'h')\n",
"\n",
"g"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.7.4"
}
},
"nbformat": 4,
"nbformat_minor": 1
}
graphviz-0.14.2/examples/process.py 0000666 0000000 0000000 00000001006 13737227654 016015 0 ustar root root #!/usr/bin/env python
# process.py - http://www.graphviz.org/content/process
from graphviz import Graph
g = Graph('G', filename='process.gv', engine='sfdp')
g.edge('run', 'intr')
g.edge('intr', 'runbl')
g.edge('runbl', 'run')
g.edge('run', 'kernel')
g.edge('kernel', 'zombie')
g.edge('kernel', 'sleep')
g.edge('kernel', 'runmem')
g.edge('sleep', 'swap')
g.edge('swap', 'runswap')
g.edge('runswap', 'new')
g.edge('runswap', 'runmem')
g.edge('new', 'runmem')
g.edge('sleep', 'runmem')
g.view()
graphviz-0.14.2/examples/rank_same.py 0000666 0000000 0000000 00000000666 13737227654 016312 0 ustar root root #!/usr/bin/env python
# https://stackoverflow.com/questions/25734244/how-do-i-place-nodes-on-the-same-level-in-dot
import graphviz
d = graphviz.Digraph(filename='rank_same.gv')
with d.subgraph() as s:
s.attr(rank='same')
s.node('A')
s.node('X')
d.node('C')
with d.subgraph() as s:
s.attr(rank='same')
s.node('B')
s.node('D')
s.node('Y')
d.edges(['AB', 'AC', 'CD', 'XY'])
d.view()
graphviz-0.14.2/examples/structs.py 0000666 0000000 0000000 00000001725 13737227654 016056 0 ustar root root #!/usr/bin/env python
# structs.py - http://www.graphviz.org/doc/info/shapes.html#html
from graphviz import Digraph
s = Digraph('structs', node_attr={'shape': 'plaintext'})
s.node('struct1', '''<
>''')
s.node('struct2', '''<
>''')
s.node('struct3', '''<
>''')
s.edges([('struct1:f1', 'struct2:f0'), ('struct1:f2', 'struct3:here')])
s.view()
graphviz-0.14.2/examples/structs_revisited.py 0000666 0000000 0000000 00000000747 13737227654 020137 0 ustar root root #!/usr/bin/env python
# structs_revisited.py - http://www.graphviz.org/pdf/dotguide.pdf Figure 12
from graphviz import Digraph
s = Digraph('structs', filename='structs_revisited.gv',
node_attr={'shape': 'record'})
s.node('struct1', ' left| middle| right')
s.node('struct2', ' one| two')
s.node('struct3', r'hello\nworld |{ b |{c| d|e}| f}| g | h')
s.edges([('struct1:f1', 'struct2:f0'), ('struct1:f2', 'struct3:here')])
s.view()
graphviz-0.14.2/examples/traffic_lights.py 0000666 0000000 0000000 00000002013 13737227654 017326 0 ustar root root #!/usr/bin/env python
# traffic_lights.py - http://www.graphviz.org/content/traffic_lights
from graphviz import Digraph
t = Digraph('TrafficLights', filename='traffic_lights.gv', engine='neato')
t.attr('node', shape='box')
for i in (2, 1):
t.node('gy%d' % i)
t.node('yr%d' % i)
t.node('rg%d' % i)
t.attr('node', shape='circle', fixedsize='true', width='0.9')
for i in (2, 1):
t.node('green%d' % i)
t.node('yellow%d' % i)
t.node('red%d' % i)
t.node('safe%d' % i)
for i, j in [(2, 1), (1, 2)]:
t.edge('gy%d' % i, 'yellow%d' % i)
t.edge('rg%d' % i, 'green%d' % i)
t.edge('yr%d' % i, 'safe%d' % j)
t.edge('yr%d' % i, 'red%d' % i)
t.edge('safe%d' % i, 'rg%d' % i)
t.edge('green%d' % i, 'gy%d' % i)
t.edge('yellow%d' % i, 'yr%d' % i)
t.edge('red%d' % i, 'rg%d' % i)
t.attr(overlap='false')
t.attr(label=r'PetriNet Model TrafficLights\n'
r'Extracted from ConceptBase and layed out by Graphviz')
t.attr(fontsize='12')
t.view()
graphviz-0.14.2/examples/unix.py 0000666 0000000 0000000 00000003457 13737227654 015336 0 ustar root root #!/usr/bin/env python
# unix.py - http://www.graphviz.org/content/unix
from graphviz import Digraph
u = Digraph('unix', filename='unix.gv',
node_attr={'color': 'lightblue2', 'style': 'filled'})
u.attr(size='6,6')
u.edge('5th Edition', '6th Edition')
u.edge('5th Edition', 'PWB 1.0')
u.edge('6th Edition', 'LSX')
u.edge('6th Edition', '1 BSD')
u.edge('6th Edition', 'Mini Unix')
u.edge('6th Edition', 'Wollongong')
u.edge('6th Edition', 'Interdata')
u.edge('Interdata', 'Unix/TS 3.0')
u.edge('Interdata', 'PWB 2.0')
u.edge('Interdata', '7th Edition')
u.edge('7th Edition', '8th Edition')
u.edge('7th Edition', '32V')
u.edge('7th Edition', 'V7M')
u.edge('7th Edition', 'Ultrix-11')
u.edge('7th Edition', 'Xenix')
u.edge('7th Edition', 'UniPlus+')
u.edge('V7M', 'Ultrix-11')
u.edge('8th Edition', '9th Edition')
u.edge('1 BSD', '2 BSD')
u.edge('2 BSD', '2.8 BSD')
u.edge('2.8 BSD', 'Ultrix-11')
u.edge('2.8 BSD', '2.9 BSD')
u.edge('32V', '3 BSD')
u.edge('3 BSD', '4 BSD')
u.edge('4 BSD', '4.1 BSD')
u.edge('4.1 BSD', '4.2 BSD')
u.edge('4.1 BSD', '2.8 BSD')
u.edge('4.1 BSD', '8th Edition')
u.edge('4.2 BSD', '4.3 BSD')
u.edge('4.2 BSD', 'Ultrix-32')
u.edge('PWB 1.0', 'PWB 1.2')
u.edge('PWB 1.0', 'USG 1.0')
u.edge('PWB 1.2', 'PWB 2.0')
u.edge('USG 1.0', 'CB Unix 1')
u.edge('USG 1.0', 'USG 2.0')
u.edge('CB Unix 1', 'CB Unix 2')
u.edge('CB Unix 2', 'CB Unix 3')
u.edge('CB Unix 3', 'Unix/TS++')
u.edge('CB Unix 3', 'PDP-11 Sys V')
u.edge('USG 2.0', 'USG 3.0')
u.edge('USG 3.0', 'Unix/TS 3.0')
u.edge('PWB 2.0', 'Unix/TS 3.0')
u.edge('Unix/TS 1.0', 'Unix/TS 3.0')
u.edge('Unix/TS 3.0', 'TS 4.0')
u.edge('Unix/TS++', 'TS 4.0')
u.edge('CB Unix 3', 'TS 4.0')
u.edge('TS 4.0', 'System V.0')
u.edge('System V.0', 'System V.2')
u.edge('System V.2', 'System V.3')
u.view()
graphviz-0.14.2/graphviz/ 0000777 0000000 0000000 00000000000 13737401626 013775 5 ustar root root graphviz-0.14.2/graphviz/backend.py 0000666 0000000 0000000 00000025165 13737366154 015755 0 ustar root root # backend.py - execute rendering, open files in viewer
import os
import re
import errno
import logging
import platform
import subprocess
from . import _compat
from . import tools
__all__ = [
'render', 'pipe', 'version', 'view',
'ENGINES', 'FORMATS', 'RENDERERS', 'FORMATTERS',
'ExecutableNotFound', 'RequiredArgumentError',
]
ENGINES = { # http://www.graphviz.org/pdf/dot.1.pdf
'dot', 'neato', 'twopi', 'circo', 'fdp', 'sfdp', 'patchwork', 'osage',
}
FORMATS = { # http://www.graphviz.org/doc/info/output.html
'bmp',
'canon', 'dot', 'gv', 'xdot', 'xdot1.2', 'xdot1.4',
'cgimage',
'cmap',
'eps',
'exr',
'fig',
'gd', 'gd2',
'gif',
'gtk',
'ico',
'imap', 'cmapx',
'imap_np', 'cmapx_np',
'ismap',
'jp2',
'jpg', 'jpeg', 'jpe',
'json', 'json0', 'dot_json', 'xdot_json', # Graphviz 2.40
'pct', 'pict',
'pdf',
'pic',
'plain', 'plain-ext',
'png',
'pov',
'ps',
'ps2',
'psd',
'sgi',
'svg', 'svgz',
'tga',
'tif', 'tiff',
'tk',
'vml', 'vmlz',
'vrml',
'wbmp',
'webp',
'xlib',
'x11',
}
RENDERERS = { # $ dot -T:
'cairo',
'dot',
'fig',
'gd',
'gdiplus',
'map',
'pic',
'pov',
'ps',
'svg',
'tk',
'vml',
'vrml',
'xdot',
}
FORMATTERS = {'cairo', 'core', 'gd', 'gdiplus', 'gdwbmp', 'xlib'}
PLATFORM = platform.system().lower()
log = logging.getLogger(__name__)
class ExecutableNotFound(RuntimeError):
"""Exception raised if the Graphviz executable is not found."""
_msg = ('failed to execute %r, '
'make sure the Graphviz executables are on your systems\' PATH')
def __init__(self, args):
super(ExecutableNotFound, self).__init__(self._msg % args)
class RequiredArgumentError(Exception):
"""Exception raised if a required argument is missing."""
class CalledProcessError(_compat.CalledProcessError):
def __str__(self):
s = super(CalledProcessError, self).__str__()
return '%s [stderr: %r]' % (s, self.stderr)
def command(engine, format_, filepath=None, renderer=None, formatter=None):
"""Return args list for ``subprocess.Popen`` and name of the rendered file."""
if formatter is not None and renderer is None:
raise RequiredArgumentError('formatter given without renderer')
if engine not in ENGINES:
raise ValueError('unknown engine: %r' % engine)
if format_ not in FORMATS:
raise ValueError('unknown format: %r' % format_)
if renderer is not None and renderer not in RENDERERS:
raise ValueError('unknown renderer: %r' % renderer)
if formatter is not None and formatter not in FORMATTERS:
raise ValueError('unknown formatter: %r' % formatter)
output_format = [f for f in (format_, renderer, formatter) if f is not None]
cmd = [engine, '-T%s' % ':'.join(output_format)]
if filepath is None:
rendered = None
else:
cmd.extend(['-O', filepath])
suffix = '.'.join(reversed(output_format))
rendered = '%s.%s' % (filepath, suffix)
return cmd, rendered
if PLATFORM == 'windows': # pragma: no cover
def get_startupinfo():
"""Return subprocess.STARTUPINFO instance hiding the console window."""
startupinfo = subprocess.STARTUPINFO()
startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
startupinfo.wShowWindow = subprocess.SW_HIDE
return startupinfo
else:
def get_startupinfo():
"""Return None for startupinfo argument of ``subprocess.Popen``."""
return None
def run(cmd, input=None, capture_output=False, check=False, encoding=None,
quiet=False, **kwargs):
"""Run the command described by cmd and return its (stdout, stderr) tuple."""
log.debug('run %r', cmd)
if input is not None:
kwargs['stdin'] = subprocess.PIPE
if encoding is not None:
input = input.encode(encoding)
if capture_output:
kwargs['stdout'] = kwargs['stderr'] = subprocess.PIPE
try:
proc = subprocess.Popen(cmd, startupinfo=get_startupinfo(), **kwargs)
except OSError as e:
if e.errno == errno.ENOENT:
raise ExecutableNotFound(cmd)
else:
raise
out, err = proc.communicate(input)
if not quiet and err:
_compat.stderr_write_bytes(err, flush=True)
if encoding is not None:
if out is not None:
out = out.decode(encoding)
if err is not None:
err = err.decode(encoding)
if check and proc.returncode:
raise CalledProcessError(proc.returncode, cmd,
output=out, stderr=err)
return out, err
def render(engine, format, filepath, renderer=None, formatter=None, quiet=False):
"""Render file with Graphviz ``engine`` into ``format``, return result filename.
Args:
engine: The layout commmand used for rendering (``'dot'``, ``'neato'``, ...).
format: The output format used for rendering (``'pdf'``, ``'png'``, ...).
filepath: Path to the DOT source file to render.
renderer: The output renderer used for rendering (``'cairo'``, ``'gd'``, ...).
formatter: The output formatter used for rendering (``'cairo'``, ``'gd'``, ...).
quiet (bool): Suppress ``stderr`` output from the layout subprocess.
Returns:
The (possibly relative) path of the rendered file.
Raises:
ValueError: If ``engine``, ``format``, ``renderer``, or ``formatter`` are not known.
graphviz.RequiredArgumentError: If ``formatter`` is given but ``renderer`` is None.
graphviz.ExecutableNotFound: If the Graphviz executable is not found.
subprocess.CalledProcessError: If the exit status is non-zero.
The layout command is started from the directory of ``filepath``, so that
references to external files (e.g. ``[image=...]``) can be given as paths
relative to the DOT source file.
"""
dirname, filename = os.path.split(filepath)
del filepath
cmd, rendered = command(engine, format, filename, renderer, formatter)
if dirname:
cwd = dirname
rendered = os.path.join(dirname, rendered)
else:
cwd = None
run(cmd, capture_output=True, cwd=cwd, check=True, quiet=quiet)
return rendered
def pipe(engine, format, data, renderer=None, formatter=None, quiet=False):
"""Return ``data`` piped through Graphviz ``engine`` into ``format``.
Args:
engine: The layout commmand used for rendering (``'dot'``, ``'neato'``, ...).
format: The output format used for rendering (``'pdf'``, ``'png'``, ...).
data: The binary (encoded) DOT source string to render.
renderer: The output renderer used for rendering (``'cairo'``, ``'gd'``, ...).
formatter: The output formatter used for rendering (``'cairo'``, ``'gd'``, ...).
quiet (bool): Suppress ``stderr`` output from the layout subprocess.
Returns:
Binary (encoded) stdout of the layout command.
Raises:
ValueError: If ``engine``, ``format``, ``renderer``, or ``formatter`` are not known.
graphviz.RequiredArgumentError: If ``formatter`` is given but ``renderer`` is None.
graphviz.ExecutableNotFound: If the Graphviz executable is not found.
subprocess.CalledProcessError: If the exit status is non-zero.
"""
cmd, _ = command(engine, format, None, renderer, formatter)
out, _ = run(cmd, input=data, capture_output=True, check=True, quiet=quiet)
return out
def version():
"""Return the version number tuple from the ``stderr`` output of ``dot -V``.
Returns:
Two, three, or four ``int`` version ``tuple``.
Raises:
graphviz.ExecutableNotFound: If the Graphviz executable is not found.
subprocess.CalledProcessError: If the exit status is non-zero.
RuntimmeError: If the output cannot be parsed into a version number.
Note:
Ignores the ``~dev.`` portion of development versions.
See also Graphviz Release version entry format:
https://gitlab.com/graphviz/graphviz/-/blob/f94e91ba819cef51a4b9dcb2d76153684d06a913/gen_version.py#L17-20
"""
cmd = ['dot', '-V']
out, _ = run(cmd, check=True, encoding='ascii',
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT)
ma = re.search(r'graphviz version'
r' '
r'(\d+)\.(\d+)'
r'(?:\.(\d+)'
r'(?:'
r'~dev\.\d{8}\.\d{4}'
r'|'
r'\.(\d+)'
r')?'
r')?'
r' ', out)
if ma is None:
raise RuntimeError('cannot parse %r output: %r' % (cmd, out))
return tuple(int(d) for d in ma.groups() if d is not None)
def view(filepath, quiet=False):
"""Open filepath with its default viewing application (platform-specific).
Args:
filepath: Path to the file to open in viewer.
quiet (bool): Suppress ``stderr`` output from the viewer process
(ineffective on Windows).
Raises:
RuntimeError: If the current platform is not supported.
Note:
There is no option to wait for the application to close, and no way
to retrieve the application's exit status.
"""
try:
view_func = getattr(view, PLATFORM)
except AttributeError:
raise RuntimeError('platform %r not supported' % PLATFORM)
view_func(filepath, quiet)
@tools.attach(view, 'darwin')
def view_darwin(filepath, quiet):
"""Open filepath with its default application (mac)."""
cmd = ['open', filepath]
log.debug('view: %r', cmd)
popen_func = _compat.Popen_stderr_devnull if quiet else subprocess.Popen
popen_func(cmd)
@tools.attach(view, 'linux')
@tools.attach(view, 'freebsd')
def view_unixoid(filepath, quiet):
"""Open filepath in the user's preferred application (linux, freebsd)."""
cmd = ['xdg-open', filepath]
log.debug('view: %r', cmd)
popen_func = _compat.Popen_stderr_devnull if quiet else subprocess.Popen
popen_func(cmd)
@tools.attach(view, 'windows')
def view_windows(filepath, quiet):
"""Start filepath with its associated application (windows)."""
# TODO: implement quiet=True
filepath = os.path.normpath(filepath)
log.debug('view: %r', filepath)
os.startfile(filepath)
graphviz-0.14.2/graphviz/dot.py 0000666 0000000 0000000 00000026074 13737366150 015150 0 ustar root root # dot.py - create dot code
r"""Assemble DOT source code objects.
>>> dot = Graph(comment=u'M\xf8nti Pyth\xf8n ik den H\xf8lie Grailen')
>>> dot.node(u'M\xf8\xf8se')
>>> dot.node('trained_by', u'trained by')
>>> dot.node('tutte', u'TUTTE HERMSGERVORDENBROTBORDA')
>>> dot.edge(u'M\xf8\xf8se', 'trained_by')
>>> dot.edge('trained_by', 'tutte')
>>> dot.node_attr['shape'] = 'rectangle'
>>> print(dot.source.replace(u'\xf8', '0')) #doctest: +NORMALIZE_WHITESPACE
// M0nti Pyth0n ik den H0lie Grailen
graph {
node [shape=rectangle]
"M00se"
trained_by [label="trained by"]
tutte [label="TUTTE HERMSGERVORDENBROTBORDA"]
"M00se" -- trained_by
trained_by -- tutte
}
>>> dot.view('test-output/m00se.gv') # doctest: +SKIP
'test-output/m00se.gv.pdf'
"""
from . import lang
from . import files
__all__ = ['Graph', 'Digraph']
class Dot(files.File):
"""Assemble, save, and render DOT source code, open result in viewer."""
_comment = '// %s'
_subgraph = 'subgraph %s{'
_subgraph_plain = '%s{'
_node = _attr = '\t%s%s'
_attr_plain = _attr % ('%s', '')
_tail = '}'
_quote = staticmethod(lang.quote)
_quote_edge = staticmethod(lang.quote_edge)
_a_list = staticmethod(lang.a_list)
_attr_list = staticmethod(lang.attr_list)
def __init__(self, name=None, comment=None,
filename=None, directory=None,
format=None, engine=None, encoding=files.ENCODING,
graph_attr=None, node_attr=None, edge_attr=None, body=None,
strict=False):
self.name = name
self.comment = comment
super(Dot, self).__init__(filename, directory, format, engine, encoding)
self.graph_attr = dict(graph_attr) if graph_attr is not None else {}
self.node_attr = dict(node_attr) if node_attr is not None else {}
self.edge_attr = dict(edge_attr) if edge_attr is not None else {}
self.body = list(body) if body is not None else []
self.strict = strict
def _kwargs(self):
result = super(Dot, self)._kwargs()
result.update(name=self.name,
comment=self.comment,
graph_attr=dict(self.graph_attr),
node_attr=dict(self.node_attr),
edge_attr=dict(self.edge_attr),
body=list(self.body),
strict=self.strict)
return result
def clear(self, keep_attrs=False):
"""Reset content to an empty body, clear graph/node/egde_attr mappings.
Args:
keep_attrs (bool): preserve graph/node/egde_attr mappings
"""
if not keep_attrs:
for a in (self.graph_attr, self.node_attr, self.edge_attr):
a.clear()
del self.body[:]
def __iter__(self, subgraph=False):
"""Yield the DOT source code line by line (as graph or subgraph)."""
if self.comment:
yield self._comment % self.comment
if subgraph:
if self.strict:
raise ValueError('subgraphs cannot be strict')
head = self._subgraph if self.name else self._subgraph_plain
else:
head = self._head_strict if self.strict else self._head
yield head % (self._quote(self.name) + ' ' if self.name else '')
for kw in ('graph', 'node', 'edge'):
attrs = getattr(self, '%s_attr' % kw)
if attrs:
yield self._attr % (kw, self._attr_list(None, attrs))
for line in self.body:
yield line
yield self._tail
def __str__(self):
"""The DOT source code as string."""
return '\n'.join(self)
source = property(__str__, doc=__str__.__doc__)
def node(self, name, label=None, _attributes=None, **attrs):
"""Create a node.
Args:
name: Unique identifier for the node inside the source.
label: Caption to be displayed (defaults to the node ``name``).
attrs: Any additional node attributes (must be strings).
"""
name = self._quote(name)
attr_list = self._attr_list(label, attrs, _attributes)
line = self._node % (name, attr_list)
self.body.append(line)
def edge(self, tail_name, head_name, label=None, _attributes=None, **attrs):
"""Create an edge between two nodes.
Args:
tail_name: Start node identifier (format: ``node[:port[:compass]]``).
head_name: End node identifier (format: ``node[:port[:compass]]``).
label: Caption to be displayed near the edge.
attrs: Any additional edge attributes (must be strings).
Note:
The ``tail_name`` and ``head_name`` strings are separated by
(optional) colon(s) into ``node`` name, ``port`` name, and
``compass`` (e.g. ``sw``).
See :ref:`details in the User Guide `.
"""
tail_name = self._quote_edge(tail_name)
head_name = self._quote_edge(head_name)
attr_list = self._attr_list(label, attrs, _attributes)
line = self._edge % (tail_name, head_name, attr_list)
self.body.append(line)
def edges(self, tail_head_iter):
"""Create a bunch of edges.
Args:
tail_head_iter: Iterable of ``(tail_name, head_name)`` pairs (format:``node[:port[:compass]]``).
Note:
The ``tail_name`` and ``head_name`` strings are separated by
(optional) colon(s) into ``node`` name, ``port`` name, and
``compass`` (e.g. ``sw``).
See :ref:`details in the User Guide `.
"""
edge = self._edge_plain
quote = self._quote_edge
lines = (edge % (quote(t), quote(h)) for t, h in tail_head_iter)
self.body.extend(lines)
def attr(self, kw=None, _attributes=None, **attrs):
"""Add a general or graph/node/edge attribute statement.
Args:
kw: Attributes target (``None`` or ``'graph'``, ``'node'``, ``'edge'``).
attrs: Attributes to be set (must be strings, may be empty).
See the :ref:`usage examples in the User Guide `.
"""
if kw is not None and kw.lower() not in ('graph', 'node', 'edge'):
raise ValueError('attr statement must target graph, node, or edge: '
'%r' % kw)
if attrs or _attributes:
if kw is None:
a_list = self._a_list(None, attrs, _attributes)
line = self._attr_plain % a_list
else:
attr_list = self._attr_list(None, attrs, _attributes)
line = self._attr % (kw, attr_list)
self.body.append(line)
def subgraph(self, graph=None, name=None, comment=None,
graph_attr=None, node_attr=None, edge_attr=None, body=None):
"""Add the current content of the given sole ``graph`` argument as subgraph \
or return a context manager returning a new graph instance created \
with the given (``name``, ``comment``, etc.) arguments whose content is \
added as subgraph when leaving the context manager's ``with``-block.
Args:
graph: An instance of the same kind (:class:`.Graph`, :class:`.Digraph`)
as the current graph (sole argument in non-with-block use).
name: Subgraph name (``with``-block use).
comment: Subgraph comment (``with``-block use).
graph_attr: Subgraph-level attribute-value mapping (``with``-block use).
node_attr: Node-level attribute-value mapping (``with``-block use).
edge_attr: Edge-level attribute-value mapping (``with``-block use).
body: Verbatim lines to add to the subgraph ``body`` (``with``-block use).
See the :ref:`usage examples in the User Guide `.
Note:
If the ``name`` of the subgraph begins with ``'cluster'`` (all lowercase)
the layout engine will treat it as a special cluster subgraph.
"""
if graph is None:
return SubgraphContext(self, {'name': name,
'comment': comment,
'graph_attr': graph_attr,
'node_attr': node_attr,
'edge_attr': edge_attr,
'body': body})
args = [name, comment, graph_attr, node_attr, edge_attr, body]
if not all(a is None for a in args):
raise ValueError('graph must be sole argument of subgraph()')
if graph.directed != self.directed:
raise ValueError('%r cannot add subgraph of different kind:'
' %r' % (self, graph))
lines = ['\t' + line for line in graph.__iter__(subgraph=True)]
self.body.extend(lines)
class SubgraphContext(object):
"""Return a blank instance of the parent and add as subgraph on exit."""
def __init__(self, parent, kwargs):
self.parent = parent
self.graph = parent.__class__(**kwargs)
def __enter__(self):
return self.graph
def __exit__(self, type_, value, traceback):
if type_ is None:
self.parent.subgraph(self.graph)
class Graph(Dot):
"""Graph source code in the DOT language.
Args:
name: Graph name used in the source code.
comment: Comment added to the first line of the source.
filename: Filename for saving the source (defaults to ``name`` + ``'.gv'``).
directory: (Sub)directory for source saving and rendering.
format: Rendering output format (``'pdf'``, ``'png'``, ...).
engine: Layout command used (``'dot'``, ``'neato'``, ...).
encoding: Encoding for saving the source.
graph_attr: Mapping of ``(attribute, value)`` pairs for the graph.
node_attr: Mapping of ``(attribute, value)`` pairs set for all nodes.
edge_attr: Mapping of ``(attribute, value)`` pairs set for all edges.
body: Iterable of verbatim lines to add to the graph ``body``.
strict (bool): Rendering should merge multi-edges.
Note:
All parameters are `optional` and can be changed under their
corresponding attribute name after instance creation.
"""
_head = 'graph %s{'
_head_strict = 'strict %s' % _head
_edge = '\t%s -- %s%s'
_edge_plain = _edge % ('%s', '%s', '')
@property
def directed(self):
"""``False``"""
return False
class Digraph(Dot):
"""Directed graph source code in the DOT language."""
if Graph.__doc__ is not None:
__doc__ += Graph.__doc__.partition('.')[2]
_head = 'digraph %s{'
_head_strict = 'strict %s' % _head
_edge = '\t%s -> %s%s'
_edge_plain = _edge % ('%s', '%s', '')
@property
def directed(self):
"""``True``"""
return True
graphviz-0.14.2/graphviz/files.py 0000666 0000000 0000000 00000027434 13737366150 015465 0 ustar root root # files.py - save, render, view
"""Save DOT code objects, render with Graphviz dot, and open in viewer."""
import os
import io
import codecs
import locale
import logging
from ._compat import text_type
from . import backend
from . import tools
__all__ = ['File', 'Source']
ENCODING = 'utf-8'
log = logging.getLogger(__name__)
class Base(object):
_format = 'pdf'
_engine = 'dot'
_encoding = ENCODING
@property
def format(self):
"""The output format used for rendering (``'pdf'``, ``'png'``, ...)."""
return self._format
@format.setter
def format(self, format):
format = format.lower()
if format not in backend.FORMATS:
raise ValueError('unknown format: %r' % format)
self._format = format
@property
def engine(self):
"""The layout commmand used for rendering (``'dot'``, ``'neato'``, ...)."""
return self._engine
@engine.setter
def engine(self, engine):
engine = engine.lower()
if engine not in backend.ENGINES:
raise ValueError('unknown engine: %r' % engine)
self._engine = engine
@property
def encoding(self):
"""The encoding for the saved source file."""
return self._encoding
@encoding.setter
def encoding(self, encoding):
if encoding is None:
encoding = locale.getpreferredencoding()
codecs.lookup(encoding) # raise early
self._encoding = encoding
def copy(self):
"""Return a copied instance of the object.
Returns:
An independent copy of the current object.
"""
kwargs = self._kwargs()
return self.__class__(**kwargs)
def _kwargs(self):
ns = self.__dict__
return {a[1:]: ns[a] for a in ('_format', '_engine', '_encoding')
if a in ns}
class File(Base):
directory = ''
_default_extension = 'gv'
def __init__(self, filename=None, directory=None,
format=None, engine=None, encoding=ENCODING):
if filename is None:
name = getattr(self, 'name', None) or self.__class__.__name__
filename = '%s.%s' % (name, self._default_extension)
self.filename = filename
if directory is not None:
self.directory = directory
if format is not None:
self.format = format
if engine is not None:
self.engine = engine
self.encoding = encoding
def _kwargs(self):
result = super(File, self)._kwargs()
result['filename'] = self.filename
if 'directory' in self.__dict__:
result['directory'] = self.directory
return result
def _repr_svg_(self):
return self.pipe(format='svg').decode(self._encoding)
def pipe(self, format=None, renderer=None, formatter=None, quiet=False):
"""Return the source piped through the Graphviz layout command.
Args:
format: The output format used for rendering (``'pdf'``, ``'png'``, etc.).
renderer: The output renderer used for rendering (``'cairo'``, ``'gd'``, ...).
formatter: The output formatter used for rendering (``'cairo'``, ``'gd'``, ...).
quiet (bool): Suppress ``stderr`` output from the layout subprocess.
Returns:
Binary (encoded) stdout of the layout command.
Raises:
ValueError: If ``format``, ``renderer``, or ``formatter`` are not known.
graphviz.RequiredArgumentError: If ``formatter`` is given but ``renderer`` is None.
graphviz.ExecutableNotFound: If the Graphviz executable is not found.
subprocess.CalledProcessError: If the exit status is non-zero.
"""
if format is None:
format = self._format
data = text_type(self.source).encode(self._encoding)
out = backend.pipe(self._engine, format, data,
renderer=renderer, formatter=formatter,
quiet=quiet)
return out
@property
def filepath(self):
return os.path.join(self.directory, self.filename)
def save(self, filename=None, directory=None):
"""Save the DOT source to file. Ensure the file ends with a newline.
Args:
filename: Filename for saving the source (defaults to ``name`` + ``'.gv'``)
directory: (Sub)directory for source saving and rendering.
Returns:
The (possibly relative) path of the saved source file.
"""
if filename is not None:
self.filename = filename
if directory is not None:
self.directory = directory
filepath = self.filepath
tools.mkdirs(filepath)
data = text_type(self.source)
log.debug('write %d bytes to %r', len(data), filepath)
with io.open(filepath, 'w', encoding=self.encoding) as fd:
fd.write(data)
if not data.endswith(u'\n'):
fd.write(u'\n')
return filepath
def render(self, filename=None, directory=None, view=False, cleanup=False,
format=None, renderer=None, formatter=None,
quiet=False, quiet_view=False):
"""Save the source to file and render with the Graphviz engine.
Args:
filename: Filename for saving the source (defaults to ``name`` + ``'.gv'``)
directory: (Sub)directory for source saving and rendering.
view (bool): Open the rendered result with the default application.
cleanup (bool): Delete the source file after rendering.
format: The output format used for rendering (``'pdf'``, ``'png'``, etc.).
renderer: The output renderer used for rendering (``'cairo'``, ``'gd'``, ...).
formatter: The output formatter used for rendering (``'cairo'``, ``'gd'``, ...).
quiet (bool): Suppress ``stderr`` output from the layout subprocess.
quiet_view (bool): Suppress ``stderr`` output from the viewer process
(implies ``view=True``, ineffective on Windows).
Returns:
The (possibly relative) path of the rendered file.
Raises:
ValueError: If ``format``, ``renderer``, or ``formatter`` are not known.
graphviz.RequiredArgumentError: If ``formatter`` is given but ``renderer`` is None.
graphviz.ExecutableNotFound: If the Graphviz executable is not found.
subprocess.CalledProcessError: If the exit status is non-zero.
RuntimeError: If viewer opening is requested but not supported.
The layout command is started from the directory of ``filepath``, so that
references to external files (e.g. ``[image=...]``) can be given as paths
relative to the DOT source file.
"""
filepath = self.save(filename, directory)
if format is None:
format = self._format
rendered = backend.render(self._engine, format, filepath,
renderer=renderer, formatter=formatter,
quiet=quiet)
if cleanup:
log.debug('delete %r', filepath)
os.remove(filepath)
if quiet_view or view:
self._view(rendered, self._format, quiet_view)
return rendered
def view(self, filename=None, directory=None, cleanup=False,
quiet=False, quiet_view=False):
"""Save the source to file, open the rendered result in a viewer.
Args:
filename: Filename for saving the source (defaults to ``name`` + ``'.gv'``)
directory: (Sub)directory for source saving and rendering.
cleanup (bool): Delete the source file after rendering.
quiet (bool): Suppress ``stderr`` output from the layout subprocess.
quiet_view (bool): Suppress ``stderr`` output from the viewer process
(ineffective on Windows).
Returns:
The (possibly relative) path of the rendered file.
Raises:
graphviz.ExecutableNotFound: If the Graphviz executable is not found.
subprocess.CalledProcessError: If the exit status is non-zero.
RuntimeError: If opening the viewer is not supported.
Short-cut method for calling :meth:`.render` with ``view=True``.
Note:
There is no option to wait for the application to close, and no way
to retrieve the application's exit status.
"""
return self.render(filename=filename, directory=directory,
view=True, cleanup=cleanup,
quiet=quiet, quiet_view=quiet_view)
def _view(self, filepath, format, quiet):
"""Start the right viewer based on file format and platform."""
methodnames = [
'_view_%s_%s' % (format, backend.PLATFORM),
'_view_%s' % backend.PLATFORM,
]
for name in methodnames:
view_method = getattr(self, name, None)
if view_method is not None:
break
else:
raise RuntimeError('%r has no built-in viewer support for %r'
' on %r platform' % (self.__class__, format,
backend.PLATFORM))
view_method(filepath, quiet)
_view_darwin = staticmethod(backend.view.darwin)
_view_freebsd = staticmethod(backend.view.freebsd)
_view_linux = staticmethod(backend.view.linux)
_view_windows = staticmethod(backend.view.windows)
class Source(File):
"""Verbatim DOT source code string to be rendered by Graphviz.
Args:
source: The verbatim DOT source code string.
filename: Filename for saving the source (defaults to ``'Source.gv'``).
directory: (Sub)directory for source saving and rendering.
format: Rendering output format (``'pdf'``, ``'png'``, ...).
engine: Layout command used (``'dot'``, ``'neato'``, ...).
encoding: Encoding for saving the source.
Note:
All parameters except ``source`` are optional. All of them can be changed
under their corresponding attribute name after instance creation.
"""
@classmethod
def from_file(cls, filename, directory=None,
format=None, engine=None, encoding=ENCODING):
"""Return an instance with the source string read from the given file.
Args:
filename: Filename for loading/saving the source.
directory: (Sub)directory for source loading/saving and rendering.
format: Rendering output format (``'pdf'``, ``'png'``, ...).
engine: Layout command used (``'dot'``, ``'neato'``, ...).
encoding: Encoding for loading/saving the source.
"""
filepath = os.path.join(directory or '', filename)
if encoding is None:
encoding = locale.getpreferredencoding()
log.debug('read %r with encoding %r', filepath, encoding)
with io.open(filepath, encoding=encoding) as fd:
source = fd.read()
return cls(source, filename, directory, format, engine, encoding)
def __init__(self, source, filename=None, directory=None,
format=None, engine=None, encoding=ENCODING):
super(Source, self).__init__(filename, directory,
format, engine, encoding)
self.source = source #: The verbatim DOT source code string.
def _kwargs(self):
result = super(Source, self)._kwargs()
result['source'] = self.source
return result
graphviz-0.14.2/graphviz/lang.py 0000666 0000000 0000000 00000012605 13737227654 015303 0 ustar root root # lang.py - dot language creation helpers
"""Quote strings to be valid DOT identifiers, assemble attribute lists."""
import re
import collections
import functools
from . import _compat
from . import tools
__all__ = ['quote', 'quote_edge', 'a_list', 'attr_list', 'escape', 'nohtml']
# https://www.graphviz.org/doc/info/lang.html
# https://www.graphviz.org/doc/info/attrs.html#k:escString
HTML_STRING = re.compile(r'<.*>$', re.DOTALL)
ID = re.compile(r'([a-zA-Z_][a-zA-Z0-9_]*|-?(\.[0-9]+|[0-9]+(\.[0-9]*)?))$')
KEYWORDS = {'node', 'edge', 'graph', 'digraph', 'subgraph', 'strict'}
COMPASS = {'n', 'ne', 'e', 'se', 's', 'sw', 'w', 'nw', 'c', '_'} # TODO
QUOTE_OPTIONAL_BACKSLASHES = re.compile(r'(?P(?:\\\\)*)'
r'\\?(?P")')
ESCAPE_UNESCAPED_QUOTES = functools.partial(QUOTE_OPTIONAL_BACKSLASHES.sub,
r'\g\\\g')
def quote(identifier,
is_html_string=HTML_STRING.match,
is_valid_id=ID.match, dot_keywords=KEYWORDS,
escape_unescaped_quotes=ESCAPE_UNESCAPED_QUOTES):
r"""Return DOT identifier from string, quote if needed.
>>> quote('')
'""'
>>> quote('spam')
'spam'
>>> quote('spam spam')
'"spam spam"'
>>> quote('-4.2')
'-4.2'
>>> quote('.42')
'.42'
>>> quote('<spam>')
'<spam>'
>>> quote(nohtml('<>'))
'"<>"'
>>> print(quote('"'))
"\""
>>> print(quote('\\"'))
"\""
>>> print(quote('\\\\"'))
"\\\""
>>> print(quote('\\\\\\"'))
"\\\""
"""
if is_html_string(identifier) and not isinstance(identifier, NoHtml):
pass
elif not is_valid_id(identifier) or identifier.lower() in dot_keywords:
return '"%s"' % escape_unescaped_quotes(identifier)
return identifier
def quote_edge(identifier):
"""Return DOT edge statement node_id from string, quote if needed.
>>> quote_edge('spam')
'spam'
>>> quote_edge('spam spam:eggs eggs')
'"spam spam":"eggs eggs"'
>>> quote_edge('spam:eggs:s')
'spam:eggs:s'
"""
node, _, rest = identifier.partition(':')
parts = [quote(node)]
if rest:
port, _, compass = rest.partition(':')
parts.append(quote(port))
if compass:
parts.append(compass)
return ':'.join(parts)
def a_list(label=None, kwargs=None, attributes=None):
"""Return assembled DOT a_list string.
>>> a_list('spam', {'spam': None, 'ham': 'ham ham', 'eggs': ''})
'label=spam eggs="" ham="ham ham"'
"""
result = ['label=%s' % quote(label)] if label is not None else []
if kwargs:
items = ['%s=%s' % (quote(k), quote(v))
for k, v in tools.mapping_items(kwargs) if v is not None]
result.extend(items)
if attributes:
if hasattr(attributes, 'items'):
attributes = tools.mapping_items(attributes)
items = ['%s=%s' % (quote(k), quote(v))
for k, v in attributes if v is not None]
result.extend(items)
return ' '.join(result)
def attr_list(label=None, kwargs=None, attributes=None):
"""Return assembled DOT attribute list string.
Sorts ``kwargs`` and ``attributes`` if they are plain dicts (to avoid
unpredictable order from hash randomization in Python 3 versions).
>>> attr_list()
''
>>> attr_list('spam spam', kwargs={'eggs': 'eggs', 'ham': 'ham ham'})
' [label="spam spam" eggs=eggs ham="ham ham"]'
>>> attr_list(kwargs={'spam': None, 'eggs': ''})
' [eggs=""]'
"""
content = a_list(label, kwargs, attributes)
if not content:
return ''
return ' [%s]' % content
def escape(s):
r"""Return ``s`` as literal disabling special meaning of backslashes and ``'<...>'``.
see also https://www.graphviz.org/doc/info/attrs.html#k:escString
Args:
s: String in which backslashes and ``'<...>'`` should be treated as literal.
Raises:
TypeError: If ``s`` is not a ``str`` on Python 3, or a ``str``/``unicode`` on Python 2.
>>> print(escape(r'\l'))
\\l
"""
return nohtml(s.replace('\\', '\\\\'))
class NoHtml(object):
"""Mixin for string subclasses disabling fall-through of ``'<...>'``."""
__slots__ = ()
_doc = "%s subclass that does not treat ``'<...>'`` as DOT HTML string."
@classmethod
def _subcls(cls, other):
name = '%s_%s' % (cls.__name__, other.__name__)
bases = (other, cls)
ns = {'__doc__': cls._doc % other.__name__}
return type(name, bases, ns)
NOHTML = collections.OrderedDict((c, NoHtml._subcls(c)) for c in _compat.string_classes)
def nohtml(s):
"""Return copy of ``s`` that will not treat ``'<...>'`` as DOT HTML string in quoting.
Args:
s: String in which leading ``'<'`` and trailing ``'>'`` should be treated as literal.
Raises:
TypeError: If ``s`` is not a ``str`` on Python 3, or a ``str``/``unicode`` on Python 2.
>>> quote('<>-*-<>')
'<>-*-<>'
>>> quote(nohtml('<>-*-<>'))
'"<>-*-<>"'
"""
try:
subcls = NOHTML[type(s)]
except KeyError:
raise TypeError('%r does not have one of the required types:'
' %r' % (s, list(NOHTML)))
return subcls(s)
graphviz-0.14.2/graphviz/tools.py 0000666 0000000 0000000 00000002452 13737227654 015521 0 ustar root root # tools.py - generic helpers
import os
from . import _compat
__all__ = ['attach', 'mkdirs', 'mapping_items']
def attach(object, name):
"""Return a decorator doing ``setattr(object, name)`` with its argument.
>>> spam = type('Spam', (object,), {})()
>>> @attach(spam, 'eggs')
... def func():
... pass
>>> spam.eggs # doctest: +ELLIPSIS
"""
def decorator(func):
setattr(object, name, func)
return func
return decorator
def mkdirs(filename, mode=0o777):
"""Recursively create directories up to the path of ``filename`` as needed."""
dirname = os.path.dirname(filename)
if not dirname:
return
_compat.makedirs(dirname, mode=mode, exist_ok=True)
def mapping_items(mapping):
"""Return an iterator over the ``mapping`` items, sort if it's a plain dict.
>>> list(mapping_items({'spam': 0, 'ham': 1, 'eggs': 2}))
[('eggs', 2), ('ham', 1), ('spam', 0)]
>>> from collections import OrderedDict
>>> list(mapping_items(OrderedDict(enumerate(['spam', 'ham', 'eggs']))))
[(0, 'spam'), (1, 'ham'), (2, 'eggs')]
"""
result = _compat.iteritems(mapping)
if type(mapping) is dict:
result = iter(sorted(result))
return result
graphviz-0.14.2/graphviz/_compat.py 0000666 0000000 0000000 00000004073 13737227654 016004 0 ustar root root # _compat.py - Python 2/3 compatibility
import os
import sys
import operator
import subprocess
PY2 = (sys.version_info.major == 2)
if PY2:
string_classes = (str, unicode) # needed individually for sublassing
text_type = unicode
iteritems = operator.methodcaller('iteritems')
def makedirs(name, mode=0o777, exist_ok=False):
try:
os.makedirs(name, mode)
except OSError:
if not exist_ok or not os.path.isdir(name):
raise
def stderr_write_bytes(data, flush=False):
"""Write data str to sys.stderr (flush if requested)."""
sys.stderr.write(data)
if flush:
sys.stderr.flush()
def Popen_stderr_devnull(*args, **kwargs): # noqa: N802
with open(os.devnull, 'w') as f:
return subprocess.Popen(*args, stderr=f, **kwargs)
class CalledProcessError(subprocess.CalledProcessError):
def __init__(self, returncode, cmd, output=None, stderr=None):
super(CalledProcessError, self).__init__(returncode, cmd, output)
self.stderr = stderr
@property # pragma: no cover
def stdout(self):
return self.output
@stdout.setter # pragma: no cover
def stdout(self, value):
self.output = value
else:
string_classes = (str,)
text_type = str
def iteritems(d):
return iter(d.items())
def makedirs(name, mode=0o777, exist_ok=False): # allow os.makedirs mocking
return os.makedirs(name, mode, exist_ok=exist_ok)
def stderr_write_bytes(data, flush=False):
"""Encode data str and write to sys.stderr (flush if requested)."""
encoding = sys.stderr.encoding or sys.getdefaultencoding()
sys.stderr.write(data.decode(encoding))
if flush:
sys.stderr.flush()
def Popen_stderr_devnull(*args, **kwargs): # noqa: N802
return subprocess.Popen(*args, stderr=subprocess.DEVNULL, **kwargs)
CalledProcessError = subprocess.CalledProcessError
graphviz-0.14.2/graphviz/__init__.py 0000666 0000000 0000000 00000003437 13737375464 016127 0 ustar root root # graphviz - create dot, save, render, view
"""Assemble DOT source code and render it with Graphviz.
>>> dot = Digraph(comment='The Round Table')
>>> dot.node('A', 'King Arthur')
>>> dot.node('B', 'Sir Bedevere the Wise')
>>> dot.node('L', 'Sir Lancelot the Brave')
>>> dot.edges(['AB', 'AL'])
>>> dot.edge('B', 'L', constraint='false')
>>> print(dot) #doctest: +NORMALIZE_WHITESPACE
// The Round Table
digraph {
A [label="King Arthur"]
B [label="Sir Bedevere the Wise"]
L [label="Sir Lancelot the Brave"]
A -> B
A -> L
B -> L [constraint=false]
}
"""
from .dot import Graph, Digraph
from .files import Source
from .lang import escape, nohtml
from .backend import (render, pipe, version, view,
ENGINES, FORMATS, RENDERERS, FORMATTERS,
ExecutableNotFound, RequiredArgumentError)
__all__ = [
'Graph', 'Digraph',
'Source',
'escape', 'nohtml',
'render', 'pipe', 'version', 'view',
'ENGINES', 'FORMATS', 'RENDERERS', 'FORMATTERS',
'ExecutableNotFound', 'RequiredArgumentError',
]
__title__ = 'graphviz'
__version__ = '0.14.2'
__author__ = 'Sebastian Bank '
__license__ = 'MIT, see LICENSE.txt'
__copyright__ = 'Copyright (c) 2013-2020 Sebastian Bank'
#: Set of known layout commands used for rendering (``'dot'``, ``'neato'``, ...)
ENGINES = ENGINES
#: Set of known output formats for rendering (``'pdf'``, ``'png'``, ...)
FORMATS = FORMATS
#: Set of known output formatters for rendering (``'cairo'``, ``'gd'``, ...)
FORMATTERS = FORMATTERS
#: Set of known output renderers for rendering (``'cairo'``, ``'gd'``, ...)
RENDERERS = RENDERERS
ExecutableNotFound = ExecutableNotFound
RequiredArgumentError = RequiredArgumentError
graphviz-0.14.2/graphviz.egg-info/ 0000777 0000000 0000000 00000000000 13737401626 015467 5 ustar root root graphviz-0.14.2/graphviz.egg-info/dependency_links.txt 0000666 0000000 0000000 00000000001 13737401624 021533 0 ustar root root
graphviz-0.14.2/graphviz.egg-info/PKG-INFO 0000666 0000000 0000000 00000016741 13737401624 016573 0 ustar root root Metadata-Version: 2.1
Name: graphviz
Version: 0.14.2
Summary: Simple Python interface for Graphviz
Home-page: https://github.com/xflr6/graphviz
Author: Sebastian Bank
Author-email: sebastian.bank@uni-leipzig.de
License: MIT
Project-URL: Documentation, https://graphviz.readthedocs.io
Project-URL: Changelog, https://graphviz.readthedocs.io/en/latest/changelog.html
Project-URL: Issue Tracker, https://github.com/xflr6/graphviz/issues
Description: Graphviz
========
|PyPI version| |License| |Supported Python| |Format|
|Travis| |Codecov| |Readthedocs-stable| |Readthedocs-latest|
This package facilitates the creation and rendering of graph descriptions in
the DOT_ language of the Graphviz_ graph drawing software (`master repo`_) from
Python.
Create a graph object, assemble the graph by adding nodes and edges, and
retrieve its DOT source code string. Save the source code to a file and render
it with the Graphviz installation of your system.
Use the ``view`` option/method to directly inspect the resulting (PDF, PNG,
SVG, etc.) file with its default application. Graphs can also be rendered
and displayed within `Jupyter notebooks`_ (formerly known as
`IPython notebooks`_, example_) as well as the `Jupyter Qt Console`_.
Links
-----
- GitHub: https://github.com/xflr6/graphviz
- PyPI: https://pypi.org/project/graphviz/
- Documentation: https://graphviz.readthedocs.io
- Changelog: https://graphviz.readthedocs.io/en/latest/changelog.html
- Issue Tracker: https://github.com/xflr6/graphviz/issues
- Download: https://pypi.org/project/graphviz/#files
Installation
------------
This package runs under Python 2.7, and 3.5+, use pip_ to install:
.. code:: bash
$ pip install graphviz
To render the generated DOT source code, you also need to install Graphviz
(`download page`_).
Make sure that the directory containing the ``dot`` executable is on your
systems' path.
Quickstart
----------
Create a graph object:
.. code:: python
>>> from graphviz import Digraph
>>> dot = Digraph(comment='The Round Table')
>>> dot #doctest: +ELLIPSIS
Add nodes and edges:
.. code:: python
>>> dot.node('A', 'King Arthur')
>>> dot.node('B', 'Sir Bedevere the Wise')
>>> dot.node('L', 'Sir Lancelot the Brave')
>>> dot.edges(['AB', 'AL'])
>>> dot.edge('B', 'L', constraint='false')
Check the generated source code:
.. code:: python
>>> print(dot.source) # doctest: +NORMALIZE_WHITESPACE
// The Round Table
digraph {
A [label="King Arthur"]
B [label="Sir Bedevere the Wise"]
L [label="Sir Lancelot the Brave"]
A -> B
A -> L
B -> L [constraint=false]
}
Save and render the source code, optionally view the result:
.. code:: python
>>> dot.render('test-output/round-table.gv', view=True) # doctest: +SKIP
'test-output/round-table.gv.pdf'
.. image:: https://raw.github.com/xflr6/graphviz/master/docs/round-table.png
:align: center
See also
--------
- pygraphviz_ |--| full-blown interface wrapping the Graphviz C library with SWIG
- graphviz-python_ |--| official Python bindings (documentation_)
- pydot_ |--| stable pure-Python approach, requires pyparsing
License
-------
This package is distributed under the `MIT license`_.
.. _pip: https://pip.readthedocs.io
.. _Graphviz: https://www.graphviz.org
.. _master repo: https://gitlab.com/graphviz/graphviz/
.. _download page: https://www.graphviz.org/download/
.. _DOT: https://www.graphviz.org/doc/info/lang.html
.. _Jupyter notebooks: https://jupyter.org
.. _IPython notebooks: https://ipython.org/notebook.html
.. _example: https://nbviewer.jupyter.org/github/xflr6/graphviz/blob/master/examples/notebook.ipynb
.. _Jupyter Qt Console: https://qtconsole.readthedocs.io
.. _pygraphviz: https://pypi.org/project/pygraphviz/
.. _graphviz-python: https://pypi.org/project/graphviz-python/
.. _documentation: https://www.graphviz.org/pdf/gv.3python.pdf
.. _pydot: https://pypi.org/project/pydot/
.. _MIT license: https://opensource.org/licenses/MIT
.. |--| unicode:: U+2013
.. |PyPI version| image:: https://img.shields.io/pypi/v/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Latest PyPI Version
.. |License| image:: https://img.shields.io/pypi/l/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: License
.. |Supported Python| image:: https://img.shields.io/pypi/pyversions/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Supported Python Versions
.. |Format| image:: https://img.shields.io/pypi/format/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Format
.. |Travis| image:: https://travis-ci.org/xflr6/graphviz.svg?branch=master
:target: https://travis-ci.org/xflr6/graphviz
:alt: Travis
.. |Codecov| image:: https://codecov.io/gh/xflr6/graphviz/branch/master/graph/badge.svg
:target: https://codecov.io/gh/xflr6/graphviz
:alt: Codecov
.. |Readthedocs-stable| image:: https://readthedocs.org/projects/graphviz/badge/?version=stable
:target: https://graphviz.readthedocs.io/en/stable/?badge=stable
:alt: Readthedocs stable
.. |Readthedocs-latest| image:: https://readthedocs.org/projects/graphviz/badge/?version=latest
:target: https://graphviz.readthedocs.io/en/latest/?badge=latest
:alt: Readthedocs latest
Keywords: graph visualization dot render
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*
Provides-Extra: dev
Provides-Extra: test
Provides-Extra: docs
graphviz-0.14.2/graphviz.egg-info/requires.txt 0000666 0000000 0000000 00000000206 13737401624 020063 0 ustar root root
[dev]
tox>=3
flake8
pep8-naming
wheel
twine
[docs]
sphinx>=1.8
sphinx-rtd-theme
[test]
mock>=3
pytest>=4
pytest-mock>=2
pytest-cov
graphviz-0.14.2/graphviz.egg-info/SOURCES.txt 0000666 0000000 0000000 00000003303 13737401624 017350 0 ustar root root CHANGES.txt
LICENSE.txt
MANIFEST.in
README.rst
requirements.txt
run-tests.py
setup.cfg
setup.py
tox.ini
try-examples.py
docs/api.rst
docs/changelog.rst
docs/conf.py
docs/examples.rst
docs/index.rst
docs/license.rst
docs/manual.rst
docs/notebooks.rst
docs/pet-shop.png
docs/round-table.png
docs/_static/angles.svg
docs/_static/btree.svg
docs/_static/cluster.svg
docs/_static/cluster_edge.svg
docs/_static/diamond.svg
docs/_static/er.svg
docs/_static/escapes.svg
docs/_static/fdpclust.svg
docs/_static/fsm.svg
docs/_static/g_c_n.svg
docs/_static/hello.svg
docs/_static/holy-grenade.svg
docs/_static/html_table.svg
docs/_static/ni.svg
docs/_static/pet-shop.svg
docs/_static/process.svg
docs/_static/qtconsole-source.png
docs/_static/qtconsole.png
docs/_static/rank_same.svg
docs/_static/round-table.svg
docs/_static/structs.svg
docs/_static/structs_revisited.svg
docs/_static/traffic_lights.svg
docs/_static/unix.svg
examples/angles.py
examples/btree.py
examples/cluster.py
examples/cluster_edge.py
examples/er.py
examples/fdpclust.py
examples/fsm.py
examples/g_c_n.py
examples/graphviz-engines.ipynb
examples/graphviz-escapes.ipynb
examples/hello.py
examples/notebook.ipynb
examples/process.py
examples/rank_same.py
examples/structs.py
examples/structs_revisited.py
examples/traffic_lights.py
examples/unix.py
graphviz/__init__.py
graphviz/_compat.py
graphviz/backend.py
graphviz/dot.py
graphviz/files.py
graphviz/lang.py
graphviz/tools.py
graphviz.egg-info/PKG-INFO
graphviz.egg-info/SOURCES.txt
graphviz.egg-info/dependency_links.txt
graphviz.egg-info/requires.txt
graphviz.egg-info/top_level.txt
tests/conftest.py
tests/dot_red.png
tests/test_backend.py
tests/test_dot.py
tests/test_files.py
tests/test_lang.py
tests/test_tools.py graphviz-0.14.2/graphviz.egg-info/top_level.txt 0000666 0000000 0000000 00000000011 13737401624 020207 0 ustar root root graphviz
graphviz-0.14.2/tests/ 0000777 0000000 0000000 00000000000 13737401626 013305 5 ustar root root graphviz-0.14.2/tests/conftest.py 0000666 0000000 0000000 00000003762 13737227654 015523 0 ustar root root # conftest.py
import sys
import platform as platform_
import pytest
def pytest_addoption(parser):
parser.addoption('--skipexe', action='store_true',
help='skip tests that run Graphviz executables'
'or subprocesses')
def pytest_configure(config):
pytest.exe = pytest.mark.skipif(config.getoption('--skipexe'),
reason='skipped by --skipexe option')
@pytest.fixture(scope='session')
def py2():
return sys.version_info.major == 2
@pytest.fixture(scope='session')
def filesdir(tmpdir_factory):
LocalPath = tmpdir_factory.getbasetemp().__class__ # noqa: N806
return LocalPath(__file__).new(basename='')
@pytest.fixture(scope='session')
def test_platform():
return platform_.system().lower()
@pytest.fixture(params=['darwin', 'freebsd', 'linux', 'windows'],
ids=lambda p: 'platform=%r' % p)
def platform(monkeypatch, request):
monkeypatch.setattr('graphviz.backend.PLATFORM', request.param)
yield request.param
@pytest.fixture
def unknown_platform(monkeypatch, name='nonplatform'):
monkeypatch.setattr('graphviz.backend.PLATFORM', name)
yield name
@pytest.fixture
def Popen(mocker): # noqa: N802
yield mocker.patch('subprocess.Popen', autospec=True)
@pytest.fixture
def startfile(mocker, test_platform):
if test_platform == 'windows':
kwargs = {'autospec': True}
else:
kwargs = {'create': True, 'new_callable': mocker.Mock}
yield mocker.patch('os.startfile', **kwargs)
@pytest.fixture
def empty_path(monkeypatch):
monkeypatch.setenv('PATH', '')
@pytest.fixture(params=[False, True], ids=lambda q: 'quiet=%r' % q)
def quiet(request):
return request.param
@pytest.fixture
def pipe(mocker):
yield mocker.patch('graphviz.backend.pipe', autospec=True)
@pytest.fixture
def render(mocker):
yield mocker.patch('graphviz.backend.render', autospec=True)
graphviz-0.14.2/tests/dot_red.png 0000666 0000000 0000000 00000002635 13737227654 015450 0 ustar root root PNG
IHDR @ @ gAMA a cHRM z& u0 ` : pQ< PLTE NN$$ ((;; >> ****((**88 77&&$$KKDDFF;;99
33@@
99 &&##7799))++..))CC;; UURR&&
%%UURR ,,))((66++## IICC
@@==&&99 --++,,<< AA(( NN tRNS [Z+ʀ)UUYV).li$#Ĥkm*(XTXQ*'~X˨Zǁ}VPR&lf f((SR&~'Ẏ[5I bKGD)Ԏ6 tIME
%zr IDATXý;[Q*R1ĈRU{VFQJVZ)ZTS=\7PqJ,Ch<ժ^nl# / =y zC@4xXH)GEL1xl
dDJR0
I3
Ӂ:/? /)Y7W 9}.Ow 8vWpH,aPr%(E`Ͽ62 *K+#o@F"h @!xA Z/vCyE ^`qu+wk|O+HX'KU1 ^ qӆZax\GF /삯~gǾ+c;Y &Z!v.3BUFE world }'):
lpath = tmpdir / filename
lpath.write_binary(data)
rendered = lpath.new(ext='%s.%s' % (lpath.ext, expected_suffix))
assert render(engine, format_, str(lpath), renderer, formatter) == str(rendered)
assert rendered.size()
assert capsys.readouterr() == ('', '')
@pytest.exe
def test_render_img(capsys, tmpdir, filesdir, engine='dot', format_='pdf'):
subdir = tmpdir / 'subdir'
subdir.ensure(dir=True)
img_path = subdir / 'dot_red.png'
(filesdir / img_path.basename).copy(img_path)
assert img_path.size()
gv_path = subdir / 'img.gv'
rendered = gv_path.new(ext='%s.%s' % (gv_path.ext, format_))
gv_rel, rendered_rel = map(tmpdir.bestrelpath, (gv_path, rendered))
assert all(s.startswith('subdir') for s in (gv_rel, rendered_rel))
gv_path.write_text(u'graph { red_dot [image="%s"] }' % img_path.basename,
encoding='ascii')
with tmpdir.as_cwd():
assert render(engine, format_, gv_rel) == rendered_rel
assert rendered.size()
assert capsys.readouterr() == ('', '')
def test_render_mocked(capsys, mocker, Popen, quiet): # noqa: N803
proc = Popen.return_value
proc.returncode = 0
proc.communicate.return_value = (b'stdout', b'stderr')
assert render('dot', 'pdf', 'nonfilepath', quiet=quiet) == 'nonfilepath.pdf'
Popen.assert_called_once_with(['dot', '-Tpdf', '-O', 'nonfilepath'],
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
cwd=None, startupinfo=mocker.ANY)
check_startupinfo(Popen.call_args.kwargs['startupinfo'])
proc.communicate.assert_called_once_with(None)
assert capsys.readouterr() == ('', '' if quiet else 'stderr')
@pytest.exe
@pytest.mark.xfail('version() == (2, 36, 0)',
reason='https://bugs.launchpad.net/ubuntu/+source/graphviz/+bug/1694108')
def test_pipe_invalid_data(capsys, quiet, engine='dot', format_='svg'):
with pytest.raises(subprocess.CalledProcessError) as e:
pipe(engine, format_, b'nongraph', quiet=quiet)
assert e.value.returncode == 1
assert 'syntax error in line' in str(e.value)
out, err = capsys.readouterr()
assert out == ''
if quiet:
assert err == ''
else:
assert 'syntax error in line' in err
@pytest.exe
@pytest.mark.parametrize('format_, renderer, formatter, pattern', [
('svg', None, None, r'(?s)^<\?xml .+\s*$'),
('ps', 'ps', 'core', r'%!PS-'),
])
@pytest.mark.parametrize('engine', ['dot'])
def test_pipe(capsys, engine, format_, renderer, formatter, pattern,
data=b'graph { spam }'):
out = pipe(engine, format_, data, renderer, formatter).decode('ascii')
if pattern is not None:
assert re.match(pattern, out)
assert capsys.readouterr() == ('', '')
def test_pipe_pipe_invalid_data_mocked(mocker, py2, Popen, quiet): # noqa: N803
stderr = mocker.patch('sys.stderr', autospec=True,
**{'flush': mocker.Mock(), 'encoding': 'nonencoding'})
proc = Popen.return_value
proc.returncode = mocker.sentinel.returncode
err = mocker.create_autospec(bytes, instance=True, name='err',
**{'__len__.return_value': 23})
proc.communicate.return_value = (mocker.sentinel.out, err)
with pytest.raises(subprocess.CalledProcessError) as e:
pipe('dot', 'png', b'nongraph', quiet=quiet)
assert e.value.returncode is mocker.sentinel.returncode
assert e.value.stderr is err
assert e.value.stdout is mocker.sentinel.out
e.value.stdout = mocker.sentinel.new_stdout
assert e.value.stdout is mocker.sentinel.new_stdout
Popen.assert_called_once_with(['dot', '-Tpng'],
stdin=subprocess.PIPE,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
startupinfo=mocker.ANY)
check_startupinfo(Popen.call_args.kwargs['startupinfo'])
proc.communicate.assert_called_once_with(b'nongraph')
if not quiet:
if py2:
stderr.write.assert_called_once_with(err)
else:
err.decode.assert_called_once_with(stderr.encoding)
stderr.write.assert_called_once_with(err.decode.return_value)
stderr.flush.assert_called_once_with()
def test_pipe_mocked(capsys, mocker, Popen, quiet): # noqa: N803
proc = Popen.return_value
proc.returncode = 0
proc.communicate.return_value = (mocker.sentinel.out, b'stderr')
assert pipe('dot', 'png', b'nongraph', quiet=quiet) is mocker.sentinel.out
Popen.assert_called_once_with(['dot', '-Tpng'],
stdin=subprocess.PIPE,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
startupinfo=mocker.ANY)
check_startupinfo(Popen.call_args.kwargs['startupinfo'])
proc.communicate.assert_called_once_with(b'nongraph')
assert capsys.readouterr() == ('', '' if quiet else 'stderr')
@pytest.exe
def test_version(capsys):
result = version()
assert isinstance(result, tuple) and result
assert all(isinstance(d, int) for d in result)
assert capsys.readouterr() == ('', '')
def test_version_parsefail_mocked(mocker, Popen): # noqa: N803
proc = Popen.return_value
proc.returncode = 0
proc.communicate.return_value = (b'nonversioninfo', None)
with pytest.raises(RuntimeError, match=r'nonversioninfo'):
version()
Popen.assert_called_once_with(['dot', '-V'],
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
startupinfo=mocker.ANY)
check_startupinfo(Popen.call_args.kwargs['startupinfo'])
proc.communicate.assert_called_once_with(None)
@pytest.mark.parametrize('stdout, expected', [
(b'dot - graphviz version 1.2.3 (mocked)', (1, 2, 3)),
(b'dot - graphviz version 2.43.20190912.0211 (20190912.0211)\n', (2, 43, 20190912, 211)),
(b'dot - graphviz version 2.44.2~dev.20200927.0217 (20200927.0217)\n', (2, 44, 2)),
(b'dot - graphviz version 2.44.1 (mocked)\n', (2, 44, 1)),
(b'dot - graphviz version 2.44.2~dev.20200704.1652 (mocked)\n', (2, 44, 2)),
])
def test_version_mocked(mocker, Popen, stdout, expected): # noqa: N803
proc = Popen.return_value
proc.returncode = 0
proc.communicate.return_value = (stdout, None)
assert version() == expected
Popen.assert_called_once_with(['dot', '-V'],
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
startupinfo=mocker.ANY)
check_startupinfo(Popen.call_args.kwargs['startupinfo'])
proc.communicate.assert_called_once_with(None)
def test_view_unknown_platform(unknown_platform):
with pytest.raises(RuntimeError, match=r'platform'):
view('nonfilepath')
def test_view(mocker, py2, platform, Popen, startfile, quiet): # noqa: N803
if quiet and py2:
open_ = mocker.patch('__builtin__.open', mocker.mock_open())
assert view('nonfilepath', quiet=quiet) is None
if platform == 'windows':
startfile.assert_called_once_with('nonfilepath')
return
if quiet and py2:
open_.assert_called_once_with(os.devnull, 'w')
kwargs = {'stderr': open_.return_value}
elif quiet:
kwargs = {'stderr': subprocess.DEVNULL}
else:
kwargs = {}
if platform == 'darwin':
Popen.assert_called_once_with(['open', 'nonfilepath'], **kwargs)
elif platform in ('linux', 'freebsd'):
Popen.assert_called_once_with(['xdg-open', 'nonfilepath'], **kwargs)
else:
raise RuntimeError
graphviz-0.14.2/tests/test_dot.py 0000666 0000000 0000000 00000014335 13737366150 015514 0 ustar root root # test_dot.py
import itertools
import pytest
from graphviz.dot import Graph, Digraph
@pytest.fixture(params=[Graph, Digraph])
def cls(request):
return request.param
@pytest.fixture(params=list(itertools.permutations([Graph, Digraph], 2)),
ids=lambda c: '%s, %s' % (c[0].__name__, c[1].__name__))
def classes(request):
return request.param
def test_copy(cls):
c = cls()
assert c.__class__ is cls
assert c.copy() is not c
assert c.copy() is not c.copy()
assert c.copy().__class__ is c.__class__
assert c.copy().__dict__ == c.__dict__ == c.copy().__dict__
def test__repr_svg_(mocker, cls):
c = cls()
kwargs = {'return_value.decode.return_value': mocker.sentinel.decoded}
pipe = mocker.patch.object(c, 'pipe', autospec=True, **kwargs)
assert c._repr_svg_() is mocker.sentinel.decoded
pipe.assert_called_once_with(format='svg')
pipe.return_value.decode.assert_called_once_with(c.encoding)
@pytest.mark.parametrize('keep_attrs', [False, True])
def test_clear(cls, keep_attrs):
kwargs = {'%s_attr' % a: {a: a} for a in ('graph', 'node', 'edge')}
c = cls(**kwargs)
assert all(getattr(c, k) == v for k, v in kwargs.items())
c.node('spam')
assert len(c.body) == 1
body = c.body
c.clear(keep_attrs)
assert c.body == []
assert c.body is body
if keep_attrs:
assert all(getattr(c, k) == v for k, v in kwargs.items())
else:
assert all(getattr(c, k) == {} for k in kwargs)
def test_iter_subgraph_strict(cls):
with pytest.raises(ValueError, match=r'strict'):
cls().subgraph(cls(strict=True))
@pytest.mark.parametrize('cls, expected', [
(Graph, 'strict graph {\n}'),
(Digraph, 'strict digraph {\n}'),
], ids=lambda p: getattr(p, '__name__', '...'))
def test_iter_strict(cls, expected):
assert cls(strict=True).source == expected
def test_attr_invalid_kw(cls):
with pytest.raises(ValueError, match=r'attr'):
cls().attr('spam')
@pytest.mark.parametrize('cls, expected', [
(Graph, 'graph {\n\tspam=eggs\n}'),
(Digraph, 'digraph {\n\tspam=eggs\n}'),
], ids=lambda p: getattr(p, '__name__', '...'))
def test_attr_kw_none(cls, expected):
dot = cls()
dot.attr(spam='eggs')
assert dot.source == expected
@pytest.mark.parametrize('cls, expected', [
(Graph, 'graph {\n\tA [label="%s"]\n\tB [label="%s"]\n}' % (r'\\', r'\"\\\"')),
(Digraph, 'digraph {\n\tA [label="%s"]\n\tB [label="%s"]\n}' % (r'\\', r'\"\\\"')),
], ids=lambda p: getattr(p, '__name__', '...'))
def test_escaped_quotes_and_escapes(cls, expected):
dot = cls()
dot.node('A', label='\\\\')
dot.node('B', label=r'"\\"')
assert dot.source == expected
@pytest.mark.parametrize('cls, expected', [
(Graph, 'graph {\n\t// comment\n\tsubgraph name {\n\t}\n}'),
(Digraph, 'digraph {\n\t// comment\n\tsubgraph name {\n\t}\n}'),
], ids=lambda p: getattr(p, '__name__', '...'))
def test_subgraph_graph_none(cls, expected):
dot = cls()
with dot.subgraph(name='name', comment='comment'):
pass
assert dot.source == expected
def test_subgraph_graph_notsole(cls):
with pytest.raises(ValueError, match=r'sole'):
cls().subgraph(cls(), name='spam')
def test_subgraph_mixed(classes):
cls1, cls2 = classes
with pytest.raises(ValueError, match=r'kind'):
cls1().subgraph(cls2())
@pytest.mark.parametrize('cls, expected', [
(Graph, 'graph {\n\t{\n\t}\n}'),
(Digraph, 'digraph {\n\t{\n\t}\n}'),
], ids=lambda p: getattr(p, '__name__', '...'))
def test_subgraph_reflexive(cls, expected): # guard against potential infinite loop
dot = cls()
dot.subgraph(dot)
assert dot.source == expected
def test_subgraph():
s1 = Graph()
s1.node('A')
s1.node('B')
s1.node('C')
s1.edge('A', 'B', constraint='false')
s1.edges(['AC', 'BC'])
s2 = Graph()
s2.node('D')
s2.node('E')
s2.node('F')
s2.edge('D', 'E', constraint='false')
s2.edges(['DF', 'EF'])
dot = Graph()
dot.subgraph(s1)
dot.subgraph(s2)
dot.attr('edge', style='dashed')
dot.edges(['AD', 'BE', 'CF'])
assert dot.source == '''graph {
\t{
\t\tA
\t\tB
\t\tC
\t\tA -- B [constraint=false]
\t\tA -- C
\t\tB -- C
\t}
\t{
\t\tD
\t\tE
\t\tF
\t\tD -- E [constraint=false]
\t\tD -- F
\t\tE -- F
\t}
\tedge [style=dashed]
\tA -- D
\tB -- E
\tC -- F
}'''
def test_label_html():
"""http://www.graphviz.org/doc/info/shapes.html#html"""
dot = Digraph('structs', node_attr={'shape': 'plaintext'})
dot.node('struct1', '''<
>''')
dot.node('struct2', '''<
>''')
dot.node('struct3', '''<
>''')
dot.edge('struct1:f1', 'struct2:f0')
dot.edge('struct1:f2', 'struct3:here')
assert dot.source == '''digraph structs {
\tnode [shape=plaintext]
\tstruct1 [label=<
>]
\tstruct2 [label=<
>]
\tstruct3 [label=<
>]
\tstruct1:f1 -> struct2:f0
\tstruct1:f2 -> struct3:here
}'''
graphviz-0.14.2/tests/test_files.py 0000666 0000000 0000000 00000014072 13737366150 016026 0 ustar root root # test_files.py
import locale
import pytest
from graphviz.files import Source
SOURCE = {
'source': 'digraph { hello -> world }',
'filename': 'hello.gv', 'directory': 'test-output',
'format': 'PNG', 'engine': 'NEATO', 'encoding': 'utf-8',
}
@pytest.fixture(scope='module')
def source():
return Source(**SOURCE)
def test_format(source):
assert not SOURCE['format'].islower()
assert source.format == SOURCE['format'].lower()
with pytest.raises(ValueError, match=r'format'):
source.format = ''
def test_engine(source):
assert not SOURCE['engine'].islower()
assert source.engine == SOURCE['engine'].lower()
with pytest.raises(ValueError, match=r'engine'):
source.engine = ''
def test_encoding(source):
assert source.encoding == SOURCE['encoding']
with pytest.raises(LookupError, match=r'encoding'):
source.encoding = ''
def test_encoding_none(source):
source_copy = source.copy()
source_copy.encoding = None
assert source_copy.encoding == locale.getpreferredencoding()
def test_init(source):
assert source.source == SOURCE['source']
assert source.filename == SOURCE['filename']
assert source.directory == SOURCE['directory']
def test_init_filename():
assert Source('').filename == 'Source.gv'
assert type('Named', (Source,), {'name': 'name'})('').filename == 'name.gv'
def test__repr_svg_(mocker, source):
pipe = mocker.patch.object(source, 'pipe', autospec=True,
**{'return_value.decode.return_value':
mocker.sentinel.decoded})
assert source._repr_svg_() is mocker.sentinel.decoded
pipe.assert_called_once_with(format='svg')
pipe.return_value.decode.assert_called_once_with(source.encoding)
def test_pipe_format(pipe, source, format_='svg'):
assert source.format != format_
assert source.pipe(format=format_) is pipe.return_value
data = source.source.encode(source.encoding)
pipe.assert_called_once_with(source.engine, format_, data,
renderer=None, formatter=None,
quiet=False)
def test_pipe(pipe, source):
assert source.pipe() is pipe.return_value
data = source.source.encode(source.encoding)
pipe.assert_called_once_with(source.engine, source.format, data,
renderer=None, formatter=None,
quiet=False)
def test_filepath(test_platform, source):
if test_platform == 'windows':
assert source.filepath == 'test-output\\hello.gv'
else:
assert source.filepath == 'test-output/hello.gv'
def test_save(mocker, py2, filename='nonfilename', directory='nondirectory'):
source = Source(**SOURCE)
makedirs = mocker.patch('os.makedirs', autospec=True)
open_ = mocker.patch('io.open', mocker.mock_open())
assert source.save(filename, directory) == source.filepath
assert source.filename == filename and source.directory == directory
if py2:
makedirs.assert_called_once_with(source.directory, 0o777)
else:
makedirs.assert_called_once_with(source.directory, 0o777, exist_ok=True)
open_.assert_called_once_with(source.filepath, 'w',
encoding=source.encoding)
assert open_.return_value.write.call_args_list == [mocker.call(source.source),
mocker.call(u'\n')]
def test_render(mocker, render, source):
save = mocker.patch.object(source, 'save', autospec=True,
**{'return_value': mocker.sentinel.nonfilepath})
_view = mocker.patch.object(source, '_view', autospec=True)
remove = mocker.patch('os.remove', autospec=True)
assert source.render(cleanup=True, view=True) is render.return_value
save.assert_called_once_with(None, None)
render.assert_called_once_with(source.engine, source.format,
save.return_value,
renderer=None, formatter=None,
quiet=False)
remove.assert_called_once_with(save.return_value)
_view.assert_called_once_with(render.return_value, source.format, False)
def test_view(mocker, source):
render = mocker.patch.object(source, 'render', autospec=True)
kwargs = {'filename': 'filename', 'directory': 'directory',
'cleanup': True, 'quiet': True, 'quiet_view': True}
assert source.view(**kwargs) is render.return_value
render.assert_called_once_with(view=True, **kwargs)
def test__view_unknown_platform(unknown_platform, source):
with pytest.raises(RuntimeError, match=r'support'):
source._view('name', 'png', False)
def test__view(mocker, platform, source):
_view_platform = mocker.patch.object(source, '_view_%s' % platform,
autospec=True)
assert source._view(mocker.sentinel.name, 'png', False) is None
_view_platform.assert_called_once_with(mocker.sentinel.name, False)
def test_copy(source):
assert source.copy() is not source
assert source.copy() is not source.copy()
assert source.copy().__class__ is source.__class__
assert source.copy().__dict__ == source.__dict__ == source.copy().__dict__
def test_from_file(tmpdir, filename='hello.gv', directory='source_hello',
data=u'digraph { hello -> world }', encoding='utf-8'):
lpath = tmpdir.mkdir(directory)
(lpath / filename).write_text(data, encoding=encoding)
source = Source.from_file(filename, str(lpath))
assert source.encoding == 'utf-8'
source = Source.from_file(filename, str(lpath), encoding=None)
assert source.encoding == locale.getpreferredencoding()
source = Source.from_file(filename, str(lpath), encoding=encoding)
assert source.source == data
assert source.filename == filename
assert source.directory == str(lpath)
assert source.encoding == encoding
graphviz-0.14.2/tests/test_lang.py 0000666 0000000 0000000 00000003444 13737227654 015653 0 ustar root root # test_lang.py
import sys
import warnings
import pytest
from graphviz.lang import quote, attr_list, nohtml
@pytest.mark.parametrize('char', ['G', 'E', 'T', 'H', 'L', 'l'])
def test_deprecated_escape(recwarn, char):
warnings.simplefilter('always')
escape = eval(r'"\%s"' % char)
if sys.version_info < (3, 6):
assert not recwarn
else:
assert len(recwarn) == 1
w = recwarn.pop(DeprecationWarning)
assert str(w.message).startswith('invalid escape sequence')
assert escape == '\\%s' % char
assert quote(escape) == '"\\%s"' % char
@pytest.mark.parametrize('identifier, expected', [
('"spam"', r'"\"spam\""'),
('node', '"node"'),
('EDGE', '"EDGE"'),
('Graph', '"Graph"'),
('\\G \\N \\E \\T \\H \\L', '"\\G \\N \\E \\T \\H \\L"'),
('\\n \\l \\r', '"\\n \\l \\r"'),
('\r\n', '"\r\n"'),
('\\\\n', r'"\\n"'),
(u'\u0665.\u0660', u'"\u0665.\u0660"'),
('\\"spam', r'"\"spam"'),
('\\\\"spam', r'"\\\"spam"'),
('\\\\\\"spam', r'"\\\"spam"'),
('\\\\\\\\"spam', r'"\\\\\"spam"'),
])
def test_quote(identifier, expected):
assert quote(identifier) == expected
@pytest.mark.parametrize('attributes, expected', [
([('spam', 'eggs')], ' [spam=eggs]'),
({'spam': 'eggs'}, ' [spam=eggs]'),
])
def test_attr_list(attributes, expected):
assert attr_list(attributes=attributes) == expected
@pytest.mark.parametrize('string', ['spam', u'spam'])
def test_nohtml(string):
result = nohtml(string)
assert result == string
assert isinstance(result, type(string))
def test_nohtml_invalid(py2):
match = r"required types.+'str'"
if py2:
match += r".+'unicode'"
with pytest.raises(TypeError, match=match):
nohtml(True)
graphviz-0.14.2/tests/test_tools.py 0000666 0000000 0000000 00000001741 13737227654 016070 0 ustar root root # test_tools.py
import os
import functools
import pytest
from graphviz.tools import mkdirs
def itertree(root):
for path, dirs, files in os.walk(root):
base = os.path.relpath(path, root)
rel_path = functools.partial(os.path.join, base if base != '.' else '')
for is_file, names in enumerate((dirs, files)):
for n in names:
yield bool(is_file), rel_path(n).replace('\\', '/')
def test_mkdirs_invalid(tmpdir):
with tmpdir.as_cwd():
(tmpdir / 'spam.eggs').write_binary(b'')
with pytest.raises(OSError):
mkdirs('spam.eggs/spam')
def test_mkdirs(tmpdir):
with tmpdir.as_cwd():
mkdirs('spam.eggs')
assert list(itertree(str(tmpdir))) == []
for _ in range(2):
mkdirs('spam/eggs/spam.eggs')
assert list(itertree(str(tmpdir))) == [(False, 'spam'),
(False, 'spam/eggs')]
graphviz-0.14.2/CHANGES.txt 0000666 0000000 0000000 00000026044 13737375464 013774 0 ustar root root Changelog
=========
Version 0.14.2
--------------
Adapt `graphviz.version()` to support the Graphviz Release version entry format
introduced with `2.44.2` (`version()` is needed to run the tests).
Version 0.14.1
--------------
Document the colon-separated ``node[:port[:compass]]`` format used for ``tail``
and ``head`` points in the ``edge()``- and ``edges()``-methods (PR Michał
Góral).
Version 0.14
------------
Improve handling of escaped quotes (``\"``). Different from other layout engine
escapes sequences such as ``\l`` and ``\N`` (which are passed on as is by
default), there is no use case for backslash-escaping a literal quote character
because escaping of quotes is done by this library. Therefore, a
backslash-escaped quote (e.g. in ``label='\\"'``) is now treated the same as a
plain unescaped quote, i.e. both ``label='"'`` and ``label='\\"'`` produce
the same DOT source ``[label="\""]`` (a label that renders as a literal quote).
Before this change, use of ``'\\"'`` could break the quoting mechanism creating
invalid or unintended DOT, possibly leading to syntax errors from the rendering
process.
Add notebook section to documentation.
Add ``sphinx.ext.viewcode`` to docs (note that this currently lacks links for
methods, so that not all of the code is linked; use the source repo for reading
on).
Improve test and doc building config.
Version 0.13.2
--------------
Fix missing support for four-part versions in ``graphviz.version()``.
Version 0.13.1
--------------
Tag Python 3.8 support.
Fix quoting for non-ASCII numerals.
Version 0.13
------------
Add explicit support for layout engine escape sequences such as ``\l`` and
``\N``. These already worked implicitly before but where broken by backslash
escaping in ``0.12``, which is reverted by this release. Escaping now resembles
the stdlib ``re`` module: literal backslashes need to be escaped (doubled),
which is most conveniently done by using raw string literals for strings that
use escape sequences (including escaped backslashes), e.g. ``label=r'\\'``.
Add ``escape()`` function (resembling ``re.escape()``) for disabling all
meta-characters in a string for rendering.
Use ``logging`` in example notebook, add notebooks demonstrating layout engines
and escape sequence usage, improve tests with parametrization.
Version 0.12
------------
Fix missing escaping of backslashes, e.g. in labels (pull request DNGros).
Add ``quiet`` argument to standalone ``view()`` function, and ``quiet_view``
argument on ``.render()`` and ``.view()`` methods. Supresses the ``stderr``
output of started viewer processes (unavailable on Windows).
Add basic debug logging via the stdlib ``logging`` module.
Reformatted some examples, improved tests by using autospec for mocks.
Version 0.11.1
--------------
Include ``stderr`` in ``str()`` of raised ``subprocess.CalledProcessError``.
Version 0.11
------------
Add ``quiet`` argument to ``.render()`` and ``.pipe()`` methods of ``Graph``,
``Digraph``, and ``Source`` objects, allowing to suppress ``stderr`` of the
layout subprocess (parity with stand-alone ``render()`` and ``pipe()``
functions).
The rendering process for ``render()`` methods and stand-alone function is now
started from the directory of the rendered dot source file. This allows to
render graph descriptions that use relative paths inline (e.g. for referring to
image files to be included) by using paths relative to the source file
location. Previously, such relative paths would need to be given relative to
the directory from which ``render()`` was started, so this change is backwards
incompatible for code that relied on the previous behaviour.
Drop Python 3.4 support.
Version 0.10.1
--------------
Fix broken renderer argument in ``pipe()`` method and function.
Version 0.10
------------
Add ``format`` argument to ``Graph/Digraph.render()``. This follows stand-alone
``render()`` function and mirrors the ``Graph/Digraph.pipe()`` method (usually,
``format`` is set on the instance).
Add ``renderer`` and ``formatter`` arguments to ``Graph/Digraph.render()`` and
``pipe()`` methods, as well as stand-alone ``render()`` and ``pipe()`` functions.
Version 0.9
-----------
Use ``sys.stderr`` to write stderr output from rendering process to stderr
(instead of file descriptor inheritance). Ensures stderr is passed in special
environments such as IDLE.
Suppress rendering process ``stdout`` in ``render()``.
Make ``quiet=True`` also suppress ``stderr`` on success of ``render()`` and
``pipe()`` (exit-status ``0``).
Include ``stderr`` from rendering process in ``CalledProcessError`` exception.
Version 0.8.4
-------------
Tag Python 3.7 support (work around subprocess ``close_fds`` issue on Windows).
Version 0.8.3
-------------
Fix compatibility with ``python -OO``.
Version 0.8.2
-------------
Add ``nohtml()`` to support labels of the form ``'<...>'`` (disabling their default
treatment as HTML strings).
Make default ``'utf-8'`` ``encoding`` more visible.
Set ``encoding = locale.getpreferredencoding()`` when ``encoding`` argument/property is
set to ``None`` explicitly (follow stdlib ``io.open()`` behaviour).
Version 0.8.1
-------------
Add ``Source.from_file()``-classmethod (simpler in-line SVG display of ready-made
.gv files within Jupyter).
Drop Python 3.3 support.
Version 0.8
-----------
Add ``clear()``-method for ``Graph`` and ``Digraph``.
Add ``grapviz.version()`` function.
Drop dot source extra indent for edge statements following dotguide examples.
Include LICENSE file in wheel.
Version 0.7.1
-------------
Fix ``TypeError`` in ``graphviz.pipe()`` with invalid dot code under Python 3.
Add ``copy()``-method for ``Graph``, ``Digraph``, and ``Source``.
Add ``graphviz.render(..., quiet=True)``.
Fix ``graphivz.view()`` exception on unsupported platform.
Raise a dedicated ``RuntimeError`` subclass ``graphviz.ExecutableNotFound`` when the
Graphviz executables are not found.
Port tests from ``nose/unittest`` to ``pytest``, extend, use mocks.
Version 0.7
-----------
Support setting top-level attrs with ``g.attr(key=value)``.
Add context manager usage of ``subgraph()`` for adding a subgraph in a with-block.
Add json-based output formats to known ``FORMATS`` (Graphviz 2.40+).
Drop extra indent level for DOT source with nonempty ``graph/node/edge_attr``.
Add a final newline to a saved DOT source file if it does not end with one.
Raise ``subprocess.CalledProcessError`` on non-zero exit status from rendering.
Raise early when adding a ``subgraph()`` with ``strict=True`` (avoid DOT syntax error).
Make undocumented ``quote()``, ``quote_edge()``, and ``attributes()`` methods private.
Version 0.6
-----------
Drop Python 2.6 support (use ``graphviz<0.6`` there).
Improve tests for ``mkdirs()``.
Better document adding custom DOT using the ``body`` attribute.
Add ``view()``-support for FreeBSD (pull request Julien Gamba).
Version 0.5.2
-------------
Add ``ENGINES`` and ``FORMATS`` to the documented public API.
Version 0.5.1
-------------
Fixed PY3 compatibility.
Version 0.5
-----------
Add low-level functions ``render()``, ``pipe()``, and ``view()`` for directly working with
existing files and strings.
Support all ``render()``-arguments in the ``view()``-short-cut-method.
Version 0.4.10
--------------
Added ``'patchwork'`` engine.
Version 0.4.9
-------------
Add support for ``strict`` graphs and digraphs.
Hide ``render/pipe()`` subprocess console window on Windows when invoked from
non-console process (e.g. from IDLE).
Improve documentation markup/wording.
Make ``TestNoent`` more robust.
Version 0.4.8
-------------
Make ``_repr_svg_()`` available on ``Source`` (pull request RafalSkolasinski).
Version 0.4.7
-------------
Fixed ``view()``-method on Linux under Python 3 (pull request Antony Lee).
Version 0.4.6
-------------
Fixed ``view()``-method on Linux and Darwin (pull request Eric L. Frederich).
Version 0.4.5
-------------
Added example for HTML-like labels (``structs.py``).
Added ``Source`` class for rendering verbatim DOT source code.
Added Python 2.6 support (pull request Jim Crist).
Version 0.4.4
-------------
Added the ``pipe()``-method directly returning the ``stdout`` of rendering.
Added ``_repr_svg_()`` for inline rendering in IPython notebooks.
Version 0.4.3
-------------
Added examples generating some of the graphs from the Graphviz Gallery.
Added sphinx-based API documentation.
Version 0.4.2
-------------
Added support for HTML-like labels.
Version 0.4.1
-------------
Added support for less common output formats. Removed dropped formats (``'dia'``, ``'pcl'``).
Added ``'osage'`` layout engine.
Documented ``format`` and ``engine`` options in the README.
The ``view()`` convenience method now returns the result file name (like render()).
Version 0.4
-----------
Added ``attr()`` method for inline switching of node/edge attributes.
Added ``subgraph()`` method (obsoletes separate ``Subgraph`` class).
Add ``cleanup`` option to ``render()``.
Replaced ``dry`` option on ``render()`` with separate ``save()`` method.
Removed undocumented ``append()`` and ``extend()`` methods (if needed, the ``body``
attribute can be edited directly).
Version 0.3.5
-------------
Skip empty ``comment`` when creating DOT source.
Document ``graph_attr``, ``node_attr``, and ``edge_attr`` in the README.
More informative exception when Graphviz executables cannot be called.
Version 0.3.4
-------------
Fixed missing identifier quoting for DOT keywords (thanks to Paulo Urio).
Version 0.3.3
-------------
Made ``format`` and ``engine`` case-insensitive.
Version 0.3.2
-------------
Indent ``graph_attr``, ``node_attr``, and ``edge_attr`` lines, adapt nodes and edges.
Version 0.3.1
-------------
Fixed ``view()`` failing on paths with forward slashes on Windows.
Version 0.3
-----------
Added Python 3.3+ support.
Made attributes order stable (sorting plain dicts).
Fixed edgeop in undirected graphs.
Version 0.2.2
-------------
Support pdf opening on Linux.
Fixed rendering filenames w/spaces.
Version 0.2.1
-------------
Fixed rendering on Mac OS X.
Version 0.2
-----------
Added format selection, use ``'PDF``' as default.
Added engines selection, use ``'dot'`` as default.
Added source encoding, use ``'UTF-8'`` as default.
Changed constructor arguments order, removed ``compile()`` and ``save()``-method,
reimplemented compilation in ``render()`` method, make interface more similar to
gv.3python (backwards incompatible change).
Double-quote-sign escaping, attribute list quoting.
``mkdirs()`` now correctly supports current directory filenames.
Version 0.1.1
-------------
Removed automatic ``'-'`` to ``'−'`` replacement from labels.
Fixed documentation typos.
Version 0.1
-----------
First public release.
graphviz-0.14.2/LICENSE.txt 0000666 0000000 0000000 00000002123 13737227654 013773 0 ustar root root The MIT License (MIT)
Copyright (c) 2013-2020 Sebastian Bank
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
graphviz-0.14.2/MANIFEST.in 0000666 0000000 0000000 00000000422 13737227654 013706 0 ustar root root include README.rst LICENSE.txt CHANGES.txt
include requirements.txt
include run-tests.py try-examples.py
include tox.ini
recursive-include tests *.py *.png
recursive-include examples *.py *.ipynb
recursive-include docs *.rst *.txt *.py *.png *.svg
prune docs/_build
graphviz-0.14.2/PKG-INFO 0000666 0000000 0000000 00000016741 13737401626 013251 0 ustar root root Metadata-Version: 2.1
Name: graphviz
Version: 0.14.2
Summary: Simple Python interface for Graphviz
Home-page: https://github.com/xflr6/graphviz
Author: Sebastian Bank
Author-email: sebastian.bank@uni-leipzig.de
License: MIT
Project-URL: Documentation, https://graphviz.readthedocs.io
Project-URL: Changelog, https://graphviz.readthedocs.io/en/latest/changelog.html
Project-URL: Issue Tracker, https://github.com/xflr6/graphviz/issues
Description: Graphviz
========
|PyPI version| |License| |Supported Python| |Format|
|Travis| |Codecov| |Readthedocs-stable| |Readthedocs-latest|
This package facilitates the creation and rendering of graph descriptions in
the DOT_ language of the Graphviz_ graph drawing software (`master repo`_) from
Python.
Create a graph object, assemble the graph by adding nodes and edges, and
retrieve its DOT source code string. Save the source code to a file and render
it with the Graphviz installation of your system.
Use the ``view`` option/method to directly inspect the resulting (PDF, PNG,
SVG, etc.) file with its default application. Graphs can also be rendered
and displayed within `Jupyter notebooks`_ (formerly known as
`IPython notebooks`_, example_) as well as the `Jupyter Qt Console`_.
Links
-----
- GitHub: https://github.com/xflr6/graphviz
- PyPI: https://pypi.org/project/graphviz/
- Documentation: https://graphviz.readthedocs.io
- Changelog: https://graphviz.readthedocs.io/en/latest/changelog.html
- Issue Tracker: https://github.com/xflr6/graphviz/issues
- Download: https://pypi.org/project/graphviz/#files
Installation
------------
This package runs under Python 2.7, and 3.5+, use pip_ to install:
.. code:: bash
$ pip install graphviz
To render the generated DOT source code, you also need to install Graphviz
(`download page`_).
Make sure that the directory containing the ``dot`` executable is on your
systems' path.
Quickstart
----------
Create a graph object:
.. code:: python
>>> from graphviz import Digraph
>>> dot = Digraph(comment='The Round Table')
>>> dot #doctest: +ELLIPSIS
Add nodes and edges:
.. code:: python
>>> dot.node('A', 'King Arthur')
>>> dot.node('B', 'Sir Bedevere the Wise')
>>> dot.node('L', 'Sir Lancelot the Brave')
>>> dot.edges(['AB', 'AL'])
>>> dot.edge('B', 'L', constraint='false')
Check the generated source code:
.. code:: python
>>> print(dot.source) # doctest: +NORMALIZE_WHITESPACE
// The Round Table
digraph {
A [label="King Arthur"]
B [label="Sir Bedevere the Wise"]
L [label="Sir Lancelot the Brave"]
A -> B
A -> L
B -> L [constraint=false]
}
Save and render the source code, optionally view the result:
.. code:: python
>>> dot.render('test-output/round-table.gv', view=True) # doctest: +SKIP
'test-output/round-table.gv.pdf'
.. image:: https://raw.github.com/xflr6/graphviz/master/docs/round-table.png
:align: center
See also
--------
- pygraphviz_ |--| full-blown interface wrapping the Graphviz C library with SWIG
- graphviz-python_ |--| official Python bindings (documentation_)
- pydot_ |--| stable pure-Python approach, requires pyparsing
License
-------
This package is distributed under the `MIT license`_.
.. _pip: https://pip.readthedocs.io
.. _Graphviz: https://www.graphviz.org
.. _master repo: https://gitlab.com/graphviz/graphviz/
.. _download page: https://www.graphviz.org/download/
.. _DOT: https://www.graphviz.org/doc/info/lang.html
.. _Jupyter notebooks: https://jupyter.org
.. _IPython notebooks: https://ipython.org/notebook.html
.. _example: https://nbviewer.jupyter.org/github/xflr6/graphviz/blob/master/examples/notebook.ipynb
.. _Jupyter Qt Console: https://qtconsole.readthedocs.io
.. _pygraphviz: https://pypi.org/project/pygraphviz/
.. _graphviz-python: https://pypi.org/project/graphviz-python/
.. _documentation: https://www.graphviz.org/pdf/gv.3python.pdf
.. _pydot: https://pypi.org/project/pydot/
.. _MIT license: https://opensource.org/licenses/MIT
.. |--| unicode:: U+2013
.. |PyPI version| image:: https://img.shields.io/pypi/v/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Latest PyPI Version
.. |License| image:: https://img.shields.io/pypi/l/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: License
.. |Supported Python| image:: https://img.shields.io/pypi/pyversions/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Supported Python Versions
.. |Format| image:: https://img.shields.io/pypi/format/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Format
.. |Travis| image:: https://travis-ci.org/xflr6/graphviz.svg?branch=master
:target: https://travis-ci.org/xflr6/graphviz
:alt: Travis
.. |Codecov| image:: https://codecov.io/gh/xflr6/graphviz/branch/master/graph/badge.svg
:target: https://codecov.io/gh/xflr6/graphviz
:alt: Codecov
.. |Readthedocs-stable| image:: https://readthedocs.org/projects/graphviz/badge/?version=stable
:target: https://graphviz.readthedocs.io/en/stable/?badge=stable
:alt: Readthedocs stable
.. |Readthedocs-latest| image:: https://readthedocs.org/projects/graphviz/badge/?version=latest
:target: https://graphviz.readthedocs.io/en/latest/?badge=latest
:alt: Readthedocs latest
Keywords: graph visualization dot render
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*
Provides-Extra: dev
Provides-Extra: test
Provides-Extra: docs
graphviz-0.14.2/README.rst 0000666 0000000 0000000 00000011734 13737375420 013642 0 ustar root root Graphviz
========
|PyPI version| |License| |Supported Python| |Format|
|Travis| |Codecov| |Readthedocs-stable| |Readthedocs-latest|
This package facilitates the creation and rendering of graph descriptions in
the DOT_ language of the Graphviz_ graph drawing software (`master repo`_) from
Python.
Create a graph object, assemble the graph by adding nodes and edges, and
retrieve its DOT source code string. Save the source code to a file and render
it with the Graphviz installation of your system.
Use the ``view`` option/method to directly inspect the resulting (PDF, PNG,
SVG, etc.) file with its default application. Graphs can also be rendered
and displayed within `Jupyter notebooks`_ (formerly known as
`IPython notebooks`_, example_) as well as the `Jupyter Qt Console`_.
Links
-----
- GitHub: https://github.com/xflr6/graphviz
- PyPI: https://pypi.org/project/graphviz/
- Documentation: https://graphviz.readthedocs.io
- Changelog: https://graphviz.readthedocs.io/en/latest/changelog.html
- Issue Tracker: https://github.com/xflr6/graphviz/issues
- Download: https://pypi.org/project/graphviz/#files
Installation
------------
This package runs under Python 2.7, and 3.5+, use pip_ to install:
.. code:: bash
$ pip install graphviz
To render the generated DOT source code, you also need to install Graphviz
(`download page`_).
Make sure that the directory containing the ``dot`` executable is on your
systems' path.
Quickstart
----------
Create a graph object:
.. code:: python
>>> from graphviz import Digraph
>>> dot = Digraph(comment='The Round Table')
>>> dot #doctest: +ELLIPSIS
Add nodes and edges:
.. code:: python
>>> dot.node('A', 'King Arthur')
>>> dot.node('B', 'Sir Bedevere the Wise')
>>> dot.node('L', 'Sir Lancelot the Brave')
>>> dot.edges(['AB', 'AL'])
>>> dot.edge('B', 'L', constraint='false')
Check the generated source code:
.. code:: python
>>> print(dot.source) # doctest: +NORMALIZE_WHITESPACE
// The Round Table
digraph {
A [label="King Arthur"]
B [label="Sir Bedevere the Wise"]
L [label="Sir Lancelot the Brave"]
A -> B
A -> L
B -> L [constraint=false]
}
Save and render the source code, optionally view the result:
.. code:: python
>>> dot.render('test-output/round-table.gv', view=True) # doctest: +SKIP
'test-output/round-table.gv.pdf'
.. image:: https://raw.github.com/xflr6/graphviz/master/docs/round-table.png
:align: center
See also
--------
- pygraphviz_ |--| full-blown interface wrapping the Graphviz C library with SWIG
- graphviz-python_ |--| official Python bindings (documentation_)
- pydot_ |--| stable pure-Python approach, requires pyparsing
License
-------
This package is distributed under the `MIT license`_.
.. _pip: https://pip.readthedocs.io
.. _Graphviz: https://www.graphviz.org
.. _master repo: https://gitlab.com/graphviz/graphviz/
.. _download page: https://www.graphviz.org/download/
.. _DOT: https://www.graphviz.org/doc/info/lang.html
.. _Jupyter notebooks: https://jupyter.org
.. _IPython notebooks: https://ipython.org/notebook.html
.. _example: https://nbviewer.jupyter.org/github/xflr6/graphviz/blob/master/examples/notebook.ipynb
.. _Jupyter Qt Console: https://qtconsole.readthedocs.io
.. _pygraphviz: https://pypi.org/project/pygraphviz/
.. _graphviz-python: https://pypi.org/project/graphviz-python/
.. _documentation: https://www.graphviz.org/pdf/gv.3python.pdf
.. _pydot: https://pypi.org/project/pydot/
.. _MIT license: https://opensource.org/licenses/MIT
.. |--| unicode:: U+2013
.. |PyPI version| image:: https://img.shields.io/pypi/v/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Latest PyPI Version
.. |License| image:: https://img.shields.io/pypi/l/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: License
.. |Supported Python| image:: https://img.shields.io/pypi/pyversions/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Supported Python Versions
.. |Format| image:: https://img.shields.io/pypi/format/graphviz.svg
:target: https://pypi.org/project/graphviz/
:alt: Format
.. |Travis| image:: https://travis-ci.org/xflr6/graphviz.svg?branch=master
:target: https://travis-ci.org/xflr6/graphviz
:alt: Travis
.. |Codecov| image:: https://codecov.io/gh/xflr6/graphviz/branch/master/graph/badge.svg
:target: https://codecov.io/gh/xflr6/graphviz
:alt: Codecov
.. |Readthedocs-stable| image:: https://readthedocs.org/projects/graphviz/badge/?version=stable
:target: https://graphviz.readthedocs.io/en/stable/?badge=stable
:alt: Readthedocs stable
.. |Readthedocs-latest| image:: https://readthedocs.org/projects/graphviz/badge/?version=latest
:target: https://graphviz.readthedocs.io/en/latest/?badge=latest
:alt: Readthedocs latest graphviz-0.14.2/requirements.txt 0000666 0000000 0000000 00000000115 13737227654 015433 0 ustar root root # development environment: install in development mode
-e .[dev,test,docs]
graphviz-0.14.2/run-tests.py 0000666 0000000 0000000 00000000634 13737227654 014473 0 ustar root root #!/usr/bin/env python
import platform
import sys
import pytest
ARGS = [
#'--pdb',
#'--exitfirst',
]
if platform.system() == 'Windows':
if 'idlelib' in sys.modules:
ARGS.extend(['--capture=sys', '--color=no'])
elif sys.version_info.major == 2 and 'win_unicode_console' in sys.modules:
ARGS.append('--capture=sys')
sys.exit(pytest.main(ARGS + sys.argv[1:]))
graphviz-0.14.2/setup.cfg 0000666 0000000 0000000 00000001122 13737401626 013760 0 ustar root root [metadata]
license_file = LICENSE.txt
[sdist]
formats = zip
[bdist_wheel]
universal = 1
[tool:pytest]
minversion = 4
testpaths = README.rst docs graphviz tests
addopts =
--doctest-modules --doctest-glob='*.rst' --ignore=docs/conf.py
--cov --cov-report=term --cov-report=html
mock_use_standalone_module = true
log_cli = false
log_cli_level = DEBUG
log_file = test-log.txt
log_file_level = DEBUG
[coverage:run]
source = graphviz
branch = false
[flake8]
ignore = E126,E128
max-line-length = 100
exclude = docs, .tox
[egg_info]
tag_build =
tag_date = 0
graphviz-0.14.2/setup.py 0000666 0000000 0000000 00000003261 13737375464 013671 0 ustar root root # setup.py
import io
from setuptools import setup, find_packages
setup(
name='graphviz',
version='0.14.2',
author='Sebastian Bank',
author_email='sebastian.bank@uni-leipzig.de',
description='Simple Python interface for Graphviz',
keywords='graph visualization dot render',
license='MIT',
url='https://github.com/xflr6/graphviz',
project_urls={
'Documentation': 'https://graphviz.readthedocs.io',
'Changelog': 'https://graphviz.readthedocs.io/en/latest/changelog.html',
'Issue Tracker': 'https://github.com/xflr6/graphviz/issues',
},
packages=find_packages(),
platforms='any',
python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*',
extras_require={
'dev': ['tox>=3', 'flake8', 'pep8-naming', 'wheel', 'twine'],
'test': ['mock>=3', 'pytest>=4', 'pytest-mock>=2', 'pytest-cov'],
'docs': ['sphinx>=1.8', 'sphinx-rtd-theme'],
},
long_description=io.open('README.rst', encoding='utf-8').read(),
classifiers=[
'Development Status :: 4 - Beta',
'Intended Audience :: Developers',
'Intended Audience :: Science/Research',
'License :: OSI Approved :: MIT License',
'Operating System :: OS Independent',
'Programming Language :: Python :: 2',
'Programming Language :: Python :: 2.7',
'Programming Language :: Python :: 3',
'Programming Language :: Python :: 3.5',
'Programming Language :: Python :: 3.6',
'Programming Language :: Python :: 3.7',
'Programming Language :: Python :: 3.8',
'Topic :: Scientific/Engineering :: Visualization',
],
)
graphviz-0.14.2/tox.ini 0000666 0000000 0000000 00000000210 13737375420 013451 0 ustar root root [tox]
envlist = py{27,35,36,37,38}
skip_missing_interpreters = true
[testenv]
extras = test
commands = ./run-tests.py {posargs}
graphviz-0.14.2/try-examples.py 0000666 0000000 0000000 00000000512 13737227654 015154 0 ustar root root #!/usr/bin/env python
# try-examples.py - import graphviz here and run all scripts in the example dir
import os
import io
import glob
import graphviz # noqa: F401
os.chdir('examples')
for filename in glob.iglob('*.py'):
with io.open(filename, encoding='utf-8') as fd:
code = fd.read()
exec(code)