gf`,dZddlmZmZmZmZddlZddlZddlZddl Z ddl Z ddl m Z ddddd d e d Z d ZeeDcic]\}}|| c}}Zed ZgZdZdZ ddlmZdZ d)dZ d*dZ d+dZdZdZ d,dZeedfdZd-dZ ddefdZ!eddddd dfd!Z"e#e d"e d#e d$fd%Z$d&Z%e$e#e d"e d#e d$Z&e!ejNjQe#dd'l)ddl)Z*e+d(k(r e%eyycc}}w#e$rdZeZYwxYw).zA FlyingCircus - Everything you always wanted to have in Python.* )divisionabsolute_importprint_functionunicode_literalsN) __version__ FlyingCircuszFlyingCircus developers)z Riccardo Metere zCopyright (C) 2014-2018z6GNU General Public License version 3 or later (GPLv3+)z This program is free software and it comes with ABSOLUTELY NO WARRANTY. It is covered by the GNU General Public License version 3 (GPLv3+). You are welcome to redistribute it under its terms and conditions. )nameauthorcontrib copyrightlicensenoticeversion) nonelowestlowerlowmediumhighhigherhighestwarningdebugraW _____ _ _ ____ _ | ___| |_ _(_)_ __ __ _ / ___(_)_ __ ___ _ _ ___ | |_ | | | | | | '_ \ / _` | | | | '__/ __| | | / __| | _| | | |_| | | | | | (_| | |___| | | | (__| |_| \__ \ |_| |_|\__, |_|_| |_|\__, |\____|_|_| \___|\__,_|___/ |___/ |___/ cd}t|dkDrt|drt|dkDr|St|dk(r|S|dS)aC Callable decorator that does nothing. Arguments are catched, but ignored. This is very useful to provide proxy for decorators that may not be defined. Args: *_args: Positional arguments. **_kws: Keyword arguments. Returns: result (callable): The unmodified callable. c|SN)fs m/var/dept/share/cheung/public_html/OutSchool/python/env/lib/python3.12/site-packages/flyingcircus/__init__.pywrapperz%do_nothing_decorator..wrapperbsr)lencallable)_args_kwsr s rdo_nothing_decoratorr&RsG  5zA~huQx0CIM UqQxr!)jitTFcT|r||zS|dkr|| kry|dkr||zS||k\r|dz S|S)a Return a valid index for an object of given size. Args: idx (int): The input index. size (int): The size of the object to index. circular (bool): Use circular normalization. If True, just use a modulo operation. Otherwise, indices beyond the edges are set to the edges. Returns: idx (int): The valid index. Examples: >>> print([(i, valid_index(i, 3)) for i in range(-4, 4)]) [(-4, 0), (-3, 0), (-2, 1), (-1, 2), (0, 0), (1, 1), (2, 2), (3, 2)] >>> print([(i, valid_index(i, 3, True)) for i in range(-4, 4)]) [(-4, 2), (-3, 0), (-2, 1), (-1, 2), (0, 0), (1, 1), (2, 2), (3, 0)] rr)idxsizecirculars r valid_indexr-ysI.Tz qSD5[ qTz ax r!c#Kt|}|dkDrZt||}t||}|rdnt|xsd}|} |j||}d|cxkr|kr nn |||z }ny,yw)aB Find all occurrences of the pattern in the text. For dense inputs (pattern is more than ~20% of the text), a looping comprehension may be faster. Args: text (str|bytes|bytearray): The input text. pattern (str|bytes|bytearray): The pattern to find. overlap (bool): Detect overlapping patterns. first (int): The first index. The index is forced within boundaries. last (int): The last index (included). The index is forced within boundaries. Yields: position (int): The position of the next finding. Examples: >>> list(find_all('0010120123012340123450123456', '0')) [0, 1, 3, 6, 10, 15, 21] >>> list(find_all(' 1 12 123 1234 12345 123456', '0')) [] >>> list(find_all(' 1 12 123 1234 12345 123456', '12')) [4, 7, 11, 16, 22] >>> list(find_all(b' 1 12 123 1234 12345 123456', b'12')) [4, 7, 11, 16, 22] >>> list(find_all(bytearray(b' 1 12 123 1234 12345 123456'), b'12')) [4, 7, 11, 16, 22] >>> list(find_all('0123456789', '')) [0, 1, 2, 3, 4, 5, 6, 7, 8, 9] >>> list(find_all('', '')) [] >>> list(find_all('', '0123456789')) [] >>> list(find_all(b'0123456789', b'')) [0, 1, 2, 3, 4, 5, 6, 7, 8, 9] >>> list(find_all(b'', b'')) [] >>> list(find_all(b'', b'0123456789')) [] >>> list(find_all('000000000', '000')) [0, 3, 6] >>> list(find_all('000000000', '000', True)) [0, 1, 2, 3, 4, 5, 6] rr)N)r"r-find)textpatternoverlapfirstlastnoffsetis rfind_allr8sh D A1uE1%4#CL$5A  '1%AA~~V   sA,A.c #K|r t|nd}|r t|nd}g}tt||}tt||}|j|} t | D]} | |vr|j | dz| |vs!t|dkDr'|j } | |z | |zt|fVtdjt|t|z || t|dkDrBtdjt|t|z ||j dz yw)a Find matching delimiters in a sequence. The delimiters are matched according to nesting level. Args: text (str|bytes|bytearray): The input text. l_delim (str|bytes|bytearray): The left delimiter. r_delim (str|bytes|bytearray): The right delimiter. including (bool): Include delimiters. yields: result (tuple[int]): The matching delimiters. Examples: >>> s = '{a} {b:{c}}' >>> list(nested_delimiters(s, '{', '}')) [(0, 3, 0), (7, 10, 1), (4, 11, 0)] >>> [s[i:j] for i, j, depth in nested_delimiters(s, '{', '}')] ['{a}', '{c}', '{b:{c}}'] >>> [s[i:j] for i, j, d in nested_delimiters(s, '{', '}') if d == 0] ['{a}', '{b:{c}}'] >>> list(nested_delimiters('{a} {b:{c}', '{', '}')) Traceback (most recent call last): ... ValueError: Found `1` unmatched left token(s) `{` (position: 4). >>> list(nested_delimiters('{a}} {b:{c}}', '{', '}')) Traceback (most recent call last): ... ValueError: Found `1` unmatched right token(s) `}` (position: 3). >>> list(nested_delimiters(s.encode(), b'{', b'}')) [(0, 3, 0), (7, 10, 1), (4, 11, 0)] >>> list(nested_delimiters(bytearray(s.encode()), b'{', b'}')) [(0, 3, 0), (7, 10, 1), (4, 11, 0)] See Also: - flyingcircus.nested_pairs() rr)z8Found `{}` unmatched right token(s) `{}` (position: {}).z7Found `{}` unmatched left token(s) `{}` (position: {}).N) r"setr8unionsortedappendpop ValueErrorformat) r0l_delimr_delim includingl_offsetr_offsetstackl_tokensr_tokens positionsposprevs rnested_delimitersrLs5V )s7|aH(s7|aH E8D'*+H8D'*+Hx(Ii N (? LLq ! H_5zA~yy{hhE CC NH H =wLNN N 5zA~ EH H -w aIJ Js BE B8Ecfg}t|ddD]5\}}}|dk(s |||j|}|j|||f7d}t |d}}t |dkDr0|}|j \}}}||||z|z}t |dkDr0|dkDr|d||z}|S#t$rYwxYw)a Perform safe string formatting from a mapping source. If a value is missing from source, this is simply ignored, and no `KeyError` is raised. Args: text (str): Text to format. source (Mapping|None): The mapping to use as source. If None, uses caller's `vars()`. Returns: result (str): The formatted text. See Also: - flyingcircus.fmt() - flyingcircus.fmtm() Examples: >>> text = '{a} {b} {c}' >>> safe_format_map(text, dict(a='-A-')) '-A- {b} {c}' >>> safe_format_map(text, dict(b='-B-')) '{a} -B- {c}' >>> safe_format_map(text, dict(c='-C-')) '{a} {b} -C-' >>> source = dict(a=4, c=101, d=dict(x='FOO'), e=[1, 2]) >>> safe_format_map('{b} {f}', source) '{b} {f}' >>> safe_format_map('{a} {b}', source) '4 {b}' >>> safe_format_map('{a} {b} {c:5d}', source) '4 {b} 101' >>> safe_format_map('{a} {b} {c!s}', source) '4 {b} 101' >>> safe_format_map('{a} {b} {c!s:>{a}s}', source) '4 {b} 101' >>> safe_format_map('{a} {b} {c:0{a}d}', source) '4 {b} 0101' >>> safe_format_map('{a} {b} {d[x]}', source) '4 {b} FOO' >>> safe_format_map('{a} {b} {e.index}', source) # doctest:+ELLIPSIS '4 {b} ' >>> safe_format_map('{a} {b} {f[g]}', source) '4 {b} {f[g]}' >>> safe_format_map('{a} {b} {f.values}', source) '4 {b} {f.values}' >>> safe_format_map('{a} {b} {e[0]}', source) '4 {b} 1' >>> safe_format_map('{{a}} {b}', source) '{a} {b}' >>> safe_format_map('{{a}} {{b}}', source) '{a} {b}' {}r)rL format_mapr=KeyErrorr"r>) r0sourcerFr7jdepth replacingresultlast_is rsafe_format_maprY(st E(sC80 1e A: 0 1I008  aI./0F t9aqA e*q.))+1iT!F^+f4 e*q. 1uaV# M  sB$$ B0/B0c&|j|i|S)a Perform string formatting using `text.format()`. Args: text (str): Text to format. *_args: Positional arguments for `str.format()`. **_kws: Keyword arguments for `str.format()`. Returns: result (str): The formatted text. Examples: >>> a, b, c = 1, 2, 3 >>> dd = dict(a=10, b=20, c=30) >>> fmt('{a} + {a} = {b}', a=a, b=b) '1 + 1 = 2' >>> fmt('{a} + {a} = {b}', **dd) '10 + 10 = 20' >>> fmt('{} + {} = {}', 2, 2, 4) '2 + 2 = 4' >>> fmt('{b} + {b} = {}', 4, b=2) '2 + 2 = 4' See Also: - flyingcircus.fmtm() - flyingcircus.partial_format() )r@)r0r$r%s rfmtr[ws> 4;; & &&r!c|*tj}|jj}|r t ||S|j |S)a Perform string formatting from a mapping source. Args: text (str): Text to format. source (Mapping|None): The mapping to use as source. If None, uses caller's `vars()`. safe (bool): Apply mapping safely. Uses `flyingcircus.partial_format()`. Returns: result (str): The formatted text. Examples: >>> a, b, c = 1, 2, 3 >>> dd = dict(a=10, b=20, c=30) >>> fmtm('{a} + {a} = {b}') '1 + 1 = 2' >>> fmtm('{a} + {a} = {b}', dd) '10 + 10 = 20' >>> fmtm('{} + {} = {}', 2, 2, 4) # doctest:+ELLIPSIS Traceback (most recent call last): ... TypeError: fmtm() takes from 1 to 3 positional arguments ... >>> fmtm('{b} + {b} = {}', 4) # doctest:+ELLIPSIS Traceback (most recent call last): ... TypeError: ... See Also: - flyingcircus.fmt() - flyingcircus.partial_format() )inspect currentframef_backf_localsrYrQ)r0rSsafeframes rfmtmrcsFJ~$$&&& tV,,v&&r!c||k\r| ddlm}t |r|nd}||rt |}|durt d|cxkr t dkrnn |j}nt d|cxkr t dkrnn |j}n|t dk\r |j}nf|jd r |j}nH|jd r |j}n*|jd r |j}n |j}t|j!dkDr|j#dd dnd } |j%| } |d| } || t| zd} t'|||jk(r |j(nd z|||jk7r |j(nd z| | | |j*} dj-| }n>d|vrdj/|}d|vr|dz }|j/|||j*z}t1|g|i|yyy#t$r ddlm}n#t$rd}YnwxYwY3wxYw)a Display a feedback message to the standard output. Args: text (str|Any): Message to display or object with `__str__`. verb_lvl (int): Current level of verbosity. verb_threshold (int): Threshold level of verbosity. fmtt (str|bool|None): Format of the message (if `blessed` supported). If True, a standard formatting is used. If False, empty string or None, no formatting is applied. If str, the specified formatting is used. This must be in the form of `{t.NAME}` where `NAME` refer to a formatting supported by `Terminal()` from `blessed`/`blessings`. *_args: Positional arguments for `print()`. **_kws: Keyword arguments for `print()`. Returns: None. Examples: >>> s = 'Hello World!' >>> msg(s) Hello World! >>> msg(s, VERB_LVL['medium'], VERB_LVL['low']) Hello World! >>> msg(s, VERB_LVL['low'], VERB_LVL['medium']) # no output >>> msg(s, fmtt='{t.green}') # if ANSI Terminal, green text Hello World! >>> msg(' : a b c', fmtt='{t.red}{}') # if ANSI Terminal, red text : a b c >>> msg(' : a b c', fmtt='cyan') # if ANSI Terminal, cyan text : a b c Nr)TerminalFTrrrzI:zW:zE:r)rP)e1e2t0t1t2r5z{t0}{e1}{t1}{n}{e2}{t2}{n}zt.z{{t.{}}}z{})t)blessedre ImportError blessingsr#strVERB_LVLcyanmagentablue startswithgreenyellowredwhiter"stripsplitr/dictboldnormalrQr@print)r0verb_lvlverb_thresholdfmttr$r%rerketxt1r5txt0txt2txt_kwss rmsgrsP>!d&6 ! (#8,HJ$ =Tt9Dt|E?^Ix7IIAh'.L8G;LL A#x'88A__T*A__T*A__T*AA14TZZ\1BQ1Ftzz$*1-BIIdOBQxAD MN+a177lAFF;a177lAFF;;4>>wGt#%,,T2Dt#DLD{{41{-8 d#U#d#]'7! ! !. !  ! !s5H I)H0/I0 H>;I=H>>IIctjtjd}|dddd}t||dt |t r"t t|j}t|}t|d y) a Print content of a variable for debug purposes. Args: obj: The name to be inspected. fmt (str): Format of the message (if `blessed` supported). If None, a standard formatting is used. Returns: None. Examples: >>> my_dict = {'a': 1, 'b': 1} >>> dbg(my_dict) dbg(my_dict): (('a', 1), ('b', 1)) >>> dbg(my_dict['a']) dbg(my_dict['a']): 1 r)rN: rendr}r) r]getouterframesr^r isinstancer{tupler<itemsrepr)objr outer_framename_strr0s rdbgr#su&(()=)=)?@CK1~a "%Ht&#tF399;'( 9D8r!c|%t}tjj|}|stjj }|j ||fy)a_ Append a named event point to the events list. Args: name (str): The name of the event point. time_point (float): The time in seconds since the epoch. events (list[(str,datetime.datetime)]): A list of named time points. Each event is a 2-tuple: (label, datetime.datetime). Returns: None. N)__file__ospathbasenamedatetimenowr=)r time_pointeventsfilenames relapsedr@sJ  |ww) &&**,  MM4$%r!zElapsed Time(s))Labelz Duration / szCum. Duration / s)$r=-c d}|rT|s t|dkDrdj|}|r|t|zdt|dznd}||t|dkDrd|zdzndzz }|r t|dkDr||j|z }|r&||j|D cgc] } || zd|  c} z }|dd} tdt|D]B} || \} } || dz d}| | z }| |z }||k(rd }||j| d|d||z }DnHt|dkDr8d j|}|d \} } |dd}||j| | |z z }nd}|s|d |jzd zz }|Scc} w)a Print quick-and-dirty elapsed times between named event points. Args: events (list[(str,datetime.datetime)]): A list of named time points. Each event is a 2-tuple: (label, time). title (str): heading of the elapsed time table. labels (Iterable[str]): Labels for the report. Three elements are expected. max_col_widths (Iterable[int]): Maximum width of columns in the report. Three elements are expected. title_sep (str): The separator used to underline the title. label_sep (str): The separator used to underline the labels. only_last (bool): print only the last event (useful inside a loop). Returns: None.  z%{{!s:{}s}} {{!s:>{}s}} {{!s:>{}s}} NrPrrr)rz{{!s:{}s}} {{!s:>{}s}}rzNo z to report!)r"r@ranger)rtitlelabelsmax_col_widths title_sep label_sep only_lastr0r max_col_width first_elapsedr7r curr_elapsed prev_elapsed diff_first diff_lasts rreportrZs4 D S[1_B;BB!D$c%j0+3u:>E"$  E+.v;?y 4'F FD#f+/f-.+9;'!=0.=A;<=#1IaLM1c&k* F%+AY"l%a!e}Q/ )M9 (<7 *!$J+.+,iEF F[1_3,33^DD!' D,!!9Qt jj||d<t jj|dd|d<|S) a Generate application directories. Args: current_filepath (str): The current filepath. name (str): Application name. author (str): Application author. version (str): Application version. Returns: dirs (dict): The package directories. - 'config': directory for configuration files. - 'cache': directory for caching files. - 'data': directory for data files. - 'log': directory for log files. - 'base': base directory of the module. - 'resources': directory for the data resources. Examples: >>> sorted(pkg_paths().keys()) ['base', 'cache', 'config', 'data', 'log', 'resources'] configcachedatalogT)exist_okbase resources) r{appdirsuser_config_diruser_cache_dir user_data_dirrrrisdirmakedirsdirnamejoin)current_filepathr r rdirpathsdirpaths r pkg_pathsrs6 7**4AB '((vw?@ &&tVW=> %%dFG<= H")0 gww}}W% KK$ /0ww'78HVGGLL&)9;GH[ Or!c~t|jtddtj}|j|j z }|j dkDrdnd}tt ddd tt d dd tt d |tty) NzRunning `doctest.testmod()`... r|rrz{t.bold}{t.red}z{t.bold}{t.green}zTests = {results.attempted}; z{t.bold}{t.cyan}rPrzOK = {results_ok}; zFail = {results.failed})rrydoctesttestmod attemptedfailedrcr)module_docstringresults results_ok results_fmts r run_doctestsrs !)7ooG""W^^3J >>A $#6 ,-4FBO "#*=2F &'k:Mr!)*__main__)F)Frr)T)NTr),__doc__ __future__rrrrrr]rrrflyingcircus._versionrINFOVERB_LVL_NAMES enumeraterp D_VERB_LVL_EVENTS MY_GREETINGSr&numbar'HAS_JITrmr-r8rLrYr[rcrrrrrrrPATHrrflyingcircus.base flyingcircus__name__)vks00rrsCC  . '+G &'~6 7TQAqD 7 h    ": G N  BT AJJK^'J +'b!  V$t<&6=#@J" &\H~Y 'V 4<hiI"#  z_ 8rG Cs DD DD