giO!UddlZddlZddlZddlmZddlmZddlmZddl m Z m Z ddl m Z ejeZee ZejdZeed<ejd Zeed <ejd Zeed <ejd Zeed<dZdZdZdZedgdZGddZdS)N) namedtuple)Pattern)Faker)AVAILABLE_LOCALESDEFAULT_LOCALE)SampleCodeValidatorz1^faker\.providers\.BaseProvider\.(?P\w+)$_base_provider_method_patternz2^faker\.providers\.\w+\.Provider\.(?P\w+)$!_standard_provider_method_patternzS^faker\.providers\.\w+\.(?P[a-z]{2,3}_[A-Z]{2})\.Provider\.(?P\w+)$_locale_provider_method_patternzZ^:sample(?: size=(?P[1-9][0-9]*))?(?: seed=(?P[0-9]+))?:(?: ?(?P.*))?$_sample_line_patternzgenerator.{method}({kwargs})zb>>> Faker.seed({seed}) >>> for _ in range({size}): ... fake.{method}({kwargs}) ... {results} Sample)sizeseedkwargsczeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z ed Zed ZdS)ProviderMethodDocstringam Class that preprocesses provider method docstrings to generate sample usage and output Notes on how samples are generated: - If the docstring belongs to a standard provider method, sample usage and output will be generated using a `Faker` object in the `DEFAULT_LOCALE`. - If the docstring belongs to a localized provider method, the correct locale will be used. - If the docstring does not belong to any provider method, docstring preprocessing will be skipped. - Docstring lines will be parsed for potential sample sections, and the generation details of each sample section will internally be represented as a ``Sample`` namedtuple. - Each ``Sample`` will have info on the keyword arguments to pass to the provider method, how many times the provider method will be called, and the initial seed value to ``Faker.seed()``. ct||_g|_g|_d|_t j|d|d|_|dkrdSt |}t |}t |} |r.| } | d|_ t|_nc| r.| } | d|_ t|_n3|r/| } | d|_ | d|_ndSd|_||dS)NTz:docstring of z : WARNING:methodlocaleF)iter _line_iter _parsed_lines_samples_skippedinspectgetfile _log_prefixr matchr r groupdict_methodr_locale_parse_generate_samples) selfappwhatnameobjoptionslinesbase_provider_method_matchlocale_provider_method_matchstandard_provider_method_matchr s n/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/faker/sphinx/docstring.py__init__z ProviderMethodDocstring.__init__3sUu++  %oc22RR$RRR 8   F%B%H%H%N%N"'F'L'LT'R'R$)J)P)PQU)V)V& % 2<<>>I$X.DL)DLL + 6@@BBI$X.DL)DLL ) 4>>@@I$X.DL$X.DLL F        cNt|jd|dS)N )loggerwarningr)r%r5s r/ _log_warningz$ProviderMethodDocstring._log_warningSs+$*66W6677777r1c~ t|j}||n#t$rYdSwxYw=N)nextr_parse_section StopIteration)r%lines r/r#zProviderMethodDocstring._parseVs] * *DO,,##D))))!     *s - ;;c|ds|j|dS t|j}n&#t $r||YdSwxYw|dr,||||dS|dkr||dS||z}||dS)Nz:sample) startswithrappendr9rr;_process_sample_sectionr:)r%section next_lines r/r:z&ProviderMethodDocstring._parse_section_s!!),,    % %g . . . F T_--II     ( ( 1 1 1 FF     * * )  ( ( 1 1 1    * * * * *"__  ( ( 1 1 1 1 1  )G    ( ( ( ( (sAA+*A+c,t|}|sd|d}||dS|}|d}|d}|d}|r"t t |tnt}|rt |nt}|r| |nd}t|||}|j |dS)Nz The section `z%` is malformed and will be discarded.rrrr>) r rr6r getmaxintDEFAULT_SAMPLE_SIZE DEFAULT_SEED_beautify_kwargsrrr@) r%rBrmsgr rrrsamples r/rAz/ProviderMethodDocstring._process_sample_section}s $**733 P'PPPC   c " " " FOO%% }}V$$}}V$$x((6:Ss3t991222@S 2s4yyyl28@&&v...bdF++ V$$$$$r1cd}d}tjd||}tjd||}|S)Ncb|dp|d}|r|ndS)Nr>grouprquoteds r/_repl_whitespacezBProviderMethodDocstring._beautify_kwargs.._repl_whitespaces/[[^^5u{{1~~F#+66 +r1cb|dp|d}|r|ndS)NrOrPz, rQrSs r/ _repl_commaz=ProviderMethodDocstring._beautify_kwargs.._repl_commas/[[^^5u{{1~~F#-66 -r1z("[^"]*")|(\'[^\']*\')|[ \t]+z("[^"]*")|(\'[^\']*\')|,)resubstrip)r%rrUrWresults r/rJz(ProviderMethodDocstring._beautify_kwargss] , , , . . . 8:JFSS3[&II||~~r1c t|Sr8)repr)r%values r/_stringify_resultz)ProviderMethodDocstring._stringify_resultsE{{r1c8ddlm}t|j|dS)Nr) OrderedDict) generatorra) collectionsra_faker")r%ras r/_generate_eval_scopez,ProviderMethodDocstring._generate_eval_scopes2++++++t|,&   r1cptttd}|j|dS)Nr>)rrHrIrr@)r%default_samples r/_inject_default_sample_sectionz6ProviderMethodDocstring._inject_default_sample_sections0 3\2FF ^,,,,,r1c 6jsd}jD]%}tj|jt}|jr)djd|jd} |h tj |j d fdt|jD}|t|j j|j|j|z }#t $r,d jd|jd} |Y#wxYw|r4d |z}j|ddSdS) Nr>)rrzNInvalid code elements detected. Sample generation will be skipped for method `z` with arguments `z`. cVg|]%}t&S)r_eval).0_command eval_scoper%s r/ z=ProviderMethodDocstring._generate_samples..s2$s$s$s[\T%;%;D*rs """"""::::::::666666  8 $ $   )34h)i)iwiii-7RZ8m-n-n!7nnn+52:f,,!+ q!!g3 H888 9 9{"{"{"{"{"{"{"{"{"{"r1