/usr/lib/python3/dist-packages/sos/__pycache__
Edit: /usr/lib/python3/dist-packages/sos/__pycache__/utilities.cpython-310.pyc (23292B)
o
G%@id @ s d dl Z d dlZd dlZd dlZd dlmZmZmZ d dlZd dl Z d dl
Z
d dl Z d dl Z d dl
Z
d dlZd dlZd dlZd dlZd dlmZ d dlmZ zd dlmZ W n eye d dlmZ Y nw edZ dZ z
d dl Z e e d Z W n! ee!fy d d
l"m#Z# d Z$e %d e#e$d
dd d Y nw dZ&g dZ'dd Z(dTddZ)dd Z*dUddZ+dd Z,d d Z-d d Z.dVd d!Z/d"d# Z0dWd$d%Z1d&e2fd'd(Z3e&dddddddddddf d)d*Z4dXd+d,Z5dWd-d.Z6dYd0d1Z7dZd3d4Z8e j9fd5d6Z:d7d8 Z;d9d: Z
Z>d?d@ Z?e j@dAdBdCZAdDdE ZBg fdFdGZCG dHdI dIZDG dJdK dKejEZFG dLdM dMejEZGG dNdO dOZHG dPdQ dQZIG dRdS dSeJZKdS )[ N)PopenPIPESTDOUT)closing)deque)parse)
parse_versionsosFT)fillzWARNING: 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_DEFAULTImporterHelperSoSTimeoutError TempFileUtilboldfile_is_binaryfileobjfindget_human_readablegrep
import_module
is_executablelistdirr path_exists
path_isdir path_isfile path_islink path_join recursive_dict_values_by_key shell_outsos_get_command_outputtac_logstailc
C s t d}z#|j| dd\}}}|s| W S t dd|d}| d| }|W S tyG } ztd| d | | W Y d
}~S d
}~ww ) z< Convert the version into a PEP440 compliant version scheme.z2^([0-9][0-9.]*(?:(?:a|b|rc|.post|.dev)[0-9]+)*)\+? )maxsplitz[+~]+.-+zUnable to format z to pep440 format: N)recompilesplitsubstrip Exceptionlogdebug)verpublic_version_re_publiclocalsanitized_localpep440_versionerr r: //usr/lib/python3/dist-packages/sos/utilities.pyformat_version_to_pep440P s r< c C s |r
t | }t|S t| S )z6 Converts the version to PEP440 format before parsing )r< r )r2 pep440
ver_pep440r: r: r; sos_parse_versiona s r? c C sT t | d}t| j|kr|| d | W d S 1 s#w Y dS )z,Returns the last number_of_bytes of filenamerb N)openosstatst_sizeseekread)filenamenumber_of_bytesfr: r: r; r$ j s
$r$ rc C sT t | tr&zt| |ddW S ty% td| d tt Y S w t| S )z@Returns a file-like object that can be used as a context managerutf-8encodingz fileobj: z could not be opened)
isinstancestrrB IOErrorr0 r1 r ioStringIO) path_or_filemoder: r: r; r r s
r c C sH ddddd}| D ]\}}| |kr t| | d| S q | S )zCConverts a number of bytes to a shorter, more human friendly formatl i @ )TGMKz.1f)itemsfloat) num_bytessizessymbolsizer: r: r;
convert_bytes~ s rb c C s | dd dv rDt | ddd+}| }td|r# W d dS td |r2 W d d
S W d dS 1 s=w Y dS dS ) a Helper to determine if a given file is a certificate or not.
This is especially helpful for `sos clean`, which cannot obfuscate
certificate files content and instead, by default, will keep them as is.
:param fname: The full path of the file to check
:type fname: ``str``
:returns: The type of the certificate or ``None``
:rtype: ``string`` or ``None``
N)z.csrz.crtz.pemrK rL rM z-----BEGIN CERTIFICATE----- certificatez"-----BEGIN [A-Z]+ PRIVATE KEY-----certificatekey)rB rG r* search)fnamerJ contentr: r: r; file_is_certificate s
ri c s t r'zt| ddg} jdko t fdd|D W S ty& Y nw t| ddd }z|d W W d
d S tyM Y W d
d S w 1 sQw Y d
S )
az 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``
ztext/zinode/binaryc 3 s | ] } j |V qd S N) mime_type
startswith).0_mt_ftupr: r; z!file_is_binary..trrL rM r% NFT) magic_modmagicdetect_from_filenamerN anyr/ rB rG UnicodeDecodeError)rg _mimestfiler: rp r; r s*
r c c s |rt j|t jj}||7 }t |D ]/\}}}|r,|t jj|kr,|dd= |r5t||s5qt|| D ]
}t j||V q;qdS )zGenerator function to find files recursively.
Usage::
for filename in find("*.properties", "/var/log/foobar"):
print filename
N) rC pathdirnamecountsepwalkfnmatchfilterjoin) file_patterntop_dir max_depth path_pattern
base_depthr| dirlistfilelistnamer: r: r; r s
r c sR g }|D ]"}t |}| fdd|D W d n1 s!w Y q|S )zReturns 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 s | ] }t |r|V qd S rk )r* match)rn linepatternr: r; rr s zgrep..N)r extend)r files_or_pathsmatchesfopfor: r r; r s
r c s\ t jddt jj} g fdd|D }r%|fdd|D 7 }tdd |D S )z6Returns if a command matches an executable on the PATHPATH c s g | ] }t j| qS r: )rC r| r )rn p)commandr: r;
z!is_executable..c s g | ] }t j |d qS )/)rC r| r lstrip)rn csysrootr: r; r s c s s | ]
}t |t jV qd S rk )rC accessX_OK)rn r| r: r: r; rr s z is_executable..)rC environgetr, r| pathseprx )r r paths
candidatesr: )r r r; r s r urlc C s ddl m}m} z2|| }|js|jr8d}|jr ||j7 }|jr(|d|j 7 }||j||j|j |j
|j fW S | W S t yE | Y S w )zK
Replace username:password@ with ********@ in proxy URL if present
r )urlparse
urlunparsez ********@:)
urllib.parser r usernamepasswordhostnameportschemer| paramsqueryfragmentr/ )r r r
parsed_urlnetlocr: r: r; scrub_url_credential s"
r c
s( fdd}
fdd}r3zt }W n ty& dddd Y S w ||j|jd tj }d |d
< |rT| D ]\}}|rM|||< qB| |d qB|rit
d rid
|r_dnd d| d| } t | }g }|D ]#}|
drd|v rt|}|r|| qr|| qr|| qr|
r|rt}n| rtjtj|
d}nt|
d}nt}zTzt|d||rtntd|d|
d}|
r|r| rtjtj|
d}nt|
d}t|j|||}n
t||}nt |j||}r|j r|| |j sn]z | |r
|nd W nP t y^ | |
r<| r._child_prep_fnc s, s | dkr| ttd d S )N| {Gz?)poll terminater timesleep)proc)pollerr: r;
_check_poller s z-sos_get_command_output.._check_poller r )statusoutput truncated)HOMELOGNAMEPWDUSERzC.UTF-8LC_ALLNtimeoutztimeout z --foreground zs r *dirwbFT)shellstdoutstderrbufsizeenv close_fds
preexec_fnr closer )~ r )+r r KeyErrorupdater rC r copyr\ popr shlexr, rm globr appendr tempfile
TemporaryFiler| r} rB r r
HeadReaderr
FakeReader
TailReaderrunningwaitr/ r r# get_contentsis_fullhasattrr r
returncodeOSErrorerrnoENOENT) r r r r r r
foregroundrj sizelimitr to_filetacr r r pwd_usercmd_envkeyvalueargs
expanded_argsarg expanded_arg_outputr readerf_dstr er: )r r r r r; r" s
@
@
;
@
r" c C s
d}d}d}| t| jdkrdS tj| dtjdZ}| d }}|| |kr2d}|dkrk||d|}||d |krK|d krJn)q2|rPd
}n
| ||d |d |}|dks6W d dS W d dS W d dS 1 s~w Y dS ) zPython 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)
flushrC fstatfilenorE mmap ACCESS_READra rfindwrite) f_srcr
drop_last_log NEWLINE_B NEWLINE_ISPACE_Immsep1sep2r: r: r; r# s4
"r# c
s dd }z t t t |g}W n ty- } ztd d|jj |d}~ww fddt |tj
D }rGfdd|D }|S ) 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: Nc s g | ] \}}|j kr|qS r: )
__module__)rn cnameclass_)
module_fqnamer: r; r s
z!import_module..c s g | ] }t | r|qS r: )
issubclass)rn m) superclassesr: r; r r )
rpartition
__import__globalslocals ImportErrorprint __class____name__inspect
getmembersisclass)r r# module_namemoduler
modulesr: )r r# r; r s
r c C s t | |||dd S )zeShell out to an external command and return the output or the empty
string in case of error.
)r r r r )r" )cmdr r runatr: r: r; r! s
r! rA c C sV g d}d}| dkr |dk r |d7 }| d } | dkr |dk s| d| d|| S ) N)BKiBMiBGiBTiBr rW r% g @r' rJ r: )ra precisionsuffixes suffixindexr: r: r; r s r c C s> |r|t jkr| |st j|| d} t||}|| S r )rC r rm r| r r getattr)r| r methodr0 _methr: r: r; _os_wrapper s
rA c C s$ d| v r t | |dtdS t | |dS )Nr r )r0 exists)rA r r| r r: r: r; r s r c C t | |dS )NisdirrA rC r: r: r; r r c C rD )NisfilerF rC r: r: r; r rG r c C rD )NislinkrF rC r: r: r; r rG r c C s t | |dtS )Nr )rA rC rC r: r: r; r r r c G s8 |r| |stj|| tj} tjj| g|R S rk )rm rC r| r r r )r| r r r: r: r; r s r c C s d| d 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[0mr: )textr: r: r; r
s
r c s g }g | | t| trS| D ]?\} | |r!||v r)| t qttrQz| tfdd|D d W n tyI Y nw qn| | fdd|D S )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 s | ] }| v r | V qd S rk r: )rn r )vr: r; rr A s z/recursive_dict_values_by_key..r c s g | ]}| vr|qS r: r: )rn d)_filtr: r; r M s z0recursive_dict_values_by_key..)r rO dictr\ r r
IndexErrorkeys)dobjrQ _itemskr: )rN rL r; r s2
r c @ s8 e Zd ZdZdd Zedd Zdd Zedd Zd
S ) r zUsed 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 C s || _ || _d S rk )processrj )selfrU rj r: r: r; __init__V
zFakeReader.__init__c C s dS )NFr: rV r: r: r; r Z s zFakeReader.is_fullc C | j sdS dS Nr r rj rY r: r: r; r ^ rJ zFakeReader.get_contentsc C s | j d u S rk )rU r rY r: r: r; r a s zFakeReader.runningN) r+ r __qualname____doc__rW propertyr r r r: r: r: r; r P s
r c s@ e Zd ZdZdZ fddZdd Zdd Zed d
Z Z
S ) r zzUsed to 'head' the command output (f_src) to a given size
without deadlocking sos. Takes a sizelimit value in MB.
rV c s8 t || _|| _|d | _|| _d| _| d S )NrV T)superrW r r remainingrj r start)rV r r r rj r* r: r; rW m s
zHeadReader.__init__c C sb | j dkr'| jt| j | j}|sn| j| | j t|8 _ | j dks| j d| _ dS )zReads 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)
ra r rG min COPY_BUFSIZEr r lenr r )rV bufr: r: r; runv s
zHeadReader.runc C rZ r[ r\ rY r: r: r; r rJ zHeadReader.get_contentsc C s
| j dkS )Nr )ra rY r: r: r; r s
zHeadReader.is_full) r+ r r] r^ re rW rh r r_ r
__classcell__r: r: rc r; r f s
r c s< e Zd ZdZ fddZdd Zdd Zedd Z Z S )
r zUsed 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 s^ t || _|| _d| _d | _|r |d }t|| j | _t| jd| _d| _| d S )Ni rV )maxlenT)
r` rW chanrj chunksizeslotsintr r rb )rV channelr rj rc r: r; rW s
zTailReader.__init__c C sJ z | j | j}|s n| j| qW n ttfy Y nw d| _dS )al 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.
TFN)rk rG rl r r
ValueErrorrQ r )rV r r: r: r; rh s
zTailReader.runc C sH | j r td | j s| jsddd | jD S ddd | jD S )z-Returns the contents of the deque as a stringr r c s s | ] }| d dV qdS )rL ignoreN)decodern lnr: r: r; rr rs z*TailReader.get_contents..r c s s | ]}|V qd S rk r: rs r: r: r; rr s )r r r rj r r rY r: r: r; r s
zTailReader.get_contentsc C s | j sdS t| j| j kS )z?Checks if the deque is full, implying that output was truncatedF)rm rf r rY r: r: r; r s zTailReader.is_full)
r+ r r] r^ rW rh r r_ r ri r: r: rc r; r s
r c @ s8 e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd S )
r zProvides 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 C s
|| _ dS )zopackage is a package module
import my.package.module
helper = ImporterHelper(my.package.module)N)package)rV ru r: r: r; rW s
zImporterHelper.__init__c C s t j|}t j|\}}|S )z-Returns the plugin module name given the path)rC r| basenamesplitext)rV r| baser r4 r: r: r; _plugin_name s zImporterHelper._plugin_namec s fdd|D }| |S )Nc s( g | ]}d |vr| dr |qS )rW z.py)endswithry )rn pluginrY r: r; r s
z9ImporterHelper._get_plugins_from_list..)sort)rV list_pluginsr: rY r; _get_plugins_from_list s
z%ImporterHelper._get_plugins_from_listc C s0 t j|rttd|}| |}|r|S g S )Nz*.py)rC r| rB listr r )rV r| py_filespnamesr: r: r; _find_plugins_in_dir s
z#ImporterHelper._find_plugins_in_dirc C s2 g }| j jD ]}tj|r|| | q|S )zQReturns the list of importable modules in the configured python
package. )ru __path__rC r| rE r r )rV r~ r| r: r: r; get_modules s zImporterHelper.get_modulesN) r+ r r] r^ rW ry r r r r: r: r: r; r s r c @ s$ e Zd Zdd Zdd Zdd ZdS )r c C s || _ g | _d S rk )tmp_dirfiles)rV r r: r: r; rW rX zTempFileUtil.__init__c C s2 t j| jd\}}t|d}| j||f |S )Nr zw+)r mkstempr rC fdopenr r )rV fdrg fobjr: r: r; new s zTempFileUtil.newc C sb | j D ](\}}z
| | W n ty Y nw zt| W q ty+ Y qw g | _ d S rk )r r r r/ rC unlink)rV rg rJ r: r: r; clean s
zTempFileUtil.cleanN)r+ r r] rW r r r: r: r: r; r s r c @ s e Zd ZdS )r N)r+ r r] r: r: r: r; r s r )T)rK )NNrk )F)r2 NN)rA )LrC r r* r,
subprocessr r r loggingr r r r r threadingr rR r
contextlibr collectionsr packaging.versionr r r(
pkg_resources getLoggerr0 ru rv rw __file__AttributeErrortextwrapr
msgwarningr __all__r< r? r$ r rb ri r r r r rP r r" r# r r! r r| rA r r r r r r r r r r Threadr r r r r r r: r: r: r; s
"
*
6%<,