id*ddlZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z mZddlmZ eej$j&dZGd d eZGd d Zy#e$rdZYwxYw) N) OrderedDict) SoSComponent) import_policy)Plugin)boldImporterHelper)fillxczeZdZdZdZdZdZdZddiZfdZ e dZ dZ d Z d Zd Zd Zd ZdZdZxZS) SoSHelperzProvide better, more in-depth help for specific parts of sos than is provided in either standard --help output or in manpages. zDetailed help infomationFtopiccftt| ||||jj|_y)N)superr __init__optsr )selfparserargscmdline __class__s 3/usr/lib/python3/dist-packages/sos/help/__init__.pyrzSoSHelper.__init__+s% i'g>YY__ cbd|_|jdd}|jddddd y) Nzsos help TOPIC [options]zHelp Information Optionsz?  !!#w7!%BAAaD&)A1Q4BB F$$&kk..v/D/D/FG  Cs %C >C cN|jjjdd}ddl}t |j j }|jD]G}t|D]7}|jjjdd}||k(s3|ccSIy)Nr(r[rrlr) rr r.sos.policies.distrosrrKdistros get_modulesr__name__lowerr/)r_topicrc_helperrVrl_ps rrQzSoSHelper._get_policy_by_names&&s+B/ $ !5!56&&( "C', "__**,44XrB<!M " "rctdd}|jdtdz|jd}td}|jd|ztd}|jd |z|jd }|jd d d ddddd}|D]1}|jdj t|||d3|j y)zhDisplays the help information for this component directly, that is help for `sos help`. zDetailed help for sos helpzThe 'help' sub-command is used to provide more detailed information on different sub-commands available to sos as well as different components at play within those sub-commands.ahSoS - officially pronounced "ess-oh-ess" - is a diagnostic and supportability utility used by several Linux distributions as an easy-to-use tool for standardized data collection. The most known component of which is %s (formerly sosreport) which is used to collect troubleshooting information into an archive for review by sysadmins or technical support teams.z sos reportzHow to search using sos helpz$component.$topic.$subtopiczG&I<>E   D   ##DJ?    r)rv __module__ __qualname____doc__descconfigure_logging load_policy load_probe arg_defaultsr classmethodr&r2rAr8rRrSrPrQr5 __classcell__)rs@rr r sq &DKJ L%11LF0@* " "5rr c<eZdZdZd dZdZd dZd dZd dZdZ y) r;zThis class is used to build the output displayed by `sos help` in a standard fashion that provides easy formatting controls. cL||_||_||_t|_y)a :param title: The title of the output section, will be prominently displayed :type title: ``str`` :param content: The text content to be displayed with this section :type content: ``str`` :param indent: If the section should be nested, set this to a multiple of 4. :type indent: ``int`` N)titlecontentindentrrrrrrs rrzHelpSection.__init__s"   #  rc||_y)zSet or override the title for this help section :param title: The name to set for this help section :type title: ``str`` N)r)rrs r set_titlezHelpSection.set_titles  rc\|jr |rdnd}||z}|xj|z c_y)zAdd body text to this section. If content for this section already exists, append the new ``content`` after a newline. :param content: The text to add to the section :type content: ``str`` z  N)r)rrr|lns rr}zHelpSection.add_texts+ <<"B7lG  rcF|j||||j|S)acAdd a section of text to the help section that will be displayed when the HelpSection object is printed. Sections will be printed *in the order added*. This will return a subsection object with which block(s) of text may be added to the subsection associated with ``title``. :param title: The title of the subsection being added :type title: ``str`` :param content: The text the new section should contain :type content: ``str`` :returns: The newly created subsection for ``title`` :rtype: ``HelpSection`` ) _add_sectionrrs rr~zHelpSection.add_sections%$ %&1}}U##rcj||jvr tdt||||j|<y)zInternal method used to add a new subsection to this help output :param title: The title of the subsection being added :type title: ``str` z(A section with that title already existsN)rr9r;rs rrzHelpSection._add_sections3 DMM !FG G*5'6B ercnttt|jt|j |j jD]'}tt|t|j )|jD]*}td|j|j,y)zWPrint the HelpSection contents, including any subsections, to console. )widthinitial_indentrN) r:r rrTERMSIZErr splitlinesrr=)rrsections rr=zHelpSection.display#s d  HT[[  ,,))+ HB $r$++F G H}} -G "I MM' " * * , -rN)rrr)T)rr) rvrrrrrr}r~rr=rrr;r;s&&$  $*C -rr;)rgrMr6os collectionsr sos.componentr sos.policiesrsos.report.pluginsr sos.utilitiesrrtextwrapr minget_terminal_sizecolumnsrr9r r;rrrrsz #&&%.'2'')1137H y yxU-U-AHs"A00A:9A: