xTc@ sVddlmZddlmZmZddlmZyddlZWnek r_dZnXyddl Z Wnek rdZ nXyddl Z e j Z Wn&ek rddl Z e jZ nXddlmZddlZddlZddlZddlZddlZddlZddlZddlZddlZejZdjZddddZdddZddd d Z ddd d Z!d Z"d Z#dZ$e%dZ&dZ'dZ(dZ)gddZ*dZ+e,dZ-dZ.ddZ/dde%dZ0de%dZ1dde,dZ2dZ3ddZ4dZ5d Z6dd!Z7d"e8fd#YZ9e9Z:d$e;fd%YZ<d&ej=kZ>ej?Z@d'ZAeAe_?d(e<fd)YZBd*e<fd+YZCd,e<fd-YZDd.ZEd/ZFd0ZGd1d2ZHdd3ZIdd4d5d6ZJd7ZKd8e8fd9YZLd:eLfd;YZMd<eLfd=YZNd>e8fd?YZOd@ZPdAZQe,dBdCZRe,dBdDZSeRZTe%dEZUde%dFZVddGZWdHd|dIYZXdddJZYdKd}dLYZZdMZ[dNZ\dOe8fdPYZ]dQe]fdRYZ^dSe8fdTYZ_dUe8fdVYZ`dWe8fdXYZadYZbdZd~d[YZcd\e8fd]YZdd^Zed_e8fd`YZfdadddbZgdce8fddYZhdeehfdfYZidgZjdhZkddiZlddjZmdkZnddlZoddmZpdne8fdoYZqejrdpZsdddqZtdrZudsZvdawdtddduZxdvZydwe8fdxYZzdye8fdzYZ{d{Z|dS(i(tdivision(t sge_utilst pbs_utils(t show_stringN(tmathsiCON PRN AUX NUL COM1 COM2 COM3 COM4 COM5 COM6 COM7 COM8 COM9 LPT1 LPT2 LPT3 LPT4 LPT5 LPT6 LPT7 LPT8 LPT9cc s|dkr|d}d}n |d7}|dkr>d}n|dksPtttj|||}|dk rt||||t||kr|d7}nx!t|D]}|||VqWdS(s A float range generator. Parameters ---------- start : float stop : float, optional If empty, start at 0 and stop at the start parameter. step : float, optional tolerance : float, optional Returns ------- generator of float gg?iN(tNonetAssertionErrortintRtceiltabstxrange(tstarttstoptstept tolerancetcountti((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytxfranges       ( cC stt|d|d|S(s Non-generator version of xfrange. Parameters ---------- start : float stop : float, optional If empty, start at 0 and stop at the start parameter. step : float, optional Returns ------- list of float See Also -------- libtbx.utils.xfrange R R (tlistR(R R R ((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytfrange>sgư>cC st||||S(s5 Wraps xfrange, acts identically. Parameters ---------- start : float stop : float, optional If empty, start at 0 and stop at the start parameter. step : float, optional tolerance : float, optional Returns ------- generator of float See Also -------- libtbx.utils.xfrange (R(R R R R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytxsamplesSscC stt||||S(sI Non-generator version of xsamples. Parameters ---------- start : float stop : float, optional If empty, start at 0 and stop at the start parameter. step : float, optional tolerance : float, optional Returns ------- list of float See Also -------- libtbx.utils.xfrange, libtbx.utils.xsamples (RR(R R R R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytsamplesiscC s,|dkrdS|jddjddS(sC The result is supposed to be double-quoted when passed to sh. s\s\\t"s\"N(Rtreplace(ts((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytescape_sh_double_quoteds cC s|dkr|St|S(s Returns the length of a sequence or None. Parameters ---------- seq : iterable or None Returns ------- int or None N(Rtlen(tseq((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytxlens cC s:d}x-|D]%}|dkr(|}q ||9}q W|S(s{ Calculates the result of multiplying all elements of a sequence together. Parameters ---------- seq : iterable N(R(Rtresulttval((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytproducts    cC sLi}x?t|D]1\}}|r:||ks:tn|||>> libtbx.utils.sequence_index_dict(['a', 'b']) {'a': 0, 'b': 1} (t enumerateR(Rtmust_be_uniqueRRtelem((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytsequence_index_dicts cC s|jdkr%td|nyt|SWntk rFnXyt|tjiSWn=tk rtn*tk rtd|tfnXdS(s Tries to covert a string into an integer, using builtin int() as well as eval(). Parameters ---------- string : str Returns ------- int Raises ------ ValueError If string cannot be converted into an integer. ttruetfalses0Error interpreting "%s" as a numeric expression.s3Error interpreting "%s" as a numeric expression: %sN(R$R%( tlowert ValueErrorRtevalRt__dict__tKeyboardInterruptt Exceptiontformat_exception(tstring((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytnumber_from_strings   cC sl|d ksttd kr\d}|ddkr=d }ntd |t|fntj||S( s Wraps gzip.open to open a .gz file. Parameters ---------- file_name : str mode : str Returns ------- file Raises ------ RuntimeError If gzip is not available. trtrbtwtwbtatabtituns4gzip module not available: cannot %scompress file %s(R/srbR1swbR3R4N(RtgzipRt RuntimeErrorRtopen(t file_nametmodeR6((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt gzip_opens  cC sY|dksttdkrItdidd6dd6||fntj||S(s Wraps bz2.open to open a .bz2 file. Parameters ---------- file_name : str mode : str Returns ------- file Raises ------ RuntimeError If bz2 is not available. R/R1s2bz2 module not available: cannot %compress file %sR6R5(R/R1N(Rtbz2RR8tBZ2File(R:R;((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytbz2_opens  %c C st}|jdjt|jj|j}|j|krStSd}dt|}d|j}t g|||gD]} t | ^q} |dkrt j }n|d| IJ||IJ||IJ||IJx|D]} || IJqW|d| IJtS(s: Checks the md5 hash of a file to see if it matches the expected hash. Parameters ---------- path : str expected_md5_hexdigests : list of str hints : list of str, optional out : file, optional Returns ------- bool False if md5 hash of file does not appear in expected_md5_hexdigests. s s"Warning: unexpected md5 hexdigest:s File: %ss New md5 hexdigest: %st*N(t hashlib_md5tupdatetjoinR9treadt splitlinest hexdigesttFalseRtmaxRRtsyststdouttTrue( tpathtexpected_md5_hexdigeststhintstouttmtcurrent_md5_hexdigesttwarningR:t new_hexdigestRtwidththint((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt warn_if_unexpected_md5_hexdigests& ( .     cC sut|tdtdgkr(|S|jddjj}|dkrVdSd}xtddd d d d d gD]\}}d}|d|kr|d }n|jd|t|dkr|d }n|dk r#yt|}Wn#t k r}t d|nXPn|d9}q~Wyt |}Wn#t k rf}t d|nXd}||S(s\ Converts a string of a memory or file size (i.e. "10G") into a number. Parameters ---------- mem_str : int or float Returns ------- int or float Examples -------- >>> libtbx.utils.get_memory_from_string("10G") 10737418240.0 >>> libtbx.utils.get_memory_from_string("10M") 10485760.0 Raises ------ RuntimeError ig?t R5iitKtMtGtTtEtZtYis%sBiis5 The numerical portion of %s is not a valid float s1 There is no memory unit or valid float in %s N( ttypeRtstriptupperR RtfindRtfloatR'R8R(tmem_strtfactorRtgreektnum_strtnumte((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytget_memory_from_string6s6$ . #  cC s`tjj|d}|dkr%|S|j}|dkrVtd||fn|dkS( s Checks the environment variables for variable, returning it as a boolean. Parameters ---------- variable_name : str default : bool, optional Returned if variable_name is not found. Returns ------- bool R%R$t0t1sSEnvironment variable %s must be "True", "False", "0", or "1" (current value: "%s").N(sfalsestrueRkRl(strueRl(tostenvirontgetRR&tSorry(t variable_nametdefaulttvaluet value_lower((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt getenv_booljs   cC stj|jS(s Wraps os.stat to calculate a file's size. Parameters ---------- file_name : str Returns ------- int : size of file, in bytes (Rmtstattst_size(R:((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt file_sizes cC stj|sttj|rBtj|tj|}n|dkr`t|d}n+|dksrttd||dd}|j t|dj ~dS(s, Copies a file from source to target, optionally compressing it before writing it out. Parameters ---------- source : str target : str compress : str, optional The compression algorithm to use. Currently only ".gz" is supported. If set, target becomes target + compress. R2s.gzR:R;R0N( toptisfileRtisdirRCtbasenameRR9R<twriteRD(tsourcettargettcompresstt((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt copy_files  cC s||gjddks!t|dkr?tj|}nx}|D]u}|rtj|rtj|tj|rtdt |qqqFtj |rFtj|qFqFWdS(s Removes a file from disk. Parameters ---------- pattern : str, optional paths : iterable of str, optional ensure_success : bool, optional isCannot remove file: %sN( RRRtglobRytexistsRmtremoveR8RRz(tpatterntpathstensure_successRL((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt remove_filess !   R@cC stjj|r|dk s$ttj|}tj|}g}xg|D]_}tjj||}|rtjj | rqOn|j |dk rO|j |qOqOW|S(s Find files matching a pattern in a directory. Parameters ---------- dir_name : str pattern: str, optional files_only : bool, optional Returns ------- list of str N( RmRLR{RRtretcompiletlistdirRCRztsearchtappend(tdir_nameRt files_onlytregextfilestmatching_filesR:t full_path((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt find_filess$ cC s||gjddks!t|dk rytjj|sEtgtj|D]}tjj||^qU}ng}x-|D]%}|j|tjj |fqW|j dd|r|j ng|D]\}}|^qS(s Sorts a list of file names by when they were last modified, ascending. Parameters ---------- file_names : iterable of str, optional dir_name : str, optional reverse : bool, optional Returns ------- list of str itkeycS s|dS(Ni((tx((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytsN( RRRRmRLR{RRCRtgetmtimetsorttreverse(t file_namesRRtfntfiles_and_mtimesR:tmtime((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytsort_files_by_mtimes! 4 # cC s*yt|SWntk r%|fSXdS(s Coverts x into a tuple, either as a direct cast or by making it the sole element of a tuple. Parameters ---------- x : object Returns ------- tuple N(ttuplet TypeError(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyttupleizes  RcC s |dkr|dfS||fS(s Returns a suffix if n != 1. Parameters ---------- n : int suffix : str, optional Returns ------- int str iR5((tntsuffix((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytplural_ss cC spt|dkstg}xAt|D]3}|dksCt|j||||}q+W|j|S(Ni(RRtreversedRR(ti1dtsizesRtsz((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytn_dim_index_from_one_dims cC sMg}t|dr<x1|D]}|jt|qWn |j||S(Nt__len__(thasattrtextendt flat_listR(t nested_listRtsub_list((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs   cC s=x6|D].\}}tj||}|dk r|SqW|S(s Selects a value from choices where its key pattern matches key. Parameters ---------- key : str choices : iterable of str, object default : object, optional Returned if no pattern matches key. Returns ------- object N(RRR(RtchoicesRrt key_patternRsRP((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytselect_matching(s  tKeepTypecB s#eZdZdZdZRS(cC sdS(NtKeep((tself((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt__str__=scC sdS(NR((R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt__repr__?scC st||jkS(N(R_t __class__(Rtother((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt__eq__As(t__name__t __module__RRR(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR<s  RpcB s&eZdZeZejZdZRS(sM Basic exception type for user errors; the traceback will be suppressed. cC s|jj|j_dS(s@ Reset the class module on an instance to libtbx.utils. N(Rt__orig_module__R(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt reset_moduleNs(RRt__doc__RR+R(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRpFs tLIBTBX_DISABLE_TRACEBACKLIMITcC st ot|t}|rPdtfdY}ttd|}dt_nt|||}|r||kr}t`q|t_n|S(s Intercepts exception tracebacks, removing tracebacks for Sorry exceptions. Parameters ---------- type : type value : Exception traceback : traceback Returns ------- str t __not_setcB seZRS((RR(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRhsttracebacklimiti(tdisable_tracebacklimitt isinstanceRptobjecttgetattrRIRt__prev_excepthook(R_Rst tracebackttb_offRtprev_tracebacklimitR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytsorry_excepthookXs    tUsagecB seZdZejZRS(s{ Subclass of Sorry, for printing out usage instructions upon program invocation without arguments (or --help, etc.). (RRRR+(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRustAbortcB seZdZejZRS(sV Subclass of Sorry, primarily used in the Phenix GUI in response to user input. (RRRR+(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR|stFailurecB seZdZejZRS(s Subclass of Sorry. (RRRR+(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRscC stjd }|dkr!d|Sddl}|jjdraddl}|jdk radSnd}d}z~yDddl}|j d d}|j d t d t dd d Wn3t k r}t|j|snd|SXWd|dk r|j|jnXdS(s Checks python and library versions and availability to diagnose why multiprocessing fails to work. Returns ------- str or None String indicating why multiprocessing is not working. iishmultiprocessing module not available: Python 2.6 or higher is required (version currently in use: %d.%d)iNtomptbxs-multiprocessing is not compatible with OpenMPs9This platform lacks a functioning sem_open implementationt processestfunctiterablet chunksizeismultiprocessing import error: (ii(RIt version_infotlibtbx.load_envtenvt has_moduleRt omp_versionRtmultiprocessingtPooltmapR tranget ImportErrortstrt startswithtcloseRC(t vers_infotlibtbxRt sem_open_msgtpoolRRi((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytdetect_multiprocessing_problems0     &   cC s|dkr|S|S(s0 Returns value or default if value is None. N(R(RsRr((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytif_nones cC stj}|dj}t|d}|dkrJ|jdd}n`tjtjdddd \}}|d k r|d}n|d k r|d|7}nd ||fjS( s$ Formats an Exception object... iiR5s (, line s (line iRWsline %ds%s: %sN( RItexc_infoRRRRt extract_tbRtrstrip(teittype_RsR:tline((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR,s   *   sEXCEPTION_INFO: c  s<ddl}|jj r$t r$dSddlm}ddlm}|}|jd|t j d|dj g|j j D]}||^qd}~gxtjtjtjtjgD]ifd}|rqnj|td d}|dk r'|njqW|S( s Shows information about an exception. Parameters ---------- prefix : str, optional Returns ------- str or None iN(t introspection(tStringIOROtfiles c s%xD]}|krtSqWtS(N(RKRG(to(tdoneRO(s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytis_dones  tflush(RRt full_testingRRRt cStringIORt show_stackRt print_excRCtgetvalueRERIRJtstderrt __stdout__t __stderr__R}RRR( tprefixRRRtsioRtmsgRR((RROs:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt#show_exception_info_if_full_testings,   6%   cC sd}g}x6|dkrDt|d\}}|j||qW|dk rzx&t||krv|jdqTWn|jdj|S(s Encodes integer as a string in base 36, prepending 0's until string is of length equal to width. Parameters ---------- integer : int width : int, optional Returns ------- str t$0123456789abcdefghijklmnopqrstuvwxyzii$RkR5N(tdivmodRRRRRC(tintegerRTt digit_settdigitsR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt base36_encodes  ii cC sB|}|dkr!tj}ntdt||dd|S(s Encodes the number of seconds since the epoch in base 36. Parameters ---------- seconds_since_epoch : time, optional multiplier : int, optional width : int, optional Rg?RTN(RttimeRR(tseconds_since_epocht multiplierRTR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytbase36_timestamps  cC stj}tj|}tjrN|ddkrNtjd}tj }ntjd}tj }tjd|d||d|dd|fS(sI Converts the current time into a string. Returns ------- str iiisDate %Y-%m-%d Time %H:%M:%Ss %s %+03d%02d (%.2f s)ii<(Rt localtimetdaylightttznametaltzonettimezonetstrftime(R R Rtoffs((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt date_and_times     t timer_basecB sGeZdZdZdZdZdddZdddZRS(sP Base timer class used to calculate the time elapsed by various operations. cC s|j|_dS(N(RoR(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt__init__+scC s|j}||j}|S(sb Returns the time elapsed since object was initialized. Returns ------- time (RoR(RRtd((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytelapsed.s  cC s&|j}||j}||_|S(sT Returns time since last call of delta(). Returns ------- time (RoR(RRR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytdelta:s   R5cC s4|dkrtj}n||d|jIJdS(s Prints the time since object was initialized. Parameters ---------- prefix : str, optional out : file, optional s%.2f sN(RRIRJR(RRRO((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt show_elapsedGs cC s4|dkrtj}n||d|jIJdS(s Prints the time since last call of delta() or show_delta(). Parameters ---------- prefix : str, optional out : file, optional s%.2f sN(RRIRJR(RRRO((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt show_deltaSs N( RRRRRRRRR(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR&s    tuser_plus_sys_timecB seZdZdZRS(sg Timer class using os.times() to calculate time. Subclasses timer_base. Methods ------- get cC stj}|d|dS(s0 Uses os.times() to calculate the time. ii(Rmttimes(RR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRois (RRRRo(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR`stwall_clock_timecB seZdZdZRS(s{ Timer class using time.time() to calculate time. Subclasses timer_base. Methods ------- get Notes ----- When running multithreaded code, user_plus_sys_time would report the cumulated times for all threads: not very useful to analyse the scaling with the number of threads! Wall clock time, although it is less reliable is the only solution in that case. cC s tjS(s1 Uses time.time() to calculate the time. (R(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRos(RRRRo(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRpsttime_logcB sVeZdZedZdZdZdZdZdZ dZ dZ RS( s1 Class used to log the time that tasks take. cC s:||_||_d|_d|_d|_d|_dS(Ni(tlabeltuse_wall_clockt accumulationRRRttimer(RRR ((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs      cC s(|jrt|_n t|_|S(s Starts the timer. (R RR"R(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR s  cC s@|jj|_d|_|j|j7_|jd7_dS(s Stops the timer. iN(R"RRR!R(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR s cC s|jtd|jS(sa Calculates the average length for runs of the timer. Returns ------- float i(R!RHR(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytaveragescC s|j|jS(s5 Stops the timer and runs its report method. (R treport(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytlogs cC sd|j|jj|fS(s Returns a string displaying the time elapsed since the timer was started. Parameters ---------- local_label : str String appended to the end of the output Returns ------- str stime_log: %s: %.2f elapsed %s(RR"R(Rt local_label((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt log_elapseds s-time_log: label: n accumulation delta averagecC s>|jdkstd|j|j|j|j|jfS(s Returns a string including the label, number of stops, accumulated time, delta time, and average time for runs of timer. Returns ------- str stime_log: %s: %d %.2f %.3g %.3gN(R"RRRRR!RR#(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR$s ( RRRRGRR R R#R%R'tlegendR$(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs   cC ss|}d}|dkri|d}d}|dkri|d}d}|dkrf|d}d}qfqin||fS( s" Rounds a time in seconds to the nearest days / hours / minutes, depending on what unit is appropriate. Parameters ---------- time_in_seconds : int Time, in seconds. Returns ------- int : The rounded time in some unit. str : The accompanying units for the time. tsecondsixi<tminutesthoursi0itdays((ttime_in_secondst time_unitst time_unit((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pythuman_readable_times      cC st|trt|}n|dkr.|S|dkrB|dS|dkrZ|ddS|dkrv|dddStd|dS( s Converts time_units and time_unit back into a time with units of seconds. Parameters ---------- time_units : int time_unit : str Returns ------- int R)R*i<R+R,isUnknown time_unit: %sN(RRRcR8(R.R/((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pythuman_readable_time_as_secondss     tunknowncC sX|dkr|S|r5tjdtjt|Stjdtjt|SdS(s Formats a unix_time in a 12-hour format. Parameters ---------- unix_time : time short : bool, optional replace_with : str, optional Returned when unix_time is None. Returns ------- str s%d-%m-%y %I:%M %ps%b %d %Y %I:%M %pN(RRRR Rc(t unix_timetshortt replace_with((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytformat_timestamp_12_hours  cC sX|dkrdS|r5tjdtjt|Stjdtjt|SdS(s Formats a unix_time in a 24-hour format. Parameters ---------- unix_time : time short : bool, optional replace_with : str, optional Returned when unix_time is None. Returns ------- str R2s%d-%m-%y %H:%Ms%b %d %Y %H:%MN(RRRR Rc(R3R4R5((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytformat_timestamp_24_hours  cC stj}d|d|d|d|df}|rytj}Wntk r\qX|d|d|d|d7}n|S(Nsu+s,u,s: %.2f %.2f %.2fiis micro-seconds/tick: %.3fg.A(RmRRItgettickeraccumulationtAttributeError(tshow_micro_seconds_per_tickRRt python_ticker((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytformat_cpu_times5s ' %cC s|dkrtj}ntj}ytj}Wntk rJn!X|dI|d||dIJ|dt|IJdS(s Prints the total CPU time and average time for each Python bytecode instruction since the process was started. Parameters ---------- out : file, optional show_micro_seconds_per_bytecode_instruction : bool, optional s1Time per interpreted Python bytecode instruction:s%.3f micro secondsg.AsTotal CPU time: %.2f %sN(RRIRJRRoR8R9R0(ROt+show_micro_seconds_per_bytecode_instructiont total_timeR;((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytshow_total_time?s   cC s|dkrtj}n|dI|dkr?|d|IJn9t|dd}||d}|d|||fIJt|dd}|dk r|ndS( s. Prints seconds in a human-readable format. Parameters ---------- seconds : float out : file, optional Examples -------- >>> show_wall_clock_time(750) wall clock time: 12 minutes 30.00 seconds (750.00 seconds total) >>> show_wall_clock_time(20) wall clock time: 20.00 seconds swall clock time:ixs %.2f secondsi<gư>s,%d minutes %.2f seconds (%.2f seconds total)RN(RRIRJRR(R)RORPRt out_flush((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytshow_wall_clock_timeTs    t show_timescB s&eZdZdddZdZRS(s@ Class to track the time past an instance's initialization. cC ss|dkr:tj}tj|d|d|_n,|dkrXtj|_nd| |_||_dS(sc Parameters ---------- time_start : time or str, optional out : file, optional iitnowN(RRmRRt time_startRO(RRDROR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRvs  " cC s|j}|dkr!tj}ntj}|d|d}ytj}Wntk rhd}nXd|}|dk r|d|7}|dkr|d|d|7}qn||IJtdt j |j d|dS( Niisusr+sys time: %.2f secondss , ticks: %ds, micro-seconds/tick: %.3fg.AR)RO( RORRIRJRmRR8R9RARRD(RRORt usr_plus_systticksR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt__call__s         N(RRRRRRG(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRBqscC s tjtd|d|dS(s Shows the time since time_start at exit. Parameters ---------- time_start : time, optional out : file, optional See Also -------- libtbx.utils.show_times RDRON(tatexittregisterRB(RDRO((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytshow_times_at_exits t host_and_usercB s2eZdZdZdZdddZRS(cC stjjd|_tjjd|_tjjd|_tjjd|_tjjd|_tjjd|_tjjd|_ tjjd|_ tjjd |_ tjjd |_ d|_tjd kr>tjjd }tjjd }d||gkrStjj|||_qSntjjd|_ttdd}|dkr}d|_n ||_tj|_tj|_dS(NtHOSTtHOSTNAMEt COMPUTERNAMEtHOSTTYPEtPROCESSOR_ARCHITECTUREtMACHTYPEtOSTYPEtVENDORtUSERtUSERNAMEtntt HOMEDRIVEtHOMEPATHtHOMEtgetpid(RmRnRothostthostnamet computernamethosttypetprocessor_architecturetmachtypetostypetvendortusertusernameRthomedirtnameRLRCRtpidRtinfotsge_infoRt chunk_infotpbs_info(Rt homedrivethomepathRZ((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs.    cC s!|jdk r|jS|jSdS(N(RcRRd(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt get_user_namescC sF|jdk r|jS|jdk r,|jS|jdk rB|jSdS(N(R[RR\R](R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt get_host_namesR5cC s|dkrtj}n|jdk rA||dI|jIJn|jdk r||j|jkr|||dI|jIJn|jdk r|j|jkr||dI|jIJn|jdk r||dI|jIJn|jdk r ||dI|jIJn|jdksZ|jdksZ|j dksZdj |j|j g|jkr|jdk r||dI|jIJn|j dk r||dI|j IJqn|j dk r|j d kr||d I|j IJn|j dk r||d I|j IJn|j dk rK|j |j krK||d I|j IJn|jdk rt||d I|jIJn|jjd|d||jjd|d|dS(NsHOST =s HOSTNAME =sCOMPUTERNAME =s HOSTTYPE =sPROCESSOR_ARCHITECTURE =t-s MACHTYPE =sOSTYPE =R2sVENDOR =sUSER =s USERNAME =sPID =ROR(RRIRJR[R\R]R^R_R`RaRCRbRcRdRgRitshowRk(RROR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRqsJ  $  N(RRRRnRoRRq(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRKs   c C stj}|tjj|dtjj|dtjj|dtjj|dtjj|dtjj|dddd g }tjj|}x|D]}||krtSqWtS( s Check for specified reserved directories which are standard on many systems; these should never be deleted as part of any program. Parameters ---------- target_dir : str Returns ------- bool t DocumentstDesktopt DownloadstLibrarytMoviestdatat/s/homes/Users(RKReRmRLRCtabspathRGRK(t target_dirRet safe_dirstsafe_dir((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytallow_delete_directorys    cC sgx`|D]X}t|dkr(t}n-|rA||t}n|||||dqWdS(Nis (RRG(t write_methodtindenttincomplete_linetlinesR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt_indentor_write_loops      tindentorcB s8eZddddZdZdZddZRS(R5cC sy|dkr0|dkr$tj}q0|j}n||_t|jdrZ|j|_n||_||_t |_ dS(NR( RRIRJt file_objectRt_flushRRtparentRGR(RRRR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR$s       c C st|dkrdS|jdrbtd|jjd|jd|jd|jt|_n|j}t|dkr|jr|jj|dq|jj|j|dnJtd|jjd|jd|jd|d |jj|j|dt |_dS( Nis R~RRRii( RtendswithRRR}RRRERGRK(RtblockR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR}1s*           cC s|jjdS(N(RR(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRJss cC s|jd|j|d|S(NRR(RR(RR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt shift_rightMsN(RRRRR}RR(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR"s  tbuffered_indentorcB s,eZddddZdZdZRS(R5cC s#tj||||g|_dS(N(RRtbuffer(RRRR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRRscC s|jj|dS(N(RR(RR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR}VscC sP|jdk r|jjnx!|jD]}tj||q)Wg|_dS(N(RRt write_bufferRRR}(RR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRYs N(RRRRR}R(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRPs tnull_outcB s;eZdZdZdZdZdZdZRS(s7 Pseudo-filehandle for suppressing printed output. cC stS(N(RG(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytisattyescC sdS(N((R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRfscC sdS(N((R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRgscC sdS(N((RR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR}hscC sdS(N((Rtsequence((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt writelinesis(RRRRRRR}R(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR`s     traise_if_outputcB s;eZdZdZdZdZdZdZRS(s Raises an exception when written to. Examples -------- >>> import sys >>> sys.stdout = libtbx.utils.raise_if_output() >>> print RuntimeError cC stS(N(RG(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRwscC sdS(N((R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRzscC sdS(N((R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR}scC s tdS(s, Raises ------ RuntimeError N(R8(RR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR}scC s tdS(s, Raises ------ RuntimeError N(R8(RR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs(RRRRRRR}R(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRks      t multi_outcB seeZdZdZdZd dZd dZdZdZ dZ dZ d Z RS( s] Multiplexing output stream, e.g. for simultaneously printing to stdout and a logfile. cC sAg|_g|_g|_t|_d|_tj|jdS(Ni( tlabelst file_objectstatexit_send_toRGtclosedt softspaceRHRIt_atexit(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs      cC sX|jsTxHt|j|jD].\}}|dk r|j|jqqWndS(N(RtzipRRRR}R(RtfR3((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs " cC sD|j st|jj||jj||jj||S(s Adds an output stream to the list. Parameters ---------- label : str Label for replacing the stream later file_object : file atexit_send_to : file, optional (RRRRRR(RRRR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRIs cC sg|jj|}|j|}|j|j|j||j|<||j|<||j|||_d|_|jdkr0d|_n|jdS(NiicS sdS(N(R(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs(RRtadvance(RR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs   cC sb|jdkr"tjjdntjjd|j|jftjj|jd7_dS(Nis s%i / %ii(RRIRJR}RR(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs   cC s4|jdkrdStjjdtjjdS(Nis (RRIRJR}R(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs(RRRRR(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs  t progress_barcB seZdZRS(cC sdg}|jdkrC|jdg|jd|jdn|jd|j|j|jdtjjdj|tjj|jd7_dS( Nt|it=it>RWs| R5( RRRRRIRJR}RCR(Rt characters((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs   (RRR(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRscC s|dkrt|Stttj| }|dkr|tjd|}t|ddkr|d9}|d7}nd|}||t|fS|d7}tt||}d}|t|||fSdS( sg Formats a float, including the uncertainty in its value. Parameters ---------- value : float standard_uncertainty : float Returns ------- str Examples -------- >>> libtbx.utils.format_float_with_standard_uncertainty(5e-3, 1e-3) '0.0050(10)' >>> libtbx.utils.format_float_with_standard_uncertainty(5e-3, 1e-6) '0.0050000(10)' gؗҜPlease note that this is not guaranteed to work in all cases; suse at your own risk.( RRRmRLRRpRyR{Rtwarningstwarnt UserWarning(R:Rtheadttail((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt check_if_output_directory_existss"    cC st|dj}|dIJ|dtjj|IJx3|jD]%}|jdraqFqF||IJqFW|dIJ|dIJdS(s Insert a Python script into an existing file, removing any __future__ import to prevent syntax errors. (This could be dangerous in most contexts but is required for some of our Coot-related scripts to work.) R/R5s#--- script copied from %ssfrom __future__s#--- endN(R9RDRmRLR|RER(ROR:RwR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytconcatenate_python_scripts  cC sAx4ddddgD] }|dkr)Pn|d9}qW||fS(s Converts seconds into its closest form in greek units. Parameters ---------- secs : float Returns ------- float str Examples -------- >>> libtbx.utils.greek_time(1e-3) (1, "milli") >>> libtbx.utils.greek_time(1e-6) (1, "micro") R5tmillitmicrotnanoii((tsecsRf((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt greek_times  iPcC sddl}|dkrJ|jid||fd6}|j|}nJ|jid||||fd6}|j}|j|||j}|a|j|d||fGH|S(Nis%s:%dthttpshttp://%s:%s@%s:%ss Installed urllib2 proxy at %s:%d(turllib2Rt ProxyHandlert build_openertHTTPBasicAuthHandlert HTTPHandlertlibtbx_urllib_proxytinstall_opener(tservertportRctpasswordRtproxytopenertauth((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytinstall_urllib_http_proxys      c O sdtjkrtdkrtjd}tjjdd}tjjdd}tjjdd}|dk rtdkrtddd ntd |d |d |d tnddl}|j ||S(s~ Substitute for urllib2.urlopen, with automatic HTTP proxy configuration if specific environment variables are defined. tCCTBX_HTTP_PROXYtCCTBX_HTTP_PROXY_SERVERtCCTBX_HTTP_PROXY_PORTiPtCCTBX_HTTP_PROXY_USERtCCTBX_HTTP_PROXY_PASSWORDs5You have defined a user name for the HTTP proxy, but s@no password was specified. Please set the environment variable sCCTBX_HTTP_PROXY_PASSWORD.RRRcRiN( RmRnRRRoRRpR Rturlopen(targstkwdsRRRctpasswdR((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR&s     tdownload_progresscB sSeZdZdddZdZdZdZdZdZ dZ RS( s Simple proxy for displaying download status - here with methods for writing to the console, but can be subclassed and used for graphical display. cC s7|dkrt}n||_||_d|_dS(Ni(RRR%t n_kb_totalt n_kb_elapsed(RR%R+((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRs     cC s||_d|_dS(s Updates the total number of bytes to download and resets the number of bytes downloaded. Parameters ---------- n_kb_total : int Total size of download, in kilobytes. iN(R+R,(RR+((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytset_total_sizes cC s.|jdk st|j|7_|jS(s Increments the number of bytes downloaded. Parameters ---------- n_kb : int Returns ------- bool N(R+RRR,t show_progress(Rtn_kb((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt increments cC s1|jjd|j|jf|jjtS(sc Prints the number of bytes downloaded out of the total. Returns ------- bool s %d/%d KB downloaded(R%R}R,R+RRK(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR.,s cC s0|jdk stdtd|j|jS(s[ Calculates the percent completion of download. Returns ------- float idg?N(R+RRRR,(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytpercent_finished9scC s|jjddS(s@ Prints a final message indicating download completion. s Download completeN(R%R}(R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytcompleteDscC sdS(sS Placeholder for cases where the download is not being run asynchronously. N((R((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pytrun_continuouslyJsN( RRRRRR-R0R.R1R2R3(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR*s  tdownload_targetcB s2eZdZdddddZdddZRS(so Flexible callable object for retrieving a file from a URL, with optional HTTPS authentication. Designed to be runnable in a separate thread with graphical progress update. Note that in some circumstances SSL support may be missing from the socket module, in which case we use 'curl' to download securely. (This will not work on Windows, obviously.) cC s||_||_||_||_||_||_d|j|jgkr|jdk sctddl}|j rt |drt |j drt |_qt |_ndS(NitsslRG( turlR:tuse_curlRcRtbase_urlRRtsocketRR5RGRK(RR6R:R7RcRR8R9((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRZs        cC sK|dkrt}n|dkr6td|}nddlm}ddl}|j}|jsd|j|j gkr|j }|j d|j |j|j |j |}|j|}|j|n|j|j} | j} t| dd} |j| t|dd} | d} t|jd}xItr| j| }|sdPn|j| s}d}Pn|j|qEW|j|jn|jd|j|j gkrd |j|j f}n|jd ||j|jf}|j|d kr+td |n|dkr;dSt j!|jS( NR%i(teasy_runsContent-lengthit n_kb_chunkiR2s --user %s:%sscurl %s "%s" -o %siscurl exited with code %d("RRR*RR:RR:R7RcRtHTTPPasswordMgrWithDefaultRealmt add_passwordR8RRRR&R6RhRR-RR9RKRDR0R}RR2R3tcallR8RyRy(RR%tprogress_meterR:RR:tpassmant authhandlerRtreqRhR+R;Rtfptchunkt curl_argstrc((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyRGpsT                 N(RRRRRRG(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyR4Ps   cC s;ddl}|jd|dtd|jd|jdkS(Nistype tshellRJRi(t subprocessR>RKtPIPE(tcmdRH((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyt cmd_existss   ((((}t __future__Rtlibtbx.queuing_system_utilsRRtlibtbx.str_utilsRR7RRR=thashlibtmd5RAtnewtstdlibRRRRRRHRRRIRmRLRyRtwindows_device_namesRRRRRRRRKR#R.R<R?RVRjRGRuRxRRRRRRRRRRRRR+RpRnRt excepthookRRRRRRRR,RRR RRRRRR0R1R6R7tformat_timestampR<R?RARBRJRKR}RRRRRRRRRRRRRRRRRRRRRRRJRR R RRR R&R*R4RK(((s:/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/utils.pyts                !        " 4           %   $  :Q     $R . $R  0 + #      #   MM