ó
    ~ þg9^  ã                   óF  • S SK r S SKrS SKrS SKrS SKJrJrJr  S SKrS SK	r	S SK
r
S SKrS SKrS SKrS SKrS SKrS SKrS SKrS SKJr  S SKJr   S SKJr  \R6                  " S5      rSr S SKr\R>                  " \ 5        S	rSr&/ SQr'S r(S5S jr)S r*S6S jr+S r,S r-S7S jr.S r/S8S jr0\&SSSSSSSSSSS4S jr1S9S jr2S8S jr3S:S jr4S;S jr5\ Rl                  4S jr7S  r8S! r9S" r:S# r;S$ r<\ Rz                  S%.S& jr>S' r?/ 4S( jr@ " S) S*5      rA " S+ S,\R„                  5      rC " S- S.\R„                  5      rD " S/ S05      rE " S1 S25      rF " S3 S4\G5      rHg! \ a
    S SKJr   GNf = f! \\!4 a'    S S
K"J#r#  Sr$\RK                  S\#" \$SSS9 S35         GNf = f)<é    N)ÚPopenÚPIPEÚSTDOUT)Úclosing)Údeque)Úparse)Úparse_versionÚsosFT)ÚfillzÜWARNING: Failed to load 'magic' module version >= 0.4.20 which sos aims to use for detecting binary files. A less effective method will be used. It is recommended to install proper python3-magic package with the module.
Ú
éH   )Úreplace_whitespacei,  )ÚTIMEOUT_DEFAULTÚImporterHelperÚSoSTimeoutErrorÚTempFileUtilÚboldÚfile_is_binaryÚfileobjÚfindÚget_human_readableÚgrepÚimport_moduleÚis_executableÚlistdirr	   Úpath_existsÚ
path_isdirÚpath_isfileÚpath_islinkÚ	path_joinÚrecursive_dict_values_by_keyÚ	shell_outÚsos_get_command_outputÚtac_logsÚtailc                 ó0  • [         R                  " S5      n UR                  U SS9u  p#nU(       d  U $ [         R                  " SSU5      R	                  S5      nU SU 3nU$ ! [
         a'  n[        R                  SU  S	U 35        U s S
nA$ S
nAff = f)z;Convert the version into a PEP440 compliant version scheme.z2^([0-9][0-9.]*(?:(?:a|b|rc|.post|.dev)[0-9]+)*)\+?é   )Úmaxsplitz[+~]+Ú.Ú-Ú+zUnable to format z to pep440 format: N)ÚreÚcompileÚsplitÚsubÚstripÚ	ExceptionÚlogÚdebug)ÚverÚpublic_version_reÚ_ÚpublicÚlocalÚsanitized_localÚpep440_versionÚerrs           Ú//usr/lib/python3/dist-packages/sos/utilities.pyÚformat_version_to_pep440r=   P   sŸ   € äŸ
š
ØAóÐð	Ø,×2Ñ2°3ÀÐ2ÐCÑˆ�5ÞØˆJÜŸ&š& ¨#¨uÓ5×;Ñ;¸CÓ@ˆØ"˜8 1 _Ð$5Ð6ˆØÐøÜó Ü�	‰	Ð% c UÐ*=¸c¸UÐCÔDØ�
ûðús"   ˜A$ ´/A$ Á$
BÁ.BÂ
BÂBc                 óR   • U(       a  [        U 5      n[        U5      $ [        U 5      $ )z5Converts the version to PEP440 format before parsing )r=   r	   )r4   Úpep440Ú
ver_pep440s      r<   Úsos_parse_versionrA   a   s%   € æÜ-¨cÓ2ˆ
Ü˜ZÓ(Ð(ä˜ÓÐó    c                 óÞ   • [        U S5       n[        R                  " U 5      R                  U:”  a  UR	                  U* S5        UR                  5       sSSS5        $ ! , (       d  f       g= f)z,Returns the last number_of_bytes of filenameÚrbé   N)ÚopenÚosÚstatÚst_sizeÚseekÚread)ÚfilenameÚnumber_of_bytesÚfs      r<   r%   r%   j   sK   € ä	ˆh˜Ô	 Ü�7Š7�8Ó×$Ñ$ Ó6Ø�F‰F�OÐ# QÔ'Ø�v‰v‹x÷ 
×	×	ús   �AAÁ
A,c                 óæ   • [        U [        5      (       a   [        XSS9$ [        U 5      $ ! [         a:    [        R                  SU  S35        [        [        R                  " 5       5      s $ f = f)z@Returns a file-like object that can be used as a context managerúutf-8©Úencodingz	fileobj: z could not be opened)	Ú
isinstanceÚstrrF   ÚIOErrorr2   r3   r   ÚioÚStringIO)Úpath_or_fileÚmodes     r<   r   r   r   sf   € ä�,¤×$Ñ$ð	*Ü˜°WÑ=Ð=ô
 �|Ó$Ð$øô	 ó 	*Ü�I‰I˜	 , Ð/CÐDÔEÜœ2Ÿ;š;›=Ó)Ò)ð	*ús   —	, ¬AA0Á/A0c                 ó|   • SSSSS.nUR                  5        H  u  p#X:¼  d  M  [        U 5      U-  S U 3s  $    U  $ )zCConverts a number of bytes to a shorter, more human friendly formatl        i   @é   é   )ÚTÚGÚMÚKz.1f)ÚitemsÚfloat)Ú	num_bytesÚsizesÚsymbolÚsizes       r<   Úconvert_bytesrg   ~   sN   € à ¨g¸GÑD€EØŸ™ž‰ˆØÕÜ˜IÓ&¨Ñ-¨cÐ2°6°(Ð;Ò;ñ &ð ˆ[ÐrB   c                 ór  ^• [         (       aK   [        R                  " U 5      mSS/nTR                  S:H  =(       a    [	        U4S jU 5       5      (       + $ [        U SSS9 n UR                  S5         S	S	S	5        g
! [
         a     N4f = f! [         a     S	S	S	5        gf = f! , (       d  f       g	= f)a^  Helper to determine if a given file contains binary content or not.

This is especially helpful for `sos clean`, which cannot obfuscate binary
data and instead, by default, will remove binary files.

:param fname:   The full path of the file to check binaryness of
:type fname:    ``str``

:returns:   True if binary, else False
:rtype:     ``bool``
ztext/zinode/Úbinaryc              3   óZ   >#   • U  H   nTR                   R                  U5      v •  M"     g 7f©N)Ú	mime_typeÚ
startswith)Ú.0Ú_mtÚ_ftups     €r<   Ú	<genexpr>Ú!file_is_binary.<locals>.<genexpr>™   s#   øé € ÐFºv¸�E—O‘O×.Ñ.¨s×3Ð3ºvùs   ƒ(+ÚtrrP   rQ   r'   NFT)	Ú	magic_modÚmagicÚdetect_from_filenamerR   Úanyr1   rF   rK   ÚUnicodeDecodeError)ÚfnameÚ_mimesÚtfilerp   s      @r<   r   r   ‡   s¹   ø€ ÷ ‚yð	Ü×.Ò.¨uÓ5ˆEØ˜xÐ(ˆFà—‘ (Ñ*÷ GÜÔF¹vÓFÓFô0Gðô 
ˆe�T GÒ	,°ð	ð �J‰J�qŒMØ÷ 
-Ð	,øô	 ó 	Ùð	ûô "ó 	Ø÷ 
-Ð	,ð	ú÷ 
-Õ	,ús<   ŽA	B  Á#B(Á%BÂ 
BÂBÂ
B%ÂB(Â$B%Â%B(Â(
B6c              #   ó$  #   • U(       aJ  [         R                  R                  U5      R                  [         R                  R                  5      nX$-  n[         R
                  " U5       H¡  u  pVnU(       a2  UR                  [         R                  R                  5      U:¼  a  USS2	 U(       a  [        R                  " XS5      (       d  Mc  [        R                  " Xp5       H$  n[         R                  R                  XX5      v •  M&     M£     g7f)z‹Generator function to find files recursively.
Usage::

    for filename in find("*.properties", "/var/log/foobar"):
        print filename
N)	rG   ÚpathÚdirnameÚcountÚsepÚwalkÚfnmatchÚfilterÚjoin)	Úfile_patternÚtop_dirÚ	max_depthÚpath_patternÚ
base_depthr}   ÚdirlistÚfilelistÚnames	            r<   r   r   ©   s«   é € ö Ü—W‘W—_‘_ WÓ-×3Ñ3´B·G±G·K±KÓ@ˆ
ØÑˆ	ä#%§7¢7¨7Ö#3Ñˆ�xÞ˜Ÿ™¤B§G¡G§K¡KÓ0°IÓ=Øš�
æ¤§¢°× CÑ CÙä—N’N 8Ö:ˆDÜ—'‘'—,‘,˜tÓ*Ô*ó ;ò $4ùs   ‚DDc                 ó    ^ • / nU H2  n[        U5       nUR                  U 4S jU 5       5        SSS5        M4     U$ ! , (       d  f       MG  = f)z�Returns lines matched in fnames, where fnames can either be pathnames to
files to grep through or open file objects to grep through line by linec              3   ód   >#   • U  H%  n[         R                  " TU5      (       d  M!  Uv •  M'     g 7frk   )r,   Úmatch)rn   ÚlineÚpatterns     €r<   rq   Úgrep.<locals>.<genexpr>Æ   s    øé € ÐKªR T´2·8²8¸GÀT×3JŸD™DªRùs   ƒ 0§	0N)r   Úextend)r‘   Úfiles_or_pathsÚmatchesÚfopÚfos   `    r<   r   r   ¿   sE   ø€ ð €GãˆÜ�SŒ\˜RØ�N‰NÔK©RÓKÔL÷ ‰\ñ ð €N÷ Ž\ús	   ”>¾
A	c           
      óÂ  • [         R                  R                  SS5      R                  [         R                  R
                  5      nU /U Vs/ s H"  n[         R                  R                  X05      PM$     sn-   nU(       aB  UU Vs/ s H1  n[         R                  R                  XR                  S5      5      PM3     sn-  n[        S U 5       5      $ s  snf s  snf )z6Returns if a command matches an executable on the PATHÚPATHÚ Ú/c              3   ól   #   • U  H*  n[         R                  " U[         R                  5      v •  M,     g 7frk   )rG   ÚaccessÚX_OK)rn   r}   s     r<   rq   Ú is_executable.<locals>.<genexpr>Ô   s"   é € Ð?²J¨DŒr�yŠy˜œrŸw™w×'Ð'²Jùs   ‚24)	rG   ÚenvironÚgetr.   r}   Úpathsepr„   Úlstriprw   )ÚcommandÚsysrootÚpathsÚpÚ
candidatesÚcs         r<   r   r   Ë   sª   € ô �J‰J�N‰N˜6 2Ó&×,Ñ,¬R¯W©W¯_©_Ó=€EØ�ÁÓFÂ¸1œbŸg™gŸl™l¨1Ö6ÁÑFÑF€JÞØÙ:Dó
Ú:D°QŒB�G‰G�L‰L˜§(¡(¨3£-Ö0¹*ñ
ñ 	
ˆ
ô Ñ?±JÓ?Ó?Ð?ùò Gùò
s   Á)CÂ8Cc                 ón
  ^^^	^• UUU4S jnU	4S jnT(       a@  [         R                  " T5      nUR                  UR                  TUR                  TS.5        [        R
                  R                  5       nSUS'   U(       a:  UR                  5        H&  u  nnU(       a  UUU'   M  UR                  US5        M(     U(       a$  [        S5      (       a  SU(       a  S	OS
 SU SU  3n [        R                  " U 5      n/ nU Hs  nUR                  S5      (       aI  SU;   aC  [        R                  " U5      nU(       a  UR                  U5        MO  UR                  U5        Mb  UR                  U5        Mu     U
(       aT  U(       a  [         nOLU(       a2  ["        R$                  " [        R&                  R)                  U
5      S9nO[+        U
S5      nO[         n [-        USUU(       a  [.        O[         SUSUS9 nU
(       aq  U(       a]  U(       a2  ["        R$                  " [        R&                  R)                  U
5      S9nO[+        U
S5      n[1        UR2                  UX‡5      nO#[5        UU5      nO[7        UR2                  X‡5      nT	(       a-  UR8                  (       a  U" U5        UR8                  (       a  M  O UR;                  U(       a  UOS5        URK                  5       c   URK                  5       c  M  U
(       aI  U(       aB  [+        U
S5       n[A        UUURD                  =(       d    URL                  S:g  5        SSS5        URL                  S;   a  SnOURC                  5       nURL                  UURD                  S.sSSS5        [G        US5      (       a  URI                  5         $ $ ! [<         a¥    UR?                  5         U
(       a;  U(       a4  [+        U
S5       n[A        UUS5        SSS5        O! , (       d  f       O= fSUl        SURC                  5       URD                  S.s sSSS5        [G        US5      (       a  URI                  5         $ $ f = f! , (       d  f       GN)= f! , (       d  f       Ob= f! [N         aR  nURP                  [P        RR                  :X  a-  SS
S
S.s SnA[G        US5      (       a  URI                  5         $ $ UeSnAff = f [G        US5      (       a  URI                  5         gg! [G        US5      (       a  URI                  5         f f = f)z�Execute a command and return a dictionary of status and output,
optionally changing root or current working directory before
executing command.
c                  óÎ  >• T(       a  TS:w  a  [         R                  " T5        T(       aœ  [         R                  " [        R                  " T5      R
                  5        [         R                  " [        R                  " T5      R                  5        [         R                  " [        R                  " T5      R                  5        T (       a  [         R                  " T 5        g g ©Nr›   )
rG   ÚchrootÚsetgidÚpwdÚgetpwnamÚpw_gidÚsetuidÚpw_uidÚchdirÚpw_dir)r´   r­   Úrunass   €€€r<   Ú_child_prep_fnÚ.sos_get_command_output.<locals>._child_prep_fnã   s   ø€ Þ�f “mÜ�IŠI�fÔÞÜ�IŠI”c—l’l 5Ó)×0Ñ0Ô1Ü�IŠI”c—l’l 5Ó)×0Ñ0Ô1Ü�HŠH”S—\’\ %Ó(×/Ñ/Ô0ÞÜ�HŠH�U�Oð rB   c                 óž   >• T" 5       (       d  U R                  5       S:X  a  U R                  5         [        e[        R                  " S5        g )Né|   ç{®Gáz„?)ÚpollÚ	terminater   ÚtimeÚsleep)ÚprocÚpollers    €r<   Ú_check_pollerÚ-sos_get_command_output.<locals>._check_pollerí   s3   ø€ Ù�8‰8�t—y‘y“{ cÓ)Ø�N‰NÔÜ!Ð!Ü�
Š
�4ÕrB   )ÚHOMEÚLOGNAMEÚPWDÚUSERzC.UTF-8ÚLC_ALLNÚtimeoutztimeout z--foregroundrš   Ú zs r›   Ú*©ÚdirÚwbFéÿÿÿÿT)ÚshellÚstdoutÚstderrÚbufsizeÚenvÚ	close_fdsÚ
preexec_fnrº   )ÚstatusÚoutputÚ	truncatedÚcloser   )é~   é   rB   rÜ   )*r¯   r°   Úupdaterµ   rG   r    Úcopyra   Úpopr   Úshlexr.   rm   Úglobr“   Úappendr   ÚtempfileÚTemporaryFiler}   r~   rF   r   r   Ú
HeadReaderrÑ   Ú
FakeReaderÚ
TailReaderÚrunningÚwaitr1   r½   r$   Úget_contentsÚis_fullÚhasattrrÚ   r¼   Ú
returncodeÚOSErrorÚerrnoÚENOENT)r¤   rÉ   rÒ   r­   r´   rÔ   Ú
foregroundri   Ú	sizelimitrÁ   Úto_fileÚtacr¶   r·   rÂ   Úpwd_userÚcmd_envÚkeyÚvalueÚargsÚexpanded_argsÚargÚexpanded_argÚ_outputr§   ÚreaderÚf_dstrÑ   Úes      ``    `  `                r<   r#   r#   ×   s1  û€ ÷õö Ü—<’< Ó&ˆØ�
‰
Ø—O‘OØØ—?‘?Øñ	
ô 	ô �j‰j�o‰oÓ€Gà!€GˆHÑæ
ØŸ)™)ž+‰JˆC�ÞØ$�˜“à—‘˜C Ö&ñ	 &ö ”= ×+Ñ+Ø¶
™nÀÐCÀ1ÀWÀIð NØ�ið!ˆô �;Š;�wÓ€Dà€MÛˆØ�>‰>˜#×Ñ 3¨#£:ÜŸ9š9 S›>ˆLÞØ×$Ñ$ \Ö2à×$Ñ$ SÖ)à× Ñ  Ö%ñ ö Þä‰GÞä×,Ò,´·±·±ÀÓ1IÑJ‰Gô ˜7 DÓ)‰GäˆðBÜ�=¨°gÞ$*�&´Ø 7°dØ,ò.ð 23æÞÞÜ"*×"8Ò"8Ü "§¡§¡°Ó 8ñ#™ô
 #' w°Ó"5˜Ü'¨¯©°'¸9ÓM‘Fä'¨¨6Ó2‘Fä# A§H¡H¨iÓ@�æØ—n—nÙ! !Ô$ð —n—n‘nøð9ð —F‘F¦g™7°4Ô8ð —&‘&“(Ñ"Øð —&‘&“(Ó"ö ž3Ü˜' 4Ô(¨EÜ˜W eØ#Ÿ^™^×@¨q¯|©|¸qÑ/@ôB÷ )ð �|‰|˜zÓ)Ø‘à×,Ñ,Ó.�ð Ÿ,™,Ø Ø#Ÿ^™^ñ÷m.ð .ô@ �7˜G×$Ñ$Ø�M‰M�Oð %øôI !ó 
9Ø—K‘K”MÞÞÜ!% g¨tÔ!4¸Ü (¨°%¸Ô >÷ "5×!4Ö!4úð &+�F”NØ&)°V×5HÑ5HÓ5JØ)/¯©ñ9ñ 9÷K.ð .ô@ �7˜G×$Ñ$Ø�M‰M�Oð %ðI
9ú÷" )Ö(ú÷[.õ .ûôv ó Ø�7‰7”e—l‘lÓ"Ø!¨R¸bÑAÔAô �7˜G×$Ñ$Ø�M‰M�Oð %ð ˆûðúðw.ô@ �7˜G×$Ñ$Ø�M‰M�Oð %øŒ7�7˜G×$Ñ$Ø�M‰M�Oð %úsÂ   Ç!R Ç=C Q<Ê?Q<ËN8Ë#Q<Ì Q<Ì.Q*ÍAQ<Î	R Î84Q'Ï,PÏ:	Q'Ð
PÐ,Q'Ð9Q<Ð:	R Ñ&Q'Ñ'Q<Ñ*
Q9	Ñ4Q<Ñ<
R
ÒR Ò	T Ò
R Ò
S)Ò#S$Ò:S)Ò;T Ó"S$Ó$S)Ó)T Ô$T4c                 ó  • SnSnSnU R                  5         [        R                  " U R                  5       5      R                  S:X  a  g[
        R
                  " U R                  5       S[
        R                  S9 nUR                  5       S-
  =pxXh   U:w  a  SnUS:¼  aT  UR                  USU5      nXgS-      U:X  a	  US	:X  a  O/M-  U(       a  S
nOUR                  XgS-   US-    5        UnUS:¼  a  MT  SSS5        g! , (       d  f       g= f)z Python implementation of the tac utility with support
for multiline logs (starting with space). It is intended
to reverse the output of 'journalctl --reverse'.
ó   
é
   é    r   N)r�   r'   TrÏ   F)
ÚflushrG   ÚfstatÚfilenorI   ÚmmapÚACCESS_READrf   ÚrfindÚwrite)	Úf_srcrÿ   Údrop_last_logÚ	NEWLINE_BÚ	NEWLINE_IÚSPACE_IÚmmÚsep1Úsep2s	            r<   r$   r$   h  sô   € ð
 €IØ€IØ€Gð 
‡K�K„MÜ	‡x‚x�—‘“Ó×'Ñ'¨1Ó,ØÜ	�Š�5—<‘<“> 1¬T×-=Ñ-=Ò	>À"Ø—g‘g“i ‘kÐ!ˆØ‰8�yÓ Ø ˆMØ�a‹iØ—8‘8˜I q¨$Ó/ˆDð �q‘&‰z˜WÓ$ð ˜2“:Øáö Ø %‘ð —‘˜B A™v d¨1¡fÐ-Ô.ØˆDð- �a�i÷	 
?×	>Ö	>ús   Á<A7C>Ã>
Dc                 óâ  • U R                  S5      S   n [        U [        5       [        5       U/5      n[        R                  " U[        R                  5       VVs/ s H  u  pVUR                  U :X  d  M  UPM     nnnU(       a$  U Vs/ s H  n[        X�5      (       d  M  UPM     nnU$ ! [         a,  n[        SU  SUR                  R                   35        UeSnAff = fs  snnf s  snf )a  Imports the module module_fqname and returns a list of defined classes
from that module. If superclasses is defined then the classes returned will
be subclasses of the specified superclass or superclasses. If superclasses
is plural it must be a tuple of classes.r)   rÏ   z"Error while trying to load module z:  N)Ú
rpartitionÚ
__import__ÚglobalsÚlocalsÚImportErrorÚprintÚ	__class__Ú__name__ÚinspectÚ
getmembersÚisclassÚ
__module__Ú
issubclass)	Úmodule_fqnameÚsuperclassesÚmodule_nameÚmoduler   ÚcnameÚclass_ÚmodulesÚms	            r<   r   r   ’  sê   € ð
  ×*Ñ*¨3Ó/°Ñ3€KðÜ˜M¬7«9´f³hÀÀÓNˆô ×!Ò! &¬'¯/©/Ô:ô6Ú:ñ (˜%à×#Ñ# }Ñ4÷ Ù:ð ñ 6ö Ù%ÓEšg˜¬°A×)D—1™gˆÐEà€Nøô ó ÜÐ2°=°/ð BØ—+‘+×&Ñ&Ð'ð)ô 	*àˆûðüó6ùò Fs/   –B- ÁC&Á7C&ÂC,Â#C,Â-
C#Â7'CÃC#c                 ó   • [        XX#S9S   $ )z]Shell out to an external command and return the output or the empty
string in case of error.
)rÉ   r­   r´   rØ   )r#   )ÚcmdrÉ   r­   Úrunats       r<   r"   r"   §  s    € ô " #Ø)/ñ>Ø>FñHð HrB   c                 óp   • / SQnSnU S:”  a  US:  a  US-  nU S-  n U S:”  a  US:  a  M  U SU S3 X#    3$ )	N)ÚBÚKiBÚMiBÚGiBÚTiBr   r\   é   r'   g      �@r)   rN   © )rf   Ú	precisionÚsuffixesÚsuffixindexs       r<   r   r   ¯  s[   € â0€HØ€KØ
�‹+˜+¨›/Ø�qÑˆØ�F‰{ˆð �‹+˜+¨�/ð �1�Y�K˜q�.Ð! (Ñ"7Ð!8Ð9Ð9rB   c                 óæ   • U(       aX  U[         R                  :w  aD  U R                  U5      (       d.  [         R                  R	                  XR                  S5      5      n [        X25      nU" U 5      $ r¬   )rG   r€   rm   r}   r„   r£   Úgetattr)r}   r¥   Úmethodr%  Ú_meths        r<   Ú_os_wrapperr<  ¹  sN   € Þ�7œbŸf™fÓ$Ø�‰˜w×'Ñ'Ü—7‘7—<‘< ¯©°SÓ)9Ó:ˆDÜ�FÓ#€EÙ�‹;ÐrB   c                 óD   • SU ;   a  [        XS[        S9$ [        XS5      $ )NrË   rá   )r%  Úexists)r<  rá   ©r}   r¥   s     r<   r   r   Á  s%   € Ø
ˆdƒ{Ü˜4¨&¼Ñ>Ð>Ü�t hÓ/Ð/rB   c                 ó   • [        XS5      $ )NÚisdir©r<  r?  s     r<   r   r   Ç  s   € Ü�t gÓ.Ð.rB   c                 ó   • [        XS5      $ )NÚisfilerB  r?  s     r<   r   r   Ë  ó   € Ü�t hÓ/Ð/rB   c                 ó   • [        XS5      $ )NÚislinkrB  r?  s     r<   r   r   Ï  rE  rB   c                 ó$   • [        XS[        5      $ )Nr   )r<  rG   r?  s     r<   r   r   Ó  s   € Ü�t i´Ó4Ð4rB   )r¥   c                óö   • U(       aR  U R                  U5      (       d<  [        R                  R                  XR	                  [        R
                  5      5      n [        R                  R                  " U /UQ76 $ rk   )rm   rG   r}   r„   r£   r€   )r}   r¥   r§   s      r<   r    r    ×  sJ   € Þ�t—‘ w×/Ñ/Ü�w‰w�|‰|˜G§[¡[´·±Ó%8Ó9ˆÜ�7‰7�<Š<˜Ð!˜qÒ!Ð!rB   c                 ó   • SU -   S-   $ )a
  Helper to make text bold in console output, without pulling in
dependencies to the project unneccessarily.

:param text:    The text to make bold
:type text:     ``str``

:returns:       The text wrapped in the ASCII codes to display as bold
:rtype:         ``str``
z[1mz[0mr4  )Útexts    r<   r   r   Ý  s   € ð �tÑ˜iÑ'Ð'rB   c                 ó<  ^• / n/ nUR                  U5        [        U [        5      (       a²  U R                  5        H�  u  nmUR	                  U5        U(       a  XA;   a  UR                  [        T5      5        M?  [        T[        5      (       d  MV   UR                  [        U4S jU 5       5      S   5        UR                  TR                  5       5        MŸ     OUR                  U 5        U Vs/ s H  oUU;  d  M
  UPM     sn$ ! [         a     N[f = fs  snf )aÅ  Recursively compile all elements of a potentially nested dict by a set
of keys. If a given key is a dict within ``dobj``, then _all_ elements
within that dict, regardless of child keys, will be returned.

For example, if a Plugin searches the devices dict for the 'storage' key,
then all storage devices under the that dict (e.g. block, fibre, etc...)
will be returned. However, if the Plugin specifies 'block' via ``keys``,
then only the block devices within the devices['storage'] dict will be
returned.

Any elements passed here that are _not_ keys within the dict or any nested
dicts will also be returned.

:param dobj:    The 'top-level' dict to intially search by
:type dobj:     ``dict``

:param keys:    Which keys to compile elements from within ``dobj``. If no
                keys are given, all nested elements are returned
:param keys:    ``list`` of ``str``

:returns:       All elements within the dict and any nested dicts
:rtype:         ``list``
c              3   ó<   >#   • U  H  oT;   d  M
  TU   v •  M     g 7frk   r4  )rn   r÷   Úvs     €r<   rq   Ú/recursive_dict_values_by_key.<locals>.<genexpr>  s   øé € ð 5Ú.2 s¸Q±h›F˜A˜cžFªdùs   ƒ	�r   )r“   rS   Údictra   râ   r!   Ú
IndexErrorÚkeys)ÚdobjrR  Ú_itemsÚ_filtÚkÚdrN  s         @r<   r!   r!   ê  sð   ø€ ð0 €FØ€EØ
‡M�M�$ÔÜ�$œ×ÑØ—J‘J–L‰DˆAˆqØ�L‰L˜ŒOæ˜1›9Ø—‘Ô:¸1Ó=Ö>ô ˜Aœt×$Ó$ð	à—M‘MÜ4ô 5Ù.2ó5ó àñôð —‘˜QŸV™V›XÖ&ò% !ð* 	�‰�dÔáÓ0’v�!¨%¡�A‘vÑ0Ð0øô "ó áðüò 1s   Â'D	Ã3	DÄ DÄ	
DÄDc                   óD   • \ rS rSrSrS r\S 5       rS r\S 5       r	Sr
g)	ræ   i   z¥Used when we are writing directly to disk without sizelimits,
this allows us to keep more simplified flows for executing,
monitoring, and collecting command output.
c                 ó   • Xl         X l        g rk   )Úprocessri   )ÚselfrZ  ri   s      r<   Ú__init__ÚFakeReader.__init__&  s   € ØŒØ�rB   c                 ó   • g)NFr4  ©r[  s    r<   rë   ÚFakeReader.is_full*  s   € àrB   c                 ó,   • U R                   (       d  S$ S$ ©Nrš   rB   ©ri   r_  s    r<   rê   ÚFakeReader.get_contents.  ó   € ØŸŸˆrÐ-¨#Ð-rB   c                 ó:   • U R                   R                  5       S L $ rk   )rZ  r¼   r_  s    r<   rè   ÚFakeReader.running1  s   € à�|‰|× Ñ Ó" dÐ*Ð*rB   )ri   rZ  N)r  r   Ú__qualname__Ú__firstlineno__Ú__doc__r\  Úpropertyrë   rê   rè   Ú__static_attributes__r4  rB   r<   ræ   ræ      s9   † ñò
ð ñó ðò.ð ñ+ó ó+rB   ræ   c                   óL   ^ • \ rS rSrSrSrU 4S jrS rS r\	S 5       r
SrU =r$ )	rå   i6  zrUsed to 'head' the command output (f_src) to a given size
without deadlocking sos. Takes a sizelimit value in MB.
r[   c                 óˆ   >• [         TU ]  5         Xl        X l        US-  U l        X@l        SU l        U R                  5         g )Nr[   T)Úsuperr\  r  rÿ   Ú	remainingri   rè   Ústart)r[  r  rÿ   rò   ri   r  s        €r<   r\  ÚHeadReader.__init__=  s9   ø€ Ü‰ÑÔØŒ
ØŒ
Ø" WÑ,ˆŒØŒØˆŒØ�
‰
�rB   c                 ó~  • U R                   S:”  aŒ  U R                  R                  [        U R                   U R                  5      5      nU(       d  OKU R
                  R                  U5        U =R                   [        U5      -  sl         U R                   S:”  a  MŒ  U R                  R                  5         SU l	        g)z‚Reads from the f_src (Popen stdout pipe) until we reach sizelimit.
once done, close f_src to signal the program that we are done.
r   FN)
rp  r  rK   ÚminÚCOPY_BUFSIZErÿ   r  ÚlenrÚ   rè   )r[  Úbufs     r<   ÚrunÚHeadReader.runF  s„   € ð �n‰n˜qÓ Ø—*‘*—/‘/¤# d§n¡n°d×6GÑ6GÓ"HÓIˆCÞØØ�J‰J×Ñ˜SÔ!Ø�NŠNœc #›hÑ&�Nð �n‰n˜qÕ ð 	�
‰
×ÑÔØˆ�rB   c                 ó,   • U R                   (       d  S$ S$ rb  rc  r_  s    r<   rê   ÚHeadReader.get_contentsS  re  rB   c                 ó    • U R                   S:*  $ )Nr   )rp  r_  s    r<   rë   ÚHeadReader.is_fullV  s   € à�~‰~ Ñ"Ð"rB   )ri   rÿ   r  rp  rè   )r  r   rh  ri  rj  ru  r\  rx  rê   rk  rë   rl  Ú__classcell__©r  s   @r<   rå   rå   6  s2   ø† ñð €Lõòò.ð ñ#ó ö#rB   rå   c                   óH   ^ • \ rS rSrSrU 4S jrS rS r\S 5       r	Sr
U =r$ )rç   i[  zÂUsed to tail the command output to a given size without deadlocking
sos.

Takes a sizelimit value in MB, and will compile stdout from Popen into a
string that is limited to the given sizelimit.
c                 ó  >• [         TU ]  5         Xl        X0l        SU l        S U l        U(       a!  US-  n[        X R                  -  5      U l        [        U R
                  S9U l        SU l        U R                  5         g )Ni   r[   )ÚmaxlenT)
ro  r\  Úchanri   Ú	chunksizeÚslotsÚintr   rè   rq  )r[  Úchannelrò   ri   r  s       €r<   r\  ÚTailReader.__init__c  sf   ø€ Ü‰ÑÔØŒ	ØŒØˆŒØˆŒ
ÞØ! GÑ+ˆIÜ˜Y¯©Ñ7Ó8ˆDŒJÜ $§*¡*Ñ-ˆŒ
ØˆŒØ�
‰
�rB   c                 óÖ   •   U R                   R                  U R                  5      nU(       d  OU R                  R	                  U5        MJ  SU l        g! [
        [        4 a     Nf = f)a<  Reads from the channel (pipe) that is the output pipe for a
called Popen. As we are reading from the pipe, the output is added
to a deque. After the size of the deque exceeds the sizelimit
earlier (older) entries are removed.

This means the returned output is chunksize-sensitive, but is not
really byte-sensitive.
FN)rƒ  rK   r„  r   râ   Ú
ValueErrorrU   rè   )r[  r�   s     r<   rx  ÚTailReader.runp  s_   € ð		ØØ—y‘y—~‘~ d§n¡nÓ5�ÞàØ—
‘
×!Ñ! $Ô'ñ ð ˆ�øô œGÐ$ó 	áð	ús   ‚-A °A ÁA(Á'A(c                 ó   • U R                   (       a)  [        R                  " S5        U R                   (       a  M)  U R                  (       d"  SR	                  S U R
                   5       5      $ SR	                  S U R
                   5       5      $ )z-Returns the contents of the deque as a stringr»   rš   c              3   óD   #   • U  H  oR                  S S5      v •  M     g7f)rP   ÚignoreN)Údecode©rn   Úlns     r<   rq   Ú*TailReader.get_contents.<locals>.<genexpr>Œ  s   é € ÐMÂ*¸BŸ9™9 W¨h×7Ð7Â*ùs   ‚ rB   c              3   ó$   #   • U  H  ov •  M     g 7frk   r4  r�  s     r<   rq   r’  �  s   é € Ð0¢Z˜rœ¢Zùs   ‚)rè   r¾   r¿   ri   r„   r   r_  s    r<   rê   ÚTailReader.get_contents…  s[   € ð �l�lÜ�JŠJ�tÔð �l�l‰là�{�{Ø—7‘7ÑMÀ$Ç*Â*ÓMÓMÐMØ�x‰xÑ0 T§Z¢ZÓ0Ó0Ð0rB   c                 ój   • U R                   (       d  g[        U R                  5      U R                   :H  $ )z?Checks if the deque is full, implying that output was truncatedF)r…  rv  r   r_  s    r<   rë   ÚTailReader.is_full�  s%   € ð �z�zØÜ�4—:‘:‹ $§*¡*Ñ,Ð,rB   )ri   rƒ  r„  r   rè   r…  )r  r   rh  ri  rj  r\  rx  rê   rk  rë   rl  r~  r  s   @r<   rç   rç   [  s+   ø† ñõòò*1ð ñ-ó ö-rB   rç   c                   ó6   • \ rS rSrSrS rS rS rS rS r	Sr
g	)
r   i—  z£Provides a list of modules that can be imported in a package.
Importable modules are located along the module __path__ list and modules
are files that end in .py.
c                 ó   • Xl         g)z_package is a package module
import my.package.module
helper = ImporterHelper(my.package.module)N©Úpackage)r[  rš  s     r<   r\  ÚImporterHelper.__init__�  s	   € ð �rB   c                 ó†   • [         R                  R                  U5      n[         R                  R                  U5      u  p4U$ )z-Returns the plugin module name given the path)rG   r}   ÚbasenameÚsplitext)r[  r}   ÚbaserŒ   r6   s        r<   Ú_plugin_nameÚImporterHelper._plugin_name£  s1   € ä�w‰w×Ñ Ó%ˆÜ—'‘'×"Ñ" 4Ó(‰ˆØˆrB   c                 ó²   • U Vs/ s H4  nSU;  d  M  UR                  S5      (       d  M#  U R                  U5      PM6     nnUR                  5         U$ s  snf )Nr\  z.py)Úendswithr   Úsort)r[  Úlist_ÚpluginÚpluginss       r<   Ú_get_plugins_from_listÚ%ImporterHelper._get_plugins_from_list©  s`   € á!&óKÚ!&�vØ ¨Ñ.ó -à39·?±?À5×3Ió -�4×$Ñ$ VÖ,Ù!&ð 	ð Kð 	�‰ŒØˆùò	Ks   …
A“A«Ac                 ó¬   • [         R                  R                  U5      (       a/  [        [	        SU5      5      nU R                  U5      nU(       a  U$ / $ )Nz*.py)rG   r}   r>  Úlistr   r¨  )r[  r}   Úpy_filesÚpnamess       r<   Ú_find_plugins_in_dirÚ#ImporterHelper._find_plugins_in_dir°  sC   € Ü�7‰7�>‰>˜$×ÑÜœD ¨Ó.Ó/ˆHØ×0Ñ0°Ó:ˆFÞØ�Øˆ	rB   c                 óÐ   • / nU R                   R                   HI  n[        R                  R	                  U5      (       d  M)  UR                  U R                  U5      5        MK     U$ )zIReturns the list of importable modules in the configured python
package. )rš  Ú__path__rG   r}   rA  r“   r®  )r[  r§  r}   s      r<   Úget_modulesÚImporterHelper.get_modules¸  sN   € ð ˆØ—L‘L×)Ô)ˆDÜ�w‰w�}‰}˜T×"Ó"Ø—‘˜t×8Ñ8¸Ó>Ö?ñ *ð ˆrB   r™  N)r  r   rh  ri  rj  r\  r   r¨  r®  r²  rl  r4  rB   r<   r   r   —  s    † ñò
òòòõrB   r   c                   ó&   • \ rS rSrS rS rS rSrg)r   iÃ  c                 ó   • Xl         / U l        g rk   )Útmp_dirÚfiles)r[  r¶  s     r<   r\  ÚTempFileUtil.__init__Å  s   € ØŒØˆ�
rB   c                 ó¬   • [         R                  " U R                  S9u  p[        R                  " US5      nU R
                  R                  X#45        U$ )NrÌ   zw+)rã   Úmkstempr¶  rG   Úfdopenr·  râ   )r[  Úfdry   Úfobjs       r<   ÚnewÚTempFileUtil.newÉ  sA   € Ü×$Ò$¨¯©Ñ6‰	ˆä�yŠy˜˜TÓ"ˆØ�
‰
×Ñ˜5˜-Ô(ØˆrB   c                 óî   • U R                    H=  u  p UR                  5         UR                  5          [        R
                  " U5        M?     / U l         g ! [         a     N/f = f! [         a     Mf  f = frk   )r·  r  rÚ   r1   rG   Úunlink)r[  ry   rN   s      r<   ÚcleanÚTempFileUtil.cleanÐ  sj   € ØŸ
œ
‰HˆEðØ—‘”	Ø—‘”	ðÜ—	’	˜%Ö ñ #ð ˆ�
øô ó áðûô
 ó âðús"   “ A´A&Á
A#Á"A#Á&
A4Á3A4)r·  r¶  N)r  r   rh  ri  r\  r¾  rÂ  rl  r4  rB   r<   r   r   Ã  s   † òòõrB   r   c                   ó   • \ rS rSrSrg)r   ià  r4  N)r  r   rh  ri  rl  r4  rB   r<   r   r   à  s   † ÚrB   r   )T)Úr)NNrk   )F)é   NN)rE   )IrG   r¯   r,   r  Ú
subprocessr   r   r   Úloggingr‚   rï   rà   rá   rã   Ú	threadingr¾   rV   r  Ú
contextlibr   Úcollectionsr   Úpackaging.versionr   r	   r  Úpkg_resourcesÚ	getLoggerr2   rt   ru   rv   Ú__file__ÚAttributeErrorÚtextwrapr   ÚmsgÚwarningr   Ú__all__r=   rA   r%   r   rg   r   r   r   r   r#   r$   r   r"   r   r}   r<  r   r   r   r   r   r€   r    r   r!   ræ   ÚThreadrå   rç   r   r   rî   r   r4  rB   r<   Ú<module>rÖ     sâ  ðó 
Û 
Û 	Û ß *Ñ *Û Û Û Û Û Û Û Û Û 	Û Ý Ý ð,Ý8ð ×Ò˜Ó€ð €	ðBÛØ	×Ò˜xÔ(Ø€Ið €ò€ò8ô"òô	%òòôD+ò,	ô	@ð -<ÀEØ"&¨d¸ÈØ"'°4ÀØ#(¨e¸4ôNôb'ôTô*Hô:ð /1¯g©gô ò0ò/ò0ò0ò5ð !#§¡õ "ò
(ð -/ô 31÷l+ñ +ô,"#�×!Ñ!ô "#ôJ9-�×!Ñ!ô 9-÷x)ñ )÷Xñ ô:	�gõ 	øðG ó ,ß+Ð+ð,ûð 	�^Ð$ó BÝð€Cð
 ‡K�K�"‘T˜#˜r°eÑ<Ð=¸RÐ@×AðBús$   ÁE Á+E1 ÅE.Å-E.Å1+F ÆF 