+ Dfj!LRt^RIt^RIt^RIt^RIt^RIHtHtHtH t ^RI H t H t ^RI Ht^RIHt^RIHt^RIHt!RR ] 4t!R R 4t!R R 4tRt]P4tRtRRlt] !R] R7tRRRllt]t Rt!RR.t"R# ]d RRltL4i;i)zL Plugin system for Twisted. @author: Jp Calderone @author: Glyph Lefkowitz N)IterableOptionalTypeTypeVar) Interface providedBy)log)getAdapterFactory) getModule)namedAnyc]tRt^tRtRtR#)IPluginz Interface that must be implemented by all plugins. Only objects which implement this interface will be considered for return by C{getPlugins}. To be useful, plugins should also implement some other application-specific interface. N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r0/usr/lib/python3/dist-packages/twisted/plugin.pyr r srr cLa]tRt^&toRtV3RlRltRtRRlt]tRt Vt R#) CachedPlugincWnW nW0nW@nVPPP V4R#N)dropinname descriptionprovidedpluginsappend)selfrrrrs&&&&&r__init__CachedPlugin.__init__'s/  &  ""4(rc <V^8dQhRS[/#return)str)format __classdict__s"r __annotate__CachedPlugin.__annotate__.s  # rc RPVPVPPRP VP Uu.uFqP NK up44#uupi)z(z, )r)rr moduleNamejoinrr)r!is& r__repr__CachedPlugin.__repr__.sO9@@ II KK " " II4==9=azz=9 :  :sA$cp\VPPR,VP,4#).)r rr.r)r!s&rloadCachedPlugin.load5s% ..4tyy@AArNcVPFSpVPV4'dVP4u#\WAR4fK<V!VP4V4u# V#r)r isOrExtendsr5r )r! interfaceregistrydefaultprovidedInterfaces&&&& r __conform__CachedPlugin.__conform__8sV!%  ,,Y77yy{" !2tDP g66 "/ r)rrrr)NN) rrrrr"r1r5r= getComponentr__classdictcell__r*s@rrr&s&)  BLrrc*a]tRt^DtoRtRtRtVtR#) CachedDropina A collection of L{CachedPlugin} instances from a particular module in a plugin package. @type moduleName: C{str} @ivar moduleName: The fully qualified name of the plugin module this represents. @type description: C{str} or L{None} @ivar description: A brief explanation of this collection of plugins (probably the plugin module's docstring). @type plugins: C{list} @ivar plugins: The L{CachedPlugin} instances which were loaded from this dropin. c,WnW n.VnR#r)r.rr)r!r.rs&&&rr"CachedDropin.__init__Vs$& r)rr.rN)rrrrrr"rr@rAs@rrCrCDs"rrCc \VPVP4pVPP 4F@wr#\ VR4pVfK\ WVP\\V444KB V#r) rCrr__dict__itemsr rlistr)providerrkvplugins& r_generateCacheEntryrN\sh (++X-=-= >F!!'')D!   AIItJv4F/G H * Mrc$/pVFpWV&K V#rr)keysvaluedrKs&& rfromkeysrSjs AaDrc /p\VP4p/pVP4F@pVPP 4pWS9d.W5&W5,pVP V4KB VP 4EFHwrvVPR4pVP4p VPR4;_uu_4p \P!V 4p RRR4Rp /p TFspTPPR4R ,pRY&TX 9g"TPP4T 8gKQRp TP4p\T4pTY&Ku \%X P'44FpY9gK YRp K T 'd'TP)\P*!T 44TP5T 4EKK V# +'giL;i \d /p ^p ELi;i \d\ P"!4EK6i;i \,d8p\ P.!RTP0TP2R7Rp?LRp?i\d\ P"!RR 4Li;i) a# Compute all the possible loadable plugins, while loading as few as possible and hitting the filesystem as little as possible. @param module: a Python module object. This represents a package to search for plugins. @return: a dictionary mapping module names to L{CachedDropin} instances. z dropin.cacherNFr4Tz@Unable to write to plugin cache %(path)s: error number %(errno)d)r)patherrnoz)Unexpected error while writing cache file)r r iterModulesfilePathparentr rHchildgetModificationTimeopenpickler5 BaseExceptionrsplitrNrerrrIrP setContentdumpsOSErrormsgrVrWupdate)moduleallCachesCombinedmodbucketsplugmodfppbucketpseudoPackagePath dropinPath lastCachedfdropinDotCache needsWrite existingKeys pluginModule pluginKeyrJentryes& rgetCacherzqs: FOO $CG??$%%'  GL g % &-]]_!&,,^<  #779J%%!'Q&   "L$))//4R8I&*L #/%%99;zI! 6+002H 09E05N-# n1134I,"-! 5  K%%fll>&BC   0]&5^ W&% NJ %GGII +$'' ! KIJ Ksf)G ?G G 8G6%H G G G  G32G36 HH J)-I J(JJc8V^8dQhR\P/#r%)types ModuleType)r)s"rr+r+s))rc^RIHpV#)N)twisted.pluginsr)packages r_pluginsPackagers % Nr _TInterface)boundcV^8dQhR\\,R\\P,R\ \,/#)r&r9rr')rrrr|r}r)r)s"rr+r+s9""K "+3E4D4D+E" k"rc#"Vf \4p\V4pVP4F,wr4VPFpV!VR4pVeVxKK K. R# \d\ P !4KDi;i5i)aG Retrieve all plugins implementing the given interface beneath the given module. @param interface: An interface class. Only plugins which implement this interface will be returned. @param package: A package beneath which plugins are installed. For most uses, the default value is correct. @return: An iterator of plugins. N)rrzrHrr`rrb)r9r allDropinskeyrrMadapteds&& r getPluginsrs}!#'"J!'') nnF "#FD1&!M' %*!   s)>B A B B>BBBc VPR4p\PUu.uFp\PP \PP !V.VR.,O5!4'dKR\PP \PP !V.VO5!4NK up#uupi)a Return a list of additional directories which should be searched for modules to be included as part of the named plugin package. @type name: C{str} @param name: The fully-qualified Python name of a plugin package, eg C{'twisted.plugins'}. @rtype: C{list} of C{str} @return: The absolute paths to other directories which may contain plugin modules for the named plugin package. r4z __init__.py)rasysrVosexistsr/abspath)rrxs& rpluginPackagePathsrsjjoG Aww~~bggll1Iw-/HIJ 3 Q112  s AB>8AB>rrr)#rrr_rr|typingrrrrzope.interfacerrtwisted.pythonrtwisted.python.componentsr twisted.python.modulesr twisted.python.reflectr r rrCrNdictrSAttributeErrorrzrrr getPlugInsr__all__rrrrs  4407,+i<0}}HIX m95 ": < - .ys" B B#"B#